Informes segmentados

Ya está disponible la nueva API de Search Ads 360 Reporting. La nueva API proporciona Flexibilidad mejorada para crear informes personalizados e integrar los datos en sus aplicaciones de informes y procesos. Más información sobre cómo migrar a la nueva experiencia de Search Ads 360 Reporting y cómo usarla API

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
}
  
Nota: Ten cuidado con las fechas. Si solicitas un informe trimestral, asegúrate de que el timeRange del informe incluye todo el trimestre. De lo contrario, obtendrás solo resultados parciales, lo que podría hacer las personas creen que hubo una reducción drástica en los clics, los ingresos, etc.

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 quarterStart y quarterEnd. 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.