开启最容易被遗漏的广告归因配置。

打开与该 App Store App 对应的 RevenueCat 项目，然后进入 Integrations → Apple AdServices → Add Apple Search Ads integration。如果你正在新建 Apple Ads 账户，我们推荐选择 Advanced；如果现有账户已经是 Basic，这里仍应选择 Basic，确保两个系统一致。

对于新账户我们推荐 Advanced，但 RevenueCat 必须始终与 Apple Ads 当前启用的产品一致。在 RevenueCat 中选择 Advanced，并不能把已有 Basic 账户升级为 Advanced。

这是最常被遗漏的一步。在 iOS 14.3 及以上版本中，需要在 Purchases 配置完成后调用 RevenueCat 的 AdServices token 自动采集方法。SDK 会在后台把 token 发送给 RevenueCat。

import RevenueCat

Purchases.configure(
    withAPIKey: "public_sdk_key",
    appUserID: "your_app_user_id"
)

// Call after Purchases.configure(...)
Purchases.shared.attribution
    .enableAdServicesAttributionTokenCollection()

Standard 归因不需要 App Tracking Transparency 授权，已经可以支持广告系列、广告组、关键词、国家/地区、claim type 和 placement 分析。Detailed 会额外提供点击与展示日期，但需要 ATT 授权。

Swift 中启用 Detailed 归因

应先请求 ATT 授权，再开启自动采集。如果在弹出 ATT 之前就开启采集，该 token 只能用于 Standard 归因。即使用户拒绝跟踪，仍可以采集 Standard 数据。

import AppTrackingTransparency
import RevenueCat

Purchases.configure(
    withAPIKey: "public_sdk_key",
    appUserID: "your_app_user_id"
)

if ATTrackingManager.trackingAuthorizationStatus != .notDetermined {
    Purchases.shared.attribution
        .enableAdServicesAttributionTokenCollection()
}

// Later, when it is appropriate to show the ATT prompt:
if ATTrackingManager.trackingAuthorizationStatus == .notDetermined {
    ATTrackingManager.requestTrackingAuthorization { _ in
        Purchases.shared.attribution
            .enableAdServicesAttributionTokenCollection()
    }
}

包含 SDK 调用的生产版本上线后，通过 Apple Ads 获取真实用户，并在 RevenueCat Charts 中检查归因维度。RevenueCat 会在 24 小时内使用 token 向 Apple 请求数据；新接入建议最多等待 7 天积累数据。

1. 01打开 RevenueCat 中的收入、试用、转化或 LTV 图表。
2. 02把 Attribution source 设为 Apple Search Ads，排除 Organic 安装。
3. 03按 Apple search ads campaign 分组，并继续检查广告组与关键词维度。
4. 04至少核对一个广告系列名称或 ID 与 Apple Ads 后台一致，再开始使用 Lily ROAS。