Leading Consent Management Platform

Compliant with GDPR, CCPA, COPPA, LGPD, PECR, PDPA, PIPEDA, and more.

移动应用发布商设置:按地区集成广告和分析 SDK

本指南面向移动应用发布商。它介绍如何为大多数应用使用的广告、分析和归因 SDK 设置 UniConsent 应用 SDK,使每个 SDK 在欧洲及您用户所在的其他地区都能获得所需的同意信号。

所需时间: 约 1 至 2 小时:第 1 步约需 10 分钟,第 2 步添加 SDK 需 20 至 30 分钟,第 4 步中每个 SDK 需 5 至 15 分钟,第 6 步和第 7 步的测试与检查约需 30 分钟。在控制台发布的更改会在应用下次加载同意界面时生效。

分工: 第 1 步和第 3 步在 UniConsent 控制台中完成。第 2、4、5 步需要修改应用代码,由您的应用开发人员完成。第 6 步和第 7 步在测试设备上完成。

第 1 步:创建应用项目

在控制台中创建一个应用项目并复制其 App ID。应用项目在欧洲使用 IAB TCF:对于在欧洲经济区、英国和瑞士投放的广告,Google 要求使用经 Google 认证且采用 IAB TCF 的 CMP,而 UniConsent 是经 Google 认证的 CMP(Gold 级)。

然后为您的其他地区开启相应政策:美国开启 CCPA 和 US State Privacy,加拿大开启 IAB TCF Canada。同时开启 IAB GPP,使广告 SDK 能收到美国和加拿大的选择。

第 2 步:添加 UniConsent SDK

为您的平台添加 UniConsent SDK:Android, iOS, Flutter, React Native。在应用启动时使用您的 App ID 启动它,并早于广告和分析 SDK,让它在需要同意时显示同意界面。各 SDK 指南都有说明。

第 3 步:各地区获得的内容

地区用户看到的内容您的 SDK 收到的内容
欧洲首次启动时显示 IAB TCF 同意界面IAB TCF 选择,以及用于 Firebase 的 Google Consent Mode
加拿大首次启动时显示 IAB TCF Canada 同意界面用户做出选择后的 IAB GPP 加拿大部分
美国启动时不显示界面:美国隐私采用选择退出模式。用户在应用的隐私设置中选择退出(第 5 步)。US Privacy 字符串和 IAB GPP 美国部分。设备上关闭广告跟踪也视为选择退出。
其他所有地区不显示同意界面广告和分析照常运行

欧洲 包括欧盟、挪威、冰岛和列支敦士登、英国、瑞士,以及阿尔巴尼亚、安道尔、白俄罗斯、波斯尼亚和黑塞哥维那、科索沃、摩尔多瓦、摩纳哥、黑山、北马其顿、圣马力诺、塞尔维亚和乌克兰。

在英国,英国 GDPR 和 ICO 的指引要求在进行非必要的存储和跟踪前取得同意,应用与网站同样适用,因此请将英国保留在您的欧洲地区中。

如果您关闭某个地区的政策,该地区的用户将被视为应用未安装 CMP:不会显示同意界面,也不会暂缓任何 SDK。

在美国,加利福尼亚适用 CCPA / CPRA,弗吉尼亚、科罗拉多、犹他、康涅狄格、佛罗里达、蒙大拿、俄勒冈、得克萨斯、特拉华、艾奥瓦、内布拉斯加、新罕布什尔、新泽西、田纳西、明尼苏达、马里兰、印第安纳、肯塔基和罗得岛适用 US State Privacy。用户可以选择退出数据的出售和共享以及定向广告,该选择会通过 IAB GPP(以及加利福尼亚的 US Privacy 字符串)传递给广告 SDK。请参阅 US State Privacy 设置。

第 4 步:集成您的 SDK

广告 SDK 和 Firebase 会自行从 UniConsent SDK 存储在设备上的标准 IAB 键中读取用户的选择,因此您无需自行暂缓它们。在用户的选择确定后再开始请求广告。

