La API de Search Ads 360 muestra solo datos agregados, a menos que solicites datos más detallados y segmentados. de datos no estructurados. Por ejemplo, la columna de clics en una palabra clave muestra la cantidad total de clics en una palabra clave durante el período que especifique.
| keywordText | keywordLandingPage | los clics |
|---|---|---|
| widgets | http://www.example.com | 6000 |
Pero si solicita un informe de palabras clave que segmente por trimestre, para cada palabra clave verás una fila para 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 | 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 |
Tenga 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, una palabra clave y
El par de actividades de Floodlight no aparecerá en el informe si no hay métricas atribuidas.
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, si segmentas por
floodlightActivity es significativo solo si incluyes columnas que informan sobre Floodlight
datos, como dfaActions, dfaRevenue, dfaTransactions,
y dfaWeightedActions. Otros tipos de columnas de conversión (p. ej.,
adWordsConversions) o columnas que informen métricas del motor de búsqueda (como los clics y
impresiones), no contienen datos informados por Floodlight, por lo que muestran valores no válidos si
segmentar 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 es para un informe de palabras clave segmentado por trimestre. El en 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 de tu solicitud. Por ejemplo, en un informe trimestral, incluye tanto las columnas
quarterStartyquarterEnd. Incluir ambos las columnas mostrarán las fechas de inicio y finalización del período, lo que te ayudará a confirmar que incluyó datos para 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 mes en la misma solicitud.
-
La cantidad de filas podría aumentar de manera exponencial con cada segmento adicional.