A API Search Ads 360 retorna somente dados agregados, a menos que você solicite dados mais detalhados e segmentados. Por exemplo, a coluna "Cliques" em um relatório de palavras-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, verá uma linha para cada trimestre para cada palavra-chave, 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 | 1.000 |
widgets | http://www.example.com | 2012-04-01 | 2012-06-30 | 1.000 |
widgets | http://www.example.com | 2012-07-01 | 2012-09-30 | 1.000 |
widgets | http://www.example.com | 2012-10-01 | 2012-12-31 | 3.000 |
Um relatório segmentado só retorna uma linha se os dados estiverem disponíveis para um segmento.
Por exemplo, em um relatório de palavra-chave com a coluna floodlightActivity
, um par de palavra-chave e
atividade do Floodlight não vai aparecer no relatório se não houver métricas atribuídas
a ele 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, a segmentação por floodlightActivity
só é relevante quando você inclui colunas que informam dados do Floodlight, como dfaActions
, dfaRevenue
, dfaTransactions
e dfaWeightedActions
. Outros tipos de colunas de conversão (como adWordsConversions
) ou que informam métricas de mecanismo (como cliques e impressões) não contêm dados informados pelo Floodlight. Por isso, elas 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órios.
A solicitação assíncrona a seguir é para um relatório de palavras-chave segmentado por trimestre. A coluna de cliques em cada linha conterá o número total de cliques para o 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 }
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 as colunas inicial e final na solicitação. Por exemplo, em um relatório trimestral, inclua as colunas
quarterStart
equarterEnd
. A inclusão dessas duas colunas exibirá as datas de início e término do período, o que ajudará a confirmar se você incluiu dados 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 com cada segmento adicional.