Apple Ads (AA) 归因数据是在 adapty.activate() 之后异步到达的。首次启动时，归因数据通常还未就绪，因此 getPaywall 会按默认目标受众来解析，Apple Ads 用户就会错过你针对 AA 市场细分配置的付费墙。与其等待归因数据到位再展示付费墙，不如先立即展示一个付费墙，等 AA 归因数据应用后再刷新——这样 Apple Ads 用户能看到定向版本的付费墙，其他用户也无需等待。AdaptyProfile.appliedAttributionSources 可告知你 AA 归因何时已完成应用。

开始之前

你需要准备以下内容：

• Adapty Capacitor SDK 3.17.1 或更高版本。
• 在 Adapty 中为应用配置 Apple Ads。请参阅 Apple Ads。

工作原理

调用 adapty.activate() 后，SDK 会在后台向 Apple 请求 Apple Ads 归因数据，并将结果转发给 Adapty 后端。当 AA 成为该用户画像的有效归因来源时，SDK 会向你的 onLatestProfileLoad 监听器推送更新后的 AdaptyProfile，其 appliedAttributionSources 数组中会包含 'apple_search_ads'。

因此，你可以分两步加载付费墙：

1. 立即调用 getPaywall。由于尚未应用任何归因，Adapty 会根据默认目标受众解析请求，用户可立即看到付费墙。
2. 当出现 'apple_search_ads' 时，再次调用 getPaywall。Adapty 此时会根据 Apple Ads 目标受众解析请求，并返回定向付费墙，替换第一个付费墙。

appliedAttributionSources 可以为空或不存在，这意味着：

• 该用户画像的 Apple Ads 归因尚未处理完成，或
• 根本没有收到任何归因数据。 无论如何，第一步都是安全的——Adapty 会根据当前用户画像状态匹配到对应的目标受众（通常是默认受众）来处理请求。第二步只有在 'apple_search_ads' 出现后才会执行。

实现

立即显示付费墙，然后监听 'apple_search_ads' 事件，当其到达时刷新付费墙。

1. 激活 SDK。 请参阅安装并配置 Capacitor SDK。
2. 使用 getPaywall 正常加载并展示付费墙 — 无需等待归因数据。
3. 通过 adapty.addListener('onLatestProfileLoad', …) 订阅用户画像更新，并监听 'apple_search_ads'。一旦出现该数据，重新获取付费墙并展示更新后的版本。如果尚未配置监听器，请参阅监听订阅状态更新：

const listener = await adapty.addListener('onLatestProfileLoad', async ({ profile }) => {
  if (!profile.appliedAttributionSources?.includes('apple_search_ads')) return;
  const targeted = await adapty.getPaywall({ placementId });
  // present the targeted paywall in place of the first one
});

// Call listener.remove() after the upgrade, or after a timeout (see below).

4. 超时后停止监听。 大多数用户不会获得 Apple Ads 归因数据，因此请在一段时间后移除监听器，而不是在整个会话期间保持开启。为版位配置备用付费墙，确保请求失败时用户始终能看到内容。

完整示例

onAppleAdsAttribution 会在苹果广告归因应用后 resolve，或在 timeoutMs 超时后 reject。下面的用法会立即加载付费墙，然后在归因数据到达时重新获取——苹果广告用户将看到定向付费墙，如果归因一直未到达，则继续使用第一次加载的付费墙：

const APPLE_ADS_SOURCE = 'apple_search_ads';
const placementId = 'YOUR_PLACEMENT_ID';

function hasAppleAdsAttribution(profile: AdaptyProfile): boolean {
  return profile.appliedAttributionSources?.includes(APPLE_ADS_SOURCE) ?? false;
}

/**
 * Resolves once Apple Ads attribution is applied to the profile.
 * Rejects with a timeout error if attribution never arrives within `timeoutMs`.
 * Call after `adapty.activate()`.
 */
export function onAppleAdsAttribution(timeoutMs: number): Promise<void> {
  return new Promise((resolve, reject) => {
    let timer: ReturnType<typeof setTimeout> | undefined;
    let handle: { remove: () => void } | undefined;

    const stop = () => {
      clearTimeout(timer);
      handle?.remove();
    };

    adapty
      .addListener('onLatestProfileLoad', ({ profile }) => {
        if (!hasAppleAdsAttribution(profile)) return;
        stop();
        resolve();
      })
      .then(listener => {
        handle = listener;
      });

    timer = setTimeout(() => {
      stop();
      reject(new Error(`Apple Ads attribution timed out after ${timeoutMs}ms`));
    }, timeoutMs);
  });
}

let paywall = await adapty.getPaywall({ placementId });

onAppleAdsAttribution(30_000)
  .then(() => adapty.getPaywall({ placementId }))
  .then(updated => {
    paywall = updated;
  })
  .catch(() => {
    console.log('Apple Ads attribution or loading failed');
  });

首次启动时，Apple Ads 用户会短暂看到默认付费墙，随后才会被替换。如果你使用付费墙编辑工具展示付费墙，请决定是否可以接受重新展示，或者在付费墙显示之前再应用更新。请根据你愿意等待的时间来调整 timeoutMs——通常情况下，归因数据在启动后几秒内就会到达。 如果你的应用已经出于其他目的监听了 onLatestProfileLoad（例如检查订阅状态），则无需做任何更改。adapty.addListener 支持多个独立监听器，因此新增的监听器不会影响已有的其他监听器。