Relatórios segmentados

A API Search Ads 360 retorna somente dados agregados, a menos que você solicite mais dados. Por exemplo, a coluna de cliques em uma palavra-chave lista o número total de cliques em uma palavra-chave durante o período especificado.

No entanto, se você solicitar um relatório de palavras-chave que segmente por trimestre, para cada palavra-chave verá uma linha para cada trimestre, e a coluna de cliques listará os totais trimestrais.

O relatório segmentado retornará uma linha somente se houver dados disponíveis para um segmento. Por exemplo, em um relatório de palavras-chave com a coluna floodlightActivity, uma palavra-chave e O par de atividades do Floodlight não vai aparecer no relatório se não houver métricas atribuídas para o período do relatório.

Alguns segmentos são incompatíveis com colunas específicas

Alguns segmentos podem fazer com que colunas específicas retornem dados inválidos. Por exemplo, segmentar por floodlightActivity é significativo somente se você incluir colunas com informações sobre o Floodlight como dfaActions, dfaRevenue, dfaTransactions e e dfaWeightedActions. Outros tipos de colunas de conversão (como adWordsConversions) ou colunas que informam métricas de mecanismo (como cliques e impressões), não contêm os dados informados pelo Floodlight e, por isso, retornam valores inválidos se você segmentar um relatório por floodlightActivity.

Como solicitar um relatório segmentado

Para solicitar um relatório segmentado, inclua uma coluna que liste segment como seu comportamento na referência Tipos de relatório.

A solicitação assíncrona a seguir é para um relatório de palavras-chave segmentado por trimestre. A clique em cada linha conterá o número total de cliques do trimestre:

{
  "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
}