방법: GET /advertiser/listStats
설명: 힐탑애즈 광고 계정에서 생성한 광고 캠페인에 대한 통계를 검색할 수 있습니다.
파라미터:
이름 | 설명 | 예제 | 댓글 |
key | 힐탑애즈 계정의 API 섹션에서 생성할 수 있는 고유 API 키입니다. | nXzgO3Bc | 요청의 필수 매개 변수입니다. |
Date | 통계 데이터를 검색해야 하는 날입니다. | 2023-01-01 | 기본적으로 응답은 어제에 대한 통계를 제공합니다. |
Date2 | 특정 기간에 대한 통계가 필요한 경우 이 매개변수를 지정합니다. | 2023-01-31 | 이 날짜는 해당 기간의 마지막 날로 간주되며 date 매개변수는 첫 번째 날로 간주됩니다. |
GEO | 특정 국가에 대한 통계가 필요한 경우 이 매개변수를 지정하세요.
| UK | 여러 국가에 대한 데이터를 검색하려면 쉼표로 구분하여 나열합니다.
|
zoneID | 특정 영역에 대한 통계가 필요한 경우 이 매개변수를 지정합니다. | 4OACSGAI8 | 여러 영역에 대한 데이터를 검색하려면 쉼표로 구분하여 나열합니다. |
campaignID | 특정 캠페인에 대한 통계가 필요한 경우 이 매개변수를 지정합니다. | 123456 | 여러 캠페인에 대한 데이터를 검색하려면 쉼표로 구분하여 나열합니다. |
adID | 특정 광고에 대한 통계가 필요한 경우 이 매개변수를 지정합니다. | 123456 | 여러 광고에 대한 데이터를 검색하려면 쉼표로 구분하여 나열합니다. |
group | 데이터를 그룹화하려면 이 매개변수를 지정합니다. | 날짜 | 그룹화할 수 있는 기준은 날짜, 시간, GEO, zoneID, 캠페인ID, 광고ID입니다. |
요청 예시:
2023년 2월 1일부터 3월 31일까지의 캠페인 123456에 대한 통계를 일자별로 그룹화하여 검색하려면 다음 요청을 작성해야 합니다:
https://hilltopads.com/api/advertiser/listStats?key=nXzgO3Bc&date=2023-02-01&date2=2023-03-31&campaignId=123456&group=date