Initialize

0. GDPR (General Data Protection Regulation)

GDPR是欧盟（以下简称“EU”）的个人信息保护法规，服务提供者在收集和使用欧盟用户的个人信息或等同信息时，必须确认用户是否同意。这是为了遵守GDPR规定并满足基于该规定的广告网络操作所需的流程。

1. Initialize & GDPR Content UI

在初始化时提供可用于处理是否征得欧洲经济区（European Economic Area）用户 GDPR 同意的相关功能。在请求广告相关代码之前调用初始化函数。

ADX SDK 需要通过用户的 GDPR 获取同意的功能。

---

2024年1月16日起，依据 IAB 欧洲的认证以及平台运营商的 认证的同意平台（CMP）来处理GDPR同意管理，, 使用 AdMob UMP（用户消息平台）来处理 GDPR 同意。

---

如果您在欧洲经济区（European Economic Area）提供应用服务，或计划提供服务， 本文件的 UMP（User Messaging Platform） 部分按照说明进行设置。

• "<ADX_APP_ID>"中使用 ADX 下发的 ADX App ID。

• SDK 初始化请在应用运行时只调用一次，并且 广告请求必须在初始化完成后进行。

• GDPR 类型请从以下选项中选择并输入其中一项。

GDPR 类型	说明
gdprTypePopupLocation	根据地区弹出同意提示（EU地区）
gdprTypePopupDebug	不论地区均弹出同意提示以供测试（DEBUG）
gdprTypeDirectNotRequired	无需同意的地区（EU 以外地区）
gdprTypeDirectDenied	用户拒绝个人信息的使用与收集
gdprTypeDirectConfirm	用户同意个人信息的使用与收集

Case 1. 为 EEA 用户提供 GDPR 同意界面

为欧洲经济区（European Economic Area）用户提供可选择是否同意的同意界面。

是否允许向欧洲经济区（European Economic Area）的用户征求同意的功能由 AdMob UMP（用户消息平台）处理。

• 如果将 GDPR 类型设置为 gdprTypePopupLocation，则用户可根据其访问国家，在 EU 用户的情况下通过 GDPR Consent UI 来决定是否同意。

• 当将 GDPR 类型设置为 gdprTypePopupDebug 时，无论接入国家如何，都可以看到同意界面。

AdxInitResult adxInitResult = await AdxSdk.initialize(
                                "<ADX_APP_ID>", 
                                AdxCommon.gdprTypePopupLocation, 
                                ["<TEST_DEVICE_ID>"]);

若要测试查看 AdMob UMP 的 GDPR 同意界面，需进行以下两项设置。 下面需进行两项设置。 1) 前往 AdMob 控制台（https://apps.admob.com），按以下 GDPR 消息编写指引完成消息的编写与发布。 https://support.google.com/admob/answer/10113207?hl=zh-Hans

---

• Android 2) 在日志输出中确认下面的设备 ID。将该标识符字符串输入到最后一个参数， gdprTypePopupDebug。\n\n使用 new ConsentDebugSettings.Builder().addTestDeviceHashedId("33BE2250B43518CCDA7DE426D04EE231") 将其设置为调试设备。

---

• iOS 2) 将 iOS 应用安装到设备后，Xcode 控制台将输出如下消息。将该标识符字符串输入到最后一个参数， gdprTypePopupDebug输入。

---

<UMP GDPR 동의 화면>

Case 2. 直接设置同意状态

如果不存在欧洲经济区（European Economic Area）用户，或应用内并未收集 GDPR 所定义的等同于个人信息的信息， 就像在韩国对推送通知同意、隐私政策的同意流程需要单独进行并处理一样，需要您自行进行处理。

• 如果针对欧洲经济区（European Economic Area）以外的地区不需要征求同意，GDPR 类型进行 gdprTypeDirectNotRequired请设置为。

在 iOS 情况下，因为 UMP 会同时处理 GDPR 与 IDFA（广告标识符）关于访问权限的控制，gdprTypeDirectNotRequired如果设置为该值则无法同时获得 IDFA 访问权限。在这种情况下，ATT（App Tracking Transparency）同意请求需要通过编程代码手动请求 ATT 同意提示。

AdxInitResult adxInitResult = await AdxSdk.initialize(
                                "<ADX_APP_ID>", 
                                AdxCommon.gdprTypeDirectNotRequired, 
                                []);

2. ConsentState

GDPR 同意状态有 4 个状态值。

int consentState = adxInitResult.consent

状态	说明
0	表示用户无同意信息，在此状态下不会展示个性化广告。
1	在不需要征求同意的地区（EU 以外地区）会展示个性化广告。
2	用户已拒绝个人信息的使用与收集的状态 不会展示个性化广告。
3	用户同意个人信息的使用与收集的状态 将展示个性化广告。