Skip to main content

iOS 自测工具接入文档

注意事项:

  1. 游可赢开发者接入自测工具,旨在开发者接入游可赢SDK后,帮助开发者对接入的关键事项进行检查,并在测试状态下进行调试;

  2. 测试工具中显示的各项信息,仅用于对开发者进行重要接入项检测提醒;

  3. 在自测工具使用完毕后,开发者切记要将与测试工具相关的代码删除或屏蔽,以免对即将发布的应用产生不必要的影响;

  4. 该工具仅用于SDK接入调试阶段使用,切勿集成上线,以免与SDK重复采集用户信息导致的用户信息采集合规风险;

工具介绍#

在接入游可赢SDK阶段,开发者可通过自测工具对接入过程中的必要操作进行检查,提高开发者接入测试的效率。

自测工具包括以下功能:

  • 基础信息:显示设备、应用及系统的相关基础信息;
  • 全局配置:显示及检测应用工程配置、建议权限状态及SDK全局信息等;
  • 广告位检测:对不同的广告类型信息及样式进行预览。

接入流程#

依赖游可赢SDK#

请参考iOS接入文档接入iOS SDK;

Cocoapods集成#

在项目的 Podfile 文件中添加以下代码:

pod 'KlevinTestMeasurement'

然后使用命令行运行:

pod install --repo-update

手动集成#

将提供的 KlevinTestMeasurement.framework 文件拖到 XCode 工程内(勾选 Copy items if needed 选项)

在合适的位置按照以下方式添加测试工具入口代码#

// 在测试配置下引入 KlevinTestMeasurement 头文件
#ifdef KLEVIN_TEST_MEASUREMENT
#import <KlevinTestMeasurement/KlevinTestMeasurement.h>
#endif
·····
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Override point for customization after application launch.
// 是合适的位置添加入口代码,支持通过悬浮入口,或摇一摇手势进入
#ifdef KLEVIN_TEST_MEASUREMENT
[KlevinTestMeasurement startOnWindow:self.window
withIconShowing:YES
enableMotionResponse:NO];
#endif
return YES;
}

使用简介#

基础信息#

开发者可通过 基础信息 页面所展示的内容查看当前应用的基础信息,包括:Bundle IDIDFV系统版本等。

页面示例详细参数
基础信息测试应用:应用名称
Bundle ID:应用标识
系统版本:iOS版本号
设备制造商:设备型号
Bundle Version:应用版本号
IDFV:供应商标识符

全局配置#

开发者可通过 全局配置 页面检查是否正常初始化游可赢广告SDK、Xcode工程配置、权限授权情况等;开发者可对照检测结果对异常项进行排查修复。

页面示例详细参数
全局配置SDK初始化:检测广告SDK是否初始化成功

Xcode配置: 检测工程是否已配置建议项,包括:
- NSUserTrackingUsageDescription 适配iOS 14的隐私及数据使用说明
- ATS相关配置 游可赢SDK建议配置项,允许HTTP协议的请求。

权限授权状态:当前应用的关键权限状态,包括:
- 隐私及数据使用授权(IDFA)
- 网络服务访问授权
- 定位服务访问授权

SDK 全局信息:游可赢广告SDK的核心信息,包括:
- SDK版本号
- AppID(游可赢平台的应用ID)
- IDFA值
- CAID值

广告位检测#

开发者可通过 广告位检测 页面进入指定类型的广告调试页面,通过输入指定的应用ID、广告位ID,即可在应用中快速加载对应的广告及预览效果。

暂不支持在线加载当前应用ID所配置的广告位列表。

页面示例详细参数
广告位检测游可赢提供的测试广告位ID信息:

AppID: 30709
开屏广告: 37060
激励广告: 37061
插屏广告: 37062
原生自渲染: 37063