支付宝媒体管理平台中关于小游戏激励广告的接入 | 支付宝广告平台

支付宝广告小游戏商家接入流程一览

一、注册支付宝账户/入驻商家平台

若尚无支付宝广告账户，需注册企业支付宝账户。

二、游戏商家创建小游戏

构建支付宝广告平台小游戏的 APPID。

三、游戏商家开通流量主

游戏商家在创建完小游戏后，需于支付宝商家平台的“【运营中心】-【小游戏】”中，选定需开通【流量主产品】的小游戏。

支付宝广告运营中心小游戏页面

点击【开通】

支付宝广告运营中心流量主页面

将资料信息完整补充后，点击【申请开通】

支付宝广告申请开通页面

等待审核通过即可（约 1 个工作日内完成审核）

商家可通过【商家中心-运营中心】查看相关审核状态，同时，审核成功后会有短信同步提醒。

支付宝广告审核成功示例

“支付宝小游戏商家群”是支付宝广告推广小游戏的官方通知群，会不定期发布注意事项及新产品通知。

四、游戏商家广告资源接入

1. 创建广告位

新建广告位：登录支付宝广告商家平台，在【运营中心】-【小游戏】-【流量主】-【广告管理】-【新增广告位】中添加小游戏激励广告位。

支付宝广告创建广告位实例

2. 获取 SpaceCode 信息

支付宝广告位创建完成后，在【广告位管理】点击【编辑】，查看对应的 spacecode（后期开发用到的 adUnitId 字段中需完整填写 spacecode）并提供给开发人员，用于后续技术开发工作。

支付宝广告广告位管理页面

详情页内的 spaceCode 即为所需信息。

支付宝广告详情页信息

3. 技术开发对接

激励视频广告组件由客户端原生的图片、文本、视频控件组成，层级最高，支付宝广告会覆盖在上屏 Canvas 上。开发者能够创建激励广告组件。激励广告可能有两种返回形式，会优先返回视频广告，当视频广告填充率不足时会返回 Feeds 流广告；创建激励广告组件。通过 my.env.clientVersion 返回字符串判断客户端版本号 >= 10.3.70 后再使用该 API。在 my.env.version >= 2.0.5 版本时，通过指定 multiton 参数也可设定为多实例。

【注意：避免高频广告请求】

为保障系统性能与广告效果，强烈建议商家合理规划广告请求的频率。频繁的广告请求不但可能对用户体验造成不良影响，还可能被认定为不符合支付宝广告服务使用协议的行为。请求限制：建议在用户游戏进程中，每个广告位的广告请求间隔不少于 1 秒。同时，避免在短时间内对同一广告位多次发起请求。用户交互触发：尽可能依据用户的交互行为来触发广告请求，比如页面切换、点击事件等，避免在自动化脚本或定时器中进行广告请求。

创建广告

激励广告组建默认隐藏，因此可以提前创建，也可以提前初始化组建；

为避免支付宝广告推广资源被滥用，目前每个用户每天激励广告的次数有限。建议在展示广告按钮前，先判断广告是否拉取成功。

显示广告

激励视频广告组件默认是隐藏的，需要调用 RewardedAd.show() 进行显示。注意，show 必须在 load 成功后调用，否则无法显示支付宝广告。

若出现 61101 相关的报错，请使用 onLoad 回调，在 onLoad 回调中，执行上述 load+show 的代码。如果广告展示失败，通过 RewardedAd.onError() 注册的回调函数会执行，回调函数的参数是一个包含错误信息的对象。常见异常错误参考文档

监听用户关闭广告

只有在用户点击激励视频广告组件上的“关闭广告”按钮时，广告才会关闭。这个事件可通过 RewardedAd.onClose() 监听。RewardedAd.onClose() 的回调函数会传入一个参数 res，res.isEnded 描述广告被关闭时的状态。

4. 广告调试

（1）代码部署完毕后，登录支付宝广告商家平台，进入【广告位管理】，选择需调试的广告位，点击【调试】按钮，如下所示：

支付宝广告广告位管理页面

（2）进入调试页面后， 点击【新增白名单】，填写测试用户账号（手机号或者邮箱），然后点击【更新】按钮，完成调试白名单的添加：

支付宝广告调试页面

（3）在 C 端请求触发完成后，在调试页面能够看到相应调试信息（曝光量 & 点击量 以及 最近 10 次的请求信息），如下图所示：

支付宝广告调试信息页面

（4）调试过程中需确认曝光量与点击量数值需与调试过程中点击支付宝广告的次数一致，如进入页面两次均出现广告且点击，则曝光数与点击数都等于 2，点击率为 100%。

（5）完成上述调试信息确认后，点击【关闭】按钮即可，流量接入成功。

五、广告组件使用规范

（1）禁止支付宝广告点击诱导，

严禁出现任何引导用户点击广告的任务/行为，不可引导用户点击广告才发放奖励或点击广告可加速完成任务，只可引导做广告浏览。

（2）禁止激励广告上叠加其他广告位类型。

为保证浏览激励广告的用户体验，禁止在激励广告上叠加展示任何其他广告位进行遮挡（比如：激励广告上不可同时叠加 banner 广告）。

