Краткий обзор. Интеграция Facebook Ads с AppsFlyer.
Руководство по настройке рекламы в Facebook
Сколько нужно времени, чтобы с помощью AppsFlyer настроить атрибуцию для рекламы своего мобильного приложения в Facebook?
Если вы уже интегрировали SDK AppsFlyer в свое приложение и зарегистрировали приложение на Facebook, то это займет меньше минуты!
Для атрибуции мобильного приложения не нужно использовать функцию Facebook Login или интегрировать в свое приложение SDK Facebook. Просто выполните базовую настройку, описанную в этом пошаговом руководстве. После чего переходите к дополнительным опциям настройки для Facebook.
Материалы по теме
Чтобы получить полное представление о работе с Facebook Ads в AppsFlyer, ознакомьтесь со следующими статьями:
- Настройка интеграции с Facebook Ads (эта статья)
- Сопоставление с внутренними событиями Facebook Ads
- Взаимодействие Facebook и SKAN
- Вопросы и ответы по Facebook Ads (общие сведения / затраты / SDK / атрибуция)
- Расхождения в данных с Facebook Ads
- Настройка партнеров Facebook по маркетингу (Bidalgo / Kenshoo / Adquant / Webpals)
- Настройка Instagram
- Реклама Facebook Canvas
- Атрибуция установок приложения немобильной рекламе
Идентификатор приложения в Facebook
Чтобы интегрировать Facebook Ads и AppsFlyer, сначала создайте идентификатор приложения Facebook, затем получите его.
Чтобы создать идентификатор приложения Facebook:
- В Facebook перейдите на дэшборд приложений.
- В разделе Apps (Приложения) выберите Create New App (Создать новое приложение).
- Введите название своего приложения и задайте уникальное пространство имен. Убедитесь, что платформа приложения указана верно, иначе возможна некорректная атрибуция установок.
Чтобы восстановить идентификатор приложения Facebook:
- В Facebook перейдите на дэшборд приложений.
- Нажмите необходимое приложение.
-
Чтобы скопировать идентификатор приложения, нажмите на него в верхнем левом углу экрана.
AppsFlyer атрибутирует данные на основе App ID. Один и тот же ID приложения Facebook можно использовать для ваших приложений для Android и для iOS. Обратите внимание, что начиная с iOS 14, Facebook Ads ограничивает количество рекламных аккаунтов девятью на приложение.
Основные настройки атрибуции в Facebook
Чтобы начать атрибуцию для кампаний в Facebook с помощью AppsFlyer, выполните следующие действия:
-
Чтобы активировать интеграцию с Facebook Ads:
- Откройте список своих приложений на платформе Facebook for Developers.
- Выберите нужное приложение.
- Чтобы скопировать ID приложения, кликните на него в верхней части экрана.
- В AppsFlyer перейдите к маркетплейсу: в верхнем меню любой страницы AppsFlyer нажмите Маркетплейс.
- Найдите и выберите Meta Ads.
- Нажмите Настроить интеграцию. Вы будете перенаправлены на страницу настройки интеграции.
- На вкладке Интеграция включите переключатель Активировать партнера.
Примечание. Этот переключатель должен быть активирован все время, пока вы работаете с этим партнером.Подробнее об активации партнеров.
- Вставьте идентификатор приложения в поле Facebook App ID (Идентификатор приложения Facebook).
- Нажмите кнопку Save Integration (Сохранить интеграцию).
- [дополнительно] Настройте рекомендуемые параметры:
- Установите окно атрибуции по кликам в 7 дней, как у Facebook Ads.
(Обратите внимание, что есть некоторые конкретные случаи, когда значение по умолчанию отличается). - Установите окно атрибуции по просмотрам в 1 день, как у Facebook.
- Чтобы учесть пользователей, которые повторно установили ваше приложение в рамках окна реатрибуции, установите переключатель Атрибуция повторных установок в положение «Включено».
Вам необязательно включать атрибуцию по просмотрам или настраивать окна атрибуции для атрибуции повторных установок, так как эти значения подставляются из настроек атрибуции установок. - Чтобы сохранить настройки, нажмите Save Integration (Сохранить интеграцию).
- Установите окно атрибуции по кликам в 7 дней, как у Facebook Ads.
Результаты из Facebook все еще не видны в AppsFlyer? См. раздел Интеграция Facebook Ads — устранение неполадок.
Расширенные настройки атрибуции в Facebook
После выполнения основных настроек для атрибуции в Facebook можно быстро выполнить некоторые дополнительные настройки атрибуции.
Данные уровня пользователя
С 29 октября 2021 года рекламодателям доступна только агрегированная отчетность. Это значит, что данные атрибуции по просмотрам и кликам отображаются в отчетах с сырыми данными как «restricted» (ограничено). Другие поля, связанные с медиа-источником, не заполняются. См. статью Ограничение содержимого сырых данных.
Это изменение касается всех рекламодателей, операционных систем и MMP. Оно относится к данным уровня устройства по всем пользователям iOS и Android, независимо от статуса согласия на ATT или персонализации рекламы.
AppsFlyer продолжит получать из Facebook данные уровня устройства. Это значит, что наши возможности атрибуции и отчетности (включая мультиканальную атрибуцию, LTV, ROI, когортные отчеты, отчеты об удержании пользователей, защиту от фрода, Аудитории и другие сервисы) не изменятся. См. Инструменты для агрегированных и аналитических отчетов.
Как получить данные уровня пользователя по установкам на устройствах Android?
Хотя данные уровня пользователя ограничены, Facebook Ads предоставляет рекламодателям метаданные кампаний по рекламе приложений для Android, ведущей в магазин Google Play. В этом случае поля атрибуции доступны рекламодателям в Google Install Referrer, который должен быть интегрирован в ваше приложение. Поля, предоставленные через реферер, поступают в отчеты AppsFlyer с сырыми данными, доступные вам сразу после отправки ключа расшифровки и атрибуции установки Facebook Ads. Благодаря этому AppsFlyer может атрибутировать пользователей, у которых нет рекламного идентификатора (с включенным LAT). Обратите внимание, что Google Play Install Referrerer не применяется к кампаниям ретаргетинга.
Поля атрибуции по кампании, доступные через реферер:
- ID рекламы.
- Имя рекламы
- ID блока рекламы
- Название блока рекламы
- ID кампании
- Название кампании
- ID аккаунта
- Канал
Примечание
- Для корректной передачи данных реферера необходимо использовать SDK AppsFlyer версии 5.4.0 и выше. Данные реферера не скрыты и имеют приоритет над данным, предоставленными через API. Это решение применимо к атрибуции по кликам и не применимо к атрибуции по просмотрам.
- Поле Channel (Канал) определяется значением канала, полученным от Facebook через реферер Google Play. Если получена пустая строка, в поле канала Channel отображается «None» (Нет)..
Зашифрованные данные от реферера
Данные в реферере зашифрованы Facebook. Чтобы их расшифровать, требуется ключ, доступный вам в аккаунте разработчика Facebook. Вы должны предоставить нам ключ расшифровки, указанный в строке требуемых действий. Его нужно предоставить один раз по каждому приложению.
Обратите внимание, что если ключ не предоставлен или был удален, могут возникнуть случаи, когда Реклама в Facebook по-прежнему атрибутируется установке на основе реферера, даже без полей атрибуции по кампании (упомянутых в списке выше). Это происходит, когда:
- Реклама в Facebook не приписала себе установку.
- Реферер установки Facebook был получен, но не расшифрован.
- И это был последний клик.
Чтобы получить ключ расшифровки из Facebook:
- Войдите в свой аккаунт на портале Facebook для разработчиков.
- Перейдите в My Apps (Мои приложения) в правом верхнем углу.
- Выберите приложение, для которого требуется получить ключ расшифровки.
-
Перейдите в Settings (Настройки) > Basic (Основные) в левой части страницы.
- Прокрутите страницу до раздела Android. В нем под полем Package Names (Имена пакетов) вы увидите ключ расшифровки для Install Referrer. Примечание. Это тот же раздел, в котором вы настраивали имена пакетов и Google Play.
Чтобы задать ключ расшифровки в AppsFlyer:
- [обязательно] Убедитесь, что в приложении установлен SDK AppsFlyer версии 5.4+. Не используйте более ранние версии.
- В AppsFlyer перейдите в раздел Configuration (Настройки) > Integrated Partners (Интегрированные партнеры).
-
Выберите Facebook.
- На вкладке Integration (Интеграция) вставьте ключ в поле Install Referrer Decryption Key (Ключ расшифровки для Install Referrer). Это нужно сделать один раз по каждому приложению.
- Нажмите Сохранить интеграцию.
Затраты, клики и показы

