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 ID、IDFV、系统版本等。

页面示例详细参数
基础信息测试应用：应用名称
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