支付宝媒体管理平台中有关小游戏任务广告的接入流程指引 | 支付宝广告平台

支付宝广告接入流程指引

第一步：广告位创建

1.1 选择接入方式

登录支付宝广告商家平台，在【运营中心】—【小游戏】—【流量主】—【广告管理】—【新增广告位】中添加广告位。接入方式选取“小游戏任务广告插件”，随后点击“新建广告位”来创建。

支付宝广告新增广告位页面

1.2 广告位编辑

填写资源位名称，并依据需求设置行业屏蔽。【支付宝广告最大返回条数】：按照商家设定的条数返回最大值，实际返回数小于等于 10 。

支付宝广告最大返回条数页面

1.3 获取广告位 id

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

支付宝广告位编辑提示

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

支付宝广告位信息页面

第二步：小游戏任务广告组件开发

任务广告请求和完成流程如下：

2.1 接入方法及步骤

（1）目前小游戏接入任务广告仅支持 api 方式。简而言之：

（2）调用 my.createTaskAd 获取任务广告实例。

（3）绑定回调事件，触发 ad.load() 获取广告。

（4）通过 onUpdate 获取到广告数据，开发者自定义渲染任务广告列表。渲染任务广告列表并绑定点击事件，在点击事件中执行 ad.clickAd({ adBizId })，实现支付宝广告投放跳转。

（5）若完成任务，在返回小游戏页面时，会触发 onTaskFinished 事件。

TIPS 1: 在调用 my.createTaskAd 之前，需判断该函数是否可用。判断方式直接判空即可: if (my?.createTaskAd) { }

TIPS 2：若没有该 API，清空缓存/重新下载后再尝试。若仍不行，请联系技术支持。

2.2 接口定义

my.createTaskAd

ITaskAdFacade

ITaskAdExposeData

该 API 的定义暂未在@mini—types/alipay 中，可下载使用类型定义。

tips：taskCategory 如提示 undefined 信息，表示未返回任务类型，如依赖该字段进行展示需做特殊逻辑处理

使用建议：

1.利用【taskCategory】和【taskRewardAmount】字段进行展示优化，例如：对任务完成度高的人群展示高价值高转化难度的任务，对任务完成度低的人群展示低转化难度任务，以提升任务完成度；

2.对任务展示进行自渲染，过长的标题文案或指向性不明确的文案根据【taskCategory】字段释义自行兼容，提高任务完成度

cocos 样例

（1）创建广告实例

（2）绑定点击事件

第三步：自助调试

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

支付宝广告位管理页面

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

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

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

支付宝广告位调试数据效验提示

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

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

三、任务状态完成查询 API 接口

使用场景：用户完成支付宝广告投放的任务后，前端组件实时发送任务完成的通知。有额外需求的开发者，通过 API 接口查询任务是否完成

。

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

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

A：确认接口使用的 adUnitId 是否上传正确，支付宝广告接口中的 adUnitId 需传入填写完整的 spaceCode 信息（后台可直接复制，示例：XX_XX）。

支付宝广告位信息提示

Q2：错误码 40003，调用接口报错，如何解决？

A：调用接口报错但无明确业务指向，建议先咨询 open api 的平台小蜜。