使用 Asapty 集成，您可以优化搜索广告活动。Adapty 将订阅事件发送至 Asapty，让您可以基于 Apple Search Ads 归因在那里构建自定义看板。

此特定集成不会向 Adapty 添加任何归因数据，因为我们已直接从 ASA 获取了所需的全部数据。

设置集成

将 Adapty 连接到 Asapty

要集成 Asapty，请在 Adapty 看板中导航至 Integrations > Asapty，并填写 Asapty ID 字段值。

Asapty ID 可在您的 Asapty 账户的 Settings > General 部分找到。

配置事件和标签

在凭据下方，有三组事件可从 Adapty 发送到 Asapty。只需开启您需要的事件即可。查看 Adapty 提供的完整事件列表，请点击此处。

我们建议使用 Asapty 提供的默认事件名称。但您也可以根据需要更改事件名称。

将您的应用连接到 Asapty

完成上述步骤后，Adapty 会自动从 Asapty 接收归因数据。无需在应用代码中显式请求归因数据。为提高归因数据准确性，请配置 Asapty 在每个事件数据中共享 customerUserId。

Asapty 事件结构

Adapty 通过 GET 请求使用查询参数将事件发送到 Asapty。每个事件 URL 格式如下：

https://asapty.com/_api/mmpEvents/?source=adapty&asaptyid=a1b2c3d4&keywordid=12345&adgroupid=67890&campaignid=11223&conversiondate=1709294400000&event_name=subscription_renewed&install_time=1709100000&app_name=MyApp&json=%7B%22af_revenue%22%3A%229.99%22%2C%22af_currency%22%3A%22USD%22...%7D

查询参数：

参数	类型	描述
source	String	始终为 “adapty”。
asaptyid	String	您凭据中的 Asapty ID。
keywordid	String	Apple Search Ads 关键词 ID（如可用）。
adgroupid	String	Apple Search Ads 广告组 ID（如可用）。
campaignid	String	Apple Search Ads 广告活动 ID（如可用）。
conversiondate	Long	事件时间戳，单位为毫秒。
event_name	String	事件名称（从 Adapty 事件映射而来）。
install_time	Long	安装时间戳，单位为秒。
app_name	String	Adapty 中的应用名称（如可用）。
json	String	URL 编码的 JSON 字符串，包含事件详情（见下文）。

json 参数是一个 URL 编码的 JSON 字符串，包含以下字段：

参数	类型	描述
af_revenue	String	收入金额（字符串形式）。
af_currency	String	货币代码（例如 “USD”）。
transaction_id	String	商店交易 ID。
original_transaction_id	String	原始商店交易 ID。
purchase_date	Long	购买时间戳，单位为毫秒。
original_purchase_date	Long	原始购买时间戳，单位为毫秒。
environment	String	Production 或 Sandbox。
vendor_product_id	String	商店中的产品 ID。
profile_country	String	基于用户 IP 的国家代码。
store_country	String	商店用户的国家代码。

故障排除

• 请确保您已在 Adapty 中配置 Apple Search Ads 并上传凭据，否则 Asapty 将无法正常工作。
• 只有具有详细非自然量 ASA 归因的用户画像才会将其事件传递至 Asapty。如果归因数据不足，您将看到”The user profile is missing the required integration data.”。
• 在配置集成之前创建的用户画像将无法将其事件传递至 Asapty。
• 如果尽管设置正确但与 Adapty 的集成仍无法正常工作，请确保在 App Settings -> Apple Search Ads 标签页中启用了 Receive Apple Search Ads attribution in Adapty 开关。