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

Краткий обзор. Подробнее об интеграции Meta Ads с AppsFlyer.

Руководство по настройке Meta Ads

Сколько нужно времени, чтобы с помощью AppsFlyer настроить атрибуцию для рекламы своего мобильного приложения в Meta Ads?

Если вы уже интегрировали SDK AppsFlyer в свое приложение и зарегистрировали приложение в Meta Ads, то это займет меньше минуты! 

Для атрибуции мобильного приложения не нужно использовать функцию Facebook Login или интегрировать в свое приложение SDK Facebook. Просто выполните базовую настройку, описанную в этом пошаговом руководстве. После чего переходите к дополнительным опциям настройки для Meta Ads.

Идентификатор приложения в Facebook

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

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

  1. В Meta Ads перейдите на дэшборд приложения.
  2. В разделе Apps (Приложения) выберите Create New App (Создать новое приложение).
  3. Введите название своего приложения и задайте уникальное пространство имен. Убедитесь, что платформа приложения указана верно, иначе возможна некорректная атрибуция установок.

Чтобы восстановить идентификатор приложения Facebook:

  1. В Meta Ads перейдите на дэшборд приложения.
  2. Нажмите на необходимое приложение.
  3. Чтобы скопировать идентификатор приложения, нажмите на него в верхнем левом углу экрана.

    FB-app-id-2-blur.png

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

Базовая настройка атрибуции Meta Ads

Чтобы начать атрибуцию в кампаниях Meta Ads с помощью AppsFlyer, выполните следующие действия:

 Посмотреть
 Прочитать
  1. Чтобы активировать интеграцию с Meta Ads:
    1. Откройте список своих приложений на платформе Meta for Developers.
    2. Выберите нужное приложение.

      FB-for-devs-app-selecrion-en_us.png

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

      FB-for-devs-app-ID-copy-en_us.png

    4. В AppsFlyer в боковом меню выберите Сотрудничество > Маркетплейс партнеров
    5. Найдите и выберите Meta Ads.
    6. Нажмите Настроить интеграцию. Вы будете перенаправлены на страницу настройки интеграции.
    7. На вкладке Интеграция включите переключатель Активировать партнера.
      Примечание. Этот переключатель должен быть активирован все время, пока вы работаете с этим партнером.
    8. В общих настройках:

      meta_ads_general_settings2.png

    9. Нажмите Сохранить интеграцию.
  2. [дополнительно] Настройте рекомендуемые параметры:

    meta_ads_install_attribution.png

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

Все еще не видите результатов в AppsFlyer? См. раздел Интеграция Meta Ads — устранение неполадок.

Расширенные настройки атрибуции в Meta Ads

После выполнения основных настроек для атрибуции в Meta Ads можно быстро выполнить некоторые дополнительные настройки атрибуции.

 Посмотреть
 Прочитать

Данные уровня пользователя

Ограничение данных атрибуции в Meta ads

С 29 октября 2021 года рекламодателям доступна только агрегированная отчетность. Все остальные данные атрибуции по кликам и просмотрам отображаются в отчетах с сырыми данными как «restricted» (ограничено). Другие поля, относящиеся к медиа-источнику, не заполнены. См. раздел Ограничение содержимого сырых данных.

Это изменение касается всех рекламодателей, операционных систем и MMP. Оно относится к данным уровня устройства по всем пользователям iOS и Android, независимо от статуса согласия на ATT или персонализации рекламы.

AppsFlyer продолжит получать из Meta Ads данные уровня устройства. Это значит, что наши возможности атрибуции и отчетности (включая мультиканальную атрибуцию, LTV, ROI, когортные отчеты, отчеты об удержании пользователей, защиту от фрода, Аудитории и другие сервисы) не изменятся. См. Инструменты для агрегированных и аналитических отчетов.

Получение данных на уровне пользователей об установках на Android и внутренних событиях приложения

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

