Facebook Ads

Интеграция с Facebook Ads позволяет легко отслеживать статистику приложения в Meta Analytics. Adapty отправляет события в Meta Ads Manager, помогая формировать похожие аудитории на основе подписок для повышения отдачи от рекламы. Так вы сможете точно видеть, сколько денег приносит реклама благодаря подпискам.

Интеграция Adapty и Facebook Ads работает следующим образом: Adapty отправляет все события подписок, настроенные в вашей интеграции, в Facebook Ads. Это полезно для оценки эффективности рекламных кампаний.

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

Подключение Adapty к Facebook Ads

Чтобы интегрировать Facebook Ads и анализировать метрики приложения, настройте интеграцию с Meta Analytics. Отправляя события в Meta Ads Manager, вы сможете создавать похожие аудитории на основе событий подписок, например продлений. Для настройки перейдите в раздел Integrations > Facebook Ads в дашборде Adapty и укажите необходимые учётные данные.

1. Чтобы найти App ID, откройте страницу вашего приложения в App Store Connect, перейдите на страницу App Information в разделе General и найдите Apple ID в левом нижнем углу экрана.
2. Вам потребуется приложение на платформе Meta for Developers. Войдите в приложение и откройте расширенные настройки. App ID находится в заголовке страницы.

3. Отключите клиентское отслеживание в настройках Meta SDK, чтобы избежать двойного учёта выручки в Meta Ads Manager. Эту настройку можно найти в Meta Developer Console в разделе App Settings > Advanced Settings. Установите Log in-app events automatically в значение «No». Это гарантирует, что события выручки будут отслеживаться только через интеграцию Adapty.

   Для отслеживания событий установки и использования необходимо активировать Meta SDK в коде. Подробности реализации — в документации Meta SDK для вашей платформы:

   • iOS SDK
   • Android SDK
   • Unity SDK

Эту интеграцию можно использовать и с Android-приложениями. Если вы настроили конфигурацию Android SDK в App Settings, достаточно указать Facebook App ID.

Настройка событий и тегов

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

StartTrial, Subscribe, CancelSubscription — стандартные события.

Чтобы включить нужные события, просто активируйте их переключателем. Если выбрано несколько названий событий, Adapty объединит данные по всем выбранным событиям в одно событие Adapty.

Подключение приложения к Facebook Ads

Если вы выполнили описанные выше шаги, Facebook будет автоматически получать данные о подписках от Adapty.

После изменений в IDFA в iOS 14.5 мы рекомендуем запрашивать у пользователя facebookAnonymousId из Facebook. Тогда, если IDFA пользователя недоступен, интеграция продолжит работать. Следуйте гайду гайд по установке атрибутов пользователя iOS, Android, React Native, Flutter и Unity , чтобы задать этот параметр.

do {
    try await Adapty.setIntegrationIdentifier(
        key: "facebook_anonymous_id", 
        value: AppEvents.shared.anonymousID
    )
} catch {
    // handle the error
}

Adapty.setIntegrationIdentifier(
    "facebook_anonymous_id",
    AppEventsLogger.getAnonymousAppDeviceGUID(context)
) { error ->
    if (error != null) {
        // handle the error
    }
}

try {
  const anonymousId = await AppEventsLogger.getAnonymousID();

  await adapty.setIntegrationIdentifier("facebook_anonymous_id", anonymousId);
} catch (error) {
  // handle `AdaptyError`
}

There is no official SDK for Flutter

anonymousID is not available in the official SDK
https://github.com/facebook/facebook-sdk-for-unity/issues/676

Структура события

Adapty отправляет события в Facebook Ads (Meta) через Graph API. Каждое событие имеет следующую структуру:

{
  "event": "CUSTOM_APP_EVENTS",
  "app_user_id": "user_12345",
  "advertiser_id": "00000000-0000-0000-0000-000000000000",
  "advertiser_tracking_enabled": 1,
  "application_tracking_enabled": 1,
  "custom_events": "[{\"_eventName\":\"Subscribe\",\"_logTime\":1709294400,\"fb_num_items\":1,\"fb_content_type\":\"in_app\",\"fb_content_id\":\"yearly.premium.6999\",\"fb_currency\":\"USD\",\"fb_order_id\":\"GPA.3383...\",\"fb_transaction_id\":\"GPA.3383...\",\"_valueToSum\":9.99}]",
  "extinfo": "[\"i2\",\"com.example.app\",\"1.0.0\",\"100\",\"17.0.1\",\"iPhone14,3\",\"en_US\",\"GMT+3\",\"\",0,0,0,0,0,0,\"GMT+3\"]",
  "anon_id": "facebook_anon_id_123"
}

Где:

Параметр custom_events — это JSON-строка с массивом объектов, содержащих: