Мы постоянно публикуем обновления документации, которые могут быть недоступны на вашем языке. Наиболее актуальные сведения содержатся в версии на английском языке.

Отчетность по сырым данным Meta для Android

Meta предоставляет рекламодателям возможность сделать содержание сырых данных для приложений на Android более подробным с помощью рефереров установки. Метаданные кампании добавляются к рефереру установки в зашифрованном виде. Чтобы прочитать метаданные, нужно использовать ключ расшифровки, предоставленный Meta для вашего приложения.

Вы можете выбрать один из двух рефереров установки для обогащения сырых данных:

  • Реферер установки от Meta (MIR)
  • Реферер установки от Google Play (GPIR)
Примечание:
Оба реферера предоставляют больше информации об установках из приложений Meta, таких как Facebook и Instagram. MIR поддерживает атрибуцию просмотров и кликов в уникальных сессиях, которая не поддерживается GPIR. MIR позволяет извлечь максимальную пользу из кампаний в Meta.

Перед началом работы

Что нужно знать, приступая к работе.

Требования

MIR

#### GPIR

Как это работает?

С помощью реферера установки можно связать активность пользователя в приложении с источником привлечения данного пользователя рекламой, показываемой на Android. Таким образом можно отслеживать результативность кампаний и выявлять основные тенденции привлечения.

Когда пользователь устанавливает ваше приложение, реферер установки собирает данные о реферале из источника установки. Meta делится этими данными с помощью программного интерфейса реферера установки в зашифрованном виде. Затем Adjust расшифровывает эти данные с помощью ключа расшифровки, полученного от Meta.

Пример строки расшифрованных данных:

{
"ad_id":"12345",
"ad_objective_name":"APP_INSTALL",
"adgroup_id":"54321",
"adgroup_name":"Test Ad Group",
"campaign_id":"987654",
"campaign_name":"Test Campaign",
"campaign_group_id":"654321",
"campaign_group_name":"Test Campaign Group",
"account_id":"444444",
"publisher_platform":"Test Publisher Platform",
}

Для получения расшифрованных данных вместе с экспортируемыми сырыми данными вы можете использовать плейсхолдеры.

Предупреждение:
Если активировать и MIR, и GPIR, вы будете получать сведения из обоих источников.Adjust дедуплицирует сведения, полученные от MIR и GPIR в Datascape, но вы по-прежнему будете получать оба набора данных при экспорте сырых данных. Данным MIR следует отдавать приоритет перед данными GPIR.

Какие данные не передаются?

Meta не отправляет следующие метаданные:

Следующие виды метаданных доступны только при использовании MIR:

  • Просмотровые конверсии.
  • События, происходящие в магазинах приложений для Android за пределами Google Play Store, например Galaxy Store и Amazon Appstore.

Настройка Реферера установки

Для настройки реферера установки и получения определенных сведений на уровне кампании от Meta выполните следующие действия.

1. Обновите учетные данные Meta в Adjust

Предоставьте ключ расшифровки реферера установки, который позволит Adjust расшифровывать метаданные реферера. Ключ представляет собой строку из 64 цифр (0-9) и букв нижнего регистра (a-f). Для каждого идентификатора приложения Meta доступен один ключ расшифровки.

Пример: 9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce

Найдите ключ расшифровки

Чтобы найти ключ расшифровки, выполните следующие действия.

  1. Войдите на портал разработчика Meta.
  2. Перейдите в раздел Мои приложения в правом верхнем углу.
  3. Выберите приложение, для которого вы хотите получить ключ расшифровки.
  4. Выберите «Настройки» > «Основные» .
  5. Пролистайте до раздела Android .
  6. Найдите Ключ расшифровки в разделе Google Play .

Добавьте свой ключ расшифровки в Adjust