Эта интеграция предоставляет агрегированные данные о затратах, кликах и показах для ваших кампаний, наборов объявлений, объявлений и гео/стран. Подробную информацию о поддерживаемых параметрах, метриках и функциях см. в таблице интеграции затрат рекламной сети.
Примечание. Данные о кликах и показах включены в интеграцию. Но для получения сведений о затратах требуется подписка Xpend.
Чтобы включить API данных о затратах:
- Выполните вход в аккаунт Facebook и убедитесь, что в нем активирована возможность проводить рекламные кампании в Facebook. При регистрации в Facebook пользователь должен получить разрешения на проведение всех кампаний на платформе Business Manager.
- Перейдите на вкладку Затраты.
- Установите переключатель Get Cost, Clicks and Impressions Data (Получать данные о затратах, кликах и показах) в положение «Включено».
- Нажмите кнопку Вход в Facebook.
- При появлении запроса разрешите AppsFlyer доступ к данным вашей кампании на Facebook.
Примечание. При первой синхронизации данных после интеграции, а также при последующих синхронизациях, в AppsFlyer поступают данные о затратах Facebook за последние 7 дней.
Читайте, как Facebook определяет клики и просмотры.
Чтобы удалить связанный аккаунт Facebook: в столбце действий наведите курсор на аккаунт и нажмите Delete connection (Удалить связанный аккаунт).
Примечания.
- Если вы уже вошли в Facebook, то при нажатии кнопки Facebook Login (Вход в Facebook) окно Facebook откроется и сразу закроется. Это обычная ситуация.
- Если у вас есть несколько пользователей с разрешениями для Facebook, рекомендуется выполнить вход в Facebook для всех этих пользователей, чтобы получать полные, а не частичные данные.
Состояние синхронизации данных о расходах
Просмотрите статус вашего API данных о затратах и последний раз, когда AppsFlyer получил соответствующие данные о затратах, либо на дэшборде статуса интеграции затрат (и доходов от рекламы), либо на дэшборде отдельной рекламной сети.
В Facebook можно синхронизировать несколько аккаунтов для извлечения данных о расходах. Для каждого синхронизированного аккаунта AppsFlyer показывает состояние интеграции данных о расходах и время последнего извлечения соответствующих данных о расходах.
Узнайте больше о дополнении информации, получаемой из Facebook, данными о затратах, кликах и показах.
Сопоставление внутренних событий приложения

