Настройка интеграции Meta Ads

Чтобы интегрировать Meta реклама с AppsFlyer, сначала создайте идентификатор Приложение Facebook, а затем получите его. 

Чтобы создать идентификатор Приложение Facebook:

1. В Meta реклама перейдите на дэшборд приложения.
2. В разделе Приложения выберите Создать новое приложение.
3. Заполните название приложения и введите уникальное пространство имен. Обязательно добавьте правильную платформу для вашего приложения, иначе установки могут быть атрибутированы неверно.

Чтобы получить идентификатор Приложение Facebook:

1. В Meta реклама перейдите на дэшборд приложения.
2. Нажмите на нужное приложение.

3. Кликните по идентификатору приложения, отображаемому в верхнем левом углу экрана, чтобы скопировать его.

    

AppsFlyer атрибутирует данные на основе App ID. Тот же идентификатор Приложение Facebook можно использовать для приложений на Android и iOS. Обратите внимание, что начиная с iOS 14, Meta Ads ограничивает количество рекламных аккаунтов девятью на приложение.

С 17 июня 2025 года Meta вновь активировала отчётность в рамках Расширенных мобильных измерений (AMM). Когда вы дадите своё согласие, вам станет доступно следующее:

• аналитика мобильных данных на уровне устройства;
• метрики атрибуции на уровне событий для кампаний в Meta;
• полная интеграция с вашими существующими дэшбордами и экспортами AppsFlyer.

Чтобы включить AMM, выполните следующие действия:

1. Перейдите в Meta Ads.
2. Выберите соответствующий идентификатор приложения, можно выбрать несколько.
3. Принять условия Расширенных мобильных измерений (AMM) от Meta.

1. В AppsFlyer в боковом меню выберите Сотрудничество> Маркетплейс партнёров.
2. Найдите рекламу Meta, затем выберите её.
3. Нажмите Настроить интеграцию. Вы будете перенаправлены на страницу настройки интеграции.
4. На вкладке Интеграция включите переключатель Активировать партнера.
   Примечание: Переключатель должен оставаться включённым (активированным) всё время, пока вы работаете с партнёром.

5. В разделе Общие настройки:

   

   • Вставьте идентификатор приложения Facebook в поле Facebook App ID (Идентификатор приложения Facebook).
   • Вставьте ключ расшифровки реферера установки из Meta Ads.
6. Включите или выключите Расширенный обмен данными, см. Расширенный обмен данными ниже. (Доступно для всех аккаунтов с 14 октября 2024 г.)
7. Нажмите Сохранить интеграцию.

• Чтобы соответствовать окну атрибуции по кликам в Meta Ads, установите его на 7 дней.
  (Обратите внимание, что есть некоторые конкретные случаи, когда значение по умолчанию отличается).
• Установите окно атрибуции по просмотрам в 1 день, как у Meta.
• Чтобы атрибутировать пользователей, которые повторно установили ваше приложение в рамках окна реатрибуции, включите переключатель Атрибуция повторных установок.
  Вам необязательно включать атрибуцию по просмотрам или настраивать окна атрибуции для атрибуции повторных установок, так как эти значения подставляются из настроек атрибуции установок.

API реферера установки Google Play

Meta Ads делится метаданными кампаний с рекламодателями для рекламы приложений на Android, направляющих пользователей в Google Play Store. В этом случае поля атрибуции доступны рекламодателям в API реферера установки Google Play, который необходимо интегрировать в ваше приложение. Поля, предоставляемые через API реферера установки Google Play, заполняют отчеты AppsFlyer по необработанным данным с указанием типа совпадения gp_referrer. Это доступно только после отправки ключа дешифрования и атрибуции установки на Meta Ads. Благодаря этому AppsFlyer может атрибутировать пользователей, у которых нет рекламного идентификатора (с включенным LAT).

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