Чтобы добавить ключ расшифровки в Adjust, выполните следующие действия.

  1. В разделе Campaign Lab выберите Партнеры.
  2. Найдите Facebook и нажмите на эту ссылку, чтобы перейти на страницу обзора.
  3. Выберите вкладку Обмен данными , чтобы увидеть список приложений.
  4. Найдите приложение, которое вы хотите настроить, и нажмите на кнопку Редактировать ().
  5. В разделе Включение обмена данными с Facebook выберите Изменить .
  6. Введите ключ расшифровки для каждой платформы, которую необходимо настроить.

2. Добавьте плейсхолдеры для рефереров Meta в колбэки

Adjust может использовать определенные плейсхолдеры для отправки расшифрованных данных из Meta при экспорте сырых данных. Чтобы получить эту информацию, добавьте в URL колбэка или CSV определение необходимые плейсхолдеры.

Доступные плейсхолдеры

MIR
GPIR
ПлейсхолдерОписание
{meta_install_referrer}Всё содержимое реферера установки Meta в расшифрованном виде.
{meta_install_referrer_campaign_group_name}Значение "campaign_group_name" из всего содержимого реферера установки Meta.
{meta_install_referrer_campaign_group_id}Значение "campaign_group_id" из всего содержимого реферера установки Meta.
{meta_install_referrer_campaign_name}Значение "campaign_name" из всего содержимого реферера установки Meta.
{meta_install_referrer_campaign_id}Значение "campaign_id" из всего содержимого реферера установки Meta.
{meta_install_referrer_adgroup_id}Значение "adgroup_id" из всего содержимого реферера установки Meta.
{meta_install_referrer_adgroup_name}Значение "adgroup_name" из всего содержимого реферера установки Meta.
{meta_install_referrer_ad_id}Значение "ad_id" из всего содержимого реферера установки Meta.
{meta_install_referrer_account_id}Значение "account_id" из всего содержимого реферера установки Meta.
{meta_install_referrer_ad_objective_name}Значение "ad_objective_name" из всего содержимого реферера установки Meta.
{meta_install_referrer_publisher_platform}Значение «publisher_platform» из всего содержимого реферера установки Meta.
{meta_install_referrer_is_click}Используется ли в качестве типа вовлечения клик. Если тип вовлечения — клик, возможными значениями будут 1 , в противном случае — 0.
{meta_install_referrer_actual_timestamp}Значение "actual_timestamp" из всего содержимого реферера установки Meta.

Отчеты и сопоставление плейсхолдеров

Для согласования данных, полученных из плейсхолдеров рефереров Meta, с нашей отчетностью Adjust использует следующие сопоставления.

MIR
GPIR
Поле атрибуции AdjustОтчеты MetaПлейсхолдерПример значения
network_nameПлатформа издателя
  • {meta_install_referrer_publisher_platform}
Установки Meta
campaign_nameНазвание кампании
ID кампании
  • {meta_install_referrer_campaign_group_name}({meta_install_referrer_campaign_group_id})
 Тестирование кампании в Facebook на Android (123456789)
adgroup_nameНазвание группы объявлений
ID группы объявлений
  • {meta_install_referrer_campaign_name}({meta_install_referrer_campaign_id})
 Android — США — базовая группа объявлений (234567890)
creative_nameНазвание объявления
ID объявления
  • {meta_install_referrer_adgroup_name}({meta_install_referrer_adgroup_id})
 Летний баннер (345678901)

Как Adjust отображает имя_сети

Примеры колбэков

Пример URL колбэка:

