Настройка интеграции с 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 откройте дэшборд монетизации Monetization Manager.
  2. Выберите Свойство, по которому вы хотите получить данные.
  3. Перейдите в раздел Placements (Размещения) > Manage Placement (Управлять размещением).
    Идентификатор приложения Facebook — это первая часть идентификатора размещения (Placement ID).

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 или персонализации рекламы.

Сырые данные по пользователям, привлеченным до 29 октября 2021 года, будут по-прежнему доступны. О данных атрибуции уровня пользователя, полученных с 29 октября 2021 года по 3 ноября 2021 года, читайте в этом бюллетене.

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

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

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

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

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

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

Данные в реферере зашифрованы 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.
    Примечание: При первой синхронизации данных после интеграции, данные о затратах Facebook поступают в AppsFlyer в течение 3 дней. При последующих синхронизациях AppsFlyer получает данные за последние 3 дней.

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

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

 Примечания.

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

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

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

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

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

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

FB-in-app-events-setup-full-screen-en_us.png

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

  1. Активируйте Внутренние события приложения.
    Когда сопоставление внутренних событий приложения с событиями Facebook выполняется в первый раз, все события af_XXX из SDK автоматически сопоставляются со списком предопределенных событий Facebook. При таком автоматическом сопоставлении экономится время и существенно сокращается количество ошибок.
  2. Введите следующие параметры:
    Имя параметра Описание
    SDK Event Name (Имя события в SDK)

    Имя события, полученное AppsFlyer из SDK, интегрированного в приложение, или из межсерверного события.
    Совет. Не нашли в списке нужное событие? Убедитесь, что событие активировано на устройстве с неорганической установкой, и повторите поиск. Вы также можете ввести название события, нажать Добавить другое и выполнить обычное сопоставление. Подробнее о сопоставлении настраиваемых событий.

    Partner Event Identifier (Идентификатор события партнера) Выберите предопределенное событие Facebook, которое больше всего соответствует вашему событию. Кроме того, в Facebook можно отправлять НАСТРАИВАЕМЫЕ события.
    Sending option (Вариант отправки)

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

    • Только от этого партнера для событий, поступающих только от пользователей, атрибутированных Facebook Ads.
    • Все источники, включая органические, чтобы предоставлять в Facebook Ads отчеты о событиях всех пользователей, которые есть в вашей базе.
    Send 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. Нажмите Сохранить доходы от рекламы.

 Примечание

Если вы используете MoPub для медиации Facebook, и при этом у вас есть интеграция с MoPub SDK и прямая интеграция с Facebook, AppsFlyer отфильтровывает данные о доходах от рекламы в Facebook из Mopub и использует данные из Facebook.

Разрешения

Разрешите 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 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. 

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