Интеграция Meta Ads с Adapty Attribution

Интеграция Adapty Attribution с Meta позволяет отслеживать и оптимизировать эффективность кампаний в Facebook, Instagram, Messenger и Audience Network.

Шаг 1. Подключите аккаунт Facebook

Чтобы подключить Meta Ads к атрибуции Adapty, перейдите в Integrations > Meta в левом сайдбаре. Доступны два варианта:

• Continue with Facebook: подключение через OAuth. Используйте этот вариант, если вы входите в Meta Ads Manager через личный или рабочий аккаунт Facebook.
• Add system token: подключение через постоянный токен системного пользователя. Используйте этот вариант, если ваша организация управляет рекламными аккаунтами через системного пользователя Meta Business.

Important

Убедитесь, что ваш аккаунт Facebook имеет доступ к нужным кампаниям и пикселям.

1. Нажмите Continue with Facebook.

2. Войдите с помощью аккаунта Facebook и нажмите Continue.

3. Проверьте запрошенные разрешения и нажмите Save.

Создайте токен доступа системного пользователя в настройках Meta Business, затем добавьте его в Adapty Attribution.

Important

Перед началом убедитесь, что в вашем портфолио Meta Business есть системный пользователь, которому уже назначены рекламные аккаунты для отслеживания. Также необходимо добавить приложение в портфолио — вы выбираете это приложение при генерации токена.

В настройках Meta Business сгенерируйте токен:

1. Откройте Business Settings.
2. В разделе Users выберите System users.
3. Выберите системного пользователя и нажмите Generate new token.
4. Выберите ваше приложение из выпадающего списка.
5. В списке разрешений включите ads_read. Это единственное разрешение, необходимое Adapty Attribution для чтения данных о кампаниях и рекламе.
6. Нажмите Generate token.
7. Скопируйте токен и сохраните его в надёжном месте. Meta показывает его только один раз.

Note

Настройка Token expiration определяет, как долго остаётся активным соединение. Токен с датой истечения нужно пересоздавать и переподключать до того, как он истечёт, иначе атрибуция прекратится. Токен без срока действия избавляет от этой проблемы, но является долгоживущей учётной записью. Храните его в надёжном месте и отзывайте, если он окажется скомпрометирован.

В Adapty Attribution добавьте токен:

1. Нажмите Add system token.

2. Вставьте токен и нажмите Connect.

После этого все ваши рекламные аккаунты будут добавлены в Adapty Attribution. Можно переходить к добавлению кампаний.

Шаг 2. Добавьте кампании

Чтобы добавить кампанию Meta в Adapty Attribution и отслеживать эффективность рекламы Meta в Adapty:

1. Перейдите на вкладку Web Campaigns и нажмите Create configuration.

2. На вкладке General раскройте секцию iOS и/или Android и вставьте URL-адреса приложений из App Store и/или Google Play.

3. Скопируйте значение поля Click link. Затем в Meta Ads Manager откройте своё объявление и вставьте эту ссылку. Это позволит Adapty связать установки и покупки с рекламой в Meta.

4. Чтобы отправлять события конверсии обратно в Meta, можно также связать пиксели Meta с кампаниями в Adapty Attribution. Для этого выберите один из существующих пикселей в выпадающем списке Pixel. После выбора пикселя можно нажать Send test event, чтобы проверить соединение.

Если вы привлекаете пользователей через веб-воронку, на вкладке General также есть раздел Web funnel со сниппетом пикселя и параметрами URL объявления. Чтобы настроить его, см. Настройка веб-пикселя Adapty.

Шаг 3. Настройте события

Чтобы отправлять конверсионные события обратно в Meta для оптимизации кампаний, необходимо настроить сопоставление событий в разделе Events names. Это позволяет Adapty автоматически отправлять события подписок в ваш пиксель Meta, когда пользователи совершают действия в приложении.

В разделе Events names включите события, которые хотите отслеживать в Meta Ads Manager. Для каждого включённого события выберите соответствующее событие Meta из выпадающего списка или задайте собственное. По умолчанию Adapty сопоставляет события Adapty со стандартными событиями Meta.

