通过 SplitMetrics Acquire 集成，你可以清楚地了解 Apple Search Ads 的订阅收益，并可以持续追踪用户数月，掌握广告的长期变现表现。

此外，Adapty 还会将订阅事件发送至 SplitMetrics Acquire，让你基于 Apple Search Ads 归因数据构建自定义看板和自动化流程。 由于 Adapty 已直接从 ASA 获取所需数据，因此不会向 Adapty 写入任何归因数据。

如何配置 SplitMetrics Acquire 集成

要集成 SplitMetrics Acquire，请前往 Integrations > SplitMetrics Acquire 并填写凭证信息。

打开你的 SplitMetrics Acquire 账户，将鼠标悬停在某个 MMP 图标上，点击 Settings 按钮。在弹出的对话框中找到第 5 项下的 Client ID，复制后粘贴至 Adapty 的 Client ID 字段。

使用集成功能还需要设置 Apple App ID。要查找 App ID，请在 App Store Connect 中打开你的应用页面，进入 General 部分下的 App Information page，在屏幕左下角找到 Apple ID。

事件与标签

在凭证信息下方，有三组事件可从 Adapty 发送至 SplitMetrics Acquire，按需开启即可。完整的事件列表请参见此处。

建议使用 Adapty 提供的默认事件名称，当然你也可以根据需要自定义事件名称。Adapty 将通过服务端到服务端的集成方式向 SplitMetrics Acquire 发送订阅事件，你可以在 SplitMetrics 看板中查看所有订阅事件。

SDK 配置

SDK 端无需任何额外配置，但建议向 Adapty 传入 customerUserId 以提高数据准确性。

故障排查

如果 SplitMetrics Acquire 集成在配置正确的情况下仍无法正常工作，请检查以下几点：

• 确保已在 App Settings -> Apple Search Ads tab 中启用 Receive Apple Search Ads attribution in Adapty 开关，已在 Adapty 中配置 Apple Search Ads，并已上传凭证，否则 SplitMetrics 将无法正常工作。
• 确认用户画像具有非自然流量的 ASA 归因数据。只有包含详细非自然流量 ASA 归因的用户画像才会将事件传递至 Adapty。

SplitMetrics Acquire 事件结构

Adapty 通过 GET 请求以查询参数的形式向 SplitMetrics Acquire 发送事件，每个事件的结构如下：

{
  "source": "Apple Search Ads",
  "app_id": "123456789",
  "name": "subscription_renewed",
  "type": "subscription_renewed",
  "revenue": 9.99,
  "currency": "USD",
  "tap_time": "2024-03-01 12:00:00",
  "open_time": "2024-03-01 12:05:00",
  "event_time": "2024-03-02 12:00:00",
  "adaccount_id": "123456",
  "campaign_id": "123456789",
  "adgroup_id": "123456789",
  "keyword_id": "123456789",
  "creative_set_id": "123456789",
  "Ad_id": "123456789",
  "country_or_region": "US",
  "conversion_type": "Download",
  "user_id": "user_12345",
  "att_status": "3",
  "device_type": "iphone",
  "app_version": "1.2.3",
  "sdk_version": "2.10.0",
  "ios_version": "17.2",
  "event_value": "{\"vendor_product_id\":\"yearly.premium.6999\",\"original_transaction_id\":\"GPA.3383...\"}",
  "event_id": "123e4567-e89b-12d3-a456-426614174000"
}

各字段说明：

参数	类型	说明
source	String	固定值 “Apple Search Ads”。
app_id	String	Apple App ID。
name	String	事件名称（由 Adapty 事件映射而来）。
type	String	事件类型（与 name 相同）。
revenue	Float	收入金额。
currency	String	货币代码。
tap_time	String	广告点击的日期和时间。
open_time	String	应用打开（安装）的日期和时间。
event_time	String	事件发生的日期和时间。
adaccount_id	String	ASA 组织 ID。
campaign_id	String	ASA 广告系列 ID。
adgroup_id	String	ASA 广告组 ID。
keyword_id	String	ASA 关键词 ID。
creative_set_id	String	ASA 创意集 ID。
Ad_id	String	ASA 广告 ID。
country_or_region	String	商店所在国家或地区。
conversion_type	String	转化类型（例如 “Download”）。
user_id	String	Customer User ID 或 Adapty 用户画像 ID。
att_status	String	追踪使用状态（0-3）。
device_type	String	设备类型（例如 “iphone”、“ipad”）。
app_version	String	应用版本号。
sdk_version	String	Adapty SDK 版本号。
ios_version	String	iOS 版本号。
event_value	String	包含所有可用事件详情的 JSON 字符串。
event_id	String	唯一事件 ID（UUID）。