概述
在使用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,共回调6次;