腾讯广告Web转化数据API自归因文档

 
php/mysql/apache

post形式上报示例二：未填写点击转发链接，上报clickid
使用此方式时，必须在url字段中填写投放落地页链接，且必须与创建转化时填写的网页链接保持一致

curl -X POST
  http://tracking.e.qq.com/conv
  -H 'Content-Type: application/json'
  -H 'cache-control: no-cache'
  -d '{    "actions":[
        {            "outer_action_id":"outer_action_identity",// 选填，若上报可能有重复请填写该id，系统会根据该ID进行去重，详见FAQ            "action_time":1492998081,            "user_id":{//user_id，可采集到的设备标示                "hash_imei":"7a4e6b9571b8911f9a035b3a76228ef7",// 示例，请勿直接上报，android设备上报imei                "hash_idfa":"abbaa569f8ab7cb1715c8aabe1db1247",// 示例，请勿直接上报，ios设备上报idfa                "hash_android_id":"",                "oaid":""
                "hash_oaid":""
                "ip":“”
                “user_agent":""
                "wechat_openid":"",//当为小程序类、公众号和企业微信转化时，此字段与wechat_unionid必传其一
                "wechat_unionid":'''',//当为小程序类、公众号和企业微信转化时，此字段与wechat_openid必传其一
                "wechat_app_id":"",//用户发生该行为对应的小程序或公众号appid，当填入wechat_openid时，该字段必填，并确保账户对该appid进行了授权
            },
            "action_type":"ACTIVATE_APP", // 必填 行为类型
            "url": "www.my.com",  // 网页域名, 选填
            "trace": {
            "click_id":"abc" // 必填 click_id
            },
            "action_param":{
            ......
            }
        }
    ]
}'

 
get形式上报示例：

curl 'http://tracking.e.qq.com/conv/web?clickid=5p76exycaaapu6n3tpqq&action_time=1606877439&action_type=DELIVER&link=www.xxx.com'// clickid// action_time: 用户转化行为发生时间（秒）// action_type: 转化行为类型// link：URLencode之后的域名，请保持与创建转化时填写的网页链接对应

 
当请求API后，收到返回值为{"code":0, "message":""} 表示广告平台成功收到数据
注意：
小程序类的转化数据上报必须填写创建转化时的小程序的APPID (以wx开头)。
上报地址__CALLBACK__是直接从点击转发出去的__CALLBACK__字段中URLDecode获得，上面示例中的url&path是示例请求，请勿直接上报。
 

二. 确定行为类型
在数据上报接口的必填字段action_type中，填写需要上报的转化行为类型。
常用Web类行为类型请见下表，完整转化行为请参考 Action_type标准行为类型枚举

优化目标名称标准行为（action_type）行为参数（action_param)投放端指标备注
预约RESERVATION


注册REGISTER
注册量
咨询CONSULT


付费PURCHASE
付费行为量若要上报金额请在param中添加参数“value”：123
下单COMPLETE_ORDER
下单量若要上报金额请在param中添加参数“value”：123
关键页面浏览VIEW_CONTENT
关键页面浏览量
商品页浏览VIEW_CONTENTobject=PRODUCT商品页浏览量
完件/进件APPLY
金融完件量
有效综合线索CONFIRM_EFFECTIVE_LEADS
有效线索量
授信CREDIT
金融授信量
加企业微信客服SCANCODE
加企业微信客服次数

 

三. 转化上报常用参数列表（action_param）

参数名类型描述是否必填取值范围备注
valueint订单价值，单位：分否—体现转化带来的价值，在上报COMPLETE_ORDER或PURCHASE行为时可选填
objectstring行为对象否^.{0,200}$在上报VIEW_CONTENT行为时参数填写为object=product，表示上报的是商品页面浏览行为
consult_typestring咨询类型否^.{0,200}$MAKE_PHONE_CALL 电话咨询、ONLINE_CONSULT 网页咨询和RESERVE_PHONE_NUMBER 电话回拨

 


有话要说