Initialize

0. GDPR (General Data Protection Regulation)

GDPR是欧盟(以下简称“EU”)的个人信息保护法规,服务提供者在收集和使用欧盟用户的个人信息或等同信息时,必须确认用户是否同意。这是为遵守GDPR规定并使广告网络按规定运行所需的程序。

1. Initialize & GDPR Content UI

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

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

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

    • OnADXConsentCompleted被调用后,才应该请求广告。

  • GdprType 请从下列项中选择并输入。

GDPR 类型

说明

POPUP_LOCATION

根据地区弹出同意提示(EU地区)

POPUP_DEBUG

不论地区均弹出同意提示以供测试(DEBUG)

DIRECT_NOT_REQUIRED

无需同意的地区(EU 以外地区)

DIRECT_DENIED

用户拒绝个人信息的使用与收集

DIRECT_CONFIRM

用户同意个人信息的使用与收集

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

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

  • 在 ADXConfiguration中将 GdprType 设置为 POPUP_LOCATION时,依据用户的接入国家,EU 用户可以通过 GDPR 同意界面(Consent UI)决定是否同意。

  • 将 GdprType 设置为 POPUP_DEBUG设置为时可无论访问国家如何都查看同意界面。

ADXConfiguration adxConfiguration = new ADXConfiguration.Builder()
                                .SetAppId("<ADX_APP_ID>")
                                .SetTestDevices(new List<string>() {"<TEST_DEVICE_ID>"})
                                .SetGdprType(GdprType.POPUP_LOCATION).Build();

AdxSDK.Initialize(adxConfiguration, adxConsentState => {
       Debug.Log(":::onADXConsentCompleted : " + adxConsentState);
});

애드몹 UMP의 GDPR 동의 화면을 테스트 목적으로 확인하려면, 아래 두 가지 설정이 필요합니다.

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


  • Android 2) 在日志输出中确认下列设备 ID。将此标识字符串作为 在 ADXConfiguration 对象创建时使用的 SetTestDevices 参数输入, SetGdprType 参数中输入 POPUP_DEBUG。\n\n使用 new ConsentDebugSettings.Builder().addTestDeviceHashedId("33BE2250B43518CCDA7DE426D04EE231") 将其设置为调试设备。


  • iOS 2) 在 iOS 设备上安装应用后,Xcode 控制台会输出如下信息。请将该标识符字符串 在 ADXConfiguration 对象创建时使用的 SetTestDevices 参数输入, SetGdprType 参数中输入 POPUP_DEBUG输入。


<UMP GDPR 동의 화면>

Case 2. 直接设置同意状态

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

  • 在欧洲经济区(European Economic Area)以外的地区,如果不需要用户同意,请在 ADXConfiguration 中将 GdprType 设置为 DIRECT_NOT_REQUIRED

ADXConfiguration adxConfiguration = new ADXConfiguration.Builder()
                                .SetAppId("<ADX_APP_ID>")
                                .SetTestDevices(new List<string>() {"<TEST_DEVICE_ID>"})
                                .SetGdprType(GdprType.DIRECT_NOT_REQUIRED).Build();

AdxSDK.Initialize(adxConfiguration, adxConsentState => {
       Debug.Log(":::onADXConsentCompleted : " + adxConsentState);
});

2. ConsentState

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

状态

说明

0

表示用户无同意信息,在此状态下不会展示个性化广告。

1

在不需要征求同意的地区(EU 以外地区)会展示个性化广告。

2

用户已拒绝个人信息的使用与收集的状态 不会展示个性化广告。

3

用户同意个人信息的使用与收集的状态 将展示个性化广告。

如需确认/更改同意状态,请使用 ADXGDPRManager

// 您可以检查在ADXGdprManager中设置的用户同意信息。
ADXGDPRManager.GetConsentState();

// 直接更改是否同意。
ADXGDPRManager.SetConsentState(consentState);

3. GDPR 同意屏幕的重新曝光 您可以向用户重新公开 GDPR 同意屏幕,以更改同意的状态值。

AdxSDK.ShowGDPRForm((bool result) => {
    // 检查 GDPR 同意界面重新展示的结果
});
  • 请仅在用户触发的输入事件(例如按钮点击)中调用上述方法。如果在没有用户输入事件的情况下调用,可能无法正常工作。

  • 如果并非欧洲经济区(European Economic Area)地区,GDPR 同意界面可能不会被重新展示。

  • 如果已存在关于 GDPR 同意状态的信息,即使并非欧洲经济区地区,GDPR 同意界面也可能被展示。

4. Privacy Policy

可以通过调用 ADXGDPRManagerGetPrivacyPolicyURL() 来使用 AD(x) 隐私政策文档的 URL。

ADXGDPRManager.GetPrivacyPolicyURL();

5. 启用调试日志

在进行 QA 时,为了确认集成及聚合的正常运行,需要在调用初始化函数之前按如下方式进行添加。

AdxSDK.SetLogEnable(true);

6. iOS 应用暂停功能(全屏广告)

如果在插页、奖励等全屏展示广告时需要暂停 iOS 应用,请按如下方式添加。

AdxSDK.SetiOSAppPauseForFullScreenAd(true);

7. Android 主线程处理

在 Android 设备上通过广告回调访问资源时会发生与主线程相关的错误

can only be called from the main thread

为了解决这一问题,需要使用 Update()AdxSDK.ExecuteMainThread() 在主线程中处理相关逻辑。

AdxSDK.ExecuteMainThread(() => {
    // 可在主线程中处理
});

8. 针对儿童的设置

如果您的服务要求您根据《儿童在线隐私保护法》(COPPA) 将内容指定为面向儿童的内容,或定位到欧洲经济区 (EEA) 中未达到法定年龄的用户,则必须在调用初始化函数之前配置 AdMob 定位设置。 有关更多信息,请参阅 AdMob 定位 (https://developers.google.com/admob/unity/targeting?hl=zh-cn)。

最后更新于

这有帮助吗?