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 | 1000 |
| 위젯 | http://www.example.com | 2012-04-01 | 2012-06-30 | 1000 |
| 위젯 | http://www.example.com | 2012-07-01 | 2012-09-30 | 1000 |
| 위젯 | http://www.example.com | 2012-10-01 | 2012-12-31 | 3000 |
분류된 보고서에서는 세그먼트에 대한 데이터가 있는 경우에만 행이 반환됩니다.
예를 들어 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
}
여러 세그먼트 요청
한 요청에 분류 기준 열을 2개 이상 포함할 수 있습니다. 다음에 유의하세요.
-
주별, 월별 또는 분기별로 분류하는 경우 시작 및 끝 열을 지정할 수 있습니다. 예를 들어 분기별 보고서에는
quarterStart및quarterEnd열 이 두 가지를 모두 포함 열에는 기간의 시작일과 종료일이 출력되므로 각 전체 기간에 대해 포함된 데이터를 보여줍니다. -
동일한 요청에 서로 다른 유형의 시간 관련 세그먼트를 포함할 수 없습니다. 예를 들어 같은 요청에서 분기 및 월을 기준으로 분류할 수 없습니다.
-
세그먼트가 추가될 때마다 행 수가 기하급수적으로 증가할 수 있습니다.