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
quarterStartequarterEnd. 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.