Хотя данные уровня пользователя скрыты, Meta Ads предоставляет рекламодателям метаданные кампаний по рекламе приложений для Android, ведущей в магазин Google Play. В этом случае поля атрибуции доступны рекламодателям в 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 во второй раз.

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

  • ID рекламы
  • Имя рекламы
  • ID блока рекламы
  • Название блока рекламы
  • ID кампании
  • Название кампании
  • ID аккаунта
  • Канал

 Примечание

  • API реферера установки в Google Play:
    • Для корректной передачи данных реферера необходимо использовать SDK AppsFlyer версии 5.4.0 и выше. Данные реферера не скрыты и имеют приоритет над данным, предоставленными через API. Это решение применимо к атрибуции по кликам и не применимо к атрибуции по просмотрам.
    • Поле «Канал» определяется значением канала, полученным из API реферера Google Play (отправленным в Google Play из Meta). Если получена пустая строка, в поле «Канал» отображается значение «Нет».
  • Для реферера установки Meta: Для корректной передачи данных реферера необходимо использовать SDK AppsFlyer версии 6.12.6 и выше. Данные рефереров имеют приоритет над данными, предоставляемыми интеграцией Meta ads, и доступны в отчетах по сырым данным. Это решение применимо как к атрибуции по кликам, так и к атрибуции по просмотрам.

Реферер установки Meta — часто задаваемые вопросы

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

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

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

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

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

Зашифрованные данные из API реферера Google Play 

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

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

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

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

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

  5. Прокрутите страницу до раздела Android. В нем под полем Package Names (Имена пакетов) вы увидите ключ расшифровки для Install Referrer. Примечание. Это тот же раздел, в котором вы настраивали имена пакетов и Google Play.

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

  1. [обязательно] Убедитесь, что в приложении установлен SDK AppsFlyer версии 5.4+. Не используйте более ранние версии.
  2. В AppsFlyer в боковом меню выберите СотрудничествоАктивные интеграции.
  3. Выберите Meta Ads.
    meta_ads_general_settings2.png
  4. На вкладке Integration (Интеграция) вставьте ключ в поле Install Referrer Decryption Key (Ключ расшифровки для Install Referrer). Это нужно сделать один раз по каждому приложению.
  5. Нажмите Сохранить интеграцию.

Затраты, клики и показы

meta_cost_tab.png

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

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

Чтобы включить API данных о затратах:

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

Читайте, как Meta Ads определяет клики и просмотры.

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

 Примечания.

  • Если вы уже вошли в Meta Ads, то при нажатии кнопки f login окно откроется и сразу закроется. Это обычная ситуация.
  • Если у вас есть несколько пользователей с разрешениями для Meta Ads, рекомендуется выполнить вход для всех этих пользователей, чтобы получать полные, а не частичные данные.

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

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

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

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

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

meta_iae_postbacks.png

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

  1. Активируйте Постбэки по внутренним событиям приложения.
    Когда сопоставление внутренних событий приложения с событиями Meta Ads выполняется в первый раз, событие af_app_open автоматически сопоставляется с fb_mobile_activate_app.
  2. Введите следующие параметры:
    Имя параметра Описание
    Событие AppsFlyer

    Имя события, полученное AppsFlyer из SDK, интегрированного в приложение, или из межсерверного события.
     Совет: Не нашли здесь нужное событие?

    • Убедитесь, что событие активировано на устройстве с неорганической установкой, и повторите поиск.
    • Введите его в поле AppsFlyer event (Событие AppsFlyer) и нажмите Create custom (Добавить другое). Подробнее о сопоставлении пользовательских событий читайте здесь.
    сопоставлено с событием партнера

    Уникальное имя или идентификатор каждого события, определенные Meta Ads. Возможны следующие настройки сопоставления:

    • Текстовое поле: Введите в него соответствующий идентификатор события, полученный от Meta Ads.
    • Раскрывающийся список: Выберите наиболее подходящее предопределенное событие AppsFlyer.
    • Как есть: События отправляются в исходном виде, без сопоставления названий.
    for users from (для пользователей от)

    Выберите вариант отправки для события.

    • Только этот партнер: отправляйте постбэки только в том случае, если это событие атрибутировано Meta Ads.
    • Все медиа-источники и органический трафик: отправляйте постбэки для событий, атрибутированных любому партнеру, а также для органических событий.
    включая
    • Нет данных (по умолчанию): отправляет только само событие без значения.
    • Значения и доход: отправляет все параметры события, включая значение дохода (если оно есть в событии).
    • Значения без дохода: отправляет все параметры, кроме значения дохода.
  3. Чтобы добавить в список событие SDK или межсерверное событие, нажмите Добавить событие.

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

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

 Примечание

