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 不可用，集成也能继续正常运行。请参阅 set user attributes guide iOS、Android、React Native、Flutter 和 Unity 指南来设置此参数。

import FacebookCore

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

import { adapty } from 'react-native-adapty';
import { AppEventsLogger } from 'react-native-fbsdk-next';

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

其中：

custom_events 参数是一个 JSON 编码的对象数组，包含以下字段：