应用事件专用转化 API

广告主可以使用转化 API 通过单个端点（而非多个来源）向 Meta 发送网站、应用和实体店这三类事件以及业务消息事件。应用事件与转化 API 的合并将简化广告主的技术堆栈，并将在 Meta 事件管理工具中通过使用数据集打造出一个更全面的视图。

本文档针对将应用事件集成到转化 API 提供了指导。

前提条件

1. 数据集

通过转化 API 发送的应用事件必须与某个数据集关联。

您可以向 https://graph.facebook.com/v16.0/{ads-pixel-id}/is_consolidated_container 发出 GET 调用，以检测广告主的数据集是否经过整合，并因此符合通过转化 API 传递应用事件的条件。

2. 权限

• 如要以广告主的身份实现直接集成，请按照此处说明操作，了解各项前提条件和权限。

• 如要在合作伙伴平台实现集成，请按照此处说明操作，了解各项前提条件和权限。

配置

将应用事件发送到转化 API

a. 将数据集编号与应用编号绑定

在事件管理工具中，可使用两种方法绑定您的应用与数据集：

• 选择“数据源”选项卡，找到应用的“设置”选项卡并执行绑定。
• 在应用的“概览”选项卡中，选择“数据源”选项卡，然后使用“所有活动”部分中的“绑定数据集”按钮。

完成绑定后，数据集中将包含已绑定的应用。

b. 必填字段

您可以参阅此处，了解当前可通过转化 API 发送的一组参数。如要发送应用事件，可在负载中分享以下 server_event 字段：

• 对于应用事件，参数 action_source 中必须包含值 app。
• 如要设置去重，event_id 是必填项。
• app_data 字段
• user_data 字段
• custom_data 字段

应用数据字段

客户信息参数

自定义数据

总之，使用转化 API 分享的应用事件将需要以下数据参数：

• action_source：必须设为“应用”。（使用转化 API，即表示您同意：据您所知，action_source 参数准确无误）
• event_id：在设置去重情况下是必填项，详情请参阅“设置多渠道去重”部分。
• advertiser_tracking_enabled
• application_tracking_enabled
• extinfo

以下是 extinfo 的示例。确保已填写以下所有子参数并按顺序对其进行排列。如有内容缺失，需使用空字符串作为占位符。

c. 设置多渠道去重

需要使用去重机制来删除转化 API 集成与应用事件的所有其他现有集成（包括 SDK、MMP 和应用事件 API）之间的重复事件流量。

对应用事件，我们会应用现用于网站事件的去重功能。该功能会利用字段 event_id 和 event_name 实现去重（具有同一 event_id 的转化 API 和 SDK/应用事件 API 事件）。event_id 参数是唯一可区分相似事件的标识符。如果事件编号不准确，这可能会导致系统错误地对您的转化事件进行去重处理，进而影响转化报告和广告系列表现。

您可以参阅以下开发者文档来实现去重设置：

• 如何设置应用事件
• 去重设置示例

以下示例展示了如何记录自定义事件。如要记录此类事件，在 iOS SDK 中，请以 AppEvents.Name 的形式传递事件名称：

AppEvents.shared.logEvent(.achievedLevel, parameters: [AppEvents.ParameterName(rawValue: "event_id"): "123"])

对于应用安装事件，已建立一个去重机制，来确保在过去 90 天的期限内仅为一个安装事件执行归因操作。我们会保留第一个事件，而弃用后续事件，无论后续事件来自哪个操作来源都是如此。对与安装事件相关的应用事件而言，不要求进行去重处理。

d. 发送事件

如要发送新事件，请通过以下路径向转化 API 发出 POST 请求：https://graph.facebook.com/{API_VERSION}/{DATASET_ID}/events?access_token={TOKEN}。向此连线发出该请求时，Meta 会新建应用服务器事件。详情请参阅此处的开发者文档。

下图简要介绍了各参数如何融入有效负载的整体架构中：

{
    "data": [
        {
            "event_name": "Purchase",
            "event_time": 1684389752,
            "action_source": "app",
            "user_data": {
                "em": [
                    "30a79640dfd8293d4f4965ec11821f640ca77979ca0a6b365f06372f81a3f602"
                ],
                "ph": [
                    "74234e98afe7498fb5daf1f36ac2d78acc339464f950703b8c019892f982b90b",
                    "74234e98afe7498fb5daf1f36ac2d78acc339464f950703b8c019892f982b90b"
                ],
                "madid": "bbbbbbbbbbbb",
      "anon_id": "cccccccc"
            },
            "custom_data": {
                "currency": "USD",
                "value": "142.52"
            },
            "app_data": {
                "advertiser_tracking_enabled": "True",
                "application_tracking_enabled": "True",
                "campaign_ids": "aaaaaaaaa",
                "extinfo": [
                    "a2",
                    "com.some.app",
                    "771",
                    "Version 7.7.1",
                    "10.1.1",
                    "OnePlus6",
                    "en_US",
                    "GMT-1",
                    "TMobile",
                    "1920",
                    "1080",
                    "2.00",
                    "2",
                    "128",
                    "8",
                    "USA/New York"
                ]
            }
        }
    ]
}

疑难解决

您可以使用有效负载设置助手工具来生成有效负载数据：

• 在适用情况下，选择 app 操作来源
• 为将发送到 Meta 的事件填写相关信息
• 这将生成事件有效负载，该有效负载可用作用于与转化 API 集成的模板

使用事件管理工具中的“测试事件”工具进行测试。

另请参阅

• 转化 API 概览
• 使用转化 API
• 转化 API 参数
• 最佳实践