支付宝媒体管理平台的任务广告接入 | 支付宝的广告平台

一、支付宝任务广告概述

任务广告是小程序在运用流量位插件后，用户通过完成特定任务从而获取相应奖励的一种广告形式，其使用流程如下：

首先，用户点击“去完成”。

接着，打开待完成任务（主要涵盖浏览、留资、加关注、购买等任务类型）。

然后，灯火负责监测用户是否完成任务，对于已完成任务的用户，通过前端接口或 API 来进行任务查询。

最后，用户返回任务列表页面，开发者为完成任务的用户发放奖励。

产品特点：开发者能够依据自身需求自行设定任务广告的样式，并完成支付宝广告的渲染。

1.任务返回中包含“最大收益值”，它代表着可获得收益的上限。商家设置奖励时建议参考平台回传的字段“「最大收益值」-taskRewardAmount”，回传的预警值单位为“分”，精确到小数点后 2 位。例如：支付宝广告平台计算得出「最大收益值」为 1.88 分，那么“taskRewardAmount”应回传 1.8 分。此数值作为单个任务广告完成后，小程序媒体主可获得收益的最大值，建议奖励金额小于最大收益值。比如：支付宝广告推广主投放留资任务，CPA 设置为 9.9 元，平台将按照【990.0 分*平台系数值=最大收益值】进行回传，具体的收益空间由商家自行决定。支付宝广告平台系数值涉及平台成本等相关内容，不对外公布。若未参考平台建议而统一设置奖励值，可能会造成金额亏损。

2.任务广告每次请求会返回多条广告。建议当一条任务完成后，将该任务广告的状态从“待完成”变更为“已完成”，用户不可重复完成同一个任务。

3.完成一条任务广告后，未完成的任务可以继续展示，无需重新请求；当未完成的任务条数少于需要展示的任务条数时，可以重新请求。

4.任务完成的消息既支持前端的消息订阅，也支持开发者通过 API 接口进行查询。

任务广告样式示例：

支付宝广告任务广告样式展示

已订购过的可跳过此步骤

使用小程序所属的支付宝主账号，在能力中心进行订购

（1）在支付宝灯火平台的“流量管理”→“广告位管理”→“新建广告位”，并选择要创建广告位的应用。

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

支付宝广告选择接入方式页面

（2）广告位类型选择“任务广告”。

广告位

名称命名建议：小程序_页面_任务广告。

注意：实际单次展示的支付宝广告数量小于或等于支付宝广告最大返回条数。

支付宝广告任务广告页面

（3）通用规则配置：建议根据需求进行设置。

其中行业屏蔽：建议遵循最小化屏蔽原则，尽量放宽行业类目，以提高整体媒体收益。

支付宝广告通用规则配置案例

（4）查看 spacecode，

完成广告位创建后，点击具体广告位的“编辑”按钮，进入广告位详情页，获取 spacecode。

支付宝广告新建广告位编辑

在广告位信息中获取 spacecode，并提供给开发人员。

支付宝广告广告位信息页面

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

2.1.接入方式及步骤

1.API 调用：通过调用 createTaskAd 来获取任务列表数据以及任务更新方法

2.组件调用：引入 ad-task-component 组件，该组件支持任务跳转，开发者无需操心跳转的实现方式

接入示例–单展位接入，

在 app.json 中引入订购后的插件 xlightPlugin，之前已引入的可忽略

针对 ad-task-component 组件再做进一步解释，该组件旨在减少开发者在处理各种点击跳转时的时间成本，它封装了一个无任何样式的组件，主要负责点击跳转，内部支持打开端内页面、唤端、下载等操作。若只想让某个区域支持跳转，比如只是按钮点击跳转，那么将按钮置于该组件内即可，任务的其他内容区域则放在组件外；若希望整个任务栏都支持跳转，那么将整个任务栏置于该组件内。

1.IDE

打开时可能会出现 rpc 接口请求报错，请使用真机或模拟器进行访问

2.接口定义

ITaskSDK

ITaskAdFacade

ITaskAdExposeData

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

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

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

（1）当代码部署完成后，登录媒体管理平台

；在“广告位管理”页面下，在具体广告位“操作”模块中，点击“调试”进入小程序广告位调试页面，如下图所示：

支付宝广告自主调试页面

（2）进入调试页面后，将扫码测试的用户账号加入白名单，点击调试“开启/更新”功能，如下图所示。

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

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

说明 当前调试完成一次任务之后会重新返回浏览任务广告，可忽略重复情况。

（4）在调试过程中需要确认

曝光数与点击数需与点击广告的次数一致，例如进入页面两次均出现支付宝广告投放且点击，则曝光数与点击数都为 2，点击率为 100%。

当完成上述调试信息的确认后，点击关闭按钮即可，流量接入成功。

使用场景：

用户完成任务后，前端组件实时发送任务完成的通知。有额外需求的开发者，可通过 API 接口查询任务是否完成。