Metrics
Métricas de Google Ads con la API
Tu cliente conecta su cuenta de Google Ads y tu producto consulta 94 métricas por el mismo endpoint que las demás plataformas. Cada métrica tiene un identificador (reference_key) que va en la llamada.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "gads:clicks",
"component": "number_v1",
"metrics": [
"metrics.clicks"
]
}
]
}Más ejemplos de llamadas a Google Ads
El mismo endpoint para cada tipo de métrica. Los campos metrics y dimensions de cada ítem vienen del catálogo de la plataforma (GET /api/metrics/{integration_slug}).
Gráfico
Clics por dispositivo
Ese gráfico muestra el número de clics en tus anuncios, agrupados por el dispositivo que la persona estaba utilizando.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "gads:clicks_per_device",
"component": "chart_v1",
"metrics": [
"metrics.clicks"
],
"dimensions": [
"device"
]
}
]
}Tabla
Resumen de los Grupos de Anuncio
Todos tus grupos de anuncio, ordenados por clics
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "gads:summary_per_adgroups",
"component": "datatable_v1",
"metrics": [
"metrics.clicks",
"metrics.cost_micros",
"metrics.impressions",
"metrics.conversions",
"metrics.absolute_top_impression_percentage",
"metrics.cost_per_conversion"
],
"dimensions": [
"ad_group"
]
}
]
}Número
Contaje de campañas
Número de campañas que tuvieron alguna inversión.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "gads:count_campaigns",
"component": "number_v1",
"metrics": [
"metrics.cost_micros"
],
"dimensions": [
"campaign"
]
}
]
}Números
57 métricas
Clics
Número de veces que alguien hizo clic en tu anuncio.
gads:clicksContaje de campañas
Número de campañas que tuvieron alguna inversión.
gads:count_campaignsContaje de anuncios
Número de anuncios que tuvieron alguna inversión.
gads:count_adsTodas la conversiones
Todas las conversiones incluyen los datos de tu columna "Conversiones" y las acciones de conversión que eligiste no incluir en la columna "Conversiones". También muestra conversiones en dispositivos diferentes, visitas a la tienda, determinadas llamadas telefónicas y más.
gads:all_conversionsValor de las conversiones
La suma de los valores de conversión de las conversiones incluidas en la columna 'Conversiones'. Esta métrica solo es útil si has ingresado un valor para tus acciones de conversión.
gads:conversions_valueValor de todas las conversiones
El valor de todas las conversiones incluye los datos de tu columna "Conversiones" y las acciones de conversión que decidiste no incluir en la columna "Conversiones". También muestra conversiones en dispositivos diferentes, visitas a la tienda, ciertas llamadas telefónicas y mucho más.
gads:all_conversions_valueConversiones
Una acción que es contabilizada cuando alguien interactúa con tu anuncio o lista de productos gratuitos (por ejemplo, hace clic en un anuncio de texto o mira un anuncio de video) y, luego realiza una acción que has definido como valiosa (por ejemplo, una compra en línea o una llamada a tu empresa desde un teléfono inteligente).
gads:conversionsImpresiones
Número de veces que tu anuncio apareció en una página de búsquedas o en Google. Un anuncio puede aparecer várias veces para el mismo usuario.
gads:impressionsReproducciones de vídeo
Número de veces que se vieron sus videos. Una vista cuenta cuando una persona ve 30 segundos de su video (o el video completo si es más corto) o interactúa con él. Las interacciones elegibles varían según el formato de anuncio e incluyen clics o toques en CTA, tarjetas, pancartas complementarias, miniaturas o logotipos.
gads:video_viewsCTR
Click Through Rate (CTR) representa el número total de clics que tu anuncio recibió dividido por el número de veces que se mostró (impresiones).
gads:ctrCoste
La cantidad de dinero gasta en tu campaña de anuncios en el periodo de tiempo especificado.
gads:cost_microsCostes por todas las conversiones
Costo por conversión total le indica cuánto cuesta, en promedio, cada una de sus conversiones. Se calcula dividiendo el costo total por el número total de conversiones. Todas las conversiones tienen en cuenta los datos de todas las acciones de conversión, incluidas las que elegiste no incluir en "Conversiones". También cubre otras fuentes de conversión especiales.
gads:cost_per_all_conversionsCoste por Conversión
Costo total dividido por todas las conversiones.
gads:cost_per_conversionCPM medio
Costo por Mil (CPM) es el precio promedio de 1000 impresiones. Él es calculado dividiendo el Valor Invertido/ Número de Impresiones x 1000. CPM es una métrica común en la publicidad en línea para indicar el costo-beneficio de una campaña de anuncios. Es frecuentemente usada para comparar rendimiento entre diferentes campañas.
gads:average_cpmCPC promedio
El coste por clic (CPC) muestra cuánto, en promedio, le cuesta cada clic de enlace. Se calcula dividiendo el coste / número de clics. El CPC es una métrica utilizada en la industria de la publicidad online para comparar la eficiencia y el rendimiento de los anuncios.
gads:average_cpcCPV promedio
El costo por vista (CPV) es un método de oferta para campañas de video en las que paga por una vista. Una vista cuenta cuando alguien ve 30 segundos de su anuncio de video (o el anuncio completo si dura menos de 30 segundos) o interactúa con él, lo que ocurra primero. Las interacciones de video incluyen clics en superposiciones de llamadas a la acción (CTA), tarjetas y pancartas complementarias. Establece ofertas de CPV para decirle a Google la cantidad máxima que está dispuesto a pagar por visualización.
gads:average_cpvTasa de Conversión
La tasa de conversión muestra la frecuencia promedio con la que una interacción con un anuncio genera una conversión. Este es el número indicado en "Conversiones" dividido por el número de interacciones con su anuncio. Las interacciones con anuncios incluyen clics en anuncios de texto y visualizaciones de anuncios de video. Esta métrica solo incluye interacciones que pueden generar conversiones.
gads:conversions_from_interactions_rateROAS
El retorno de la inversión publicitaria (ROAS) es la ganancia que obtiene de sus anuncios en relación con sus inversiones publicitarias. Se calcula dividiendo el valor de las conversiones por el costo.
gads:roasValor de todas las conversiones por costo
El valor de todas las conversiones por costo mide el ROI de todas las conversiones. Es el valor de todas las conversiones dividido por el costo de todas las interacciones con anuncios, como clics en anuncios de texto o vistas de anuncios de video. Esta métrica no incluye interacciones que no generan conversiones, como las que ocurren cuando no utiliza el seguimiento de conversiones.
gads:all_conversions_value_per_costValor de las conversiones por costo
El valor de conversión de costo a costo mide el retorno de la inversión. Refleja el valor de conversión dividido por el costo de todas las interacciones con los anuncios. El costo de esta métrica no incluye las interacciones que no pueden generar conversiones, como las que ocurren cuando no utiliza el seguimiento de conversiones.
gads:conversions_value_per_costLlamadas telefónicas
Número de veces que las personas hicieron clic en un número de teléfono mostrado en un anuncio para dispositivos móviles o marcaron el número de reenvío de llamadas de Google mostrado en un anuncio en cualquier dispositivo.
gads:phone_callsVer tasa de videos
La métrica "Tasa de visualización" le muestra el porcentaje de personas que vieron sus videos después de ver el video o la miniatura por primera vez. Es igual a la cantidad de vistas de su anuncio dividida por la cantidad de impresiones, incluidas las impresiones de miniaturas de anuncios de descubrimiento de video
gads:video_view_rateConversiones de vídeo
Número de veces que los espectadores realizaron la acción deseada después de ver el anuncio de video durante el período analizado.
gads:video_conversionsTasa de conversión de vídeo
La tasa de conversión muestra la frecuencia promedio con la que una interacción con un anuncio da como resultado una conversión. Es igual al número indicado en "Conversiones" dividido por el número de interacciones con su anuncio. Las interacciones con anuncios incluyen clics en anuncios de texto y visualizaciones de anuncios de video. Esto La métrica solo incluye interacciones que pueden generar conversiones
gads:video_conversions_rateVídeos CTR
La tasa de clics (CTR) mide la frecuencia con la que las personas hacen clic en su anuncio después de verlo. Esto puede ayudarlo a comprender la efectividad del anuncio. Para calcular el CTR, debe dividir la cantidad de clics que recibe su anuncio por la cantidad de veces que se muestra.
gads:video_ctrImpresiones de vídeo
Número de veces que se mostró el anuncio de video a los espectadores en la plataforma de YouTube durante el período del informe. Esto significa que cada vez que un espectador ve el anuncio, se cuenta una impresión, independientemente de si vieron el video completo o solo una parte.
gads:video_impressionsClics de vídeo
Número de veces que el espectador hizo clic en el anuncio de video durante su visualización en el período analizado.
gads:video_clicksTasa de interacción
La "tasa de interacción" es el número de interacciones dividido por el total de impresiones. Mide la frecuencia con la que las personas interactúan con su anuncio después de haber sido expuestas a él. Esto le ayuda a evaluar la eficacia del anuncio.
gads:interaction_rateInteracciones
Una interacción es la acción principal asociada a un formato de anuncio. Puede incluir clics en anuncios de texto y de Shopping, vistas en anuncios de video y más.
gads:interactions% de impresiones (arriba)
La tasa de impresiones de búsqueda principales es el porcentaje de impresiones que se muestran en cualquier lugar encima de los resultados de búsqueda orgánicos.
gads:top_impression_percentageInteraccións
Una interacción se produce cuando un consumidor interactúa con un anuncio, por ejemplo, viendo al menos 10 segundos o haciendo clic en un anuncio de vídeo. Por tanto, ayuda a medir el rendimiento del anuncio. Los anuncios relevantes y altamente orientados con contenido atractivo alientan a los usuarios a interactuar más activamente con su marca.
gads:engagementsTasa de interaccíon
La tasa de participación se utiliza para medir la frecuencia con la que las personas interactúan con su anuncio después de que se les muestra. Úselo para evaluar la efectividad de su anuncio. La tasa de participación es la cantidad de interacciones dividida por el total de impresiones.
gads:engagement_rateCPE promedio
El costo promedio por interacción (CPE) es el monto promedio cobrado por una interacción publicitaria. Esta cantidad representa el costo total de las interacciones publicitarias dividido por el número total de interacciones publicitarias.
gads:cpe% de impresiones (1.ª posición)
La tasa de primera impresión de búsqueda es el porcentaje de impresiones que aparecen como el primer anuncio encima de los resultados de búsqueda orgánicos.
gads:absolute_top_impression_percentageParticipación de Impresiones en Búsqueda
La cuota de impresiones (IS) es el porcentaje de impresiones que tus anuncios reciben en comparación con el número total de impresiones que podrían recibir. Los valores por debajo del 10% aparecen como 9,99%, porque Google no informa el número exacto en ese rango.
gads:search_impression_shareVisualizaciones de la página
El número de veces que se visualizó una página después de una interacción con el anuncio.
gads:conversions_page_viewsAdiciones al carrito
Número de veces que los productos fueron agregados al carrito de compras por los usuarios después de interactuar con anuncios.
gads:conversion_add_to_cartIniciar Pago
El número de veces que una persona inició el proceso de pago después de una interacción con el anuncio.
gads:conversion_begin_checkoutCompras
Número de transacciones completadas a través de anuncios, indicando cuántas Compras/ventas fueron generadas directamente por las campañas de Google Ads.
gads:conversion_purchaseSolicitudes de programación
El número de veces que se reservó una cita después de una interacción con el anuncio.
gads:conversion_book_appointmentContactos
Esta métrica cuenta el número de contactos realizados a través de formularios, chats u otras formas de comunicación ofrecidas en el sitio web, después de interactuar con los anuncios.
gads:conversion_contactDescargar
Número de descargas de archivos o aplicaciones que se realizaron después de que los usuarios hicieran clic en los anuncios durante el período analizado.
gads:conversion_downloadLead Convertido
Número de leads convertidos en el período analizado. Un lead convertido o "cerrado" te ayuda a rastrear los leads generados por Google que han completado un paso elegido en el proceso de conversión de leads, típicamente offline (fuera de Google Ads). Este paso puede definirse como completar una venta, una transacción cerrada offline o online, o cualquier paso que determines como "conversión".
gads:conversion_converted_leadConversiones (Interacción)
El número de veces que una persona interactuó con tu anuncio después de una interacción con el anuncio.
gads:conversion_engagementObtener direcciones
El número de veces que una persona solicitó direcciones para tu negocio después de una interacción con el anuncio.
gads:conversion_get_directionsClic de Salida
El número de veces que una persona hizo clic en un enlace a otro sitio después de una interacción con el anuncio.
gads:conversion_outbound_clickLead de Llamada Telefónica
"Phone Call Lead" muestra cuántas veces se mostró su anuncio con un número de desvío de llamadas de Google, o cuántas veces un número de desvío de llamadas de Google podría haberse mostrado a alguien en su sitio web.
gads:conversion_phone_call_leadLead Calificado
Número de leads calificados en el período analizado. Un lead calificado o "interesado" te ayuda a rastrear los leads generados por Google que también fueron calificados offline (fuera de Google Ads) en tu sistema de gestión de relaciones con el cliente (CRM) o sistema interno de generación de leads.
gads:conversion_qualified_leadSolicitudes de cotización
El número de veces que una persona solicitó una cotización después de una interacción con el anuncio.
gads:conversion_request_quoteSuscripciones
Número de veces que alguien se suscribió a un boletín informativo o prueba gratuita, creó una cuenta o se pre-registró.
gads:conversion_sign_upVisitas a la Tienda
Número de clientes que recibieron o hicieron clic en sus anuncios en línea y luego visitaron su tienda física.
gads:conversion_store_visitVentas en la Tienda
Número de compras offline que ocurrieron después de que los clientes interactuaron con sus anuncios de Google.
gads:conversion_store_saleEnviar Formulario de Lead
Número de formularios de lead enviados después de interactuar con anuncios. Estos formularios generalmente recopilan información de usuarios interesados en productos o servicios, siendo esenciales para generar leads calificados.
gads:conversion_submit_lead_formEnviar Formulario de Lead (todas las conversiones)
Número total de conversiones* de formularios de lead enviados tras interactuar con anuncios. Estos formularios generalmente recopilan información de usuarios interesados en productos o servicios, siendo esenciales para generar leads calificados. *Todas las conversiones incluye lo que está configurado como "Conversiones" y otros datos, como conversiones marcadas como acciones secundarias.
gads:conversion_submit_lead_form_all_conversionsSuscripciones pagas
Esta métrica cuenta el número de inscripciones o registros realizados por usuarios después de hacer clic en un anuncio.
gads:conversion_subscribe_paidPTR (Tasa de Paso)
El número total de llamadas (llamadas telefónicas) recibidas dividido por el número de veces que se mostró tu número de teléfono (impresiones de número de teléfono).
gads:ptrCosto por Llamada Telefónica
El costo total de tus anuncios dividido por el número de llamadas telefónicas recibidas.
gads:cost_per_phone_calls
Gráficos
13 métricas
Clics por dispositivo
Ese gráfico muestra el número de clics en tus anuncios, agrupados por el dispositivo que la persona estaba utilizando.
gads:clicks_per_deviceClics y CTR a lo largo del tiempo
Este gráfico muestra el número de clics y el porcentaje de CTR en el período de tiempo especificado
gads:clicks_ctr_per_dayConversiones por Dispositivo
Ese gráfico demuestra el número de conversiones generadas por tus anuncios, agrupados por el dispositivo que la persona estaba utilizado.
gads:conversions_by_deviceImpresiones por Género
Este gráfico muestra la cantidad de impresiones que generaron sus anuncios, agrupadas por género.
gads:impressions_by_genderImpresiones por edad
Este gráfico muestra la cantidad de impresiones que generaron sus anuncios, agrupadas por edad.
gads:impressions_by_ageCoste por Dispositivo
Coste de tus anuncios, agrupado por el dispositivo que la persona usaba.
gads:cost_per_deviceTodas las conversiones y Tasa de Conversión a lo largo del tiempo
Ese gráfico demuestra el número de todas conversiones y la tasa de conversión en el periodo especificado.
gads:all_conversion_conversion_rate_per_dayConversiones y Tasa de Conversión a lo largo del tiempo
Ese grafico demuestra el número de conversiones y la tasa de conversión en el periodo de tiempo especificado.
gads:conversion_conversion_rate_per_dayCoste y CPC Promedio a lo largo del tiempo
Este gráfico muestra el costo y el promedio del CPC en el tiempo especificado.
gads:cost_average_cpc_per_dayImpresiones y visualizaciones de vídeo
Este gráfico representa la cantidad de veces que se mostraron los anuncios de video (impresiones) y cuántas veces se reprodujeron (vistas) durante el período de tiempo analizado.
gads:video_impressions_by_timeClics vidéo et CTR
Este gráfico le permite verificar la cantidad de clics que recibieron los anuncios de video (Clics) y la tasa de clics en relación con la cantidad de veces que se mostraron los anuncios (CTR - Tasa de clics) durante el período analizado.
gads:video_clicks_ctr_by_timeConversión y tasa de conversión de videos
Este gráfico demuestra la cantidad de acciones deseadas (Conversión) que realizó el espectador de los anuncios después de verlos, así como la tasa de conversión en relación con la cantidad de veces que se mostraron los anuncios (Tasa de conversión) durante el período analizado.
gads:video_conversions_by_timeCosto y CPM promedio de videos
Este gráfico muestra el costo total de las campañas de anuncios de video (Coste) y el costo promedio para entregar 1,000 impresiones (CPM - Costo por mil) durante el período de análisis.
gads:video_cost_by_time
Tablas
24 métricas
Resumen de los Grupos de Anuncio
Todos tus grupos de anuncio, ordenados por clics
gads:summary_per_adgroupsTodas las Campañas
Todas tus campañas de anuncio, ordenadas por clics
gads:top_campaignsDesempeño de Campañas por ID
Todas sus campañas de anuncio con IDs de campaña, ordenadas por clics.
gads:campaign_performance_by_idResumen de las Palabras Clave en la búsqueda
Todas las palabras clave de búsqueda en las que has gastado dinero, ordenadas por clics.
gads:summary_per_keywordsResumen de términos de búsqueda de campañas inteligentes
Resumen del rendimiento para cada uno de los términos de búsqueda de las campañas inteligentes durante el período analizado. Los términos de búsqueda son las palabras o frases que los usuarios escriben en una búsqueda de Google y que activan la aparición de anuncios.
gads:summary_per_smart_campaign_search_termDesempenho de la URL de destino
Resumen de cómo cada URL de destino realizó durante el período analizado.
gads:destination_url_performanceVideos destacados
Esta tabla proporciona información detallada sobre cada video publicitario en YouTube. Presenta datos como la cantidad de vistas, clics, costo, tasa de visualización y otros indicadores importantes para que pueda evaluar el rendimiento individual de cada video.
gads:featured_videosAcciones de conversión
Todos los tipos de conversiones personalizadas que recibió la campaña después de las interacciones con los anuncios.
gads:custom_conversion_actionsTérminos de búsqueda
Resumen del rendimiento de sus términos de búsqueda durante el período analizado. Los términos de búsqueda son los términos utilizados por un número significativo de personas que dieron como resultado que su anuncio se mostrara en el momento de la búsqueda.
gads:search_termCanales destacados
Resumen de rendimiento de las ubicaciones en las que aparecieron sus anuncios durante el período de revisión. Los canales son donde aparecen sus anuncios en YouTube o en la Red de Display de Google. Una ubicación puede ser un sitio web o una página específicos, una aplicación móvil, contenido de video o un bloque de anuncios individual.
gads:detail_group_placementAnuncios destacados
Resumen del rendimiento de sus anuncios no inteligentes en el período analizado.
gads:ads_summary_tableAnuncios de texto destacados
Resumen del rendimiento de sus anuncios, en el período analizado.
gads:text_ads_summary_tableRendimiento por ciudad
Esta tabla detalla el rendimiento de los anuncios segmentados por diferentes ciudades. Te permite evaluar cómo están funcionando tus campañas en ciudades específicas, ayudándote a identificar qué ciudades están generando más clics y conversiones.
gads:performance_by_cityRendimiento por estado
Esta tabla detalla el rendimiento de los anuncios segmentados por diferentes estados. Te permite evaluar cómo están funcionando tus campañas en estados específicos, ayudándote a identificar qué estados están generando más clics y conversiones.
gads:performance_by_stateRendimiento por región
Esta tabla detalla el rendimiento de los anuncios segmentados por diferentes estados. Te permite evaluar cómo están funcionando tus campañas en estados específicos, ayudándote a identificar qué estados están generando más clics y conversiones.
gads:performance_by_regionRendimiento por aeropuerto
Esta tabla detalla el rendimiento de los anuncios segmentados por diferentes aeropuertos. Te permite evaluar cómo están funcionando tus campañas en aeropuertos específicos, ayudándote a identificar qué aeropuertos están generando más clics y conversiones.
gads:performance_by_airportRendimiento por condado
Esta tabla detalla el rendimiento de los anuncios segmentados por diferentes condados. Te permite evaluar cómo están funcionando tus campañas en condados específicos, ayudándote a identificar qué condados están generando más clics y conversiones.
gads:performance_by_countyRendimiento por distrito
Esta tabla detalla el rendimiento de los anuncios segmentados por diferentes distritos. Te permite evaluar cómo están funcionando tus campañas en distritos específicos, ayudándote a identificar qué distritos están generando más clics y conversiones.
gads:performance_by_districtRendimiento por código postal
Esta tabla detalla el rendimiento de los anuncios segmentados por diferentes códigos postales. Te permite evaluar cómo están funcionando tus campañas en códigos postales específicos, ayudándote a identificar qué códigos postales están generando más clics y conversiones.
gads:performance_by_postal_codeRendimiento por región metropolitana
Esta tabla detalla el rendimiento de los anuncios segmentados por diferentes regiones metropolitanas. Te permite evaluar cómo están funcionando tus campañas en regiones metropolitanas específicas, ayudándote a identificar qué regiones están generando más clics y conversiones.
gads:performance_by_metroRendimiento por país
Esta tabla detalla el rendimiento de los anuncios segmentados por diferentes países. Te permite evaluar cómo están funcionando tus campañas en países específicos, ayudándote a identificar qué países están generando más clics y conversiones.
gads:performance_by_countryDesempenho por Grupo de Recurso PMAX
Desempenho detallado por Grupo de Recurso
gads:pmax_asset_group_performanceDesempenho por Recurso PMAX
Desempenho de cada recurso creativo
gads:pmax_asset_performanceDesempenho por Localización PMAX
Desempenho por región geográfica
gads:pmax_location_performance
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
