Google UMP 使用指南

一、集成 UMP

通过CocoPods集成

pod 'GoogleUserMessagingPlatform'

根据UMP接入指南进行集成

示例代码

#import <TradPlusAds/TradPlusAds.h>
#import <UserMessagingPlatform/UserMessagingPlatform.h>
//通过UMP授权
__weak typeof(self) weakSelf = self;
[UMPConsentInformation.sharedInstance
      requestConsentInfoUpdateWithParameters:nil
      completionHandler:^(NSError *_Nullable requestConsentError) {
        if (requestConsentError == nil) {
            NSLog(@"Error: %@", requestConsentError.localizedDescription);
            [UMPConsentForm loadAndPresentIfRequiredFromViewController:nil
                completionHandler:^(NSError * _Nullable error) {
                 [weakSelf startTradPlusSDK];
            }];
        }
        else
        {
            [weakSelf startTradPlusSDK];
        }
}];
if(UMPConsentInformation.sharedInstance.canRequestAds)
{
    [self startTradPlusSDK];
}


- (void)startTradPlusSDK {
  static dispatch_once_t onceToken;
  dispatch_once(&onceToken, ^{
      //初始化
      [TradPlus initSDK:@"TradPlus后台的应用对应appid" completionBlock:^(NSError *error){}];
      //加载广告
  });
}

二、在Admob后台开启UMP

1.访问Admob后台登录Admob账号，在 AdMob 中添加你的应用（如果您尚未添加应用）

2.点击“隐私权和消息”

3.点击“欧洲法规-管理”

4.点击“创建消息”，等待GDPR消息页面打开

5.在GDPR消息页面中点击右上角“选择应用”，选择您想要显示GDPR信息的应用

6.选择您想要显示消息的语言

7.在“定位”栏目中选择“须遵守 GDPR 的国家/地区（EEA 和 UK）”选项

Tips：推荐以下样式配置可以提高用户同意GDPR概率：

三、指定的广告合作伙伴

默认情况下，Google 可能不会在您的 GDPR 消息中显示您项目中集成的所有广告平台。如果您未能包含这些广告平台，可能会对您的广告收入产生不利影响。请按照本部分中的步骤操作，确保您项目中集成的所有广告平台都出现在 GDPR 消息中。

1. 在Admob后台“隐私权和消息”中点击“GDPR设置”，打开GDPR设置

2. 点击“检查您的广告合作伙伴”部分下的编辑图标

3. 选择 自行指定的广告合作伙伴 按钮

4. 参考下方表格，勾选您项目中集成的所有广告平台

TradPlus Network	Google Name
Meta	Facebook
AppLovin	AppLovin Corp
IronSource	ironSource Mobile
Chartboost	Chartboost
UnityAds	Unity Ads
Ogury	Ogury Ltd
AdColony	AdColony
Start.io	StartApp 或 Start.io Inc
Verve	Verve Group
Liftoff	Liftoff
Fyber	Fyber
Mintegral	Mobvista/Mintegral
Amazon	Amazon
InMobi	InMobi Choice
Smaato	Smaato
Yandex	Yandex
Bigo	BIGOAds

5. 点击“确认”

6. 点击GDPR设置页面最底部的“保存”按钮

注意：如果有弹出“重新向所有符合条件的用户征求意见？”弹窗时需要选择“重新提示”

四、TradPlus 相关设置

1. v10.6.0之前版本

开发者需要在UMP授权完成后调用GDRP设置API

iOS相关代码如下

//集成UMP并进行授权调用
//授权完成后，开发者需根据授权结果，向TradPlusSDK设置GDPR状态
//参考代码如下
NSInteger gdprApplies = [[NSUserDefaults standardUserDefaults] integerForKey:@"IABTCF_gdprApplies"];
if(gdprApplies == 1)//当前地区适用GDPR
{
    NSString *purposeConsents = [[NSUserDefaults standardUserDefaults] stringForKey:@"IABTCF_PurposeConsents"];
    if(purposeConsents != nil)
    {
        BOOL consent = [purposeConsents containsString:@"1"];
        [TradPlus setGDPRDataCollection:consent];
    }
}

2. v10.6.0及之后版本

大部份支持TCF2.0的三方广告源 TradPlus SDK 会根据平台情况自动进行适配处理

1.三方广告源自行获取的，则不进行任何设置操作 ( Amazon, AdColony, Admob, GoogleAdManger, GoogleIMA, Applovin, InMobi, Mintegral, Smaato, Verve, Yandex, Helium )

2.通过三方SDK API 传入 TCF v2 consent strings ( Fyber, Ogury )

3.根据 Global Vendor List (GVL)，TCF v2 string 授权情况后向三方SDK设置授权状态 ( Liftoff, Start.io )

4.通过UMP Additional Consent (AC) Mode 来判断授权情况后向三方SDK设置授权状态 ( IronSource, UnityAds, Chartboost, startapp )

5.根据三方规则判断后向三方SDK设置授权状态 ( Pangle, Bigo )

6.根据Meta的用户协议相关功能需要开发自行判断后设置

在授权流程结束后，开发者需要根据授权情况来决定是否开启Meta的受限数据使用 (LDU) 模式。 Meta的受限数据使用 (LDU) 模式 相关文档: Meta for Developers documentation

如使用UMP可参考如下代码：

//授权完成后
NSInteger gdprApplies = [[NSUserDefaults standardUserDefaults] integerForKey:@"IABTCF_gdprApplies"];
if(gdprApplies == 1)//当前地区适用GDPR
{
    NSString *addtlConsent = [[NSUserDefaults standardUserDefaults] stringForKey:@"IABTCF_AddtlConsent"];
    BOOL consent = ([addtlConsent rangeOfString:@"89"].location != NSNotFound);
    //根据授权状态，依照Meta文档进行设置
}
else
{
    //根据Meta文档进行设置
}