Для сопоставления внутренних событий приложения:
- Активируйте постбэки о внутренних событиях приложений.
Когда сопоставление внутренних событий приложения с событиями Facebook выполняется в первый раз, событие af_app_open автоматически сопоставляется с session_start. - Введите следующие параметры:
Имя параметра Описание 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 (Значения без дохода): отправляет все параметры, кроме значения дохода.
- Чтобы добавить в список событие SDK или межсерверное событие, нажмите Add Event (Добавить событие).
Ограничения в названиях событий:
- Длина названия события: 2-40 символов
- Недопустимые символы:
- Двоеточие (:)
- Точка (.)
- Нелатинские (неанглийские) символы: по состоянию на 12 января 2020 Facebook не принимает китайские символы. AppsFlyer не проверял другие алфавиты, поэтому их стоит использовать только после верификации, поддерживает ли Facebook эти символы в постбэках.
- Названия событий чувствительны к регистру. Чтобы избежать расхождений, убедитесь, что вы используете правильный регистр в названиях событий для всех медиа-источников и версий приложений.
Узнайте больше о Сопоставлении внутренних событий приложения с событиями Facebook Ads.
Атрибуция ретаргетинга
Атрибуция ретаргетинга в Facebook средствами AppsFlyer позволяет рекламодателям атрибутировать вовлечение имеющегося пользователя с помощью рекламы на Facebook, а также оценивать качество этого пользователя и его вовлечение после установки на основании отчетов AppsFlyer.
Такую атрибуцию можно использовать, только если у вас есть активные кампании, направленные на ваших собственных пользователей в Facebook.
- Включите ретаргетинг на странице настроек приложения.
- На странице партнера Facebook Ads включите Re-engagement attribution (Атрибуция повторного вовлечения).
- Установите окно атрибуции повторного вовлечения по кликам.
Окно атрибуции повторного вовлечения — это временной интервал начиная от клика по рекламе, в течение которого приложение должно быть запущено, чтобы клик был засчитан как повторное вовлечение.
Выберите окно атрибуции в часах или днях и установите бегунок на нужное значение. - Установите окно повторного вовлечения.
Это временной интервал, в течение которого внутренние события приложения данного пользователя будут атрибутироваться медиаисточнику ретаргетинга как основному источнику.
Это значение можно задавать в днях (от 1 до 90), часах (до 23) или даже на весь период использования приложения. Значение по умолчанию 30 дней.
Узнайте больше об атрибуции ретаргетинга в AppsFlyer.
Узнайте больше о том, как работает диплинкинг для пользователей из сетей с самостоятельной атрибуцией (SRN), таких как Facebook.
Соблюдение закона о защите персональных данных граждан штата Калифорния (California Consumer Privacy Act, CCPA)
Закон CCPA ограничивает использование данных, которые поступают от пользователей Facebook, находящихся в штате Калифорния (США).
Для соблюдения требований закона CCPA установите флажок Ограничить использование персональных данных пользователей в Facebook (CCPA) на вкладке Интеграция.
Узнать больше о законах по защите данных.
Регистрация доходов от рекламы
Если в вашем приложении для монетизации рекламы используется функция Facebook Audience Network Ad Revenue (Выручка от сетевой рекламы для аудитории Facebook), вы можете регистрировать в AppsFlyer свои доходы от рекламы в Facebook. С помощью этой функции (вместе с данными о выручке от покупок в приложении или без них) можно получить полное представление о выручке, полученной от ваших пользователей.
Чтобы начать регистрацию доходов от сетевой рекламы для аудитории Facebook, выполните следующие действия:
- На вкладке Ad Revenue (Доход от рекламы) включите Get Ad Revenue Data (Получать данные о доходах от рекламы).
- Выберите тип агрегированных данных о доходах от рекламы, которые вы хотите получать: Attributed revenue (Атрибутированный доход) и/или Aggregated monetization revenue (Агрегированные данные о доходе от монетизации):
-
Атрибутированный доход: доход по источнику привлечения пользователей.
В списке Event Source (Источник событий) выберите событие, наиболее соответствующее вашей модели получения дохода от рекламы. Например, если источником дохода являются показы, рекомендуется отправлять в AppsFlyer событие ad_viewed. Для каждой платформы монетизации можно отдельно выбрать наиболее подходящее событие. Однако можно использовать и событиеaf_app_opened
. В этом случае доход от рекламы атрибутируется по каждому открытию приложения пользователем. - Агрегированные данные о доходе от монетизации: доход по источникам рекламы.
-
Атрибутированный доход: доход по источнику привлечения пользователей.
- На вкладке есть поле Ad Revenue Event (Событие дохода от рекламы). В этом поле только для чтения отображается новое событие дохода от рекламы с именем [событие]_monetized (например, на скриншоте выше это имя Ad_Watched_Monetized). На дэшборде это событие дохода от рекламы отображается как дополнительное.
- Нажмите Connect to Facebook (Подключить к Facebook), чтобы начать сбор данных о доходе от сетевой рекламы для аудитории Facebook. Чтобы разрешить использование этой функции, выполните вход с помощью своих учетных данных Facebook.
- Введите Идентификатор приложения Audience Network (Идентификатор приложения Facebook). Его можно узнать на сайте Facebook Audience Network (FAN).
- Получите идентификатор приложения Facebook.
- Скопируйте идентификатор и вставьте его в поле Audience Network App ID в AppsFlyer.
- Нажмите Сохранить доходы от рекламы.
Разрешения
Разрешите 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 Ads.
Обратите внимание, что проверить идентификатор вашего приложения в Facebook можно также с помощью Facebook Graph API.
Состояние приложения в Facebook
Чтобы атрибуция работала, пользователь должен зарегистрировать свое приложение в Facebook как Live (Действующее) , а не как In development (В разработке).
Неправильный тип кампании в Facebook
Реклама в Facebook с целью установки приложений
При правильной настройке атрибуция будет работать.
При неправильной настройке атрибуция работать не будет.
Обновления 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.