La API anterior de Search Ads 360 Reporting dejará de estar disponible y se retirará el 30 de junio de 2024. Ten en cuenta que la API de conversiones de Search Ads 360 no se ve afectada y seguirá siendo compatible. Todo el desarrollo de informes nuevo debe usar la nueva API de Search Ads 360 Reporting.

A partir de abril de 2024, se mostrará un error supportedApiVersion cuando se solicite un informe. Consulte los detalles aquí.

También te recomendamos que migres todas las implementaciones existentes de Search Ads 360 a la nueva API. Consulta la introducción y la guía de migración de la nueva API de Search Ads 360 Reporting para obtener más información.

Se usó la API de Cloud Translation para traducir esta página.

Tipo de informe: palabra clave

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

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

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

`columnName`	Descripción	Comportamiento	Tipo	Filtrable
`status`	El estado de la palabra clave: `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`	Sí
`engineStatus`	Es el estado adicional de la palabra clave en la cuenta de motor externo. 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`	Sí
`creationTimestamp`	La marca de tiempo de la creación de la palabra clave, con el formato ISO 8601.	atributo	`Timestamp`	Sí
`lastModifiedTimestamp`	La marca de tiempo de la modificación más reciente de la palabra clave, con el formato ISO 8601.	atributo	`Timestamp`	Sí
`agency`	Nombre de la agencia.	atributo	`String`	Sí
`agencyId`	ID de agencia de DS.	atributo	`ID`	Sí
`advertiser`	Nombre del anunciante	atributo	`String`	Sí
`advertiserId`	ID del anunciante de DS.	atributo	`ID`	Sí
`account`	Nombre de la cuenta de motor.	atributo	`String`	Sí
`accountId`	ID de cuenta de motor de DS.	atributo	`ID`	Sí
`accountEngineId`	ID de la cuenta en la cuenta de motor externo.	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 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í
`keywordId`	ID de palabra clave de DS. El valor 0 indica que la palabra clave no tiene un atributo.	atributo	`ID`	Sí
`keywordMatchType`	Tipo de concordancia de palabras clave: `Broad`, `Exact`, `Phrase` o `Content`.	atributo	`Match type`	Sí
`keywordText`	Texto de la palabra clave.	atributo	`String`	Sí
`keywordEngineId`	ID de la palabra clave en la cuenta del motor externo.	atributo	`ID`	Sí
`keywordMaxCpc`	Anula el CPC máximo 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`	Sí
`effectiveKeywordMaxCpc`	El CPC máximo (costo por clic máximo) vigente para esta palabra clave Este valor será el mismo que el CPC máximo del grupo de anuncios o, si la palabra clave anula la configuración del grupo de anuncios, tendrá el mismo CPC máx.	atributo	`Money`	Sí
`keywordLandingPage`	La URL final que un usuario visitaría después de hacer clic en su anuncio. Consulta Página de destino y URL de clickserve.	atributo	`String`	Sí
`keywordClickserverUrl`	URL que DS utiliza para realizar el seguimiento de la actividad. Un usuario que haga clic en un anuncio primero visitará la URL del servidor de clics y, luego, se lo redireccionará a la página de destino final. Consulta Página de destino y URL de clickserve.	atributo	`String`	Sí
`isDisplayKeyword`	Indica si se trata de una palabra clave de marcador de posición que se utiliza para generar informes sobre las ubicaciones y la Red de Display.	atributo	`Boolean`	Sí
`keywordMaxBid`	Si una palabra clave de DS administra esta palabra clave, la estrategia de oferta nunca aumentará las ofertas por encima de este límite. Consulte el artículo Cómo aplicar una estrategia de oferta a palabras clave.	atributo	`Money`	Sí
`keywordMinBid`	Si una palabra clave de DS administra esta palabra clave, la estrategia de oferta nunca disminuirá por debajo de este límite. Consulte el artículo Cómo aplicar una estrategia de oferta a palabras clave.	atributo	`Money`	Sí
`keywordUrlParams`	Se agregaron parámetros de URL adicionales a la página de destino. Consulte Cómo agregar parámetros de URL.	atributo	`String`	Sí
`bingKeywordParam2`	Parámetro 2 de una palabra clave de Bing Ads.	atributo	`String`	Sí
`bingKeywordParam3`	Parámetro 3 de una palabra clave de Bing Ads.	atributo	`String`	Sí
`keywordLabels`	Son los nombres de las etiquetas que se asignaron directamente a esta palabra clave. No se incluyen las etiquetas heredadas.	atributo	`String list`	Sí
`qualityScoreCurrent`	Solo Google Ads y Bing Ads. El valor más reciente del Nivel de calidad del motor de búsqueda 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`	Sí
`topOfPageBidCurrent`	Solo Google Ads Se aproxima la oferta de CPC actual necesaria para que el anuncio se publique periódicamente en las primeras posiciones sobre los resultados de la búsqueda. Tenga en cuenta que esta columna siempre informa el CPC que se necesita actualmente independientemente del intervalo de tiempo del informe.	atributo	`Money`	Sí
`effectiveBidStrategyId`	El ID de DS de la estrategia de oferta asignada a esta entidad o heredada por esta entidad.	atributo	`ID`	Sí
`effectiveBidStrategy`	Es el nombre de la estrategia de oferta asignada a esta entidad o heredada por esta.	atributo	`String`	Sí
`bidStrategyInherited`	Indica si la estrategia de oferta de esta entidad es heredada.	atributo	`Boolean`	Sí
`effectiveLabels`	Nombres de todas las etiquetas heredadas o asignadas directamente a esta palabra clave.	atributo	`String list`	Sí
`dfaActions`	Es la cantidad total de acciones en Campaign Manager.	métrica	`Integer`	Sí
`dfaRevenue`	Ingresos totales 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 acciones de Campaign Manager.	métrica	`Number`	Sí
`dfaActionsCrossEnv`	La cantidad total de acciones de Campaign Manager en varios entornos.	métrica	`Number`	Sí
`dfaRevenueCrossEnv`	Ingresos totales generados por transacciones de Campaign Manager en varios entornos.	métrica	`Money`	Sí
`dfaTransactionsCrossEnv`	La cantidad total de transacciones de Campaign Manager entre entornos.	métrica	`Number`	Sí
`dfaWeightedActionsCrossEnv`	Suma ponderada de 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 totales	métrica	`Integer`	Sí
`cost`	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`	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`	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`	Indica la cantidad total de visitas a DS.	métrica	`Integer`	Sí
`qualityScoreAvg`	Solo Google Ads y Bing Ads. Promedio ponderado de impresiones del Nivel de calidad del motor (QS) de todos los días y palabras clave dentro del alcance del informe.	métrica	`Number`	Sí
`topOfPageBidAvg`	Solo Google Ads Indica la oferta de CPC promedio aproximada que necesita durante el intervalo de tiempo del informe para que sus anuncios aparezcan periódicamente en las primeras posiciones sobre los resultados de la búsqueda.	métrica	`Money`	Sí
`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`	Sí
`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`	Sí
`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`	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 globales 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 globales 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 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`	Sí
`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`	Sí
`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`	Sí
`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`	Sí
`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`	Sí
`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`	Sí
`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`	Sí
`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`	Sí
`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`	Sí
`ad`	Segmenta el informe por anuncios. Cada fila y sus métricas globales se dividen en varias filas, hasta una por cada anuncio. Esta columna muestra el nombre del anuncio en cada fila.	segmento	`String`	Sí
`adId`	Segmenta el informe por anuncios. Cada fila y sus métricas globales se dividen en varias filas, hasta una por cada anuncio. Esta columna muestra el ID de DS del anuncio en cada fila.	segmento	`ID`	Sí
`isUnattributedAd`	Segmenta el informe por anuncios. Cada fila y sus métricas globales se dividen en varias filas, hasta una por cada anuncio. Esta columna indica si las métricas de esta fila no se pueden atribuir a un anuncio específico.	segmento	`Boolean`	Sí
`adHeadline`	Segmenta el informe por anuncios. Cada fila y sus métricas globales se dividen en varias filas, hasta una por cada anuncio. Esta columna muestra el título del anuncio en cada fila.	segmento	`String`	Sí
`adHeadline2`	Segmenta el informe por anuncios. Cada fila y sus métricas globales se dividen en varias filas, hasta una por cada anuncio. Esta columna muestra el título 2 del anuncio en cada fila. No está disponible para algunos motores.	segmento	`String`	Sí
`adHeadline3`	Segmenta el informe por anuncios. Cada fila y sus métricas globales se dividen en varias filas, hasta una por cada anuncio. Esta columna muestra el título 3 del anuncio en cada fila. No está disponible para algunos motores.	segmento	`String`	Sí
`adDescription1`	Segmenta el informe por anuncios. Cada fila y sus métricas globales se dividen en varias filas, hasta una por cada anuncio. Esta columna muestra la línea descriptiva 1 del anuncio en cada fila.	segmento	`String`	Sí
`adDescription2`	Segmenta el informe por anuncios. Cada fila y sus métricas globales se dividen en varias filas, hasta una por cada anuncio. Esta columna muestra la línea descriptiva 2 del anuncio en cada fila.	segmento	`String`	Sí
`adDisplayUrl`	Segmenta el informe por anuncios. Cada fila y sus métricas globales se dividen en varias filas, hasta una por cada anuncio. Esta columna muestra la URL visible del anuncio en cada fila.	segmento	`String`	Sí
`adLandingPage`	Segmenta el informe por anuncios. Cada fila y sus métricas globales se dividen en varias filas, hasta una por cada anuncio. Esta columna muestra la página de destino del anuncio en cada fila.	segmento	`String`	Sí
`adType`	Segmenta el informe por anuncios. Cada fila y sus métricas globales se dividen en varias filas, hasta una por cada anuncio. Esta columna muestra el tipo de anuncio en cada fila: `Text` o `Product`.	segmento	`Ad type`	Sí
`adPromotionLine`	Segmenta el informe por anuncios. Cada fila y sus métricas globales se dividen en varias filas, hasta una por cada anuncio. Esta columna muestra la línea de promoción del anuncio de productos en cada fila.	segmento	`String`	Sí