English
Log In
You can then view all documents
Installation/SDK Test Device/iOS自测工具集成说明V1.0
iOS自测工具集成说明V1.0
Last updated 2022-01-25 11:25:16

注意事项:

  1. 穿山甲开发者接入测试工具,仅支持开发者在接入穿山甲SDK时,在测试状态下进行调用
  2. 测试工具检测/显示的相关信息,只用于对开发者进行重要接入项检测提醒,使用测试工具预览的广告均为测试广告,不会产生任何线上影响
  3. 开发者在测试结束后,上线前切记将调用测试工具的相关代码删除/屏蔽,以免对应用体验产生影响
  4. SDK版本要求:3702及以上版本


一、产品简介

在接入阶段,通过测试工具进行接入过程必要操作check,提高开发者接入测试的效率:

  • 基础信息检测:检测应用、设备、sdk的相关信息
  • 全局配置检测:检测相关参数、权限等是否成功配置
  • 代码位检测:检测测试代码位的基础信息、设置测试代码位需要请求展示的广告类型

二、测试工具接入流程

  1. 首先接入穿山甲SDK,参考接入文档接入https://www.csjplatform.com/support/doc/5fbdb5e11ee5c2001d3f0c75方式一:Pod 方式引入

方式二:Framework引入官网下载引入SDK,将解压后的BUAdTestMeasurement.framework, BUAdTestMeasurement.bundle引入工程。使用开发者测试工具

  • 在SDK初始化前设置debug,开发者应避免将测试工具带上线,不然可能会影响应用的体验
  • 媒体根据具体需求展示测试工具

三、测试工具使用指南

1.测试功能的使用

1.1 基础信息检测(首页)

进入测试工具首页,即可进行基础信息检测,在此页面可查看应用、设备、接入的sdk的相关信息,开发者可根据信息检查接入信息是否正确

示意图

检测内容

iOS工具1.png

SDK版本号:接入的SDK的版本测试应用:测试应用的名称AppID:测试应用对应的苹果应用商店ID设备ID:didos_version:操作系统_版本manufacturer:设备制造商IDFA:设备唯一标识符Bundle version:bundle版本


1.2 全局配置检测

进入全局配置检测页面,可检测sdk初始化后必要的参数是否配置,根据检测结果,检查必要/重要参数是否已配置正确,提高接入的准确性

示意图

检测内容

iOS 工具2.png

SDK初始化:检测SDK初始化是否成功IOS 14 升级 checkSKAdNetwork:检测是否配置了穿山甲SKAN参数App Tracking Transparency:检测是否配置支持苹果 ATTXcode配置添加权限(optional):检测工程plist文件设置是否配置了相关权限,具体权限信息如下:网络相机访问相册保存到相册定位Other Link:-ObjC(Required):检测Build Settings中Other Linker Flags 是否增加参数-ObjC全局配置SDK初始化:检测SDK初始化时相关参数是否配置App ID(Required):应用ID,初始化参数必须配置区域设置Enable SKAdNetwork:检测是否使用SKANCustom idfa:检测是否自定义idfaOffine Type:检测是否配置WKWebview post message为空的类型Theme Night:检测是否配置了暗黑模式



1.3 代码位检测(定向预览特定类型测试广告)
1.3.1 代码位基础信息检测


示意图

检测内容

代码位检测(一级页面)

iOS 1.3.1-3.png

在这个页面可以看到所有已接入的代码位(广告位)id,点击选择对应代码位id,可进入对应的代码位详情页

代码位详情页(二级页面)

iOS sdk -4.png
iOS SDK -5.png

代码位名称代码位ID参数配置:检测开发者配置的代码位请求参数(请求广告之后能显示)请求素材宽请求素材高请求广告次数:一次请求的广告条数设置请求广告类型:可选择配置需要预览的测试广告类型,进行特定广告预览选择广告类型:选择穿山甲提供的测试广告类型进行预览手动输入:若穿山甲提供的测试广告类型无法满足测试要求,可根据需要申请建立对应的测试广告,由穿山甲侧提供新建的测试广告aid、cid,进行特定测试广告预览


1.3.2 定向预览特定类型测试广告

使用接入测试工具预览广告流程

1.3.2-lll.png
  • 图例
1.3.2-IIIII.png

1.3.3 测试广告预览相关说明(重要)
  • 手动输入的测试广告aid、cid,必须是经过申请配置通过后,才能正常预览(需BD向PM申请)
  • 穿山甲提供了五种类型的测试广告,为了保证测试效果,请根据测试广告位类型选择对应可支持的测试素材进行预览

测试广告类型

支持的素材类型

可支持预览的广告位类型

落地页-表单提交Playable(试玩广告,只支持在激励视频广告位预览、只支持横板视频素材)下载-商店直投下载-直接下载下载-落地页下载调起类

竖版视频

draw视频、激励视频、全屏视频

竖版大图

开屏

横版大图

信息流、banner、插屏

小图

信息流、banner、插屏

组图

信息流、banner、插屏

横版视频

信息流、draw视频、激励视频、全屏视频

  • 退出定向预览测试广告,需要返回测试工具,将配置的aid、cid信息清除,否则一致拉取的测试广告都是测试广告
  • 上线前check:在测试阶段结束后,切记需要将调用测试工具的代码删除/屏蔽才能上线


Contents
Contact us