Datos de informes para cuentas de motor, incluidos los siguientes:
- Métricas de rendimiento de todas las campañas de una cuenta de motor
- Atributos de configuración para una cuenta de motor.
Solicitar un extracto
Envía un cuerpo de solicitud normal de Reports.request() o Reports.generate(), pero especifica "reportType": "account".
{
...
"reportType": "account",
"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 de la cuenta: Active, Paused o Removed. |
atributo | Status |
Sí |
creationTimestamp |
Es la marca de tiempo de la creación de la cuenta, con formato ISO 8601. | atributo | Timestamp |
Sí |
lastModifiedTimestamp |
Es la marca de tiempo de la última modificación de la cuenta, 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í |
account |
Es el nombre de la cuenta de motor. | atributo | String |
Sí |
accountId |
ID de la cuenta del motor de DS. | atributo | ID |
Sí |
accountEngineId |
ID de la cuenta de la cuenta de motor externa. | atributo | String |
Sí |
accountType |
Tipo de cuenta de motor: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu o Comparison Shopping. |
atributo | Engine type |
Sí |
accountCurrencyCode |
Es el código de moneda de la cuenta del motor en formato ISO 4217. | atributo | String |
Sí |
accountTimeZone |
Es la zona horaria de la cuenta de motor en 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 (NQ) 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í |