需要 write_marketing_event 权限点。
更多权限点使用信息,请参考:
POST https://{handle}.myshopline.com/admin/openapi/v20240301/sales/marketing_events/sync_data.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
请求体
  • marketing_activity_datasobject[]
    营销事件数据,统计数据为全量数据
  • add_cart_sum long
    加购数
    Example: 100
  • benefit_amount long
    优惠金额
    Example: 100
  • bounced_num long
    弹回数
    Example: 100
  • check_out_sum long
    结账数
    Example: 100
  • click_num long
    点击数
    Example: 100
  • get_unit_cost long
    获得单位成本
    Example: 100
  • has_delivery_num long
    送达数
    Example: 100
  • has_send_num long
    发送数
    Example: 100
  • impression_num long
    曝光数,指展示次数
    Example: 100
  • marketing_event_id string
    营销事件的唯一id
    Example: MA_12323312324
  • new_buyer_sum long
    新客数
    Example: 100
  • occurred_on long
    发生时间,标准13位时间戳
    Example: 1672246800000
  • open_sum long
    打开数
    Example: 100
  • order_amount long
    销售额
    Example: 100
  • order_num long
    订单数
    Example: 100
  • order_product_sum long
    订单商品总数
    Example: 100
  • order_visitor_amount long
    下单用户数
    Example: 100
  • purchase_num long
    购买数
    Example: 100
  • reported_as_spam_num long
    报告为垃圾邮件数
    Example: 100
  • spend_cost long
    营销成本
    Example: 100
  • unsubscribed_num long
    取消订阅数
    Example: 100
  • visitor_amount long
    访客数
    Example: 100
响应
更多状态码信息请参考 HTTP 状态码

响应头
  • traceId
    traceId
响应体
  • sucess_count integer
    成功总数
    Example: 1
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20240301

ParamOptions

— header required

Body

required
{
  "marketing_activity_datas": [
    {
      "add_cart_sum": 100,
      "benefit_amount": 100,
      "bounced_num": 100,
      "check_out_sum": 100,
      "click_num": 100,
      "get_unit_cost": 100,
      "has_delivery_num": 100,
      "has_send_num": 100,
      "impression_num": 100,
      "marketing_event_id": "MA_12323312324",
      "new_buyer_sum": 100,
      "occurred_on": 1672246800000,
      "open_sum": 100,
      "order_amount": 100,
      "order_num": 100,
      "order_product_sum": 100,
      "order_visitor_amount": 100,
      "purchase_num": 100,
      "reported_as_spam_num": 100,
      "spend_cost": 100,
      "unsubscribed_num": 100,
      "visitor_amount": 100
    }
  ]
}

Language

curl --request POST \
--url https://openapiceshidianpu.myshopline.com/admin/openapi/v20240301/sales/marketing_events/sync_data.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
{
"marketing_activity_datas": [
{
"add_cart_sum": "200",
"benefit_amount": "300",
"check_out_sum": "50",
"click_num": "49",
"get_unit_cost": "59",
"has_delivery_num": "66",
"has_send_num": "77",
"impression_num": "88",
"marketing_event_id": "MA_5731815623023404122",
"new_buyer_sum": "20",
"occurred_on": 1672246800000,
"open_sum": "139",
"order_amount": "31000",
"order_num": "289",
"order_product_sum": "179",
"order_visitor_amount": "260",
"purchase_num": "177",
"spend_cost": "4100",
"visitor_amount": "145"
}
]
}
Response
{
"sucess_count": 1
}
这篇文章对你有帮助吗?

Error loading component.

Error loading component.