通过集成 SplitMetrics Acquire，你可以清晰了解 Apple Search Ads 从订阅中带来的实际收益，并持续追踪用户数月，掌握广告的长期变现表现。 此外，Adapty 还会将订阅事件发送给 SplitMetrics Acquire，方便你在那里基于 Apple Search Ads 归因数据搭建自定义看板和自动化流程。 它不会向 Adapty 添加任何归因数据，因为我们已经直接从 ASA 获取了所需的全部信息。

如何配置 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 提供的默认事件名称。但您也可以根据需要修改事件名称。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"
}

It looks like your message got cut off — could you share the MDX documentation you’d like me to translate?

参数	类型	描述
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）。