（3）避免高频率广告请求为保障系统性能及广告效果，强烈建议商家合理规划广告请求的频次。频繁的广告请求不仅可能对用户体验产生负面影响，或被认定为不符合广告服务使用协议的行为。请求限制：建议在用户游戏进程期间，每个广告位的广告请求间隔不应低于 1 秒。同时，请避免在短时间内对同一广告位发起多次请求。用户交互触发：尽可能地根据用户的交互行为来触发广告请求，比如页面切换、点击事件等，避免在自动化脚本或定时器中进行广告请求。

（4）时间信息透传规范激励广告-视频样式浏览广告时长为 15s，激励广告-商品信息流样式浏览广告时长为 30s，目前展示逻辑为算法决策选定具体展示内容，建议商家在前置点位文案无需体现具体浏览时长，使用较通用的表达方式“浏览广告可获得 xx 奖励”，避免时长与具体展示不一致。

（5）激励广告接入建议商家在接入激励广告时位置或页面做区隔设计，支付宝广告平台避免同一个页面接入多个激励广告位，导致整体效率降低或用户体验问题，监测不同页面及位置的数据后期对展位进行优化。

六、小游戏广告接入的常见技术答疑问题

错误码及对应解决方案概述

错误码	错误信息	解决方案
61000	广告返回空	建议检查广告单元配置是否成功
61001	广告请求超时	建议检查网络环境是否正常，服务器是否稳定
61002	广告请求错误	建议检查参数配置，重新请求接口
61003	广告单元重复创建	建议确认是否创建了重复的广告单元，删除重复广告，再进行创建广告视图
61004	广告视图创建失败	建议检查参数配置，重新创建广告视图
61005	广告视图区域异常	建议检查广告视图的展示区域是否超出了屏幕，重新设置 style 属性
62000	spaceCode 传入错误	填写正确的 spaceCode，并传入对应的 adUnitId 字段中
62001	用户触发了服务端疲劳度的规则	建议商家设置某个按钮的领奖次数（用户广告观看次数）
62002	用户关闭隐私权限	建议商家以及用户打开支付宝 -> 我的->用户保护中心->隐私设置->支付宝广告、推荐设置
2	参数类型错误	建议检查请求时传递的数据是否正常，格式是否正确，可以在请求前打印下入参数据日志
3	未知错误	建议检查参数是否正常，重新请求参数
61101	广告状态异常	属于接入问题，在激励广告接入常见，建议在广告加载成功之后再显示广告； loadAd：非激励广告，回报异常 REWARDED showAd： 激励广告，独立页面模式，状态为非创建成功 广告 view 已创建，状态为隐藏
61102	广告重复展示	属于接入问题，避免在支付宝广告展示期间，重复拉起广告，广告正在展示【重复调用 jsapi】
61201	hideAd 调用问题	jsapi: hideAd，属于接入问题 建议非 banner 广告不调用 hideAd；banner 广告也不要重复调用
61301	destroyAd 调用问题	jsapi: destroyAd，属于接入问题，banner 和激励广告常见，banner 重复调用会触发，建议业务去重

Q1：错误码 62000，spaceCode 传入错误，怎么解决？

A： 确认下接口使用的 adUnitId 是否上传正确，广告接口中的 adUnitId 需要传入填写完整的 spaceCode 信息。

Q2：错误码 61000，报错广告返回空，怎么解决？

A：服务端没有返回数据，建议检查广告单元配置是否成功。

解决方案：

1.如果是 createBannerAd 接口报错的话，可能是 banner 的 style 设置不对，left/或者 top + banner 的尺寸，超过了屏幕的尺寸；可以参考下如下的尺寸，设置排查下是否是这个问题；如果尺寸不一对，createBannerAd 在 Android 端会返回 广告为空，iOS 端会返回视图创建失败；

2.目前线上的广告填充并没达到 100%，在调试阶段可以配置调试白名单使广告填充率达到 100%。

支付宝广告资源位页面

Q3：错误码 61001 或 61002，报错广告请求超时或错误，怎么解决？

A：用户当前网络比较差，导致请求失败。

解决方案：

建议检查当前网络环境是否正常，切换到流畅的网络环境中进行广告的观看。

Q4：错误码 61003 或 61101，报错广告单元重复创建或广告状态异常，怎么解决？

A：70 版本同时调用 create，load 和 show 接口会触发这个问题。

解决方案：

建议游戏开发者在较早的时机进行广告的创建工作，防止同时调用接口而导致广告展示失败的情况

Q5：错误码 61004，报错广告视图创建失败，怎么解决？

A：资源校验失败或设置 banner 的 style 参数中的 left，top 和 width 后超出屏幕。

解决方案：

切换一个网络通畅的环境重新请求支付宝广告或设置 banner 广告参数前先请求 systemInfo 接口，获取屏幕参数，防止出现超出屏幕的情况。

Q6：错误码 2，报错参数类型错误，怎么解决？

A：入参配置错误或 banner 广告没有按照要求传 style 参数，或者自查 game.json 是否有配置 screenOrientation 字段。

解决方案：

请按照接口规范重新检查入参是否正确传递，格式是否正确，可以在请求前打印下入参数据日志。

Q7：create 和 load 接口耗时长，怎么解决？

解决方案：

切换一个通畅的网络进行重新创建广告。