通过集成 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

如果已正确配置集成，但与 SplitMetrics Acquire 的集成仍无法正常工作：

• 确保已在 App Settings -> Apple Search Ads tab 中启用 Receive Apple Search Ads attribution in Adapty 开关，并在 Adapty 中配置了 Apple Search Ads，同时上传了凭证——没有这些，SplitMetric 将无法正常运行。
• 确保用户画像具有非自然流量的 ASA 归因。只有包含详细非自然流量 ASA 归因的用户画像，其事件才会传送至 Adapty。

access_level_updated 在事件流中显示为失败

access_level_updated 是一个仅限 Webhook 的事件。Adapty 不会将其发送到此集成。但 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	客户用户 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）。