Relatórios segmentados

A nova API Search Ads 360 Reporting já está disponível. A nova API oferece mais flexibilidade para criar relatórios personalizados e integrar os dados aos seus aplicativos de geração de relatórios e processos. Saiba mais sobre como migrar e usar os novos relatórios do Search Ads 360 API.

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.

keywordText keywordLandingPage os cliques
widgets http://www.example.com 6000

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.

keywordText keywordLandingPage quarterStart quarterEnd os cliques
widgets http://www.example.com 2012-01-01 2012-03-31 1000
widgets http://www.example.com 2012-04-01 2012-06-30 1000
widgets http://www.example.com 2012-07-01 2012-09-30 1000
widgets http://www.example.com 2012-10-01 2012-12-31 3000

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
}
  
Observação: tenha cuidado com datas. Se você solicitar um relatório trimestral, certifique-se de que o timeRange do relatório inclui o trimestre inteiro. Caso contrário, você obterá apenas resultados parciais, o que pode tornar as pessoas acham que houve uma redução drástica nos cliques, na receita e assim por diante.

Como solicitar vários segmentos

Você pode incluir mais de uma coluna de segmento em uma solicitação. Observe o seguinte:

  • Se você segmentar por semana, mês ou trimestre, recomendamos incluir os dois das colunas start e end da solicitação. Por exemplo, em um relatório trimestral, inclua nas colunas quarterStart e quarterEnd. Incluir os dois produzirão as datas de início e término do período, o que ajudará a confirmar que você os dados incluídos para cada período completo.

  • Não é possível incluir tipos diferentes de segmentos relacionados ao tempo na mesma solicitação. Por exemplo, não é possível segmentar por trimestre e mês na mesma solicitação.

  • O número de linhas pode aumentar exponencialmente a cada segmento adicional.