v2.ads.get_all_cpc_ads_hourly_performance

GET /api/v2/ads/get_all_cpc_ads_hourly_performance

Sử dụng API này để lấy hiệu suất theo giờ trong một ngày của quảng cáo CPC cấp Cửa hàng.

Đường dẫn Endpoint

URL: https://partner.shopeemobile.com/api/v2/ads/get_all_cpc_ads_hourly_performance

Tham số chung

Tên	Kiểu	Mẫu	Mô tả
partner_id	int	1	Partner ID được cấp khi đăng ký thành công. Bắt buộc cho mọi yêu cầu.
timestamp	timestamp	1610000000	Dùng để xác định thời điểm của yêu cầu. Bắt buộc cho mọi yêu cầu. Hết hạn sau 5 phút.
access_token	string	c09222e3fc40ffb25fc947f738b1abf1	Token truy cập API, dùng để xác định quyền của bạn. Có thể dùng nhiều lần và hết hạn sau 4 giờ.
shop_id	int	600000	Mã định danh duy nhất của Shopee cho cửa hàng. Tham số bắt buộc cho hầu hết các API.
sign	string	e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2	Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

Tham số Request

Tên	Kiểu	Bắt buộc	Mẫu	Mô tả
performance_date	string	True	17-03-2021	Tham số ngày đơn mà người yêu cầu muốn kiểm tra hiệu suất theo giờ. Ngày theo định dạng DD-MM-YYYY.

Tham số Response

Tên	Kiểu	Mẫu	Mô tả
error	string		Mã lỗi, để trống khi không có lỗi
message	string		Mô tả lỗi
warning	string		Nếu một số dữ liệu không thể phản hồi bình thường, đặt cảnh báo
request_id	string	6f235f4a343e4feb8a9ed74c439f6663	request id là duy nhất cho mỗi yêu cầu
response	object[]		Nội dung phản hồi
hour	int32	13	Tham số xác định bản ghi hiệu suất thuộc giờ nào.
date	string	17-03-2021	Tham số xác định bản ghi hiệu suất thuộc ngày nào.
impression	int32	123456	Số lần người mua nhìn thấy quảng cáo
clicks	int32	123456	Tổng số lần nhấp vào Quảng cáo
ctr	float	1.23	CTR, tỷ lệ nhấp đo tần suất người mua nhìn thấy quảng cáo và nhấp vào. CTR = Số nhấp / Số hiển thị
direct_order	int32	123456	Buyer place an order within 7 days after clicking on the ads (item gets purchased from the clicked ads). Please kindly note that the direct_order in the API reflected to Seller Center Shopee Ads Module FE is Direct Conversions.
broad_order	int32	123456	Buyer place an order within 7 days after clicking on the ads; (the item gets purchased as long as there are other items from the same shops got click.) Please kindly note that the broad_order in the APIreflected to Seller Center Shopee Ads Module FE is Conversions.
direct_conversions	float	1.23	Ad orders / total number of clicks on the Ad. (item gets purchased from the clicked ads.) Please kindly note that the direct_conversions in the API reflected to Seller Center Shopee Ads Module FE is the Direct Conversion Rate
broad_conversions	float	1.23	Đơn hàng quảng cáo / tổng số nhấp vào Quảng cáo. (sản phẩm được mua miễn là có sản phẩm khác từ cùng cửa hàng được nhấp). Lưu ý: broad conversions trong API tương ứng với Conversion Rate trên Seller Center Shopee Ads Module FE
direct_item_sold	int32	123	Sản phẩm được bán trong vòng 7 ngày sau khi nhấp vào quảng cáo. (sản phẩm được mua từ quảng cáo đã nhấp.)
broad_item_sold	int32	123	Sản phẩm được bán trong vòng 7 ngày sau khi nhấp vào quảng cáo. (sản phẩm được mua miễn là có sản phẩm khác từ cùng cửa hàng được nhấp.)
direct_gmv	float	1.23	Tổng doanh thu từ Quảng cáo trong khoảng thời gian nhất định, thường 7 ngày. (sản phẩm được mua từ quảng cáo đã nhấp.)
broad_gmv	float	1.23	Tổng doanh thu từ Quảng cáo trong khoảng thời gian nhất định (sản phẩm được mua miễn là có sản phẩm khác từ cùng cửa hàng được nhấp.)
expense	float	1.23	Chi tiêu Quảng cáo
cost_per_conversion	float	1.23	(Chi phí mỗi chuyển đổi) Chi phí trung bình mỗi chuyển đổi bán hàng của Quảng cáo
direct_roas	float	1.23	Ad GMV/Chi tiêu Quảng cáo. (item gets purchased from the clicked ads.)
broad_roas	float	1.23	Ad GMV/Chi tiêu Quảng cáo. (the item gets purchased as long as there are other items from the same shops got click.)