上报买家身份信息
POST https://{handle}.myshopline.com/admin/openapi/v20250601/cdp/identify.json
handle
:店铺的唯一标识符,值为店铺域名的前缀。例如,域名为 open001.myshopline.com
的店铺,其 handle
是 open001
。上报买家身份信息,用于个性化推荐和精准营销。
请求头
- Content-Type required字段值固定为
application/json; charset=utf-8
- Authorization string required资源的访问令牌。请参考 应用授权 获取访问令牌,然后将获取到的访问令牌以 Bearer 格式传入Example:
Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
请求体
- channel_id string required营销渠道实例 ID,CDP 系统生成的。Example:
6689609588495885399
user_idobject[]
买家行为事件的列表。 最大个数限制:32channel_type string营销渠道类型。Example:Z_store
type string买家身份类型。 最大长度限制:128Example:idCard
value string买家身份信息的值。Example:324568754
- user_traits map买家的属性,比如姓名、年龄、邮箱等等,请参照 CDP 系统里的买家属性元数据填值。Example:
[object Object]
响应
- 200
- 401
- 403
- 429
更多状态码信息请参考 HTTP 状态码
响应头
traceId
traceId
响应体
dataobject
响应内容。one_id string在 CDP 系统中一个买家的唯一 ID,这个 ID 是由 CDP 系统生成。Example:0155eb0038b6f96a3b6d5f977ad076fa
user_traits map买家的属性,比如姓名、年龄、邮箱等等。Example:[object Object]
API Explorer
调试台
示例代码
这篇文章对你有帮助吗?