| 请求方法 | post |
|---|
| 请求地址 | /api/v1/user/register/ |
query 参数
| 参数名称 | 必填 | 参数类型 |
|---|
| access_token | Y | 当前 app 的 access_token |
body 参数
| 名称 | 必填 | 类型 | 描述 |
|---|
| client_id | Y | string | 用户在业务的唯一标识字符串（唯一 ID） |
| name | Y | string | 用户名 |
| channel | Y | string | 用户注册渠道 |
| version | Y | integer | 用户注册的版本 |
| wx_openid | N | string | 用户 wxopenid 微信小程序和小游戏必填 |
| wx_unionid | N | string | 微信 union_id 微信小程序和小游戏选填 优先回传 wx_openid |
| ad_data | N | struct | 结构体，微信小程序和小游戏必填，不同媒体平台参数不一样，详情参考下文 |
| device_info | N | struct | 结构体，ios 或安卓应用才 选填。(建议由服务器端上报时才携带) |
| client_ip | N | string | 用户注册时的 ip 地址（服务器端上报时必填，客户端上报时会自动采集） |
| client_ua | N | string | 用户注册时的 UserAgent（服务器端上报时必填，客户端上报时会自动采集） |
ad_data 结构体
提示
针对不同的媒体平台，ad_data 结构体详细信息如下
腾讯广告（广点通）
| 参数名 | 对应含义 | 值 |
|---|
| gdt_vid | 广告 traceid（点击 id） | wx0ewinbalytptma00（示例） |
百度广告
| 参数名 | 对应含义 | 值 |
|---|
| bd_vid | 广告点击、曝光唯一标识 | NuadwUSnqdLUdaq（示例） |
快手广告
| 参数名 | 对应含义 | 值 |
|---|
| callback | 快手归因参数 | mGDiBa_h5yK67Qbz7n_D8nQ20rxPfrrbQ8s806l10YBkNtf9izf3493pBwWB9SvfPF4CuP_LInPFTedtlgD0LAqFVOzGUT-i-Qh8ZJ7-_zaFYS1zGa5VKouNj910olWYwyJKLcKFxzrpk7VxLEhDvzD7gFVypFTSMMS75YZbmQc（示例） |
| ksCampaignId | 计划 id | 20316591978（示例） |
| ksUnitId | 组 id | 24148178（示例） |
| ksCreativeId | 创意 id | 12313131001（示例） |
| ksChannel | 流量来源 | kuaishou（示例|固定值） |
头条（巨量广告）
| 参数名 | 对应含义 | 值 |
|---|
| clue_token | 头条归因参数 | |
| ad_id | 计划 id | 1732611111122851（示例） |
| creative_id | 创意 id | 1732600000022851 （示例） |
| advertiser_id | 广告主账户 id | 1731111111147918（示例） |
| request_id | 请求下发的 id | 2022051321442401014020517101987A18（示例） |
Apple Search Ads：asa
| 参数名 | 类型 | 示例值 |
|---|
| attribution | string | true |
| orgId | integer | 40669820 |
| campaignId | integer | 542370539 |
| conversionType | string | "Download" |
| clickDate | string | "2020-04-08T17:17Z" |
| adGroupId | integer | 542317095 |
| countryOrRegion | string | "US" |
| keywordId | integer | 87675432 |
| adId | integer | 542317136 |
device_info 结构体
略，具体见 设备信息上报中的 <device_info 结构体>
请求示例
curl 'https://backend.gravity-engine.com/event_center/api/v1/user/register/?access_token=<ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"client_id": "123",
"name": "turbo",
"channel": "default",
"version": 1,
"wx_openid": "",
"wx_unionid": "",
"ad_data": {}
}'
应答示例
{
"data": {
"token": "*****"
},
"extra": {},
"code": 0,
"msg": "成功"
}