Помимо API реферера установки в Google Play, реферер установки в Meta позволяет AppsFlyer получать метаданные рекламной кампании из локального хранилища устройства. Эти данные используются для измерения атрибуции. Основные различия между API реферера установки Google Play и реферером установки Meta заключаются в следующем:

• Реферер установки Meta может включать данные о показах и кликах, тогда как API реферера установки Google Play передает только данные о кликах
• Реферер установки Meta потенциально включает данные нескольких сеансов, тогда как API реферера установки Google Play ограничен данными только последнего сеанса (на устройство должно быть установлено приложение в том же сеансе, в котором произошел клик)

В результате вы можете увидеть увеличение количества установок, атрибутированных Meta, в отчетах по сырым данным. Если атрибуция установки осуществляется с помощью API реферера установки Google Play или реферера установки Meta, данные доступны в отчетах по сырым данным. Поля, которые могут быть доступны для атрибуции с помощью реферера установки Meta, заполняют отчеты AppsFlyer по сырым данным с указанием типа соответствия fb_referrer для атрибуции в приложении Facebook и ig_referrer для Instagram. Это доступно только после отправки ключа дешифрования и атрибуции установки к Meta Ads. Ключ дешифрования реферера установки Meta – это тот же ключ, который используется в реферере установки Google Play, и его не нужно предоставлять AppsFlyer во второй раз.

Поля атрибуции по кампании, доступные через реферер:

• идентификатор рекламы;
• название рекламы;
• идентификатор группы объявлений (adset);
• название группы объявлений;
• идентификатор кампании;
• название кампании;
• идентификатор аккаунта;
• канал.

Вопросы и ответы: реферер установки Meta

В каких случаях реферальная ссылка установки Meta применима для атрибуции?

• Для атрибуции установки:
  • Атрибуция по кликам для всех кампаний
  • Атрибуция по просмотрам поддерживается для всех кампаний Advantage+ для приложения и кампаний по продвижению приложений вручную с широким таргетингом (например, где возраст и пол установлены по умолчанию).

• Совместимость: Магазин приложений Google Play и другие магазины приложений для Android
• Исключения: Сюда не входят кампании, перенаправляющие на целевые страницы

Для чего используется «широкий таргетинг» в Meta ads?

Для получения данных об установках по просмотрам требуется широкий таргетинг. Поддерживаемая конфигурация кампании включает в себя:

• Возраст: Применяется настройка по умолчанию (18-65+)
• Пол: Применяется настройка по умолчанию (все полы)
• Местоположение: Поддерживаются группы стран и отдельные страны. Примечание. В более конкретных местоположениях (например, в городах или по почтовым индексам) кампании, использующие инклюзивный таргетинг, должны быть настроены как свободные.
• Детальный таргетинг: Сегменты интересов, поведение и расширенные демографические данные настроены как свободные.
• Пользовательские аудитории: Установлено как расслабленное.
• Для «свободных» необходимо выбрать поле «Детальный таргетинг Advantage» для рекламных кампаний:

Зашифрованные данные из API реферальной ссылки Google Play или реферальной ссылки Meta

Данные из API Google Play Referrer или реферальной ссылки установки Meta, шифруются Meta. Эти данные можно расшифровать с помощью ключа, доступного вам в аккаунте разработчика Meta. Вы должны предоставить нам ключ расшифровки, указанный в строке требуемых действий. Его нужно предоставить один раз по каждому приложению.

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

• Meta Ads не приписала себе установку.
• данные от API реферера установки Google Play были получены, но не дешифрованы.
• кроме того, это был последний клик.

Чтобы получить ключ расшифровки от Meta:

1. Войдите в свой аккаунт на портале Meta для разработчиков.
2. Перейдите в My Apps (Мои приложения) в правом верхнем углу.
3. Выберите приложение, для которого требуется получить ключ дешифрования.
4. Перейдите в раздел Настройки > Основные в левой части страницы.
5. Прокрутите страницу до раздела Android. В нем под полем Package Names (Имена пакетов) вы увидите ключ расшифровки для Install Referrer. Примечание. Это тот же раздел, в котором вы настраивали названия пакетов и Google Play.

