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

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

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

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

  • Реферер установки от Google Play (GPIR)
  • Реферер установки от Meta (MIR)

Оба реферера предоставляют больше информации об установках из приложений Meta, таких как Facebook и Instagram. Однако только MIR поддерживает атрибуцию просмотров и кликов в уникальных сессиях.

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

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

Требования

GPIR

Для активации GPIR следует настроить реферер установки от Google Play.

MIR

Для активации плагина MIR следует обновить Adjust Android SDK до версии 5, а также настроить плагин реферера установки Meta.

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

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

  1. Когда пользователь устанавливает ваше приложение, реферер установки собирает данные о реферале из источника установки.
  2. Meta делится этими данными в зашифрованном виде, используя программный интерфейс реферера установки.
  3. Затем 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",
}

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

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

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

Meta не отправляет идентификаторы устройств.

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

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

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

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

Укажите учетные данные Meta в Adjust

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

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

Ключ расшифровки представляет собой 64-символьную строку при каждом идентификаторе приложения Meta.

Пример: 9fc19e01a8ac4db1404c23b1ea656047f9fcd5cb3befb0cf650a32ed919893ce

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

  1. Откройте панель управления приложениями.
  2. Выберите нужное приложение.
  3. Выберите «Настройки» > «Основные» .
  4. Пролистайте до раздела Android .
  5. Скопируйте  Ключ расшифровки реферера установки .
A screenshot from Meta's App Dashboard that shows where to find your Decryption Key. Refer to the textual instructions above.

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

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

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

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

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

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

GPIR
MIR
ПлейсхолдерОписание
{fb_install_referrer}Всё содержимое реферера установки Meta в расшифрованном виде.
{fb_install_referrer_campaign_group_name}Значение "campaign_group_name" из всего содержимого реферера установки Meta.
{fb_install_referrer_campaign_group_id}Значение "campaign_group_id" из всего содержимого реферера установки Meta.
{fb_install_referrer_campaign_name}Значение "campaign_name" из всего содержимого реферера установки Meta.
{fb_install_referrer_campaign_id}Значение "campaign_id" из всего содержимого реферера установки Meta.
{fb_install_referrer_adgroup_id}Значение "adgroup_id" из всего содержимого реферера установки Meta.
{fb_install_referrer_adgroup_name}Значение "adgroup_name" из всего содержимого реферера установки Meta.
{fb_install_referrer_ad_id}Значение "ad_id" из всего содержимого реферера установки Meta.
{fb_install_referrer_account_id}Значение "account_id" из всего содержимого реферера установки Meta.
{fb_install_referrer_ad_objective_name}Значение "ad_objective_name" из всего содержимого реферера установки Meta.
{fb_install_referrer_publisher_platform}Значение «publisher_platform» из всего содержимого реферера установки Meta.

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

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

GPIR
MIR
Поле атрибуции AdjustОтчеты MetaПлейсхолдерПример значения
network_nameПлатформа издателя {fb_install_referrer_publisher_platform} Установки Meta
campaign_nameНазвание кампании
ID кампании
{fb_install_referrer_campaign_group_name}
({fb_install_referrer_campaign_group_id})
Тестирование кампании в Meta на Android (123456789)
adgroup_nameНазвание группы объявлений
ID группы объявлений
{fb_install_referrer_campaign_name}
({fb_install_referrer_campaign_id})
Android — США — базовая группа объявлений (234567890)
creative_nameНазвание объявления
ID объявления
{fb_install_referrer_adgroup_name}
({fb_install_referrer_adgroup_id})
Летний баннер (345678901)

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

Для представления network_name Adjust использует следующую логику:

publisher_platformnetwork_name, представленное следующим образом:
«facebook», «unknown» или любое другоеУстановки Facebook
«instagram»Установки Instagram
«messenger»Установки Facebook Messenger
«audience_network»Установки за пределами Facebook

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

GPIR
MIR
https://app.my-random-server.com/?tracker={tracker_token}&tracker_name={tracker_name}referrer={referrer}&fb_referrer={fb_install_referrer}&PhFbInstallReferrerAdId={fb_install_referrer_ad_id}&PhFbInstallReferrerAdGroupId={fb_install_referrer_adgroup_id}&PhFbInstallReferrerAdGroupName={fb_install_referrer_adgroup_name}&PhFbInstallReferrerCampaignId={fb_install_referrer_campaign_id}&PhFbInstallReferrerCampaignName={fb_install_referrer_campaign_name}&PhFbInstallReferrerCampaignGroupId={fb_install_referrer_campaign_group_id}&PhFbInstallReferrerCampaignGroupName={fb_install_referrer_campaign_group_name}&PhFbInstallReferrerAccountId={fb_install_referrer_account_id}&PhFbInstallReferrerAdObjectiveName={fb_install_referrer_ad_objective_name}&PhFbInstallReferrerPublisherPlatform={fb_install_referrer_publisher_platform}

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

GPIR
MIR
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&fb_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&PhFbInstallReferrerAdId=12345&PhFbInstallReferrerCampaignId=%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&PhFbInstallReferrerCampaignName=Adams+Test+Campaign&PhFbInstallReferrerCampaignGroupId=654321&PhFbInstallReferrerCampaignGroupName=Adams+Test+Campaign+Group&PhFbInstallReferrerAccountId=444444&PhFbInstallReferrerAdObjectiveName=APP_INSTALLS &PhFbInstallReferrerAdObjectiveName=APP_INSTALLS&FbInstallReferrerPublisherPlatform=facebook

Установки, не атрибутированные Meta

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

GPIR
MIR
https://myserver.com?tracker=def456&tracker_name=NetworkA&fb_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