Атрибуция ретаргетинга

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

  1. Включите ретаргетинг на странице настроек приложения.
  2. На странице партнера Meta Ads включите Атрибуция повторного вовлечения.
  3. Установите окно атрибуции повторного вовлечения по кликам.
    Окно атрибуции повторного вовлечения — это временной интервал начиная от клика по рекламе, в течение которого приложение должно быть запущено, чтобы клик был засчитан как повторное вовлечение.
    Выберите единицы измерения окна атрибуции (часы или дни) и установите бегунок на нужное значение.

    re-engagement_attribution_toggle.png

  4. Активируйте опцию Атрибуция повторного вовлечения по просмотрам.
  5. Установите ползунок окна атрибуции повторного вовлечения по просмотрам на нужное значение (до 24 часов). Это временной интервал, который начинается с показа рекламы, в течение которого должно быть запущено приложение, чтобы показ был записан как повторное вовлечение.

    re-engagement_view-through_toggle.png

  6. Установите окно повторного вовлечения.
    Это временной интервал, в течение которого внутренние события приложения данного пользователя будут атрибутироваться медиа-источнику ретаргетинга как основному источнику.
    Это значение можно задавать в днях (от 1 до 90), часах (до 23) или даже на весь период использования приложения. Значение по умолчанию 30 дней.

    re-engagement_window.png

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

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

Соблюдение закона о защите персональных данных граждан штата Калифорния (California Consumer Privacy Act, CCPA)

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

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

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

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

meta_ads_ad_revenue.png

Если в вашем приложении для монетизации рекламы используется функция 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.
  6. Нажмите Сохранить доходы от рекламы.

Разрешения

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

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

Агрегированное измерение событий (AEM) для iOS

AppsFlyer поддерживает решение Meta ads Агрегированное измерение событий (AEM). Это решение помогает оптимизировать конверсии iOS и события в приложении, а также атрибутировать повторное вовлечение на iOS в Meta ads.

Интеграция Meta Ads: устранение неполадок

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

Если это так, ознакомьтесь с основными причинами этой проблемы и способами ее устранения.

Не выполняется сбор идентификаторов IDFA

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

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

Неправильный идентификатор приложения в Facebook

Идентификатор приложения в Facebook был неправильно настроен в AppsFlyer.
Убедитесь, что идентификатор приложения указан правильно и соответствует значению на дэшборде Meta Ads.

Обратите внимание, что проверить идентификатор вашего приложения в Facebook можно также с помощью Facebook Graph API.

Статус приложения в Meta Ads

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

fb-app-status.png

Неправильный тип кампании в Meta Ads

Убедитесь, что для кампаний в Meta Ads выбран тип Mobile app install ads (Реклама мобильных приложений с целью установки) или Mobile App Engagement (Взаимодействие с мобильными приложениями). При настройке кампаний в Meta Ads с другими целями (например, Link Click (Клики по ссылке) для целевых страниц) для измерения количества установок мобильных приложений рекламодателю нужно установить флажок App Event recording  (Регистрация событий в приложении).

Реклама в Meta Ads с целью установки приложений

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

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

fb-app-install.png

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

fb-app-incorrect_setup.png

Обновления Meta Ads

 Важно!

С 29 октября 2021 года рекламодателям доступны только агрегированные отчеты из Meta Ads. Это относится как к установкам, так и к внутренним событиям приложения. Это изменение касается всех рекламодателей, операционных систем и MMP. Оно относится к данным уровня устройства по всем пользователям iOS и Android, независимо от статуса согласия на ATT или персонализации рекламы.
Сырые данные по установкам и внутренним событиям, привлеченным до изменения (29 октября 2021 года), будут по-прежнему доступны.
Обратите внимание, что данные уровня пользователя можно получить через реферер установки Google. 
Подробнее в этом новостном бюллетене.

Обновления iOS 14, связанные с Meta Ads

AppsFlyer подтверждает, что в нашей MMP-интеграции с Meta Ads всегда реализуется флаг Отслеживание рекламодателем включено. Это значит, что от вас никаких действий в AppsFlyer не требуется. Эта информация предоставляется в соответствии с чек-листом из рекомендаций Meta Ads по приложениям для iOS 14, опубликованным в феврале 2021 года.