Tipo de informe: palabra clave

Métricas de rendimiento y atributos de configuración para palabras clave.

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": "keyword".

{
...
  "reportType": "keyword",
  "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 de la palabra clave: 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
engineStatus Estado adicional de la palabra clave en la cuenta de motor externa. Los estados posibles (según el tipo de cuenta externa) incluyen criterion rarely served, criterion below first page bid, criterion low quality score, review, campaign paused, etcétera. atributo String
creationTimestamp Marca de tiempo de la creación de la palabra clave, con el formato ISO 8601. atributo Timestamp
lastModifiedTimestamp Marca de tiempo de la modificación más reciente de la palabra clave, con el formato ISO 8601. atributo Timestamp
agency Nombre de la agencia. atributo String
agencyId Es el ID de la agencia de DS. atributo ID
advertiser Es el nombre del anunciante. atributo String
advertiserId ID del anunciante de DS. atributo ID
account Nombre de la cuenta de buscador. atributo String
accountId ID de la cuenta de motor de DS. atributo ID
accountEngineId ID de la cuenta de la cuenta de motor externa. 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 la 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
keywordId ID de palabra clave de DS. El valor 0 indica que la palabra clave no tiene atribución. atributo ID
keywordMatchType Tipo de concordancia de palabras clave: Broad, Exact, Phrase o Content. atributo Match type
keywordText Texto de palabra clave atributo String
keywordEngineId Es el ID de la palabra clave en la cuenta de motor externa. atributo ID
keywordMaxCpc Anula el CPC máx. del grupo de anuncios y establece el importe máximo que está dispuesto a pagar si un usuario hace clic en un anuncio para esta palabra clave específica. Si este campo está vacío, la palabra clave utilizará el CPC máximo del grupo de anuncios. atributo Money
effectiveKeywordMaxCpc El CPC máximo (costo por clic máximo) que está vigente para esta palabra clave. Será el mismo valor que el CPC máximo del grupo de anuncios o, si la palabra clave anula la configuración del grupo de anuncios, el CPC máximo de la palabra clave. atributo Money
keywordLandingPage Es la URL final que visitaría un usuario después de hacer clic en tu anuncio. Consulta URL de página de destino y servidor de clics. atributo String
keywordClickserverUrl URL que utiliza DS para realizar un seguimiento de la actividad. Un usuario que hace clic en un anuncio primero visita la URL del servidor de clics y, luego, se lo redirecciona a la página de destino final. Consulta URL de página de destino y servidor de clics. atributo String
isDisplayKeyword Indica si se trata de una palabra clave de marcador de posición que se utiliza para los informes de anuncios gráficos y de posición. atributo Boolean
keywordMaxBid Si esta palabra clave es administrada por una estrategia de oferta de DS, la estrategia de oferta nunca aumentará las ofertas por encima de este límite. Consulte Cómo aplicar una estrategia de oferta a las palabras clave. atributo Money
keywordMinBid Si esta palabra clave es administrada por una estrategia de oferta de DS, la estrategia de oferta nunca disminuirá las ofertas por debajo de este límite. Consulte Cómo aplicar una estrategia de oferta a las palabras clave. atributo Money
keywordUrlParams Se agregaron parámetros de URL adicionales a la página de destino. Consulta Cómo agregar parámetros de URL. atributo String
bingKeywordParam2 Parámetro 2 de una palabra clave de Bing Ads. atributo String
bingKeywordParam3 Parámetro 3 de una palabra clave de Bing Ads. atributo String
keywordLabels Los nombres de las etiquetas que se asignaron directamente a esta palabra clave. no se incluyen las etiquetas heredadas. atributo String list
qualityScoreCurrent Solo Google Ads y Bing Ads. El valor más reciente del nivel de calidad (QS) del motor para una palabra clave. Tenga en cuenta que esta columna siempre informa el último nivel de calidad de una palabra clave, independientemente del período del informe. atributo Integer
topOfPageBidCurrent Solo en Google Ads. Calcula la oferta actual de CPC necesaria para que su anuncio se publique periódicamente en las primeras posiciones encima de los resultados de la búsqueda. Ten en cuenta que esta columna siempre informa el CPC que necesitas en la actualidad, independientemente del período del informe. atributo Money
effectiveBidStrategyId Es el ID de DS de la estrategia de oferta que se asignó a esta entidad o la heredó. atributo ID
effectiveBidStrategy El nombre de la estrategia de oferta que se asignó a esta entidad o la heredó. atributo String
bidStrategyInherited Indica si la estrategia de oferta de esta entidad es heredada. atributo Boolean
effectiveLabels Son los nombres de todas las etiquetas heredadas o asignadas directamente a esta palabra clave. atributo String list
dfaActions Es la cantidad total de acciones de Campaign Manager. métrica Integer
dfaRevenue Son los ingresos agregados 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 las acciones de Campaign Manager. métrica Number
dfaActionsCrossEnv Es la cantidad total de acciones del Administrador de campañas en varios entornos. métrica Number
dfaRevenueCrossEnv Son los ingresos agregados generados por transacciones de Campaign Manager multientorno. métrica Money
dfaTransactionsCrossEnv Es la cantidad total de transacciones de Campaign Manager en varios entornos. métrica Number
dfaWeightedActionsCrossEnv Suma ponderada de las 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 agregados. métrica Integer
cost Costo total pagado a la cuenta de motor. métrica Money
ctr Tasa de clics promedio métrica Number
impr Es la cantidad total de impresiones. métrica Integer
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
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 La cantidad total de visitas de DS. métrica Integer
qualityScoreAvg Solo Google Ads y Bing Ads. Es el promedio ponderado por impresiones del Nivel de calidad (NC) del motor de todos los días y las palabras clave incluidas en el alcance del informe. métrica Number
topOfPageBidAvg Solo en Google Ads. Calcula la oferta de CPC promedio necesaria durante el período del informe para que sus anuncios aparezcan periódicamente en las primeras posiciones encima de los resultados de la búsqueda. métrica Money
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
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
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
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 agregadas 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 agregadas se dividen en varias filas, una para cada semana. Esta columna muestra el último día (sábado) de cada fila. segmento Date
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
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
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
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
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
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
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
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
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
ad Segmenta el informe por anuncios. cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada anuncio. Esta columna muestra el nombre del anuncio en cada fila. segmento String
adId Segmenta el informe por anuncios. cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada anuncio. Esta columna devuelve el ID de DS del anuncio en cada fila. segmento ID
isUnattributedAd Segmenta el informe por anuncios. cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada anuncio. Esta columna indica si las métricas de esta fila no se pueden atribuir a un anuncio específico. segmento Boolean
adHeadline Segmenta el informe por anuncios. cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada anuncio. Esta columna muestra el título del anuncio en cada fila. segmento String
adHeadline2 Segmenta el informe por anuncios. cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada anuncio. Esta columna muestra el título 2 del anuncio en cada fila. No está disponible para algunos motores. segmento String
adHeadline3 Segmenta el informe por anuncios. cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada anuncio. Esta columna muestra el título 3 del anuncio en cada fila. No está disponible para algunos motores. segmento String
adDescription1 Segmenta el informe por anuncios. cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada anuncio. Esta columna muestra la línea descriptiva 1 del anuncio en cada fila. segmento String
adDescription2 Segmenta el informe por anuncios. cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada anuncio. Esta columna muestra la línea descriptiva 2 del anuncio en cada fila. segmento String
adDisplayUrl Segmenta el informe por anuncios. cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada anuncio. Esta columna muestra la URL visible del anuncio en cada fila. segmento String
adLandingPage Segmenta el informe por anuncios. cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada anuncio. Esta columna muestra la página de destino del anuncio en cada fila. segmento String
adType Segmenta el informe por anuncios. cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada anuncio. Esta columna muestra el tipo de anuncio en cada fila: Text o Product. segmento Ad type
adPromotionLine Segmenta el informe por anuncios. cada fila y sus métricas agregadas se dividen en varias filas, hasta una para cada anuncio. Esta columna devuelve la línea de promoción del anuncio de producto en cada fila. segmento String