SDK方法指南
Google Mobile Ads(AdMob、Ad Manager)自动读取 IAB TCF 和 IAB GPP 键。您平台的指南:Android, iOS, Flutter, React Native
聚合平台和其他广告网络(例如 AppLovin MAX、Unity LevelPlay)大多数会读取 IAB 键。请查看各网络的文档:有些还需要通过其自身设置传入美国的选择。
Firebase AnalyticsUniConsent SDK 会自动将用户的选择发送给 Firebase。请按您平台的指南,在应用设置中将默认同意设为关闭。您平台的指南
归因(Adjust、AppsFlyer、Branch、Airbridge)UniConsent SDK 会将选择传递给支持的归因 SDK。应用归因合作伙伴
App Tracking Transparency(iOS)在 UniConsent 选择之后显示 ATT 提示。不允许跟踪时,UniConsent 会将其视为美国退出。iOS 与 ATT
应用内的网页(WebView)将用户的选择传递给网页,使网站的 CMP 不再重复询问。您平台指南中的“Sync Consent to WebView”

第 5 步:在应用中添加隐私设置

用户必须能随时更改其选择,美国用户也在这里选择退出。请在应用的设置界面中添加 隐私设置 项,用于打开 UniConsent 界面。您平台的指南介绍了如何打开指定界面,例如设置界面:Android, iOS, Flutter, React Native。

第 6 步:测试每个地区

在应用中设置测试地区以查看其他地区的界面,然后对 CA(加拿大)、CAQC(魁北克)、USCA(加利福尼亚)、USTX(得克萨斯)和 N(以上地区以外)重复测试:

// for testing only: remove it in release builds
UniConsent.getInstance().setTestRegion("EU");

UniConsent 演示应用提供测试地区选择器。发布应用前请移除测试地区。

第 7 步:确认您的 SDK 遵循用户的选择

每次检查都在全新安装或清除应用数据后进行,以免沿用之前的选择。

在欧洲检查

  1. 使用测试地区 EU 打开应用。首次启动时显示同意界面,广告在做出选择后才加载。
  2. 全部接受。 关闭并重新打开应用:同意界面不再出现,广告正常加载。
  3. 在全新安装中 全部拒绝。在广告合作伙伴支持的情况下,广告以非个性化或有限广告的形式加载。
  4. 打开应用中的 隐私设置,更改您的选择,并检查重新打开应用后该选择是否保留。

在美国检查

  1. 使用测试地区 USCA 打开应用。不显示同意界面,广告正常加载。
  2. 打开 隐私设置,选择退出并重新打开应用:退出选择会保留。

供开发人员参考

UniConsent SDK 将选择存储在应用的标准存储中(Android 为 SharedPreferences,iOS 为 NSUserDefaults),广告 SDK 从中读取。开发人员可以检查这些键,或使用 SDK 的方法读取,例如 getGPPString() 和 getUSPrivacyString():

IABTCF_TCString        IAB TCF choice (Europe)
IABGPP_HDR_GppString   IAB GPP string (US and Canada)
IABUSPrivacy_String    US Privacy string (California)

常见错误

  • 添加了 CMP 却没有集成您的 SDK。 同意界面会显示,但在选择确定前就启动的广告、分析或归因 SDK,或在其自身设置中被设为已同意的 SDK,会忽略用户的选择。请按第 4 步集成每个 SDK,并用第 7 步确认。
  • 发布后未检查供应商的报告。 发布几天后,打开您各 SDK 的报告(例如 AdMob 或 Ad Manager、聚合平台、Firebase 和归因合作伙伴),并与之前几天进行比较。与拒绝用户比例相当的下降属于正常。下降幅度大得多或数据中断,通常意味着某个 SDK 被完全暂缓或未收到同意信号。

还有问题?

联系我们:support@uniconsent.com