iOS自测工具集成说明-SDK Test Device-常见问题接入指南说明-Installation-穿山甲广告平台

CSJ: A global platform dedicated to developer growth.

Support Center

English

You can then view all documents

Details

Introduction

Registration

Configurement

Installation

Payment

Compliance

GroMore

AdSpark（增长参谋）

成长工具

Installation/常见问题接入指南说明/SDK Test Device/iOS自测工具集成说明

iOS自测工具集成说明

Last updated 2023-03-15 14:41:59

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

一、产品简介

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

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

二、测试工具接入流程

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

复制

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

在SDK初始化前设置debug，开发者应避免将测试工具带上线，不然可能会影响应用的体验

复制

媒体根据具体需求展示测试工具

复制

三、测试工具使用指南

1.测试功能的使用

1.1 基础信息检测（首页）

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

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

1.2 全局配置检测

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

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

1.3 代码位检测（定向预览特定类型测试广告）

1.3.1 代码位基础信息检测

示意图

检测内容

代码位检测（一级页面）

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

代码位详情页（二级页面）

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

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

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

图例

1.3.3 测试广告预览相关说明（重要）

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

测试广告类型	支持的素材类型	可支持预览的广告位类型
落地页-表单提交 Playable（试玩广告，只支持在激励视频广告位预览、只支持横板视频素材）下载-商店直投下载-直接下载下载-落地页下载调起类	竖版视频	draw视频、激励视频、全屏视频
	竖版大图	开屏
	横版大图	信息流、banner、插屏
	小图	信息流、banner、插屏
	组图	信息流、banner、插屏
	横版视频	信息流、draw视频、激励视频、全屏视频

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

Contents