支付宝媒体管理平台中的小游戏浮层广告 支付宝的广告平台

支付宝广告小游戏浮层广告的接入流程

游戏商家在完成小游戏的创建后，需于支付宝商家平台的【运营

中心】—【小游戏】里，选取要开通【流量主产品】的小游戏。

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

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

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

支付宝广告审核成功后会有相应页面显示。

1. 创建广告位

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

在支付宝广告新增广告位页面，有四种样式尺寸可供选择，建议选取 1280*720 或 1242*670，以适配更多预算。

支付宝广告位信息页面及支付宝广告图文样式配置页面会有相应展示。

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

在支付宝广告位管理页面及支付宝广告详情页内的 spaceCode 即为所需信息。

Banner 广告组件由客户端原生的图片、文本控件构成的原生组件，层级最高，会覆盖在上屏 Canvas 上。开发者能够调用 my.createBannerAd 来创建 Banner 广告组件。Banner 广告组件在创建后会自动拉取广告数据并进行渲染，开发者仅需控制 Banner 广告组件的位置和显示/隐藏即可。

Banner 广告组件默认是隐藏状态，需要调用 BannerAd.show() 来显示。当切换至没有 Banner 广告组件的场景或页面时，调用 BannerAd.hide() 来隐藏 Banner 广告组件。

广告拉取成功时，BannerAd.onLoad() 会执行，BannerAd.show() 返回的 Promise 也会是一个已解决的 Promise。两者的回调函数中均无参数传递。

若拉取失败，通过 BannerAd.onError() 注册的回调函数会执行，回调函数的参数是一个包含错误信息的对象。常见异常错误可参考文档，BannerAd.show() 返回的 Promise 也会是一个被拒绝的 Promise。

4. 广告调试

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

支付宝广告位管理新建广告位页面会有相关显示。

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

支付宝广告位调试设置页面会有相应操作指引。

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

支付宝广告调试信息页面会有详细展示。

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

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

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

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

支付宝广告位信息

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

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

支付宝广告资源位页面

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

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

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

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

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

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

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

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

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