Datos de los informes para los anunciantes, que incluyen:
- Métricas de rendimiento en todas las cuentas de motor y las campañas de un anunciante.
- Atributos de configuración para un anunciante.
Solicitar extracto
Envía un cuerpo de solicitud normal 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 desees mostrar o filtrar en el informe, especifica la columnName que aparece en la siguiente tabla.
De manera opcional, también puedes especificar headerText, startDate y endDate.
Tenga en cuenta que no se pueden filtrar algunas columnas. Consulte la sección “Filtrable” en la tabla a continuación.
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 el formato ISO 8601. | atributo | Timestamp |
Sí |
lastModifiedTimestamp |
La marca de tiempo de la modificación más reciente del anunciante, con el formato ISO 8601. | atributo | Timestamp |
Sí |
agency |
Nombre de la agencia. | atributo | String |
Sí |
agencyId |
ID de agencia de DS. | atributo | ID |
Sí |
advertiser |
Nombre del anunciante | atributo | String |
Sí |
advertiserId |
ID del anunciante de DS. | atributo | ID |
Sí |
dfaAdvertiserId |
ID del anunciante de Campaign Manager asociado con este anunciante de DS. | atributo | ID |
Sí |
dfaNetworkId |
ID de la red de Campaign Manager asociada con este anunciante de DS. | atributo | ID |
Sí |
dfaNetworkTimeZone |
Zona horaria de la red de Campaign Manager asociada con este anunciante de DS en el formato de la base de datos de zonas horarias de IANA, como America/New_York. |
atributo | String |
Sí |
advertiserCurrencyCode |
Código de moneda del anunciante en formato ISO 4217 | atributo | String |
Sí |
googleAnalyticsTimeZone |
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 en Campaign Manager. | métrica | Integer |
Sí |
dfaRevenue |
Ingresos totales generados por transacciones de Campaign Manager. | métrica | Money |
Sí |
dfaTransactions |
Es la cantidad total de transacciones de Campaign Manager. | métrica | Integer |
Sí |
dfaWeightedActions |
Suma ponderada de acciones de Campaign Manager. | métrica | Number |
Sí |
dfaActionsCrossEnv |
La cantidad total de acciones de Campaign Manager en varios entornos. | métrica | Number |
Sí |
dfaRevenueCrossEnv |
Ingresos totales generados por transacciones de Campaign Manager en varios entornos. | métrica | Money |
Sí |
dfaTransactionsCrossEnv |
La cantidad total de transacciones de Campaign Manager entre entornos. | métrica | Number |
Sí |
dfaWeightedActionsCrossEnv |
Suma ponderada de acciones de Campaign Manager en varios entornos | métrica | Number |
Sí |
avgCpc |
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 totales | métrica | Integer |
Sí |
cost |
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 |
Los datos que el anunciante configuró para que se incluyan en la columna "Conversiones de Google Ads". Cuando se crea una acción de conversión de Google Ads, el anunciante puede elegir si desea registrar esas conversiones en la columna de informes "Conversiones". | métrica | Number |
Sí |
adWordsConversionValue |
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 |
Indica la cantidad total de visitas a DS. | métrica | Integer |
Sí |
searchImpressionShare |
Solo Google Ads y Bing Ads. Las impresiones que recibió en la Red de Búsqueda divididas por la cantidad estimada de impresiones que podría haber recibido. Se muestra como un número entre 0.1 y 1 o, si el porcentaje es menor que 0.1, la string < 10%. |
métrica | Impression share |
Sí |
searchBudgetLostImpressionShare |
Solo Google Ads y Bing Ads. El porcentaje de tiempo durante el cual sus 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 string > 90%. |
métrica | Impression share |
Sí |
searchRankLostImpressionShare |
Solo Google Ads y Bing Ads. El porcentaje de tiempo que sus 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 string > 90%. |
métrica | Impression share |
Sí |
displayImpressionShare |
Solo Google Ads Las impresiones que recibió en la Red de Display divididas por el número estimado de impresiones que podría haber recibido. Se muestra como un número entre 0.1 y 1 o, si el porcentaje es menor que 0.1, la string < 10%. |
métrica | Impression share |
Sí |
displayBudgetLostImpressionShare |
Solo Google Ads El porcentaje de tiempo durante el cual sus 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 string > 90%. |
métrica | Impression share |
Sí |
displayRankLostImpressionShare |
Solo Google Ads El porcentaje de tiempo que sus 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 string > 90%. |
métrica | Impression share |
Sí |
qualityScoreAvg |
Solo Google Ads y Bing Ads. Promedio ponderado de impresiones del Nivel de calidad del motor (QS) de todos los días y palabras clave dentro del alcance del informe. | métrica | Number |
Sí |
topOfPageBidAvg |
Solo Google Ads Indica la oferta de CPC promedio aproximada que necesita durante el intervalo de tiempo del informe para que sus anuncios aparezcan periódicamente en las primeras posiciones sobre los resultados de la búsqueda. | métrica | Money |
Sí |
absoluteTopImpressionPercentage |
Es el porcentaje de sus 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 |
Impresiones que recibió 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ía haber recibido en la ubicación superior. | métrica | Impression share |
Sí |
topImpressionPercentage |
Es el porcentaje de sus 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 |
Impresiones que recibió 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ía haber recibido en la ubicación superior. | métrica | Impression share |
Sí |
searchBudgetLostAbsoluteTopImpressionShare |
Es una estimación de la frecuencia con la que su anuncio no se mostró en el primer lugar encima de los resultados de la búsqueda orgánica debido a un presupuesto bajo. | métrica | Impression share |
Sí |
searchBudgetLostTopImpressionShare |
Lo ayuda a comprender la frecuencia con la que su 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 |
Calcula la frecuencia con la que su anuncio no se mostró en el primer lugar encima de los resultados de la búsqueda orgánica debido a un ranking del anuncio bajo. | métrica | Impression share |
Sí |
searchRankLostTopImpressionShare |
Calcula la frecuencia con la que su 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 globales 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 globales 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 globales 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 globales 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 globales 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 globales 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 globales 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 globales se dividen en varias filas, hasta una por cada segmento de dispositivo. Esta columna muestra el segmento de dispositivos de cada fila. | segmento | Device segment |
Sí |
floodlightGroup |
Segmenta el informe por grupos de Floodlight. Cada fila y sus métricas globales se dividen en varias filas, hasta una por cada grupo de Floodlight. Esta columna muestra el nombre del grupo de Floodlight de cada fila. Tenga en cuenta que algunas métricas no tienen valores segmentados de Floodlight, como clics y visitas. | segmento | String |
Sí |
floodlightGroupId |
Segmenta el informe por grupos de Floodlight. Cada fila y sus métricas globales se dividen en varias filas, hasta una por cada grupo de Floodlight. Esta columna muestra el ID de grupo de Floodlight de DS de cada fila. Tenga en cuenta que algunas métricas no tienen valores segmentados de Floodlight, como clics y visitas. | segmento | ID |
Sí |
floodlightGroupTag |
Segmenta el informe por grupos de Floodlight. Cada fila y sus métricas globales se dividen en varias filas, hasta una por cada grupo de Floodlight. Esta columna muestra la etiqueta del grupo de Floodlight de cada fila. Tenga en cuenta que algunas métricas no tienen valores segmentados de Floodlight, como clics y visitas. | segmento | String |
Sí |
floodlightActivity |
Segmenta el informe por actividades de Floodlight, y cada fila y sus métricas globales se dividen en varias filas, hasta una por cada actividad de Floodlight. Esta columna muestra el nombre de la actividad de Floodlight de cada fila. Tenga en cuenta que algunas métricas no tienen valores segmentados de Floodlight, como clics y visitas. | segmento | String |
Sí |
floodlightActivityId |
Segmenta el informe por actividades de Floodlight, y cada fila y sus métricas globales se dividen en varias filas, hasta una por cada actividad de Floodlight. Esta columna muestra el ID de actividad de Floodlight de DS de cada fila. Tenga en cuenta que algunas métricas no tienen valores segmentados de Floodlight, como clics y visitas. | segmento | ID |
Sí |
floodlightActivityTag |
Segmenta el informe por actividades de Floodlight, y cada fila y sus métricas globales se dividen en varias filas, hasta una por cada actividad de Floodlight. Esta columna muestra la etiqueta de actividad de Floodlight de cada fila. Tenga en cuenta que algunas métricas no tienen valores segmentados de Floodlight, como clics y visitas. | segmento | String |
Sí |