一、API方案介绍

在公众号广告投放平台推广小游戏时，用户进入小游戏之后会产生对应的行为（如注册、付费等），为了量化小游戏广告用户的转化效果，需要回传用户的转化行为。本API解决的是小游戏内用户行为回传的问题。

说明：

1）此文档说明与技术开发紧密相关，建议广告主运营人员在开发人员指导下阅读；

2）联调时，请以回传示例格式为准，确保联调正常；

使用须知

（一）对接流程简介

特别说明：请使用已开通广告主身份的公众号或小程序身份进行联调，小游戏和游戏类小程序无法调用联调。

1.对于广告主账号与所推广的小游戏为同公司/个人主体时：在微信公众平台的『开发』—『基本配置』中注册成为开发者；

2.对于广告主账号与所推广的小游戏为不同公司/个人主体时：需要先通过跨主体回传功能获取小游戏账号授权，即回传的广告主账号需要获取小游戏账号的授权。

3.创建转化数据对应的数据源；

4.获取用户openid，根据转化行为、推广目标，选择对应的行为类型回传数据，构造请求回传数据至对应的行为源，需要确保回传成功；

5.例行化：确保线上实际投放时，用户发生转化后，会自动实时运行步骤2，调用API回传数据，并回传成功；

6.验证：判断步骤4是否正常运行；

注：对于二次接入本API的广告主账号，可以跳过1、2步骤；

(二)问题咨询流程

开发过程中遇到任何问题可以参考以下流程解决

1.根据【行为数据回传附录-返回码】，查询是否有相关说明，如果未检索到对应内容，访问公众平台开发者文档再次查询；

2.对接人工客服

原理介绍

1.对于小程序/小游戏的用户，每个用户都会生成一个openid，将openid与小程序appid作为转化数据的标识之一回传广告平台。

2.广告平台会通过openid和appid关联到之前投放的小程序/小游戏广告，从而得到用户行为与推广广告的关联。

3.关联后计算的广告效果会呈现在公众号广告投放报表中，并会成为后续智能优化的数据基础。

二、对接步骤

概览

1、准备阶段

2、正式对接

3、例行化

确保线上实际投放时，用户发生转化后，会自动实时运行『2;、正式对接』

4、验证

调用API回传数据，并回传成功，共分为4个阶段：