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

Краткий обзор. Интеграция Facebook Ads с AppsFlyer.

Руководство по настройке рекламы в Facebook

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

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

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

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

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

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

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

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

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

    FB-app-id-2-blur.png

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

Основные настройки атрибуции в Facebook

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

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

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

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

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

    4. В AppsFlyer перейдите в раздел Настройки > Интегрированные партнеры.
    5. В списке партнеров выберите Facebook Ads.
    6. На вкладке Integration (Интеграция) установите переключатель Activate partner (Активировать партнера) в положение «Включено».

      Activating-integration-with-FB-en_us.png

      Подробнее об активации партнеров.
    7. Вставьте идентификатор приложения в поле Facebook App ID (Идентификатор приложения Facebook).
    8. Нажмите кнопку Save Integration (Сохранить интеграцию).
  2. [дополнительно] Настройте рекомендуемые параметры:

    FB-recommanded-settings-en_us.png


    1. Установите окно атрибуции по кликам в 7 дней, как у Facebook Ads.
      (Обратите внимание, что есть некоторые конкретные случаи, когда значение по умолчанию отличается).
    2. Установите окно атрибуции по просмотрам в 1 день, как у Facebook.
    3. Чтобы учесть пользователей, которые повторно установили ваше приложение в рамках окна реатрибуции, установите переключатель Атрибуция повторных установок в положение «Включено».
      Вам необязательно включать атрибуцию по просмотрам или настраивать окна атрибуции для атрибуции повторных установок, так как эти значения подставляются из настроек атрибуции установок.
    4. Чтобы сохранить настройки, нажмите Save Integration (Сохранить интеграцию).

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

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

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

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

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

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

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

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

Как получить данные уровня пользователя по установкам на устройствах Android?

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

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

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

Внимание! Для корректной передачи данных реферера необходимо использовать SDK AppsFlyer версии 5.4.0 и выше. Данные реферера не скрыты и имеют приоритет над данным, предоставленными через API. Это решение применимо к атрибуции по кликам и НЕ применимо к атрибуции по просмотрам.  

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

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

  • Реклама в Facebook не приписала себе установку.
  • Реферер установки Facebook был получен, но не расшифрован.
  • И это был последний клик.

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

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

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

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

  1. [обязательно] Убедитесь, что в приложении установлен SDK AppsFlyer версии 5.4+. Не используйте более ранние версии.
  2. В AppsFlyer перейдите в раздел Configuration (Настройки) > Integrated Partners (Интегрированные партнеры).
  3. Выберите Facebook.

    FB-for-install-referrer-decryption-key2.png

  4. На вкладке Integration (Интеграция) вставьте ключ в поле Install Referrer Decryption Key (Ключ расшифровки для Install Referrer). Это нужно сделать один раз по каждому приложению.
  5. Нажмите Сохранить интеграцию.

Данные о затратах, кликах и показах

fb-cost-tab.png

Активировав функцию Затраты в Facebook, можно получать данные о затратах в Facebook по кампаниям, группам объявлений, отдельным объявлениям и каналам. Также вы можете получать по ним агрегированные данные о кликах и показах. Подробную информацию о поддерживаемых параметрах, метриках и функциях см. в таблице интеграции затрат рекламной сети. Примечание. Для получения сведений о затратах требуется подписка Xpend.

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

  1. Выполните вход в аккаунт Facebook и убедитесь, что в нем активирована возможность проводить рекламные кампании в Facebook. При регистрации в Facebook пользователь должен получить разрешения на проведение всех кампаний на платформе Business Manager.
  2. Перейдите на вкладку Затраты.
  3. Установите переключатель Get Cost, Clicks and Impressions Data (Получать данные о затратах, кликах и показах) в положение «Включено».
  4. Нажмите кнопку Вход в Facebook.
  5. При появлении запроса разрешите AppsFlyer доступ к данным вашей кампании на Facebook.
    Примечание. При первой синхронизации данных после интеграции, а также при последующих синхронизациях, в AppsFlyer поступают данные о затратах Facebook за последние 7 дней.

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

Чтобы удалить связанный аккаунт Facebook: в столбце действий наведите курсор на аккаунт и нажмите Delete connection (Удалить связанный аккаунт).

 Примечания.

  • Если вы уже вошли в Facebook, то при нажатии кнопки Facebook Login (Вход в Facebook) окно Facebook откроется и сразу закроется. Это обычная ситуация.
  • Если у вас есть несколько пользователей с разрешениями для Facebook, рекомендуется выполнить вход в Facebook для всех этих пользователей, чтобы получать полные, а не частичные данные.

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

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

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

Узнайте больше о дополнении информации, получаемой из Facebook, данными о затратах, кликах и показах.

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

In-app_event_postbacks_en-us.png

 

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

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

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

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

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

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

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

    • This partner only (Только этот партнер): отправляйте постбэки только в том случае, если это событие атрибутировано Facebook.
    • All media sources including organic (Все медиа-источники, включая органические): отправляйте постбэки для событий, атрибутированных любому партнеру, а также для органических событий.
    Включая
    • No data (default) (Нет данных (по умолчанию)): отправляет только само событие без значения.
    • Values and revenue (Значения и доход): отправляет все параметры события, включая значение дохода (если оно есть в событии).
    • Values without revenue (Значения без дохода): отправляет все параметры, кроме значения дохода.
  3. Чтобы добавить в список событие SDK или межсерверное событие, нажмите Add Event (Добавить событие).

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

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

Узнайте больше о Сопоставлении внутренних событий приложения с событиями Facebook Ads.

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

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

Такую атрибуцию можно использовать, только если у вас есть активные кампании, направленные на ваших собственных пользователей в Facebook.

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

    facebook_reengagement_attribution.png

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

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

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

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

Для соблюдения требований закона CCPA установите флажок Ограничить использование персональных данных пользователей в Facebook (CCPA) на вкладке Интеграция.

Подробнее о соответствии требованиям CCPA.

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

mceclip0.png

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

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

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

Разрешения

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

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

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

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

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

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

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

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

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

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

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

Состояние приложения в Facebook

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

Make_Test_App_Public.png

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

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

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

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

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

how_to_set_campaign_FB.png

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

how_not_to_set_a_campaign_on_Facebook.png

 

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

 Важно!

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

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

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

Материал по теме: Совместимость SKAdNetwork с AppsFlyer. В этой статье рассматриваются вопросы о кампаниях, связанные с iOS 14. 

Была ли эта статья полезной?