Нажмите Save, чтобы применить настройки сопоставления событий.

Дополнительная настройка

Дополнительные параметры

Поле Additional parameter позволяет добавлять пользовательские данные для анализа за пределами Adapty. Это удобно, когда нужно передать конкретные данные о кампании или пользователе во внешние инструменты аналитики или партнёрам по атрибуции.

В поле Additional parameter введите любые пользовательские данные, которые хотите включить в отслеживание атрибуции. Дополнительный параметр будет включён во все данные атрибуции, отправляемые в Meta, и может использоваться для расширенного анализа и оптимизации кампаний. Например, если вы запускаете несколько вариантов одной кампании, можно добавить variant=A или variant=B, чтобы различать разные креативные подходы.

Настройки

Вкладка Settings управляет тем, как Adapty сопоставляет действия пользователей с вашими кампаниями в Meta Ads. Эти настройки определяют временные окна для детерминированного и вероятностного сопоставления атрибуции.

Чтобы настроить их, перейдите на вкладку Settings в конфигурации кампании. Здесь вы найдёте две основные настройки:

• Окно детерминированного совпадения: использует точные идентификаторы устройства (например, IDFA на iOS или Advertising ID на Android) для точного сопоставления пользователей с кампаниями. Установите значение 168 часов (7 дней) для максимальной точности атрибуции — это значение по умолчанию и рекомендованное. Когда пользователь нажимает на вашу рекламу в Meta и устанавливает приложение в течение этого времени, Adapty может однозначно атрибутировать установку конкретному клику по объявлению с помощью идентификаторов устройства.
• Probabilistic matching window: Использует статистическое моделирование и цифровой отпечаток устройства для сопоставления пользователей, когда детерминированное сопоставление невозможно. Для большинства кампаний установите значение 6 часов — это значение по умолчанию, которое хорошо работает в большинстве случаев. Для кампаний с высоким объёмом кликов можно сократить его до 1–2 часов. Для пользователей, которых не удаётся сопоставить детерминированно (из-за настроек конфиденциальности или других факторов), Adapty использует вероятностное сопоставление в рамках этого более короткого окна.

Нажмите Save, чтобы применить настройки.

Переопределение дохода

Если вы отслеживаете события триала и хотите, чтобы Meta приписывала к ним доход, используйте раздел Revenue override. Он появляется, когда включено событие Trial started. Переопределение применяется только к Trial started — события Trial converted и Subscription started всегда передают фактический доход.

Для каждого целевого события триала укажите процент от стоимости подписки, который нужно передавать как доход. Например, при значении 30% Adapty будет отправлять 30% от цены подписки в качестве ценности конверсии для событий триала.

Чтобы добавить переопределение:

1. Включите Trial started в разделе Events names.
2. В разделе Revenue override нажмите Add override.
3. Выберите целевое событие и укажите процент дохода (0–100).
4. Нажмите Save.

Квалифицированный триал

Триал считается квалифицированным, если пользователь не отменил его в течение заданного количества часов. Используйте раздел Qualified trial, чтобы откладывать отправку событий триала до их квалификации — так Meta получает только те триалы, которые пользователи сохранили.

Для каждого целевого события триала укажите количество часов ожидания. Adapty отсчитывает часы с момента начала триала и отправляет событие по истечении этого срока. Если пользователь отключает автопродление до истечения срока — событие не отправляется. Если пользователь снова включает автопродление до истечения срока — событие отправляется в запланенное время.

Чтобы удержать событие триала до его квалификации:

1. Включите Trial started в разделе Events names.
2. В разделе Qualified trial нажмите Add event.
3. Выберите целевое событие и укажите количество часов ожидания — от 1 до 24.
4. Нажмите Save.

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

Отправка всех событий

По умолчанию Adapty отправляет события на ваш пиксель только для пользователей, атрибутированных к кампании Meta. Включите Send all events, чтобы также передавать события от органических и неатрибутированных пользователей на пиксель.

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

Чтобы включить эту опцию, в настройках кампании выберите Send all events (forward organic/non-attributed events to this pixel) и нажмите Save.