# H5游戏接入指南
# 1.申请账号
请联系云步申请账号(暂不开放申请)。
# 2.创建游戏和配置广告
# 2.1 创建游戏
进入后台 广告配置--H5游戏 页面，右上角点击"添加小游戏"，需要配置的信息如下：
| 配置名称 | 说明 | 是否必须 | 示例 |
|---|---|---|---|
| 游戏名称 | 游戏中文名称 | 是 | 泡泡精灵传奇 |
| 英文标识 | 游戏英文标识 | 是 | bubbleelfsaga |
| 包名 | 不带渠道后缀游戏包名 | 是 | com.yunbu.bubbleelfsaga |
| 友盟Key | 暂时无需配置 | 否 | / |
| 游戏分类 | 选择游戏分类 | 是 | 休闲消除 |
| 屏幕方向 | 游戏屏幕方向 | 是 | 竖屏 |
# 2.2 配置广告
广告场景、广告位和广告单元之间的关系说明
广告场景指游戏里触发广告时的场景，比如关卡结束、主界面、点击返回按钮等，后台已经内置了一些常用的场景，创建广告位时根据需求选择对应的场景即可；
广告位是在特定场景下展示广告的位置，广告位和广告场景是一种绑定关系，一个广告位只能绑定一种场景，比如在关卡结束界面有展示插屏的位置，也有展示banner的位置；
广告单元是比广告位更小的单位，一个广告位可以有多个广告单元，一个广告单元里对应一个渠道的广告单元id。
比如一个插屏的广告位可以同时配渠道的插屏广告单元id和原生广告单元id，这样就可以控制原生插屏和插屏的展示优先级。
# 2.2.1 创建广告位
进入后台 广告配置--广告位管理 页面，右上角点击"添加广告位"，需要配置的信息如下：
| 配置名称 | 说明 | 是否必须 | 示例 |
|---|---|---|---|
| 选择游戏 | 选择2.1中创建的游戏 | 是 | 泡泡精灵传奇 |
| 广告位ID | 广告位唯一标识，客户端请求广告需要用到 | 是 | interspos |
| 广告场景 | 这个广告位展示的场景 | 是 | 【操作】点击返回按钮 |
| 展示类型 | 这个广告位需要展示的广告类型，比如展示原生插屏，实际向广告平台请求的是原生广告，但是展示类型是插屏 | 是 | 插屏 |
| 描述 | 广告位描述 | 是 | 泡泡插屏广告 |
# 2.2.2 创建广告单元
进入后台 广告配置--广告单元 页面，右上角点击"添加广告单元"，需要配置的信息如下：
| 配置名称 | 说明 | 是否必须 | 示例 |
|---|---|---|---|
| 选择游戏 | 选择2.1中创建的游戏 | 是 | 泡泡精灵传奇 |
| 广告位 | 选择2.2.1中添加的广告位 | 是 | 泡泡插屏广告 |
| 广告平台 | 上线渠道所使用的广告平台 | 是 | oppo |
| 广告单元ID | 广告平台申请的广告单元ID，用于向平台请求广告 | 是 | 155986 |
| 填充类型 | 广告单元ID在广告平台所属的广告格式 | 是 | 原生 |
| 权重 | 如果同一个广告位下有多个广告单元，权重越高则优先展示 | 否 | 20 |
| 刷新间隔 | 特指banner广告自动刷新时间间隔，其他广告类型无需配置 建议最低也要设置10s以上，否则渠道会返回调用频率过高导致不填充广告 | 否 | 15 |
| 优化规则 | 选择2.2.3中创建的平台优化规则 | 否 | 屏蔽oppo审核 |
| 原生广告优化 | 选择2.2.5中创建的原生广告优化 填充类型选择"原生"才会显示 | 否 | 关闭按钮误触 |
| 描述 | 广告单元描述 | 否 | oppo原生 |
提示：配置完广告单元就已经可以进行打包测试广告，以下为可选项，根据需求添加配置即可。
# 2.2.3 添加平台优化规则（可选）
进入后台 广告配置--平台优化规则 页面，右上角点击"添加渠道优化"，需要配置的信息如下：
| 配置名称 | 说明 | 是否必须 | 示例 |
|---|---|---|---|
| 广告平台 | 上线渠道所使用的广告平台 | 是 | oppo |
| 规则代码 | 优化规则唯一标识 | 是 | bubbleelfsaga_oppo_common |
| 描述 | 规则描述 | 是 | 屏蔽oppo审核 |
| 排除地域 | 选择需要屏蔽的城市，被屏蔽的城市将不会展示广告 | 否 | 原生 |
# 2.2.4 添加场景优化（可选）
进入后台 广告配置--场景优化 页面，右上角点击"添加场景优化"，需要配置的信息如下：
| 配置名称 | 说明 | 是否必须 | 示例 |
|---|---|---|---|
| 选择游戏 | 选择2.1中创建的游戏 | 是 | 泡泡精灵传奇 |
| 选择场景 | 选择需要优化的广告场景 | 是 | 【操作】点击返回按钮 |
| 优化策略代码 | 场景优化唯一标识 | 是 | btn_back_scene_rule |
| 优化策略描述 | 策略描述 | 是 | 1s延迟策略 |
| 显示延时 | 广告延迟展示，进度条代表延时时间，单位秒 | 否 | 1 |
| 广告强度 | 暂时无需配置 | 否 | 1 |
| 广告叠加显示 | 是否在渠道banner广告下隐藏显示一个原生banner广告，只有banner广告需要配置 | 否 | 是 |
# 2.2.5 原生广告优化（可选）
进入后台 广告配置--原生广告优化 页面，右上角点击"添加原生广告优化"，需要配置的信息如下：
| 配置名称 | 说明 | 是否必须 | 示例 |
|---|---|---|---|
| 选择游戏 | 选择2.1中创建的游戏 | 是 | 泡泡精灵传奇 |
| 广告平台 | 上线渠道所使用的广告平台 | 是 | oppo |
| 优化策略代码 | 场景优化唯一标识 | 是 | bubbleelfsaga_oppo_close_misstake |
| 优化策略描述 | 策略描述 | 否 | 关闭按钮50%误触 |
| 关闭按钮位置 | 原生插屏广告关闭按钮显示位置 | 否 | 右上 |
| 关闭按钮误触 | 点击关闭按钮触发广告点击的概率 | 否 | 50 |
| 关闭按钮延时 | 关闭按钮延时展示，单位秒 | 否 | 2 |
| 全屏误触 | 暂时无需配置 | 否 | 50 |
# 3. 打包
在游戏引擎自带的打包工具打出rpk。
# 4. 测试与上线
- 测试各个广告位是否能展示广告;
- 测试广告是否能反复展示；
- 测试后台配置的关闭按钮误触、延时等配置。
以上测试都没问题可以上线。