La API de Search Ads 360 solo muestra datos agregados, a menos que solicites datos segmentados más detallados. Por ejemplo, la columna de clics en un informe de palabras clave muestra la cantidad total de clics en una palabra clave durante el período que especificas.
keywordText | keywordLandingPage | los clics |
---|---|---|
widgets | http://www.example.com | 6000 |
Sin embargo, si solicitas un informe de palabras clave que se segmente por trimestre, para cada palabra clave verás una fila correspondiente a cada trimestre, y la columna de clics mostrará los totales trimestrales.
keywordText | keywordLandingPage | quarterStart | quarterEnd | los clics |
---|---|---|---|---|
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 |
Ten en cuenta que un informe segmentado muestra una fila solo si hay datos disponibles para un segmento.
Por ejemplo, en un informe de palabras clave con la columna floodlightActivity
, un par de palabras clave y actividad de Floodlight no aparecerá en el informe si no hay métricas atribuidas a él para el período del informe.
Algunos segmentos no son compatibles con columnas específicas
Algunos segmentos pueden hacer que columnas específicas muestren datos no válidos. Por ejemplo, la segmentación por floodlightActivity
solo es significativa si incluyes columnas que informan datos de Floodlight, como dfaActions
, dfaRevenue
, dfaTransactions
y dfaWeightedActions
. Otros tipos de columnas de conversión (como adWordsConversions
) o columnas que informan métricas de motores (como impresiones y clics) no contienen datos informados por Floodlight. Por lo tanto, muestran valores no válidos si segmentas un informe por floodlightActivity
.
Cómo solicitar un informe segmentado
Para solicitar un informe segmentado, incluye una columna que indique segment
como su comportamiento en la referencia Tipos de informes.
La siguiente solicitud asíncrona corresponde a un informe de palabras clave segmentado por trimestre. La columna de clics de cada fila contendrá la cantidad total de clics del 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 }
Cómo solicitar varios segmentos
Puedes incluir más de una columna de segmento en una solicitud. Ten en cuenta lo siguiente:
-
Si segmentas por semana, mes o trimestre, te recomendamos que incluyas las columnas de inicio y finalización en tu solicitud. Por ejemplo, en un informe trimestral, incluye las columnas
quarterStart
yquarterEnd
. Si incluyes ambas columnas, se mostrarán las fechas de inicio y finalización del período, lo que te ayudará a confirmar que incluiste los datos de cada período completo. -
No puedes incluir diferentes tipos de segmentos relacionados con el tiempo en la misma solicitud. Por ejemplo, no puede segmentar por trimestre y por mes en la misma solicitud.
-
La cantidad de filas podría aumentar exponencialmente con cada segmento adicional.