MIR
GPIR
https://app.my-random-server.com/?tracker={tracker_token}&tracker_name={tracker_name}referrer={referrer}&meta_referrer={meta_install_referrer}&PhMetaInstallReferrerAdId={meta_install_referrer_ad_id}&PhMetaInstallReferrerAdGroupId={meta_install_referrer_adgroup_id}&PhMetaInstallReferrerAdGroupName={meta_install_referrer_adgroup_name}&PhMetaInstallReferrerCampaignId={meta_install_referrer_campaign_id}&PhMetaInstallReferrerCampaignName={meta_install_referrer_campaign_name}&PhMetaInstallReferrerCampaignGroupId={meta_install_referrer_campaign_group_id}&PhMetaInstallReferrerCampaignGroupName={meta_install_referrer_campaign_group_name}&PhMetaInstallReferrerAccountId={meta_install_referrer_account_id}&PhMetaInstallReferrerAdObjectiveName={meta_install_referrer_ad_objective_name}&PhMetaInstallReferrerPublisherPlatform={meta_install_referrer_publisher_platform}&PhMetaInstallReferrerIsClick={meta_install_referrer_is_click}&PhMetaInstallReferrerActualTimestamp={meta_install_referrer_actual_timestamp}

Пример колбэка с указанными значениями:

MIR
GPIR
https://app.my-random-server.com/?tracker=unattr&tracker_name=Unattributed&referrer=adjust_reftag%3DceJTzfSP7kyVV%26utm_source%3Dfacebook%26utm_content%3D%257B%2522source%2522%253A%257B%2522data%2522%253A%2522afe56cf6228c6ea8c79da49186e718e92a579824596ae1d0d4d20d7793dca797bd4034ccf467bfae5c79a3981e7a2968c41949237e2b2db678c1c3d39c9ae564c5cafd52f2b77a3dc77bf1bae063114d0283b97417487207735da31ddc1531d5645a9c3e602c195a0ebf69c272aa5fda3a2d781cb47e117310164715a54c7a5a032740584e2789a7b4e596034c16425139a77e507c492b629c848573c714a03a2e7d25b9459b95842332b460f3682d19c35dbc7d53e3a51e0497ff6a6cbb367e760debc4194ae097498108df7b95eac2fa9bac4320077b510be3b7b823248bfe02ae501d9fe4ba179c7de6733c92bf89d523df9e31238ef497b9db719484cbab7531dbf6c5ea5a8087f95d59f5e4f89050e0f1dc03e464168ad76a64cca64b79%2522%252C%2522nonce%2522%253A%2522b7203c6a6fb633d16e9cf5c1%2522%257D%257D&meta_referrer=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Adams+Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Adams+Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Adams+Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D&PhMetaInstallReferrerAdId=12345&PhMetaInstallReferrerCampaignId=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Adams+Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Adams+Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Adams+Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D&PhMetaInstallReferrerCampaignName=Adams+Test+Campaign&PhMetaInstallReferrerCampaignGroupId=654321&PhMetaInstallReferrerCampaignGroupName=Adams+Test+Campaign+Group&PhMetaInstallReferrerAccountId=444444&PhMetaInstallReferrerAdObjectiveName=APP_INSTALLS &PhMetaInstallReferrerAdObjectiveName=APP_INSTALLS&MetaInstallReferrerPublisherPlatform=facebook&PhMetaInstallReferrerIsClick=1&PhMetaInstallReferrerActualTimestamp=1234567890

Для установок, не атрибутированных Meta

Если реферер привязан к установке, а окончательная атрибуция присваивается другому партнеру (не Meta), информация о реферере все равно будет содержаться в ваших данных.

MIR
GPIR
https://myserver.com?tracker=def456&tracker_name=NetworkA&meta_install_referrer=%7B%22ad_id%22%3A%2212345%22%2C%22ad_objective_name%22%3A%22APP_INSTALLS%22%2C%22adgroup_id%22%3A%2254321%22%2C%22adgroup_name%22%3A%22Test+Ad+Group%22%2C%22campaign_id%22%3A%22987654%22%2C%22campaign_name%22%3A%22Test+Campaign%22%2C%22campaign_group_id%22%3A%22654321%22%2C%22campaign_group_name%22%3A%22Test+Campaign+Group%22%2C%22account_id%22%3A%22444444%22%7D