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 即可。

配置事件和标签

Adapty 将其购买事件映射到 Meta 的标准事件，Meta 可基于这些事件优化广告系列：StartTrial、Subscribe 和 fb_mobile_purchase（Meta 的购买事件）。Subscription started、Subscription renewed、Trial started 和 Trial converted 会为事件字段中选择的每个名称各发送一个 Meta 事件，且默认情况下所有名称均已选中。例如，一次试用开始会向 Meta 发送三个事件。如需减少发送数量，请从字段中移除相应名称。

Meta 没有针对其余事件的标准事件，因此 Adapty 以自定义事件的形式发送这些事件，并使用其 Adapty 名称。如需匹配您自己的命名，请在事件字段中修改名称。

Trial still active 和 Subscription still active 是合成事件：Adapty 会在计时器触发时向 Meta 发送这些事件，且仅在试用或订阅在计时器到期时仍处于有效状态的情况下才会发送。这些事件不包含收入数据，因此 Meta 不会将其计入购买价值。两者默认均为关闭状态。如需发送，请开启相应选项并设置延迟时间。

将您的应用与 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 编码的数组，每个对象对应 Adapty 事件所映射的一个 Meta 事件。只有 StartTrial、Subscribe 和 fb_mobile_purchase 包含 fb_content_id、fb_content_type、fb_num_items 和 fb_transaction_id。每个对象包含：

故障排查

access_level_updated 在事件流中显示为失败

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