4. 转化上报灵蹊 – API回传

第三方上传转化数据到灵蹊平台主要分为如下几个步骤

1、进入灵蹊产品,进入账户管理,打开转化设置,配置转化类型(如图1)

图1

2、创建转化,会自动生成转化id,填写转化名称并选择转化类型(如图2)

图2

3、选择追踪方式为API回传(图3)

图3

4、根据生成的API回传格式构建请求数据(格式如下)
curl -H "Content-Type:application/json" -X POST -d '{"lxTracingId":"${url获取}","cvId":"${cvId}","cvType":"${cvType}"}' "https://agent.getlingxi.com/api/conversion/upload"

如上述代码

请求方式:HTTP POST
请求数据格式:Content-Type:”application/json”
请求地址:https://agent.getlingxi.com/api/conversion/upload
发送数据:
{
    "lxTrackingId":"eyJwcm9maWxlSWQiOiI4YmQwYWRjYi02YTJjLTQ2MTUtODAzZi0yMjkwMGJmZGQzN2IiLCJwYWdldmlld0lkIjoiZTU3MjhkMjctMzJlMS00OTFiLTk3MWUtZDE2ZjBmMGZhNzRjIiwidHlwZSI6ImxlYWQifQ==",
    "cvId":"xxxxx-xxxx-xxxxx-xxxxx-xxxx",//上述创建阶段配置
    "cvType":"转化类型" //配置阶段配置
}

参数说明:

lxTrackingId:在灵蹊页面跳转到第三方页面时,需要获取(通过analytics.page.getTrackingId()获取)并传递该参数,第三方页面可直接在url中获取。

cvId: 转化id,创建转化时生成。

cvType:转化类型,创建转化时根据选择的转化类型生成

5、确认上报结果

{ status:"success", errorCode:null, errorMsg:null}

响应结构说明:
status 成功取值“succes”,失败取值“failed”,此时errorCode 和 errorMsg会打印相关错误信息

发表评论