Métricas de rendimiento y atributos de configuración de los anuncios.
Este informe solo se puede mostrar mediante una solicitud asíncrona (es decir, a través del método Reports.request()).
Solicitar un extracto
Envía un cuerpo de solicitud Reports.request() normal, pero especifica "reportType": "ad".
{
...
"reportType": "ad",
"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 anuncio: Active, Paused o Removed. Ten en cuenta que las campañas, los grupos de anuncios, las palabras clave y los anuncios tienen su propio estado. Consulta el estado. |
atributo | Status |
Sí |
engineStatus |
Estado adicional del anuncio en la cuenta de motor externa. Los estados posibles (según el tipo de cuenta externa) incluyen active, eligible, creative deleted, creative approved family safe, etcétera. |
atributo | String |
Sí |
creationTimestamp |
Marca de tiempo de la creación del anuncio, con formato ISO 8601. | atributo | Timestamp |
Sí |
lastModifiedTimestamp |
Marca de tiempo de la última modificación del anuncio, 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í |
campaign |
Nombre de la campaña. | atributo | String |
Sí |
campaignId |
ID de la campaña de DS. | atributo | ID |
Sí |
campaignStatus |
Es el estado de la campaña que contiene este artículo. | atributo | Status |
Sí |
adGroup |
Nombre del grupo de anuncios. | atributo | String |
Sí |
adGroupId |
ID del grupo de anuncios de DS. | atributo | ID |
Sí |
adGroupStatus |
Es el estado del grupo de anuncios que contiene este elemento. | atributo | Status |
Sí |
ad |
Es el nombre del anuncio. | atributo | String |
Sí |
adId |
ID del anuncio de DS. Un valor de 0 indica que el anuncio no se atribuye. | atributo | ID |
Sí |
adEngineId |
ID del anuncio en la cuenta de motor externa. | atributo | ID |
Sí |
isUnattributedAd |
Indica si las métricas de esta fila no se pueden atribuir a un anuncio específico. Por ejemplo, un anuncio con un formato no admitido o una URL de servidor de clics errónea puede impedir que DS atribuya métricas a un anuncio. | atributo | Boolean |
Sí |
adHeadline |
Título del anuncio. | atributo | String |
Sí |
adHeadline2 |
Título 2 del anuncio (no disponible para algunos motores) | atributo | String |
Sí |
adHeadline3 |
Título 3 del anuncio; no está disponible para algunos motores. | atributo | String |
Sí |
adDescription1 |
Línea descriptiva del anuncio 1. | atributo | String |
Sí |
adDescription2 |
Línea 2 de la descripción del anuncio (no disponible para algunos motores) | atributo | String |
Sí |
adDisplayUrl |
URL visible del anuncio. | atributo | String |
Sí |
adLandingPage |
Página de destino del anuncio Consulta Páginas de destino y URLs del servidor de clics. | atributo | String |
Sí |
adType |
Es el tipo de anuncio: Text, Product, Dynamic search, Mobile app install, Call-Only, Expanded text o Expanded dynamic search. |
atributo | Ad type |
Sí |
adPromotionLine |
Línea de promoción del anuncio. Un mensaje promocional breve para un anuncio de producto. | atributo | String |
Sí |
adLabels |
Son los nombres de las etiquetas asignadas directamente a este anuncio. No se incluyen las etiquetas heredadas. | atributo | String list |
Sí |
adPathField1 |
Campo de ruta 1 del anuncio Los campos de ruta 1 y 2 se combinan con adDisplayUrl para formar la URL que se muestra en un anuncio. | atributo | String |
Sí |
adPathField2 |
Campo de ruta 2 del anuncio Los campos de ruta 1 y 2 se combinan con adDisplayUrl para formar la URL que se muestra en un anuncio. | atributo | String |
Sí |
effectiveLabels |
Son los nombres de todas las etiquetas heredadas o asignadas directamente a este anuncio. | atributo | String list |
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í |
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í |