需要 read_data_report 权限点。
更多权限点使用信息,请参考:
POST https://{handle}.myshopline.com/admin/openapi/v20250601/cdp/identify.json
handle :店铺的唯一标识符,值为店铺域名的前缀。例如,域名为 open001.myshopline.com 的店铺,其 handleopen001
上报买家身份信息,用于个性化推荐和精准营销。
请求头
  • 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[]
    买家行为事件的列表。 最大个数限制:32
  • channel_type string
    营销渠道类型。
    Example: Z_store
  • type string
    买家身份类型。 最大长度限制:128
    Example: idCard
  • value string
    买家身份信息的值。
    Example: 324568754
  • user_traits map
    买家的属性,比如姓名、年龄、邮箱等等,请参照 CDP 系统里的买家属性元数据填值。
    Example: [object Object]
响应
更多状态码信息请参考 HTTP 状态码

响应头
  • traceId
    traceId
响应体
  • dataobject
    响应内容。
  • one_id string
    在 CDP 系统中一个买家的唯一 ID,这个 ID 是由 CDP 系统生成。
    Example: 0155eb0038b6f96a3b6d5f977ad076fa
  • user_traits map
    买家的属性,比如姓名、年龄、邮箱等等。
    Example: [object Object]
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601

ParamOptions

header required

Body

required
{
  "channel_id": "6689609588495885399",
  "user_id": [
    {
      "channel_type": "Z_store",
      "type": "idCard",
      "value": "324568754"
    }
  ],
  "user_traits": {}
}

Language

curl --request POST \
--url https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601/cdp/identify.json \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
--header 'Content-Type: application/json; charset=utf-8' \
--header 'accept: application/json'
Examples
上报买家身份信息
Request
{
"channel_id": "6689609588495885399",
"user_id": [
{
"type": "idCard",
"value": "32054678"
},
{
"type": "email",
"value": "example@shopline.com"
},
{
"type": "mobilePhone",
"value": "008613917692706"
},
{
"channel_type": "Z_store",
"type": "uid",
"value": "U03356"
},
{
"type": "anonymousId",
"value": "OPENAPI_TEST_ANONYMOUSID_1234567890"
}
],
"user_traits": {
"address_1": "HYATT PLACE SANJOSE AIRPORT 82 KARINA CT",
"address_2": "SAN JOSE CA 95131",
"age": 18,
"birthday": 1577808000000,
"country": "US",
"firstname": "Tao",
"language": "CN",
"lastname": "Xu",
"nickName": "Tao",
"state": "CA"
}
}
Response
{
"data": {
"one_id": "6689609588495812345",
"user_traits": {
"address_1": "HYATT PLACE SANJOSE AIRPORT 82 KARINA CT",
"address_2": "SAN JOSE CA 95131",
"age": 18,
"birthday": 1577808000000,
"country": "US",
"firstname": "Tao",
"language": "CN",
"lastname": "Xu",
"nickName": "Tao",
"state": "CA"
}
}
}
这篇文章对你有帮助吗?