더 상세하고 분류된 데이터를 요청하지 않는 한 Search Ads 360 API는 집계된 데이터만 반환합니다. 예를 들어 키워드 보고서의 클릭수 열에는 지정한 기간 동안 키워드에 발생한 총 클릭수가 나열됩니다.
| keywordText | keywordLandingPage | 클릭수 |
|---|---|---|
| 위젯 | http://www.example.com | 6000 |
그러나 분기별로 분류된 키워드 보고서를 요청하면 각 키워드에 대해 분기별로 하나의 행이 표시되고 클릭수 열에 분기별 총계가 표시됩니다.
| keywordText | keywordLandingPage | quarterStart | quarterEnd | 클릭수 |
|---|---|---|---|---|
| 위젯 | http://www.example.com | 2012-01-01 | 2012-03-31 | 1,000 |
| 위젯 | http://www.example.com | 2012-04-01 | 2012-06-30 | 1,000 |
| 위젯 | http://www.example.com | 2012-07-01 | 2012-09-30 | 1,000 |
| 위젯 | http://www.example.com | 2012-10-01 | 2012-12-31 | 3,000 |
분류된 보고서에서는 세그먼트에 대해 데이터를 사용할 수 있는 경우에만 행이 반환됩니다.
예를 들어 floodlightActivity 열이 있는 키워드 보고서에서는 보고서 기간에 해당하는 측정항목이 없으면 키워드와 플러드라이트 활동 쌍이 보고서에 표시되지 않습니다.
일부 분류 기준이 특정 열과 호환되지 않음
일부 분류 기준에서는 특정 열이 잘못된 데이터를 반환할 수 있습니다. 예를 들어 floodlightActivity별 분류는 dfaActions, dfaRevenue, dfaTransactions, dfaWeightedActions와 같이 플러드라이트 데이터를 보고하는 열을 포함하는 경우에만 의미가 있습니다. 다른 유형의 전환 열 (예: adWordsConversions) 또는 엔진 측정항목을 보고하는 열 (예: 클릭수, 노출수)에는 플러드라이트에서 보고된 데이터가 포함되지 않으므로 floodlightActivity을 기준으로 보고서를 분류하면 잘못된 값이 반환됩니다.
분류된 보고서 요청 방법
분류된 보고서를 요청하려면 보고서 유형 참조에 segment를 동작으로 표시하는 열을 포함하세요.
다음은 분기별로 분류된 키워드 보고서에 대한 비동기식 요청입니다. 각 행의 클릭수 열에는 해당 분기의 총 클릭수가 포함됩니다.
{
"reportScope": {
"agencyId": "20700000000000123", // Replace with your IDs
"advertiserId": "2170000012345" // Replace with your IDs
},
"reportType": "keyword",
"columns": [
{ "columnName": "campaignId" },
{ "columnName": "keywordText" },
{ "columnName": "keywordLandingPage" },
{ "columnName": "quarterStart" },
{ "columnName": "quarterEnd" },
{ "columnName": "clicks" },
]
"timeRange" : {
"startDate" : "2012-01-01",
"endDate" : "2012-12-31"
},
"downloadFormat": "csv",
"maxRowsPerFile": 5000000,
"statisticsCurrency": "agency",
"verifySingleTimeZone": false,
"includeRemovedEntities": false
}
여러 세그먼트 요청
한 요청에 세그먼트 열을 두 개 이상 포함할 수 있습니다. 다음에 유의하세요.
-
주, 월 또는 분기별로 분류하는 경우 요청에 시작 열과 종료 열을 모두 포함하는 것이 좋습니다. 예를 들어 분기별 보고서에는
quarterStart열과quarterEnd열을 모두 포함하세요. 이 두 열을 모두 포함하면 기간의 시작일과 종료일이 출력되어 각 전체 기간의 데이터가 포함되었는지 확인할 수 있습니다. -
같은 요청에 다른 유형의 시간 관련 세그먼트를 포함할 수 없습니다. 예를 들어 동일한 요청에서 분기 및 월을 기준으로 분류할 수 없습니다.
-
행 수는 각 세그먼트가 추가될 때마다 기하급수적으로 증가할 수 있습니다.