Чтобы задать ключ дешифрования в AppsFlyer:

1. [Обязательно] убедитесь, что в приложении установлен SDK AppsFlyer версии 5.4+. Не используйте более ранние версии.
2. В AppsFlyer в боковом меню выберите Сотрудничество > Активные интеграции.
3. Выберите Meta ads.
4. На вкладке Интеграция вставьте ключ в поле Ключ дешифрования для реферера установки. Это нужно сделать один раз по каждому приложению.
5. Нажмите Сохранить интеграцию.

Эта интеграция предоставляет агрегированные данные о затратах, кликах и показах для ваших кампаний, наборов объявлений, объявлений и регионов/стран. Подробную информацию о поддерживаемых параметрах, метриках и функциях см. в таблице интеграции затрат рекламной сети.

Примечание. Данные о кликах и показах включены в интеграцию. Однако для получения данных о затратах требуется подписка ROI360.

Чтобы активировать API стоимости:

1. Выполните вход в аккаунт Meta Ads и убедитесь, что в нем активирована возможность проводить рекламные кампании в Meta Ads. При регистрации пользователь должен получить разрешения на проведение всех кампаний на платформе Meta Business Manager.
2. Перейдите на вкладку Затраты.
3. Включите Получение данных о стоимости, кликах и показах.
4. Нажмите кнопку вход в систему. Вы можете войти с помощью бизнес-аккаунта или аккаунта администратора Meta Ads.
5. При появлении запроса разрешите AppsFlyer доступ к данным вашей кампании в Meta Ads.
   Внимание: При первой синхронизации данных после интеграции, а также при последующих синхронизациях, в AppsFlyer поступают данные о затратах из Meta Ads за последние 7 дней.

Чтобы удалить подключенный аккаунт Meta ads: В столбце действий наведите курсор на аккаунт и нажмите Удалить подключение.

Статус синхронизации данных о затратах

Просмотрите статус вашего API данных о затратах и время, когда AppsFlyer получил соответствующие данные о затратах в последний раз, либо на дэшборде статуса интеграции затрат (и доходов от рекламы), либо на дэшборде отдельной рекламной сети. 

Вы можете синхронизировать несколько аккаунтов для извлечения данных о расходах. Для каждого синхронизированного аккаунта AppsFlyer показывает состояние интеграции данных о затратах и время последнего извлечения соответствующих данных о затратах.

Узнайте больше об обогащении данных данными о затратах, кликах и показах.

Для сопоставления внутренних событий приложения:

1. Активируйте Постбэки по внутренним событиям приложения.
   Когда сопоставление внутренних событий приложения с событиями Meta Ads выполняется в первый раз, событие af_app_open автоматически сопоставляется с fb_mobile_activate_app.

2. Введите следующие параметры:

   Имя параметра	Описание
   Событие AppsFlyer	Имя события, полученное AppsFlyer из SDK, интегрированного в приложение, или из межсерверного события. Совет: Не нашли здесь нужное событие? Убедитесь, что событие активировано на устройстве с неорганической установкой, и повторите поиск. Введите его в поле Событие AppsFlyer и нажмите Добавить другое. Узнайте больше о сопоставлении пользовательских событий.
   сопоставлено с событием партнера	Уникальное имя или идентификатор каждого события, определенные Meta Ads. Возможны следующие настройки сопоставления: Текстовое поле: Введите в него соответствующий идентификатор события, полученный от Meta Ads. Раскрывающийся список: Выберите наиболее подходящее предопределённое событие AppsFlyer. Как есть: События отправляются в исходном виде, без сопоставления названий.
   для пользователей от	Выберите вариант отправки для события: Только этот партнер: отправляйте постбэки только если это событие атрибутировано Meta Ads. Все медиа-источники, включая органические: отправляйте постбэки для событий, атрибутированных любому партнеру, включая органические.
   включая	Нет данных (по умолчанию): отправляет только само событие без значения. Значения и доход: отправляет все параметры события, включая значение дохода (если оно есть в событии). Значения без дохода: отправляет все параметры, кроме значения дохода.

