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 发送事件，您可以基于订阅事件（如续订）创建相似受众。要配置此集成，请在 Adapty 看板中导航至 Integrations > Facebook Ads 并填写所需凭据。

1. 要查找 App ID，请在 App Store Connect 中打开您的应用页面，进入 General 部分的 App Information 页面，在屏幕左下角找到 Apple ID。
2. 您需要在 Meta for Developers 平台上拥有一个应用。登录您的应用后，进入高级设置，即可在页面顶部找到 App ID。

3. 在 Meta SDK 配置中禁用客户端跟踪，以防止 Meta Ads Manager 中的收入重复计算。你可以在 Meta 开发者控制台的 App Settings > Advanced Settings 中找到此设置。将 Log in-app events automatically 设置为”No”。这样可以确保收入事件仅通过 Adapty 的集成进行跟踪。

要跟踪安装和使用事件，您需要在代码中激活 Meta SDK。具体实现方法请参阅各平台的 Meta SDK 文档：

• iOS SDK
• Android SDK
• Unity SDK

此集成同样适用于 Android 应用。如果您已在 App Settings 中配置好 Android SDK，只需填写 Facebook App ID 即可。

配置事件和标签

请注意，Facebook Ads 集成专为使用 Meta 投放广告并基于用户行为进行优化的企业而设计。它支持 Meta 的标准事件以实现优化目的。因此，Meta Ads 集成不支持修改事件名称。Adapty 会自动将您的用户事件映射到相应的 Meta 事件，以便进行精准分析。

StartTrial、Subscribe、CancelSubscription 是标准事件。

要启用特定事件，只需打开相应的开关即可。如果选择了多个事件名称，Adapty 会将所有选中事件的数据合并到同一个 Adapty 事件名称下。

将您的应用与 Facebook Ads 连接

如果您按照上述步骤操作，Facebook 将自动从 Adapty 接收订阅数据。

在 iOS 14.5 对 IDFA 进行修改后，我们建议您向 Facebook 请求用户的 facebookAnonymousId。这样，即使用户的 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 通过 Graph API 向 Facebook Ads（Meta）发送事件。每个事件的结构如下：

{
  "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"
}

Where:

custom_events 参数是一个经过 JSON 编码的对象数组，包含以下内容：

故障排查

access_level_updated 在事件流中显示为失败

access_level_updated 是一个仅限 Webhook 的事件。Adapty 不会将其发送到此集成。但 Adapty 会为每个已启用的集成记录结果，不支持的事件将显示为失败。