Requires write_marketing_event access scope.
For more info , refer to:
POST https://{handle}.myshopline.com/admin/openapi/v20230901/sales/marketing_events/sync_data.json
handle : The store's unique identifier, which is the prefix of the store's domain name. For example, if a store's domain name is open001.myshopline.com , the store handle is open001 .
Request Headers
  • Content-Type required
    The value of this field is fixed to application/json; charset=utf-8
  • Authorization string required
    The access token for the API. Please refer to App authorization to obtain the access token, and then put the obtained access token into the API request header in Bearer Token.
    Example:
    Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
Request Body
  • marketing_activity_datasobject[]
    Marketing event data , statistics are full data
  • add_cart_sum long
    Additional purchases
    Example: 100
  • benefit_amount long
    Discount amount
    Example: 100
  • bounced_num long
    bounced num
    Example: 100
  • check_out_sum long
    Checkout number
    Example: 100
  • click_num long
    Click count
    Example: 100
  • get_unit_cost long
    Get unit cost
    Example: 100
  • has_delivery_num long
    Number of deliveries
    Example: 100
  • has_send_num long
    Number of send
    Example: 100
  • impression_num long
    Exposure number , refers to the number of displays
    Example: 100
  • marketing_event_id string
    Yingxiao id for marketing events
    Example: MA_12323312324
  • new_buyer_sum long
    New guest number
    Example: 100
  • occurred_on long
    Time to happen , standard 13- digit stamp
    Example: 1672246800000
  • open_sum long
    Number of open
    Example: 100
  • order_amount long
    Sales
    Example: 100
  • order_num long
    Order qty
    Example: 100
  • order_product_sum long
    Order Product total number
    Example: 100
  • order_visitor_amount long
    Number of users ordered
    Example: 100
  • purchase_num long
    Number of purchases
    Example: 100
  • reported_as_spam_num long
    reported as spam num
    Example: 100
  • spend_cost long
    Marketing cost
    Example: 100
  • unsubscribed_num long
    unsubscribed num
    Example: 100
  • visitor_amount long
    Number of visitors
    Example: 100
Response
For more information about status codes, see Http status code.

Response Headers
  • traceId
    traceId
Response Body
  • sucess_count integer
    Success total number
    Example: 1
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20230901

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/v20230901/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
Batch sync successful marketing event statistics
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
}
Was this article helpful to you?

Error loading component.

Error loading component.