开放平台X-Reach回调链接归因回调

概述

在使用X-Reach深度链接投放时,用户通过链接下载安装/打开(包括延迟深度链接)App时,以及通过链接进入APP后注册,TurboLink会向您的服务器发送一个回调。

请求头参数

  • 请求方法:POST
  • 内容类型:application/json
  • 请求认证:Authorization: Bearer md5(OpenSecret+(空格)+md5(请求body))

请求参数

请求包体:

{
    "msg_id": "kdiejsuehd73jf84kfde",
    "msg_type": "link_attribution",
    "msg_time": 1692668795,
    "project_id": "项目id",
    "msg_data":{
        "link_template": "模板id",
        "short_hash": "链接短hash",
        "long_hash": "链接长hash,唯一标识",
        "link_url": "https://test.allapp.link/1054/47kihy",
        "link_tag": ["标签1", "标签2"],
        "user_id": "用户id",
        "invite_user_id": "邀请用户id",
        "attributing_device_status": 0, // 归因设备状态: 0旧设备 1新设备
        "trigger_event": "register",
        "event_time": 1692668795,
        "link_data": [
            { "key": "key1", "value": "value1"},
            { "key": "key2", "value": "value2"}
        ],
    }
}

参数说明:

参数必须类型说明
msg_idstring消息ID,发送失败重试时id不变
msg_typestring固定为”link_attribution”
msg_timenumber消息生成时间戳
project_idstring项目ID
msg_data.link_templatestring模板id
msg_data.short_hashstring短链hash
msg_data.long_hashstring链接长hash,唯一标识
msg_data.link_urlstring链接地址
msg_data.link_tag[]string链接标签
msg_data.user_idstring用户id
msg_data.invite_user_idstring邀请用户id(需创建深度链接时带上unique_mark字段标识)
msg_data.attributing_device_statusnumber归因设备状态: 0旧设备 1新设备
msg_data.trigger_eventstring触发事件: install安装 reinstall重新安装 open打开 reopen后台切换打开 register注册 login登录
msg_data.event_timenumber事件时间戳,单位秒
msg_data.link_data[]object归因中的所属链接相关LinkData数据
msg_data.link_data.keystring自定义参数键,包括utm数据
msg_data.link_data.valuestring自定义值

响应处理

当回调处理成功之后,请返回200状态码,以及在响应内容中返回字符串success

当服务器收不到上述状态码及响应内容返回,重试频率为15s/15s/30s/3m/10m/20m,共回调6次;