세분화된 보고서

이제 새 Search Ads 360 Reporting API를 사용할 수 있습니다. 새로운 API는 맞춤 보고서를 작성하고 보고 애플리케이션에 데이터를 통합할 수 있는 유연성 향상 프로세스입니다 새 Search Ads 360 보고서로 이전하고 이를 사용하는 방법 자세히 알아보기 API를 참고하세요.

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
}
참고: 날짜에 주의하세요. 분기별 보고서를 요청하는 경우 보고서의 timeRange 여기에는 전체 분기가 포함됩니다 그렇지 않으면 결과가 일부만 표시되어 사람들은 클릭수, 수익 등의 급격한 감소가 있었다고 생각합니다.

여러 세그먼트 요청

한 요청에 분류 기준 열을 2개 이상 포함할 수 있습니다. 다음에 유의하세요.

  • 주별, 월별 또는 분기별로 분류하는 경우 시작 및 끝 열을 지정할 수 있습니다. 예를 들어 분기별 보고서에는 quarterStart 및 quarterEnd 열 이 두 가지를 모두 포함 열에는 기간의 시작일과 종료일이 출력되므로 각 전체 기간에 대해 포함된 데이터를 보여줍니다.

  • 동일한 요청에 서로 다른 유형의 시간 관련 세그먼트를 포함할 수 없습니다. 예를 들어 같은 요청에서 분기 및 월을 기준으로 분류할 수 없습니다.

  • 세그먼트가 추가될 때마다 행 수가 기하급수적으로 증가할 수 있습니다.