开放平台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_id是string消息ID,发送失败重试时id不变
msg_type是string固定为”link_attribution”
msg_time是number消息生成时间戳
project_id是string项目ID
msg_data.link_template是string模板id
msg_data.short_hash是string短链hash
msg_data.long_hash是string链接长hash,唯一标识
msg_data.link_url是string链接地址
msg_data.link_tag是[]string链接标签
msg_data.user_id是string用户id
msg_data.invite_user_id是string邀请用户id(需创建深度链接时带上unique_mark字段标识)
msg_data.attributing_device_status是number归因设备状态: 0旧设备 1新设备
msg_data.trigger_event是string触发事件: install安装 reinstall重新安装 open打开 reopen后台切换打开 register注册 login登录
msg_data.event_time是number事件时间戳,单位秒
msg_data.link_data是[]object归因中的所属链接相关LinkData数据
msg_data.link_data.key是string自定义参数键,包括utm数据
msg_data.link_data.value是string自定义值

响应处理

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

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