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 }
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
equarterEnd
. 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.