一、API方案介绍
在微信广告推广APP应用程序时，用户下载APP应用程序会产生对应的转化行为（如激活、注册等），为了量化微信朋友圈转化效果，以及积累转化数据以使用智能优化（oCPM/oCPA）能力，需要回传用户的转化行为。本API解决的是APP行为数据回传的问题
说明：
1）此文档说明与技术开发紧密相关，建议广告主运营人员在开发人员指导下阅读； 2）联调时，请以回传示例格式为准，确保联调正常；
使用须知
（一） 对接流程简介
特别说明：请使用已开通微信广告主身份的公众号或小程序身份进行联调，小游戏和游戏类小程序无法调用联调。
1、在微信公众平台的『开发』—『基本配置』中注册成为开发者；
2、创建转化数据对应的数据源；
3、获取用户设备号（IMEI/IDFA），并进行加密处理，根据转化行为、推广目标，选择对应的行为类型回传数据，构造请求回传数据至对应的行为源，需要确保回传成功；
4、例行化：确保线上实际投放时，用户发生转化后，会自动实时运行步骤2，调用API回传数据，并回传成功；
5、验证：判断步骤3是否正常运行；
注：
1、对于二次接入本API的广告主账号，可以跳过1、2步骤；
2、需要通过点击转发获取点击微信广告的用户详细信息，用于内部归因或用户冷启动，详见点击转发使用说明
(二) 问题咨询流程
开发过程中遇到任何问题可以参考以下流程解决:
1、查看FAQ中是否有类似的问题；
2、根据【行为数据回传附录-返回码】，查询是否有相关说明，如果未检索到对应内容，访问公众平台开发者文档再次查询；
3、参见【行为数据回传附录-问题咨询流程】对接人工客服；
使用背景
(一) 目前支持的行为类型以及对应的智能投放优化目标、数据指标如下：
| 行为名称 | ActionType | 推广目标 | 数据指标 | 说明 |
|---|---|---|---|---|
| 激活 | ACTIVATE_APP | 推广我的应用 | APP激活次数 | 用户下载应用后首次打开的操作行为。 |
| 注册 | REGISTER | 推广我的应用 | APP注册次数 | 用户在应用内完成注册，如手机号码验证、注册应用下账户、创建游戏角色、通过QQ微信号等方式通过授权或其他类注册行为 |
| 加入购物车 | ADD_TO_CART | 推广我的应用 | APP加入购物车次数 | 用户在应用内发起购买而未完成付费的行为，如加入购物车、下单等。 |
| 付费 | PURCHASE | 推广我的应用 | APP付费次数 | 用户在应用内进行付费，完成了交易的操作行为。 |
| 次留 | START_APP | 推广我的应用 | 暂无 | 用户完成应用激活后，第二天继续进入APP |
（二）目前支持的微信小视频广告流量包括
1、微信公众号底部和文中：品牌活动推广、电商推广、销售线索收集广告的H5落地页；
2、微信信息流广告：品牌活动推广、本地推广、电商推广、销售线索收集广告的H5落地页；
原理介绍
（一）对于推广微信APP广告，用户通过广告下载安装并使用对应APP后，APP可以获取用户手机的设备号信息，如Android的IMEI、iOS的IDFA信息，设备号信息作为广告主与广告平台共同使用的用户标识；
（二）回传转化数据时，需要回传转化行为与对应的设备号信息，广告平台会通过设备号关联到该次转化对应的微信公众号广告点击，从而得到广告点击与广告后端转化的关联。
（三）关联后计算的微信广告效果会呈现在MP投放端报表中（mp.weixin.qq.com），并会成为智能优化的数据基础。
二、对接步骤
准备阶段:成为为公众平台开发者，创建数据源
（一）注册成为开发者
目标：获取开发者ID、密码和access_token
步骤∶
特别说明：请使用已开通广告主身份的公众号或小程序身份进行联调。
1、进入注册页面，点击左边栏，『开发』下『基本配置』。同意《微信公众平台开发者服务协议》后，点击『成为开发者』;
2、获取开发者密码。点击“重置”按钮：
3、弹窗提示，点击“确定重置”按钮：
4、点击“开始”按钮：
5、选择验证方式进行验证：
6、验证完成之后扫码绑定微信号，绑定成功后重置开发者密码。然后微信上点击确认，进行第二步密码验证：
7、密码验证后，即可查看开发者密码。由于开发者密码不会直接显示在MP后台，因此需要开发者保存。开发者密码为重要账号凭据，建议不要外传。
8、获取access_token。在开发——基本配置中点击“获取access_token”,用之前注册的开发者id和生成的开发者密码调用接口获取access_token。
（二） 创建数据源
目标：创建数据源，生成数据源ID（user_action_set_id）
步骤：
1、构造请求，创建数据源；
2、保存数据源ID，用于后续回传数据；
请求地址： user_action_sets/add
请求方法： POST
请求参数：
-
名称 类型 描述 Type enum 用户行为源类型，IOS或ANDROID mobile_app_id integer 应用 id，必填字段; Name string 用户行为源名称，必填 description string 用户行为源描述，字段长度最小 1 字节，长度最大 128 字节
