Datos de informes para los anunciantes, incluidos los siguientes:
- Métricas de rendimiento de todas las campañas y cuentas de motor de un anunciante
- Atributos de configuración de un anunciante.
Solicitar un extracto
Envía un cuerpo de solicitud normal de Reports.request() o Reports.generate(), pero especifica "reportType": "advertiser".
{
...
"reportType": "advertiser",
"columns": [
{
"columnName":string ,
"headerText":string ,
"startDate":string ,
"endDate":string
}
],
"filters": [
{
"column": {
"columnName":string ,
},
...
},
...
],
...
}
Para cada columna que quieras que se muestre o filtre en el informe, especifica el columnName que se indica en la siguiente tabla.
De manera opcional, también puedes especificar
headerText,
startDate y
endDate.
Ten en cuenta que no se pueden filtrar algunas columnas. Consulta "Filtrable" en la siguiente tabla.
columnName | Descripción | Comportamiento | Tipo | Filtrable |
|---|---|---|---|---|
status |
El estado del anunciante: Active, Paused o Removed. |
atributo | Status |
Sí |
creationTimestamp |
Marca de tiempo de la creación del anunciante, con formato ISO 8601. | atributo | Timestamp |
Sí |
lastModifiedTimestamp |
Es la marca de tiempo de la última modificación del anunciante, con formato ISO 8601. | atributo | Timestamp |
Sí |
agency |
Nombre de la agencia | atributo | String |
Sí |
agencyId |
Es el ID de la agencia de DS. | atributo | ID |
Sí |
advertiser |
Es el nombre del anunciante. | atributo | String |
Sí |
advertiserId |
ID del anunciante de DS. | atributo | ID |
Sí |
dfaAdvertiserId |
Es el ID del anunciante de Campaign Manager asociado con este anunciante de DS. | atributo | ID |
Sí |
dfaNetworkId |
Es el ID de la red de Campaign Manager asociada con este anunciante de DS. | atributo | ID |
Sí |
dfaNetworkTimeZone |
Es la zona horaria de la red de Campaign Manager asociada con este anunciante de DS en formato de la base de datos de zonas horarias de IANA, como America/New_York. |
atributo | String |
Sí |
advertiserCurrencyCode |
Es el código de moneda del anunciante en formato ISO 4217. | atributo | String |
Sí |
googleAnalyticsTimeZone |
Es la zona horaria de la vista de Google Analytics vinculada a este anunciante de DS. Usa el formato de la base de datos de zonas horarias de IANA, como America/New_York. |
atributo | String |
Sí |
dfaActions |
Es la cantidad total de acciones de Campaign Manager. | métrica | Integer |
Sí |
dfaRevenue |
Son los ingresos agregados que generan las transacciones de Campaign Manager. | métrica | Money |
Sí |
dfaTransactions |
Es la cantidad total de transacciones del Administrador de campañas. | métrica | Integer |
Sí |
dfaWeightedActions |
Es la suma ponderada de las acciones de Campaign Manager. | métrica | Number |
Sí |
dfaActionsCrossEnv |
Es la cantidad total de acciones del Administrador de campañas en varios entornos. | métrica | Number |
Sí |
dfaRevenueCrossEnv |
Son los ingresos agregados que generan las transacciones de Campaign Manager en varios entornos. | métrica | Money |
Sí |
dfaTransactionsCrossEnv |
Es la cantidad total de transacciones de Campaign Manager en varios entornos. | métrica | Number |
Sí |
dfaWeightedActionsCrossEnv |
Es la suma ponderada de las acciones de Campaign Manager en varios entornos. | métrica | Number |
Sí |
avgCpc |
Es el costo por clic promedio. | métrica | Money |
Sí |
avgCpm |
Costo promedio por cada mil impresiones. | métrica | Money |
Sí |
avgPos |
Posición promedio. | métrica | Number |
Sí |
clicks |
Clics agregados | métrica | Integer |
Sí |
cost |
Es el costo total pagado a las cuentas de motor. | métrica | Money |
Sí |
ctr |
Tasa de clics promedio. | métrica | Number |
Sí |
impr |
Es la cantidad total de impresiones. | métrica | Integer |
Sí |
adWordsConversions |
Son los datos que el anunciante configuró para que se registren en la columna Conversiones de Google Ads. Cuando se crea una acción de conversión de Google Ads, el anunciante puede elegir si registrar esas conversiones en la columna de informes Conversiones. | métrica | Number |
Sí |
adWordsConversionValue |
Es el valor agregado de las conversiones de Google Ads. | métrica | Number |
Sí |
adWordsViewThroughConversions |
Es la cantidad total de conversiones posimpresión de Google Ads. | métrica | Integer |
Sí |
visits |
Es la cantidad total de visitas a DS. | métrica | Integer |
Sí |
searchImpressionShare |
Solo para Google Ads y Bing Ads. Es la cantidad de impresiones que recibiste en la Red de Búsqueda dividida por la cantidad estimada de impresiones que podrías haber recibido. Se muestra como un número entre 0.1 y 1 o, si la parte es inferior a 0.1, la cadena < 10%. |
métrica | Impression share |
Sí |
searchBudgetLostImpressionShare |
Solo para Google Ads y Bing Ads. Es el porcentaje de veces que tus anuncios no se mostraron en la Red de Búsqueda debido a un presupuesto insuficiente. Se muestra como un número entre 0 y 0.9 o, si el porcentaje es mayor que 0.9, como una cadena > 90%. |
métrica | Impression share |
Sí |
searchRankLostImpressionShare |
Solo para Google Ads y Bing Ads. Es el porcentaje de veces que tus anuncios no se mostraron en la Red de Búsqueda debido a un ranking del anuncio bajo. Se muestra como un número entre 0 y 0.9 o, si el porcentaje es mayor que 0.9, como una cadena > 90%. |
métrica | Impression share |
Sí |
displayImpressionShare |
Solo para Google Ads. Es la cantidad de impresiones que recibiste en la Red de Display dividida por la cantidad estimada de impresiones que podrías haber recibido. Se muestra como un número entre 0.1 y 1 o, si la parte es inferior a 0.1, la cadena < 10%. |
métrica | Impression share |
Sí |
displayBudgetLostImpressionShare |
Solo para Google Ads. Es el porcentaje de veces que tus anuncios no se mostraron en la Red de Display debido a un presupuesto insuficiente. Se muestra como un número entre 0 y 0.9 o, si el porcentaje es mayor que 0.9, como una cadena > 90%. |
métrica | Impression share |
Sí |
displayRankLostImpressionShare |
Solo para Google Ads. Es el porcentaje de veces que tus anuncios no se mostraron en la Red de Display debido a un ranking del anuncio bajo. Se muestra como un número entre 0 y 0.9 o, si el porcentaje es mayor que 0.9, como una cadena > 90%. |
métrica | Impression share |
Sí |
qualityScoreAvg |
Solo para Google Ads y Bing Ads. Es el promedio ponderado por cantidad de impresiones del Nivel de calidad (NC) del motor en todos los días y palabras clave del alcance del informe. | métrica | Number |
Sí |
topOfPageBidAvg |
Solo para Google Ads. Es la oferta de CPC promedio aproximada que se necesita durante el período del informe para que tus anuncios aparezcan con regularidad en las posiciones principales sobre los resultados de la búsqueda. | métrica | Money |
Sí |
absoluteTopImpressionPercentage |
Es el porcentaje de tus impresiones de anuncios que se muestran como el primer anuncio por encima de los resultados de la búsqueda orgánica. | métrica | Impression share |
Sí |
searchAbsoluteTopImpressionShare |
Son las impresiones que recibiste en la ubicación superior absoluta (el primer anuncio por encima de los resultados de la búsqueda orgánica) divididas por la cantidad estimada de impresiones que podrías haber recibido en esa ubicación. | métrica | Impression share |
Sí |
topImpressionPercentage |
Es el porcentaje de tus impresiones de anuncios que se muestran en cualquier lugar por encima de los resultados de la búsqueda orgánica. | métrica | Impression share |
Sí |
searchTopImpressionShare |
Son las impresiones que recibiste en la ubicación superior (cualquier lugar por encima de los resultados de la búsqueda orgánica) en comparación con la cantidad estimada de impresiones que podrías haber obtenido en esa ubicación. | métrica | Impression share |
Sí |
searchBudgetLostAbsoluteTopImpressionShare |
Es una estimación de la frecuencia con la que tu anuncio no se mostró en el primer lugar por encima de los resultados de la búsqueda orgánica debido a un presupuesto bajo. | métrica | Impression share |
Sí |
searchBudgetLostTopImpressionShare |
Te ayuda a comprender la frecuencia con la que tu anuncio no se mostró en ningún lugar por encima de los resultados de la búsqueda orgánica debido a un presupuesto bajo. | métrica | Impression share |
Sí |
searchRankLostAbsoluteTopImpressionShare |
Es una estimación de la frecuencia con la que tu anuncio no se mostró en el primer lugar por encima de los resultados de la búsqueda orgánica debido a un ranking del anuncio bajo. | métrica | Impression share |
Sí |
searchRankLostTopImpressionShare |
Es una estimación de la frecuencia con la que tu anuncio no se mostró en ningún lugar por encima de los resultados de la búsqueda orgánica debido a un ranking del anuncio bajo. | métrica | Impression share |
Sí |
date |
Segmenta el informe por días. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada día. Esta columna muestra la fecha de cada fila. | segmento | Date |
Sí |
monthStart |
Segmenta el informe por meses. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada mes. Esta columna muestra el primer día del mes de cada fila. | segmento | Date |
Sí |
monthEnd |
Segmenta el informe por meses. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada mes. Esta columna muestra el último día del mes de cada fila. | segmento | Date |
Sí |
quarterStart |
Segmenta el informe por trimestres. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada trimestre. Esta columna muestra el primer día del trimestre de cada fila. | segmento | Date |
Sí |
quarterEnd |
Segmenta el informe por trimestres. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada trimestre. Esta columna muestra el último día del trimestre de cada fila. | segmento | Date |
Sí |
weekStart |
Segmenta el informe por semanas (de domingo a sábado). Cada fila y sus métricas agregadas se dividen en varias filas, una para cada semana. Esta columna muestra el primer día (domingo) de cada fila. | segmento | Date |
Sí |
weekEnd |
Segmenta el informe por semanas (de domingo a sábado). Cada fila y sus métricas agregadas se dividen en varias filas, una para cada semana. Esta columna muestra el último día (sábado) de cada fila. | segmento | Date |
Sí |
yearStart |
Segmenta el informe por años. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada año. Esta columna muestra el primer día del año de cada fila. | segmento | Date |
Sí |
yearEnd |
Segmenta el informe por años. Cada fila y sus métricas agregadas se dividen en varias filas, una para cada año. Esta columna muestra el último día del año de cada fila. | segmento | Date |
Sí |
deviceSegment |
Segmenta el informe por dispositivo. Cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada segmento de dispositivo. Esta columna muestra el segmento de dispositivo de cada fila. | segmento | Device segment |
Sí |
floodlightGroup |
Segmenta el informe por grupos de Floodlight. Cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada grupo de Floodlight. Esta columna muestra el nombre del grupo de Floodlight de cada fila. Ten en cuenta que algunas métricas no tienen valores segmentados de Floodlight, como los clics y las visitas. | segmento | String |
Sí |
floodlightGroupId |
Segmenta el informe por grupos de Floodlight. Cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada grupo de Floodlight. Esta columna muestra el ID del grupo de Floodlight de DS de cada fila. Ten en cuenta que algunas métricas no tienen valores segmentados de Floodlight, como los clics y las visitas. | segmento | ID |
Sí |
floodlightGroupTag |
Segmenta el informe por grupos de Floodlight. Cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada grupo de Floodlight. Esta columna muestra la etiqueta del grupo de Floodlight de cada fila. Ten en cuenta que algunas métricas no tienen valores segmentados de Floodlight, como los clics y las visitas. | segmento | String |
Sí |
floodlightActivity |
Segmenta el informe por actividades de Floodlight. Cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada actividad de Floodlight. Esta columna muestra el nombre de la actividad de Floodlight de cada fila. Ten en cuenta que algunas métricas no tienen valores segmentados de Floodlight, como los clics y las visitas. | segmento | String |
Sí |
floodlightActivityId |
Segmenta el informe por actividades de Floodlight. Cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada actividad de Floodlight. Esta columna muestra el ID de la actividad de Floodlight de DS de cada fila. Ten en cuenta que algunas métricas no tienen valores segmentados de Floodlight, como los clics y las visitas. | segmento | ID |
Sí |
floodlightActivityTag |
Segmenta el informe por actividades de Floodlight. Cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada actividad de Floodlight. Esta columna muestra la etiqueta de actividad de Floodlight de cada fila. Ten en cuenta que algunas métricas no tienen valores segmentados de Floodlight, como los clics y las visitas. | segmento | String |
Sí |