Tipo de informe: anuncio

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

Este informe solo puede mostrarse a través de una solicitud asíncrona (es decir, mediante el Reports.request()).

Solicitar extracto

Enviar un Reports.request() de la solicitud, 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 se filtre en el informe, especifica los columnName que se indican en la siguiente tabla. También puedes especificar headerText startDate, y endDate. Ten en cuenta que algunas columnas no se pueden filtrar. consulta "Filtrable" en la siguiente tabla.

columnNameDescripciónComportamientoTipoFiltrable
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 Es la marca de tiempo de la creación del anuncio, con el formato ISO 8601. atributo Timestamp Sí
lastModifiedTimestamp Marca de tiempo de la modificación más reciente del anuncio, con el 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 Nombre de la cuenta de buscador. atributo String Sí
accountId ID de la cuenta de 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 El estado de la campaña que contiene este elemento. atributo Status Sí
adGroup Nombre del grupo de anuncios. atributo String Sí
adGroupId ID del grupo de anuncios de DS. atributo ID Sí
adGroupStatus El estado del grupo de anuncios que contiene este elemento. atributo Status Sí
ad 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 está 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 1 del anuncio. atributo String Sí
adDescription2 línea descriptiva 2 del anuncio; no está disponible para algunos motores. atributo String Sí
adDisplayUrl URL visible del anuncio atributo String Sí
adLandingPage Página de destino del anuncio Consulta URL de página de destino y servidor de clics. atributo String Sí
adType Indica 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 Es un breve mensaje promocional para un anuncio de producto. atributo String Sí
adLabels Los nombres de las etiquetas que se asignaron 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 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 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 generados por transacciones de Campaign Manager multientorno. métrica Money Sí
dfaTransactionsCrossEnv Es la cantidad total de transacciones de Campaign Manager en varios entornos. métrica Number Sí
dfaWeightedActionsCrossEnv Suma ponderada de las 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 agregados. métrica Integer Sí
cost Costo total pagado a la cuenta 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 registrarse 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 La cantidad total de visitas de 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 Segmentar 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 Segmentar 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 dispositivos de cada fila. segmento Device segment Sí
floodlightGroup Segmentar 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 devuelve 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 Segmentar 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 devuelve 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 Segmentar 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 devuelve la etiqueta de 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 Segmentar 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 devuelve 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 Segmentar 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 devuelve el ID de 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 Segmentar 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í