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 初始化请在应用运行时只调用一次,并且 广告请求必须在初始化完成后进行。
OnADXConsentCompleted被调用后,才应该请求广告。
GdprType 请从下列项中选择并输入。
GDPR 类型
说明
POPUP_LOCATION
根据地区弹出同意提示(EU地区)
POPUP_DEBUG
不论地区均弹出同意提示以供测试(DEBUG)
DIRECT_NOT_REQUIRED
无需同意的地区(EU 以外地区)
DIRECT_DENIED
用户拒绝个人信息的使用与收集
DIRECT_CONFIRM
用户同意个人信息的使用与收集
Case 1. 向 EEA 用户提供 GDPR 同意界面
为欧洲经济区(European Economic Area)用户提供可选择是否同意的同意界面。
是否允许向欧洲经济区(European Economic Area)的用户征求同意的功能由 AdMob UMP(用户消息平台)处理。
在 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);
});
Case 2. 直接设置同意状态
如果不存在欧洲经济区(European Economic Area)用户,或应用内并未收集 GDPR 所定义的等同于个人信息的信息, 就像在韩国对推送通知同意、隐私政策的同意流程需要单独进行并处理一样,需要您自行进行处理。
在欧洲经济区(European Economic Area)以外的地区,如果不需要用户同意,请在
ADXConfiguration中将GdprType设置为DIRECT_NOT_REQUIRED。
在 iOS 情况下,因为 UMP 会同时处理 GDPR 与 IDFA(广告标识符)关于访问权限的控制,DIRECT_NOT_REQUIRED如果设置为该值则无法同时获得 IDFA 访问权限。在这种情况下,ATT(App Tracking Transparency)同意请求需要通过编程代码手动请求 ATT 同意提示。
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 同意界面重新展示的结果
});4. Privacy Policy
可以通过调用 ADXGDPRManager 的 GetPrivacyPolicyURL() 来使用 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)。
最后更新于
这有帮助吗?