3. Чтобы добавить в список событие SDK или межсерверное событие, нажмите Добавить событие.

Ограничения в названиях событий:

• Ограничения длины названий событий: 2-40 символов
• Следующие символы не допускаются:
  • Двоеточие (:)
  • Точка (.)
  • Нелатинские (не английские) наборы символов: По состоянию на 12 января 2020 года Meta ads отклоняет китайские иероглифы. AppsFlyer не проверял другие алфавиты, поэтому их стоит использовать только после верификации на предмет поддержки Meta Ads этих символов в постбэках.
• Названия событий чувствительны к регистру. Чтобы избежать расхождений, убедитесь, что вы используете правильный регистр в названиях событий для всех медиа-источников и версий приложений.

Атрибуция ретаргетинга в Meta Ads средствами AppsFlyer позволяет рекламодателям атрибутировать вовлечение имеющегося пользователя с помощью рекламы на Facebook, а также оценивать качество этого пользователя и его вовлечение после установки на основании отчетов AppsFlyer. Такую атрибуцию можно использовать, только если у вас есть активные кампании, направленные на ваших собственных пользователей в Facebook.

1. Включите ретаргетинг на странице настроек приложения.
2. На странице партнера Meta Ads включите Атрибуция повторного вовлечения.
3. Установите окно атрибуции повторного вовлечения по кликам.
   Окно атрибуции повторного вовлечения — это временной интервал начиная от клика по рекламе, в течение которого приложение должно быть запущено, чтобы клик был засчитан как повторное вовлечение.
   Выберите единицы измерения окна атрибуции (часы или дни) и установите бегунок на нужное значение.
   
4. Включите атрибуцию повторного вовлечения по просмотрам.
5. Установите ползунок окна атрибуции по просмотрам для повторного вовлечения на нужное значение (до 24 часов). Это временной интервал, который начинается с показа рекламы, в течение которого должно быть запущено приложение, чтобы показ был записан как повторное вовлечение.
6. Установите окно повторного вовлечения.
   Это временной интервал, в течение которого внутренние события приложения данного пользователя будут атрибутироваться медиа-источнику ретаргетинга как основному источнику.
   Это значение можно задавать в днях (от 1 до 90), часах (до 23) или даже на весь период использования приложения. Значение по умолчанию 30 дней.
   

Узнайте больше об атрибуции ретаргетинга в AppsFlyer.

Узнайте подробнее, как работает диплинкинг для пользователей из сетей с самостоятельной атрибуцией (SRN), таких как Meta Ads.

Атрибуция кампании ретаргетинга в WhatsApp

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

Когда переключатель повторного вовлечения включен как на уровне интеграции, так и на уровне приложения, эти кампании измеряются автоматически, без необходимости дополнительной настройки.

В ваших данных атрибуции поле канал будет отображать "WhatsApp" для этих типов кампаний.

Когда включен обмен расширенными данными, Meta получает постбэки и события с идентификаторами на уровне устройства для всех устройств, включая устройства, которые не сделали свой рекламный идентификатор (IDFA) доступным.

Кроме того, когда включен обмен расширенными данными, AppsFlyer атрибутирует эти события. Когда он выключен, отправляются и атрибутируются только постбэки и события от устройств с IDFA.

Этот метод учитывает установки iOS по кликам и просмотрам, а также повторное вовлечение через диплинки в iOS для устройств с одним и двумя вариантами отказа. Атрибуция основана на атрибуции последнего касания с максимальным окном атрибуции в 24 часа.

