Shopee Ads¶
Đang chạy production
Kết nối qua nút Cấp quyền trong portal, cùng chỗ với shopee — không
còn quy trình riêng qua Logidata.
Base URL:
Vì sao tách khỏi shopee¶
Shopee cấp cho mỗi loại tích hợp một partner app riêng với cặp khoá riêng —
bán hàng, quảng cáo và affiliate không dùng chung. Thay vì giấu việc chọn khoá
trong một nhánh if bên trong, Logidata tách thành nền tảng riêng ở URL:
/v1/shopee/ và /v1/shopee-ads/.
Tính riêng một kết nối
shopee-ads cấp quyền riêng với shopee, nên cùng một shop dùng cả hai
tính 2 kết nối trong hạn mức gói, không phải một.
Nhóm dữ liệu¶
| Nhóm | Đường dẫn gốc | Dùng để |
|---|---|---|
| Hiệu quả CPC theo ngày | /api/v2/ads/get_all_cpc_ads_daily_performance |
Chi phí, hiển thị, click, đơn và doanh thu quy cho quảng cáo, theo từng ngày |
Đây là endpoint chính cho báo cáo hiệu quả quảng cáo Shopee, và là endpoint pipeline nội bộ của Logidata đang dùng.
Ràng buộc cần biết¶
Tối đa 15 ngày mỗi lần gọi
get_all_cpc_ads_daily_performance chỉ nhận cửa sổ tối đa 15 ngày. Muốn
kéo một quý lịch sử, bạn phải chia thành nhiều lần gọi liên tiếp. Hãy tính
số request này vào hạn mức khi backfill.
Số liệu quảng cáo hôm nay chưa chốt. Như mọi nền tảng, chỉ số trong ngày còn được điều chỉnh. Kéo lại vài ngày gần nhất mỗi lần chạy nếu bạn cần con số ổn định.
Chi phí quảng cáo và doanh thu đơn hàng là hai nguồn khác nhau. Ghép được chúng thành một bảng lãi lỗ là việc của tầng chuẩn hoá, không phải của API thô.
Xác thực và mã lỗi¶
Giống hệt mọi nền tảng khác — X-API-Key + X-Account-Id. Chữ ký HMAC và việc
chọn đúng cặp khoá partner quảng cáo do Logidata lo. Xem Xác
thực và Mã lỗi.