注意事项:
- 支持开发者在接入Taku SDK后进行检测使用
- 测试工具仅作为检测SDK集成,并不能代替APP自身的广告逻辑测试
- 开发者在测试结束后,上线前将调用测试工具的相关代码删除
- 版本要求:Android(v6.2.78及以上),iOS(v6.2.78及以上)
一、产品简介
通过使用测试工具提高开发者接入测试的效率:
- 基础信息:检测应用、设备、sdk的相关信息
- Taku SDK设置信息:检测隐私设置、权限是否成功配置
- 集成检测:检测集成三方平台SDK和adapter集成情况和测试建议,以及测试三方广告平台的广告加载
版本说明
二、接入流程
注意:在接入测试工具之前,需要先集成Taku SDK。SDK集成方式可以参考 unity插件使用说明 。
Android接入流程
- 导入测试工具的依赖库,按照以下两个操作:
第一步:先在Unity的项目/Assets/AnyThinkAds/Plugins/Android目录下新建一个名为Editor的文件夹;
第二步:创建Dependencies.xml文件并在文件中添加以下内容,然后放到第一步创建的Editor目录下。
注意:第一步文件夹命名必须是Editor,第二步文件命名必须是Dependencies.xml。<dependencies> <androidPackages> <repositories> <repository>https://jfrog.anythinktech.com/artifactory/debugger</repository> </repositories> <androidPackage spec="com.anythink.sdk:debugger-ui:1.1.1"/> </androidPackages> </dependencies>
- 完成测试工具依赖库导入后,就可以直接在Unity层调用C# API先调用SDK初始化后,再调用以下方法跳转到测试工具页面:
注意:必须先初始化SDK后才能跳转到测试工具页面。ATSDKAPI.showDebuggerUI("Your Debug Key");
iOS接入流程
- 导入测试工具的依赖库,按照以下两个操作:
第一步:先在Unity的项目/Assets/AnyThinkAds/Plugins/iOS目录下新建一个名为Editor的文件夹;
第二步:创建Dependencies.xml文件并在文件中添加以下内容,然后放到第一步创建的Editor目录下。
注意:第一步文件夹命名必须是Editor,第二步文件命名必须是Dependencies.xml。<?xml version="1.0" encoding="utf-8"?> <dependencies> <iosPods> <iosPod name="AnyThinkDebugUISDK" version="1.0.3" /> </iosPods> </dependencies>
- 完成测试工具依赖库导入后,就可以直接在Unity层调用C# API先调用SDK初始化后,再调用以下方法跳转到测试工具页面:
注意:ATSDKAPI.showDebuggerUI("Your Debug Key");
a. 必须先初始化SDK后才能跳转到测试工具页面。
b. 测试工具里面的功能还需要媒体端先获取到idfa ,才能使用,目前SDK初始化,是不会去获取idfa的。
注意:上线前需要将调用测试工具的相关代码删除
三、测试工具使用
1.基础信息
功能:支持长按复制信息和当前页面数据分享。
Android基础信息
- GAID为Google Advertising ID,如果GAID显示为空,请检查以下因素:
1.手机是否有谷歌服务。
2.进入这个页面前,是否调用了以下方法限制GAID的获取。
string[] deniedInfos = new string[] { "gaid" }; ATSDKAPI.deniedUploadDeviceInfo(deniedInfos);
- Android ID为设备唯一标识符,如果AndroidId显示为空,请检查是否调用了以下方法限制AndroidId的获取:
string[] deniedInfos = new string[] { "android_id" }; ATSDKAPI.deniedUploadDeviceInfo(deniedInfos);
- 注意:如果集成的SDK是海外SDK,开启下面的调试模式则需要GAID不为空,如果是国内SDK,则需要AndroidId不为空。
iOS基础信息
- IDFA为设备唯一标识符,如果IDFA显示为空,请检查是否授予允许跟踪权限。
- 注意:如果IDFA为空,则无法成功开启广告调试,请在设置中授予跟踪权限。
2.Taku SDK设置
Taku SDK设置包括两部分:隐私设置和权限设置。
- 隐私设置
国内:有个性化推荐广告开关、设置隐私信息控制开关。设置方法:分别在Unity导出Android和iOS原生项目去设置,详情请查看Android国内隐私配置和iOS国内隐私配置。
海外:设置GDPR。设置方法:1.支持在unity直接设置,点击查看;2.导出Android和iOS原生项目去设置,详情请查看Android设置GDPR和iOS设置GDPR。 - 权限设置:应用已申请的权限列表。
- Android页面
- iOS页面
3.集成检测
- 看广告平台列表的集成状态:集成异常、完成集成、未集成。
- 勾选开关打开调试模式。
- 选择完成集成的广告平台进入调试模式。
- 选择广告平台的广告样式进行测试操作。
- 可点击右上角分享按钮,分享当前页面的广告平台调试信息。