Закон CCPA ограничивает использование данных, которые поступают от пользователей Meta Ads, находящихся в штате Калифорния (США).

Чтобы обеспечить соответствие требованиям CCPA: Включите опцию Ограничить использование в Meta ads личной информации пользователей (CCPA) на вкладке Интеграция.

Узнать больше о законах по защите данных.

Если в вашем приложении для монетизации рекламы используется функция Meta Audience Network Ad Revenue (Доход от сетевой рекламы для аудитории Meta), вы можете регистрировать в AppsFlyer свои доходы от рекламы в Meta Ads. С помощью этой функции (вместе с данными о выручке от покупок в приложении или без них) можно получить полное представление о выручке, полученной от ваших пользователей.

Регистрация доходов от сетевой рекламы для аудитории Meta

1. На вкладке Доход от рекламы включите опцию Получать данные о доходах от рекламы.
2. Выберите тип агрегированных данных о доходах от рекламы, которые вы хотите получать: Атрибутированный доход и/или совокупный доход от монетизации:
   • Атрибутированный доход: доход по источнику привлечения пользователей.
     В списке Event Source (Источник событий) выберите событие, наиболее соответствующее вашей модели получения выручки от рекламы. Например, если источником дохода являются показы, рекомендуется отправлять в AppsFlyer событие ad_viewed. Для каждой платформы монетизации можно отдельно выбрать наиболее подходящее событие. Тем не менее событие af_app_opened также можно использовать. В этом случае доход от рекламы атрибутируется каждому открытию приложения пользователем.
   • Агрегированные данные о доходе от монетизации: Выручка на основе источника рекламы.
3. На вкладке есть поле Событие выручки от рекламы. В этом поле только для чтения отображается новое событие дохода от рекламы с именем [событие]_monetized (например, на скриншоте выше это имя Ad_Watched_Monetized). На панели управления это событие выручки от рекламы отображается как дополнительное.
4. Нажмите Connect to Meta Ads (Подключить к Meta Ads), чтобы начать сбор данных о доходе от сетевой рекламы для аудитории Meta. Чтобы разрешить использование этой функции, выполните вход с помощью своих учетных данных Meta Ads.
5. Введите Идентификатор приложения Audience Network (Идентификатор приложения Facebook). Получите его из Meta Audience Network.
   • Получите идентификатор приложения Facebook.
   • Скопируйте идентификатор и вставьте его в поле Audience Network App ID в AppsFlyer.
6. Нажмите Сохранить доходы от рекламы.

Разрешите Meta Ads выполнять различные действия и получать доступ к вашим данным в соответствии с доступными разрешениями.

Подробнее о предоставлении разрешений интегрированным партнерам.

Как указано в руководстве по интеграции SDK (пакет средств разработки ПО) - iOS, необходимо добавить AdSupport.framework в ваш проект, чтобы начался сбор IDFA. Проверьте отчет о необработанных данных по установке, чтобы убедиться, что столбец IDFA действительно пуст или нет. Рекомендуется включить сбор IDFA в приложениях для iOS и GAID в приложениях для Android.
Начиная с iOS 14.5, вы должны показать запрос Apple ATT и получить согласие пользователя перед сбором IDFA.

Примечание. На атрибуцию SKAdNetwork не влияет наличие IDFA. Тем не менее, убедитесь, что при настройке кампаний для iOS 14 вы включили переключатель «Кампания iOS 14» в реклама Meta.

Чтобы атрибуция работала, пользователь должен зарегистрировать свое приложение в Meta Ads как Live (Действующее) , а не как In development (В разработке).

При настройке кампании установки приложений в Meta Ads вы можете выбрать приложение из выпадающего списка или вставить полный URL-адрес магазина в приложение. Хотя оба метода работают с рекламой Meta, второй метод не позволяет выполнить атрибуцию AppsFlyer.

Правильная настройка — атрибуция работает.

Неправильная настройка — атрибуция не удается.