赶知识网

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

2022-12-08 / 679次点击 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 电话回拨

 


Top10

沪ICP备09053415号 © 赶知识网