promotion_update_push
Last Updated: 18 Aug 2022
Thông số cơ bản
| Property | Value |
|---|---|
| Category | Marketing Push |
| Push Mechanism Name | promotion_update_push |
| Push Mechanism Code | 9 |
| Push Mechanism Description | Get the promotion update |
| Push Mechanism Subscription Rules | Original/ERP System/Seller In House System/Product Management/Marketing/Customized APP/Swam ERP |
| Time Out Seconds | 3s |
| Sequence Guaranteed | No |
| Can Repeated Same Message | Yes |
| Retry Seconds | 300s,1800s,10800s |
Tham số Push
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| data | object | ||
| shop_id | int | 122406687 | Mã định danh duy nhất của Shopee cho một cửa hàng. |
| promotion_id | int | 965808642693807 | Mã định danh của chương trình khuyến mãi sản phẩm. |
| promotion_type | string | seller_discount | Loại khuyến mãi. Loại: seller_discount / product_promotion_SG / product_promotion_MY / product_promotion_ID / product_promotion_VN / product_promotion_TW / product_promotion_TH / product_promotion_PH / flash_sale (bao gồm: in_shop_flash_sale, flash_sale, brand_sale) / add_on_deal_main / add_on_deal_sub / bundle_deal / group_buy |
| end_time | timestamp | 1660123171 | Thời điểm kết thúc khuyến mãi. |
| action | string | promo_time_updated | Hành động của sự kiện. Hành động: added_in_promo / removed_from_promo / promo_time_updated |
| item_id | int | 89526059511 | Mã định danh duy nhất của Shopee cho một sản phẩm. |
| variation_id | int | 163967197734 | Mã định danh duy nhất của Shopee cho một biến thể của sản phẩm. |
| shop_id | int | 122406687 | Mã định danh duy nhất của Shopee cho một cửa hàng. |
| code | int | 9 | Mã định danh duy nhất của Shopee cho một thông báo push. |
| timestamp | timestamp | 1660123173 | Thời điểm cho biết tin nhắn đã được gửi. |
We will push messages when these three events occur：
- item is added in a promotion
- item is removed from a promotion
- promotion start /end time is updated
Push logic:
1.when item is added in a promotion:
- for reserved stock promotion（flash_sale/product_promotion），reserved_stock = reserved stock qty ；
- for non-reserved stock promotion，reserved_stock field won't return
- action = added_in_promo；
Json
{"data":{"shop_id":712661865,"promotion_id":22775521,"promotion_type":"bundle_deal","start_time":1660124460,"end_time":1661943600,"action":"added_in_promo","item_id":14662380213,"variation_id":0},"shop_id":712661865,"code":9,"timestamp":1660124466}
2.when item is removed form a promotion:
- for reserved stock promotion（FS/PP），reserved_stock = the stock qty (the latest value)；
- action= removed_from_promo；
- there is one cases when item is removed form a promotion:
item is rejected/deleted，promotion still valid, notification will return the unique item that removed from a promotion;
Json
{"data":{"shop_id":526225965,"promotion_id":668908774363077,"promotion_type":"seller_discount","action":"removed_from_promo","item_id":20332329221,"variation_id":145413438373},"shop_id":526225965,"code":9,"timestamp":1660124435}
3.when promotion start/end time is update (include upcoming and ongoing promotion):
- promotion_status = normal；
- action= promo_time_updated;
- start_time/ end_time return the updated start/end time；
- no reserved stock field
Json
{"data":{"shop_id":722406687,"promotion_id":665808642693807,"promotion_type":"seller_discount","end_time":1660123171,"action":"promo_time_updated","item_id":19526059511,"variation_id":163767197734},"shop_id":722406687,"code":9,"timestamp":1660123173}
Lịch sử cập nhật
| Ngày | Chi tiết cập nhật |
|---|---|
| 2022-08-18 | New Push Mechanism |