Tipo de informe: anuncio

Métricas de rendimiento y atributos de configuración para los anuncios.

Este informe solo se puede mostrar mediante una solicitud asíncrona (es decir, a través del método Reports.request()).

Solicitar 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 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.

columnNameDescripciónComportamientoTipoFiltrable
status El estado del anuncio: Active, Paused o Removed. Tenga en cuenta que las campañas, los grupos de anuncios, las palabras clave y los anuncios tienen sus propios estados. Consulta el estado. atributo Status
engineStatus Es el estado adicional del anuncio en la cuenta de motor externo. Los estados posibles (según el tipo de cuenta externa) incluyen active, eligible, creative deleted, creative approved family safe, etcétera. atributo String
creationTimestamp Marca de tiempo de la creación del anuncio, con el formato ISO 8601. atributo Timestamp
lastModifiedTimestamp La marca de tiempo de la modificación más reciente del anuncio, con el formato ISO 8601. atributo Timestamp
agency Nombre de la agencia. atributo String
agencyId ID de agencia de DS. atributo ID
advertiser Nombre del anunciante atributo String
advertiserId ID del anunciante de DS. atributo ID
account Nombre de la cuenta de motor. atributo String
accountId ID de cuenta de motor de DS. atributo ID
accountEngineId ID de la cuenta en la cuenta de motor externo. atributo String
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
campaign Nombre de la campaña. atributo String
campaignId ID de campaña de DS. atributo ID
campaignStatus El estado de la campaña que contiene este elemento. atributo Status
adGroup Nombre del grupo de anuncios. atributo String
adGroupId ID del grupo de anuncios de DS. atributo ID
adGroupStatus El estado del grupo de anuncios que contiene este elemento. atributo Status
ad Nombre del anuncio. atributo String
adId ID del anuncio de DS. El valor 0 indica que el anuncio no tiene atribución. atributo ID
adEngineId ID del anuncio en la cuenta del motor externo. atributo ID
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 compatible o con una URL de clickserve errónea puede evitar que DS atribuya métricas a un anuncio. atributo Boolean
adHeadline Título del anuncio. atributo String
adHeadline2 Título del anuncio 2; no disponible para algunos motores atributo String
adHeadline3 Título del anuncio 3; no está disponible para algunos motores atributo String
adDescription1 Línea 1 de descripción del anuncio atributo String
adDescription2 Línea descriptiva 2 del anuncio; no está disponible para algunos motores atributo String
adDisplayUrl URL visible del anuncio. atributo String
adLandingPage Página de destino del anuncio. Consulta Página de destino y URL de clickserve. atributo String
adType Es el tipo de anuncio: Text, Product, Dynamic search, Mobile app install, Call-Only, Expanded text o Expanded dynamic search. atributo Ad type
adPromotionLine Línea de promoción del anuncio. Un mensaje promocional breve para un anuncio de productos. atributo String
adLabels Son los nombres de las etiquetas que se asignaron directamente a este anuncio. No se incluyen las etiquetas heredadas. atributo String list
adPathField1 Campo de ruta de anuncios 1. Los campos de ruta 1 y 2 se combinan con adDisplayUrl para formar la URL que se muestra en un anuncio. atributo String
adPathField2 Campo de ruta de anuncios 2. Los campos de ruta 1 y 2 se combinan con adDisplayUrl para formar la URL que se muestra en un anuncio. atributo String
effectiveLabels Nombres de todas las etiquetas heredadas o asignadas directamente a este anuncio. atributo String list
dfaActions Es la cantidad total de acciones en Campaign Manager. métrica Integer
dfaRevenue Ingresos totales generados por transacciones de Campaign Manager. métrica Money
dfaTransactions Es la cantidad total de transacciones de Campaign Manager. métrica Integer
dfaWeightedActions Suma ponderada de acciones de Campaign Manager. métrica Number
dfaActionsCrossEnv La cantidad total de acciones de Campaign Manager en varios entornos. métrica Number
dfaRevenueCrossEnv Ingresos totales generados por transacciones de Campaign Manager en varios entornos. métrica Money
dfaTransactionsCrossEnv La cantidad total de transacciones de Campaign Manager entre entornos. métrica Number
dfaWeightedActionsCrossEnv Suma ponderada de acciones de Campaign Manager en varios entornos métrica Number
avgCpc Costo por clic promedio. métrica Money
avgCpm Costo promedio por cada mil impresiones. métrica Money
avgPos Posición promedio. métrica Number
clicks Clics totales métrica Integer
cost Costo total pagado a las cuentas de motor. métrica Money
ctr Tasa de clics promedio métrica Number
impr Es la cantidad total de impresiones. métrica Integer
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
adWordsConversionValue Valor agregado de las conversiones de Google Ads. métrica Number
adWordsViewThroughConversions Es la cantidad total de conversiones posimpresión de Google Ads. métrica Integer
visits Indica la cantidad total de visitas a DS. métrica Integer
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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