支付宝广告小游戏商家接入流程示意图

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

如无支付宝广告账户需要注册企业支付宝账户

二、游戏商家创建小游戏

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

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

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

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接口耗时长，怎么解决？

解决方案：切换一个通畅的网络进行重新创建广告。