批量同步营销事件统计数据

需要 write_marketing_event 权限点。

更多权限点使用信息，请参考：

POST https://{handle}.myshopline.com/admin/openapi/v20270301/sales/marketing_events/sync_data.json

handle ：店铺的唯一标识符，值为店铺域名的前缀。例如，域名为 open001.myshopline.com 的店铺，其 handle 是 open001 。

批量同步营销事件统计数据（创建营销参与）

请求头

Content-Type string required

字段值固定为 application/json; charset=utf-8。
Authorization string required

资源的访问令牌。参考应用授权获取访问令牌，然后将获取到的访问令牌以 Bearer 格式传入。
例子:

Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6MCwiYXBwS2V5IjoiNzU2ZjI1NWE2NjdlZTcwNTk1MzM0ZjVjYzk4NzU5MzBmN2E3NGZjMSIsImV4cCI6MTg3OTQ4MjA3NiwiaXNzIjoieXNvdWwiLCJzZWxsZXJJZCI6IjIwMDAyMzQ4ODAiLCJzdG9yZUlkIjoiMTY3MjM2OTcyOTYwNiIsInRpbWVzdGFtcCI6MTc4NDc4NzY3NjY2MSwidmVyc2lvbiI6IlYyIn0.3ZzbGAH4cLU1QR2VPEvMOQInUDvus-C4amkINSQIPuNVlXsFKj0sAt1c0KnUy9MWUOFV9cHlkf7J90r2y1FzpA

请求体

marketing_activity_datasobject[]

营销事件数据，统计数据为全量数据
add_cart_sum long

加购数
例子: 100
impression_num long

曝光数，指展示次数
例子: 100
custom_sale_data_listobject[]

自定义拓展-销售数据，最多5个
value string

数据值
例子: 100
name string

数据名称，最长20个字符
例子: FackbookOrderCount
tool_tips string

提示语，最长30个字符
例子: Order from Fackbook count
type integer

数据类型,1-金额;2-百分比;3-数值
例子: 3
custom_activity_engagement_listobject[]

自定义拓展-活动参与度，最多5个
type integer

数据类型,1-金额;2-百分比;3-数值
例子: 2
value string

数据值
例子: 0.09
name string

数据名称，最长20个字符
例子: FackbookOrderConversionRate
tool_tips string

提示语，最长30个字符
例子: Fackboo order conversion rate
order_amount long

销售额
例子: 100
order_num long

订单数
例子: 100
new_buyer_sum long

新客数
例子: 100
unsubscribed_num long

取消订阅数
例子: 100
check_out_sum long

结账数
例子: 100
marketing_event_id string

营销事件的唯一id
例子: MA_12323312324
spend_cost long

营销成本
例子: 100
occurred_on long

发生时间，标准13位时间戳
例子: 1672246800000
visitor_amount long

访客数
例子: 100
click_num long

点击数
例子: 100
old_buyer_sum long

老客数
例子: 1001672246800000
bounced_num long

弹回数
例子: 100
order_product_sum long

订单商品总数
例子: 100
has_send_num long

发送数
例子: 100
has_delivery_num long

送达数
例子: 100
order_visitor_amount long

下单用户数
例子: 100
regional_visit_listobject[]

地区访问量-排行榜，最多5个
name string

名称，最长200个字符
例子: ua
count long

访问量
例子: 100
benefit_amount long

优惠金额
例子: 100
reported_as_spam_num long

报告为垃圾邮件数
例子: 100
get_unit_cost long

获得单位成本
例子: 100
product_sale_listobject[]

商品销量-排行榜，最多10个
count long

销量
例子: 100
product_id string

商品id
例子: 16062938070772167548642145
purchase_num long

购买数
例子: 100
open_sum long

打开数
例子: 100

状态码

更多状态码信息，参考 HTTP 状态码。

响应头

traceId

请求的全局唯一标识符。用于追踪请求在系统中的流转，以便于问题发生时进行定位和调试。

响应体

sucess_count integer

成功总数
例子: 1

API Explorer

调试台

Base URL

https://openapiceshidianpu.myshopline.com/admin/openapi/v20270301

ParamOptions

Authorization — header required

Body

Body required

{
  "marketing_activity_datas": [
    {
      "custom_sale_data_list": [
        {
          "value": "100",
          "name": "FackbookOrderCount",
          "tool_tips": "Order from Fackbook count",
          "type": 3
        }
      ],
      "open_sum": 100,
      "order_num": 100,
      "get_unit_cost": 100,
      "has_delivery_num": 100,
      "order_visitor_amount": 100,
      "unsubscribed_num": 100,
      "regional_visit_list": [
        {
          "name": "ua",
          "count": 100
        }
      ],
      "order_amount": 100,
      "impression_num": 100,
      "custom_activity_engagement_list": [
        {
          "name": "FackbookOrderConversionRate",
          "tool_tips": "Fackboo order conversion rate",
          "type": 2,
          "value": "0.09"
        }
      ],
      "spend_cost": 100,
      "visitor_amount": 100,
      "check_out_sum": 100,
      "occurred_on": 1672246800000,
      "benefit_amount": 100,
      "new_buyer_sum": 100,
      "reported_as_spam_num": 100,
      "purchase_num": 100,
      "add_cart_sum": 100,
      "has_send_num": 100,
      "old_buyer_sum": 1001672246800000,
      "product_sale_list": [
        {
          "count": 100,
          "product_id": "16062938070772167548642145"
        }
      ],
      "bounced_num": 100,
      "order_product_sum": 100,
      "marketing_event_id": "MA_12323312324",
      "click_num": 100
    }
  ]
}

Language

curl --request POST \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20270301/sales/marketing_events/sync_data.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6MCwiYXBwS2V5IjoiNzU2ZjI1NWE2NjdlZTcwNTk1MzM0ZjVjYzk4NzU5MzBmN2E3NGZjMSIsImV4cCI6MTg3OTQ4MjA3NiwiaXNzIjoieXNvdWwiLCJzZWxsZXJJZCI6IjIwMDAyMzQ4ODAiLCJzdG9yZUlkIjoiMTY3MjM2OTcyOTYwNiIsInRpbWVzdGFtcCI6MTc4NDc4NzY3NjY2MSwidmVyc2lvbiI6IlYyIn0.3ZzbGAH4cLU1QR2VPEvMOQInUDvus-C4amkINSQIPuNVlXsFKj0sAt1c0KnUy9MWUOFV9cHlkf7J90r2y1FzpA' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'

这篇文章对你有帮助吗？

SHOPLINE

条款协议