菜单

初始化说明

• 您的App需要制订《隐私政策》，同时在用户首次启动App时展示《隐私政策》并取得用户同意。App制订的《隐私政策》，请参考《隐私合规指南》请务必确保用户同意App《隐私政策》之后，再初始化Taku SDK。

使用SDK加载和展示广告前，需要调用initSDK方法；

• 涉及欧盟地区或者相关用户隐私协议控制，可通过setGDPRLevel控制数据上报权限；

• 通过setDebugLog方法，可以开启调试日志，方便定位SDK集成中遇到的问题；

• DK需要的appid、appkey等参数可通过开发者后台创建app之后获取

1 初始化SDK

1.1 初始化相关API说明

类名：ATCocosSdk.h

说明：以下为android&ios通用API

API	参数说明	功能说明
integrationChecking	-	检查SDK是否正确集成广告平台的SDK
initSDK	const char * appId, const char * appKey	初始化SDK 如何获取App Key?
setDebugLog	bool value	打开debug模式，用于SDK查看更多的日志
setChannel	const char * channel	配置SDK的渠道号信息
setSubChannel	const char * subChannel	配置SDK的子渠道号信息
setCustomData	cocos2d::ValueMap customData	配置自定义参数，可用于定制流量分组，Taku自定义规则预留的key可查看文档。
setPlacementCustomData	cocos2d::ValueMap customData	配置广告位维度的自定义参数
getUserLocation	ATCocosUserLocationListener * listener	判断是否处于欧盟地区ATCocosSdk::USER_LOCATION_UNKNOWN:未知ATCocosSdk::USER_LOCATION_IN_EU:处于欧盟地区ATCocosSdk::USER_LOCATION_OUT_OF_EU:处于非欧盟地区
setGDPRLevel	int level	有关GDPR指引请参考 iOS平台或安卓平台面向欧盟地区，设置GDPR隐私等级ATCocosSdk::GDPR_PERSONALIZED：完全个性化ATCocosSdk::GDPR_NONPERSONALIZED：不收集设备信息,无个性化ATCocosSdk::GDPR_UNKNOWN：未知
getGDPRLevel	-	获取GDPR隐私等级ATCocosSdk::GDPR_PERSONALIZED：完全个性化ATCocosSdk::GDPR_NONPERSONALIZED：不收集设备信息,无个性化ATCocosSdk::GDPR_UNKNOWN：未知
showGdprAuth	-	展示GDPR授权页面

iOS部分需要API

API	参数说明	功能说明
getScreenScale	-	获取屏幕大小

1.2 初始化示例代码

// 测试阶段打开，上线的时候请移除
ATCocosSdk::setDebugLog(true);
ATCocosSdk::integrationChecking();

ATCocosSdk::setChannel("test_cocos_channel");
ATCocosSdk::setSubChannel("test_cocos_sub_channel");

//custom rule for app 
cocos2d::ValueMap customDict; 
customDict["custom_data_key"] = "custom_data_value"; 
ATCocosSdk::setCustomData(customDict);

 //custom rule for placmenet 
 cocos2d::ValueMap plcamentCustomDict; 
 plcamentCustomDict["placement_custom_data_key"] = "placement_custom_data_value"; 
 ATCocosSdk::setPlacementCustomData(placementId, plcamentCustomDict);

ATCocosSdk::initSDK(appId, appKey);

2 GDPR说明

2.1 GDPR相关API说明

API	参数说明	功能说明
getUserLocation	ATCocosUserLocationListener * listener	判断是否处于欧盟地区 ATCocosSdk::USER_LOCATION_UNKNOWN:未知 ATCocosSdk::USER_LOCATION_IN_EU:处于欧盟地区 ATCocosSdk::USER_LOCATION_OUT_OF_EU:处于非欧盟地区
setGDPRLevel	int level	面向欧盟地区，设置GDPR隐私等级 ATCocosSdk::GDPR_PERSONALIZED：完全个性化 ATCocosSdk::GDPR_NONPERSONALIZED：不收集设备信息,无个性化 ATCocosSdk::GDPR_UNKNOWN：未知
getGDPRLevel	-	获取GDPR隐私等级 ATCocosSdk::GDPR_PERSONALIZED：完全个性化 ATCocosSdk::GDPR_NONPERSONALIZED：不收集设备信息,无个性化 ATCocosSdk::GDPR_UNKNOWN：未知
showGdprAuth	-	展示GDPR授权页面
isEUTraffic	-	判断是否欧盟国家

2.2 GDPR调用示例

    //check is in EU
    ATCocosSdk::getUserLocation(this);

    CCLOG("DemoMainScene::isEUTraffic %s", ATCocosSdk::isEUTraffic()?"YES":"NO");

    int gdpr_level = ATCocosSdk::getGDPRLevel();
    CCLOG("DemoMainScene::getGDPRLevel %d", gdpr_level);
    if (gdpr_level == ATCocosSdk::GDPR_PERSONALIZED) {
        CCLOG("DemoMainScene 同意上报隐私数据");
    } else if (gdpr_level == ATCocosSdk::GDPR_UNKNOWN && ATCocosSdk::isEUTraffic() == YES){
        CCLOG("DemoMainScene 未查询的授权状态");
        ATCocosSdk::showGdprAuthWithListener(this); // 发起弹框授权
    } ;
//    ATCocosSdk::setGDPRLevel(0);

最近修改: 2025-05-30Powered by

大纲