支付宝媒体管理平台中小游戏插屏广告的接入步骤 | 支付宝广告平台

支付宝广告小游戏插屏广告的接入步骤

一、注册支付宝广告账户并入驻商家平台

二、游戏商家创建小游戏

三、开通游戏商家流量主

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

在支付宝广告运营中心页面，点击【开通】。

进入支付宝广告流量主页面，将资料信息补充完整，再点击【申请开通】。

在支付宝广告申请开通页面操作完成后，等待审核通过即可（约 1 个工作日内完成审核）。商家可通过【商家中心—运营中心】查看相关审核状态。同时，支付宝广告推广审核成功后会有短信同步提醒。

支付宝广告审核成功会有相应提示。

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

1.创建广告位

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

小游戏插屏广告会依据游戏横竖屏情况自行适配。

支付宝广告样式规则页面有相关信息提示。

2. 获取 SpaceCode 信息

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

支付宝广告新建广告位提示页面及支付宝广告平台详情页内的 spaceCode 即为所需信息。

3. 技术开发对接

插屏广告组件由客户端原生的图片、文本、视频控件构成，层级最高，会覆盖普通组件。

【广告创建】

插屏广告组件默认处于隐藏状态，因此可提前创建，以提前初始化组件。

【显示/隐藏】

插屏广告组件默认隐藏，开发者需调用 InterstitialAd.show() 进行显示。若支付宝广告投放拉取失败或触发频率限制，InterstitialAd.show() 方法会返回一个 rejected Promise，开发者可自行监听错误信息。

【广告拉取成功与失败】

插屏广告组件会自动拉取广告并更新。组件创建后会拉取一次广告，用户关闭支付宝广告后会去拉取下一条广告。若拉取成功，通过 InterstitialAd.onLoad() 注册的回调函数会执行，回调函数无参数传递。若拉取失败，通过 InterstitialAd.onError() 注册的回调函数会执行，回调函数的参数是一个包含错误信息的对象。

【监听用户关闭广告】

若支付宝广告被关闭，通过 InterstitialAd.onClose() 注册的回调函数会执行，回调函数无参数传递。

4. 广告调试

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

支付宝广告位管理页面如图所示。

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

支付宝广告位调试设置页面如下。

（3）在 C 端请求触发完成后，在调试页面可看到相应调试信息（曝光量&点击量以及最近 10 次的请求信息）。

支付宝广告调试效验页面如图。

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

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

五、小游戏广告接入的常见技术答疑

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

Q1：错误码 62000，spaceCode 传入错误，如何解决？

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

支付宝广告位信息页面

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

解决方案：切换至通畅的网络重新创建广告。