海外隐私配置

💡Tips

• ⚠️ 隐私合规相关配置建议在 ATSDK.init() 之前调用，以确保 SDK 初始化时即遵循对应策略。
• 出海应用需遵守 GDPR（欧盟）、COPPA / CCPA（美国）等隐私法规。
• TopOn React Native SDK 通过 GDPR 数据上传等级 + 个性化广告开关控制数据合规，并提供 EU 流量判定与内置同意弹窗。

1. 概述

2. 个性化广告开关

用 setPersonalizedAdStatus 设置是否投放个性化广告，入参取以下常量：

import { ATSDK } from '@anythink/react-native-sdk';

// 用户同意个性化广告
ATSDK.setPersonalizedAdStatus(ATSDK.PERSONALIZED);

// 用户不同意
ATSDK.setPersonalizedAdStatus(ATSDK.NONPERSONALIZED);

3. GDPR 数据上传等级

适用于欧盟及欧洲经济区用户。根据用户授权状态设置数据上传等级（取值同上常量）：

// 用户同意 → 允许上传个性化数据
ATSDK.setGDPRUploadDataLevel(ATSDK.PERSONALIZED);

// 用户不同意 → 仅上传非个性化数据
ATSDK.setGDPRUploadDataLevel(ATSDK.NONPERSONALIZED);

// 读取当前等级
const level = await ATSDK.getGDPRDataLevel();

📌 当设置为非个性化时，SDK 会通知各广告平台不进行个性化投放，部分平台可能降低填充率或收益。

4. EU 流量判定与同意弹窗

可先判定当前是否为受 GDPR 约束的 EU 流量，再决定是否弹出授权：

const isEu = await ATSDK.checkIsEuTraffic();
if (isEu) {
  // 弹出 GDPR 同意弹窗（appId 可选）
  ATSDK.showGDPRConsentDialog();

  // 二次确认弹窗
  // ATSDK.showGDPRConsentSecondDialog();
}

💡 选型建议：判定流量用 checkIsEuTraffic()、弹同意框用 showGDPRConsentDialog() 即可覆盖绝大多数场景；isEUTraffic / showGdprAuth / showGDPRConsentSecondDialog 为兼容 / 特定场景接口，按需选用。以上 5 个方法均在 SDK 中真实存在。

5. 限制设备信息上传

按需禁止上传特定设备信息字段：

ATSDK.deniedUploadDeviceInfo('imei', 'oaid');

💡 入参为设备信息字段名的可变参数（如 imei / oaid 等），可传入一个或多个。可禁止上传的具体字段集以原生 SDK 文档为准——传入未识别的字段不会报错，但也不产生效果。

6. 广告源隐私策略

如需对各广告源单独下发隐私策略，传入 JSON 字符串：

const policy = {
  networkFirmIds: [1, 2, 3],  // 仅对指定平台生效；省略则全部
  agreePrivacyStrategy: true,
  isCanUseAppList: false,
  isCanUseOaid: false,
  isCanUseAndroidId: false,
  isCanUseLocation: false,
  isCanUseWifiState: true,
  customOaid: 'your-oaid-if-needed',
  customLocation: { latitude: 39.9, longitude: 116.4 },
};

ATSDK.setAdSourcePrivacyPolicy(JSON.stringify({ /* policy */ }));

7. 注意事项

8. COPPA / CCPA

⚠️ RN SDK 层未暴露 COPPA / CCPA 专用 API —— ATSDK 不提供 setIsAgeRestrictedUser / setDoNotSell 之类的方法，接入侧无需额外代码。

配置步骤：登录 TopOn 控制台 → 进入目标应用 → 隐私合规模块 → 启用 COPPA / CCPA 开关。控制台配置后，SDK 在请求广告时即按对应法规处理，RN 端无需调用任何方法。

📌 出海美国市场的应用请勿仅用 GDPR 覆盖欧洲而忽略 CCPA / COPPA，相关开关在控制台启用即可生效。