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

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

设置集成

将 Adapty 连接到 Asapty

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

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

配置事件和标签

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

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

将您的应用连接到 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

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

access_level_updated 在事件动态中显示为失败

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