Phương thức: GET /advertiser/listStats
Mô tả: Bạn có thể truy xuất thống kê cho các chiến dịch quảng cáo được tạo trong tài khoản quảng cáo HilltopAds của bạn.
Tham số:
Tên | mô tả | ví dụ | ghi chú |
key | Một khóa API duy nhất mà bạn có thể tạo trong phần API của tài khoản HilltopAds của bạn | nXzgO3Bc | Đây là một tham số bắt buộc trong yêu cầu. |
Date | Ngày mà bạn cần lấy dữ liệu thống kê. | 2023-01-01 | Mặc định, phản hồi sẽ cung cấp thống kê cho ngày hôm qua. |
Date2 | Chỉ định tham số này nếu bạn cần thống kê cho một khoảng thời gian cụ thể. | 2023-01-31 | Ngày này sẽ được coi là ngày cuối cùng của khoảng thời gian và tham số ngày sẽ là ngày đầu tiên. |
GEO | Chỉ định tham số này nếu bạn cần thống kê cho các quốc gia cụ thể. | UK | Để lấy dữ liệu cho nhiều quốc gia, liệt kê chúng cách nhau bằng dấu phẩy. |
zoneID | Chỉ định tham số này nếu bạn cần thống kê cho các vùng cụ thể. | 4OACSGAI8 | Để lấy dữ liệu cho nhiều vùng, liệt kê chúng cách nhau bằng dấu phẩy. |
campaignID | Chỉ định tham số này nếu bạn cần thống kê cho các chiến dịch cụ thể. | 123456 | Để lấy dữ liệu cho nhiều chiến dịch, liệt kê chúng cách nhau bằng dấu phẩy. |
adID | Chỉ định tham số này nếu bạn cần thống kê cho các quảng cáo cụ thể. | 123456 | Để lấy dữ liệu cho nhiều quảng cáo, liệt kê chúng cách nhau bằng dấu phẩy. |
group | Chỉ định tham số này để nhóm dữ liệu. | ngày | Bạn có thể nhóm theo: ngày, giờ, GEO, zoneID, campaignID, adID. |
Ví dụ yêu cầu:
Để lấy thống kê cho chiến dịch 123456 cho khoảng thời gian từ ngày 1 tháng 2 đến ngày 31 tháng 3, 2023, được nhóm theo ngày, bạn cần viết yêu cầu sau:
https://hilltopads.com/api/advertiser/listStats?key=nXzgO3Bc&date=2023-02-01&date2=2023-03-31&campaignId=123456&group=date