DocumentaciónExperience PlatformGuía de conectores de origen

Google Ads (V2)

Última actualización: 2 de octubre de 2026

Creado para:

  • Developer
IMPORTANT
El origen Google Ads está disponible como parte del SKU Customer Journey Analytics.

Google Ads (V2) es un conector de origen de medios de pago de Adobe Experience Platform que ingiere datos de cuenta publicitaria, campaña, grupo de anuncios, anuncio, recurso, experiencia y rendimiento de la API Google Ads en Experience Platform.

El conector asigna datos de Google Ads a estructuras de modelo de datos de experiencia (XDM) de medios pagados estandarizados, lo que le permite analizar datos de Google Ads junto con datos de otras redes de publicidad, propiedades web, sistemas de comercio y aplicaciones de clientes.

Google Ads (V2) utiliza acceso de solo lectura para recuperar los datos de informes y los metadatos de publicidad. No crea, modifica ni elimina Google Ads recursos.

Ejemplos de casos de uso

Ejemplo de uso
Objetivo
Cómo ayuda Google Ads (V2)
Análisis de publicidad en canales múltiples
Comparar el rendimiento de Google Ads con Meta Ads y otros canales de medios de pago.
Ingesta datos de Google Ads en estructuras XDM de medios pagados comunes con identificadores estandarizados en cada nivel de entidad.
Modelado y atribución de mezcla de medios
Evaluar la contribución de los medios de pago a los resultados empresariales.
Proporciona datos de rendimiento de campañas y publicidad, incluidas impresiones, clics, gastos, conversiones y valores de conversión para el análisis descendente.
Optimización de campaña y presupuesto
Comprenda qué campañas, estrategias de oferta y configuraciones de segmentación producen los mejores resultados.
Ingesta metadatos de campaña, presupuestos, estrategias de oferta, tipos de canal, estados, fechas y criterios de objetivo seleccionados.
Creative y rendimiento de los recursos
Identifique qué recursos creativos, formatos de publicidad y experiencias funcionan mejor.
Ingesta metadatos creativos de nivel de anuncio, incluidas asociaciones, tipos y etiquetas de rendimiento de recursos.
Análisis de rendimiento máximo
Analizar el rendimiento de los grupos de recursos máximos y sus recursos asociados.
Utiliza datos de grupo de recursos de rendimiento máximo para representar el rendimiento de grupo de recursos y las relaciones de experiencia donde Google Ads no expone una estructura tradicional de nivel de anuncios.
Análisis del recorrido del cliente
Relacione la participación de la publicidad con eventos web, comerciales, CRM y de otros clientes.
Hace que Google Ads datos estén disponibles en Experience Platform para su uso con los flujos de trabajo de activación y análisis descendentes.

Requisitos previos

Antes de conectar Google Ads (V2) a Experience Platform, asegúrese de que dispone de lo siguiente:

Configuración de permisos en Experience Platform

Debe tener los permisos para Ver fuentes y Administrar fuentes habilitados para su cuenta de Experience Platform.

Póngase en contacto con el administrador del producto si no tiene los permisos necesarios. Para obtener más información, lea la guía de la interfaz de usuario de control de acceso.

Configurar el acceso a la API Google Ads

Experience Platform administra el flujo de autorización de OAuth 2.0 para Google Ads (V2). No cree ningún proyecto de Google Cloud, cliente de OAuth ni token de actualización.

Debe tener:

  • Un token de desarrollador Google Ads válido.
  • Acceso a la cuenta de anunciante Google Ads que desea introducir.
  • Permiso para acceder a las cuentas de anunciante relevantes a través de Google Ads o una cuenta de administrador de Google Ads.

Acceso desde la cuenta del responsable

Si se accede a la cuenta del anunciante a través de una cuenta de administrador de Google Ads, proporcione también el identificador de cliente del administrador apropiado como loginCustomerId.

loginCustomerId no es necesario cuando el usuario autorizado por OAuth puede acceder directamente a la cuenta del anunciante de destino y no se necesita ninguna jerarquía de administrador.

Google Ads (V2) enumera las cuentas accesibles, identifica las cuentas de administrador, atraviesa la jerarquía de cuentas de administrador y resuelve las cuentas de anunciante disponibles para la ingesta.

Recopilar credenciales necesarias

Para conectar Google Ads (V2) a Experience Platform, proporcione los siguientes valores.

Credencial
Descripción
developerToken
El token de desarrollador Google Ads usado para autorizar solicitudes de API.
loginCustomerId
El ID numérico de cliente de la cuenta de responsable utilizada para acceder a la cuenta del anunciante. Esta credencial es necesaria para el acceso de administrador a la cuenta.

Autenticación y descubrimiento de cuentas

Google Ads (V2) utiliza OAuth 2.0 para autorizar el acceso a la API Google Ads. Experience Platform administra el flujo de autorización, por lo que no se configuran los ámbitos o permisos de OAuth en el lado Google Ads.

Después de autorizar la cuenta, Experience Platform usa el token de desarrollador para acceder a los recursos de informes de Google Ads. Para las configuraciones de cuenta de administrador, el conector resuelve la jerarquía de cuentas e identifica las cuentas de anunciante disponibles para la ingesta.

El flujo de trabajo de detección de cuentas incluye las siguientes operaciones:

  1. Enumere las cuentas accesibles para el usuario autorizado.
  2. Determine si una cuenta accesible es una cuenta de administrador.
  3. Recorra la jerarquía de cuenta de administrador.
  4. Identificar las cuentas de anunciante que no son de gerente.
  5. Utilice el loginCustomerId adecuado cuando las solicitudes se enruten a través de la jerarquía de cuentas de administrador.
  6. Recupere metadatos de la cuenta, como ID de cuenta, nombre de cuenta, moneda y zona horaria.

Google Ads (V2) realiza operaciones de API de solo lectura. No emite solicitudes de mutación, creación, actualización o eliminación en Google Ads recursos.

Selección e ingesta de datos

Google Ads (V2) usa Google Ads lenguaje de consulta (GAQL) para recuperar metadatos de cuenta, metadatos de campaña y datos de informes.

El conector utiliza consultas específicas del recurso para recuperar los atributos, segmentos y métricas necesarios para cada entidad. El conector utiliza SearchStream para los recursos de informes y grandes conjuntos de resultados donde el procesamiento de filas incrementales es beneficioso.

El inventario de consultas admitido incluye recursos como:

  • customer
  • customer_client
  • campaign
  • campaign_budget
  • campaign_criterion
  • geo_target_constant
  • ad_group
  • ad_group_criterion
  • ad_group_ad
  • ad_group_ad_asset_view
  • ad_group_ad_asset_combination_view
  • asset
  • asset_group
  • asset_group_asset
  • change_status

Las métricas de rendimiento se recuperan mediante segmentos basados en fechas como segments.date.

Configuración del esquema

Google Ads (V2) asigna datos de origen a estructuras XDM de medios de pago estandarizadas. El conector organiza los datos por nivel de entidad, de modo que las métricas de metadatos y rendimiento se puedan unir en los registros de cuenta, campaña, grupo de anuncios, publicidad, recurso y experiencia.

Entidad
Recursos principales Google Ads
Datos representados
Cuenta
customer, customer_client
ID de cuenta, nombre de cuenta, moneda, zona horaria, estado del administrador y metadatos de la cuenta.
Campaign
campaign, campaign_budget, campaign_criterion
Nombre de la campaña, estado, canal de publicidad, subtipo, objetivo, presupuestos, estrategia de oferta, fechas, seguimiento de URL y configuración de segmentación.
Grupo de publicidad
ad_group, ad_group_criterion
ID del grupo de publicidad, nombre, estado, ofertas, segmentación, palabras clave, ubicaciones y relación de campaña.
Anuncio
ad_group_ad
ID de anuncio, tipo de anuncio, contenido creativo, direcciones URL de destino, estado de envío, información de revisión y política, y relaciones de campaña/grupo de publicidad.
Recurso
asset, ad_group_ad_asset_view, asset_group_asset
ID de recurso, tipo de recurso, metadatos de texto, imagen o vídeo, dimensiones, uso, etiqueta de rendimiento y anuncios o campañas asociados.
Experiencia
ad_group_ad_asset_combination_view, asset_group, asset_group_asset
Composición creativa derivada, recursos servidos, titulares, descripciones, llamadas a la acción, direcciones URL de páginas de aterrizaje y relaciones de experiencia.
Métricas de resumen
metrics.* campos y segments.date específicos del recurso
Impresiones de nivel de fecha, clics, gasto, conversiones, valor de conversión, CTR, CPC, CPM, métricas de vídeo y otras medidas de rendimiento admitidas.

Convenciones de identificador

La asignación V2 define identificadores cualificados para la plataforma para entidades de medios de pago. Por ejemplo:

  • El conector deriva los identificadores de cuenta del ID de cliente Google Ads.
  • Los identificadores de campaña combinan el ID de cliente Google Ads y el ID de campaña.
  • Los identificadores de grupo de anuncios y de publicidad incluyen su jerarquía principal.
  • Los identificadores de recursos combinan el ID de cliente Google Ads y el ID de recurso.
  • El conector deriva los identificadores de experiencia del contexto de combinación creativa o grupo de recursos.
  • Las rutas de jerarquía representan la relación entre las entidades de cuenta, campaña, grupo de publicidad, publicidad, experiencia y recursos.

Datos máximos de rendimiento

Las campañas Máximo rendimiento no siempre exponen las mismas relaciones de entidad que los tipos de campaña tradicionales.

Para los datos de Rendimiento máximo:

  • asset_group representa la agrupación principal de recursos.
  • asset_group_asset representa relaciones de recurso a grupo.
  • Las métricas de grupo de recursos proporcionan el contexto necesario para analizar el rendimiento de los recursos.
  • Los grupos de recursos actúan como un proxy de experiencia cuando una entidad de experiencia nativa no está disponible.

Limitaciones y consideraciones de datos

Tenga en cuenta las siguientes limitaciones al planificar la implementación de Google Ads (V2).

Compatibilidad con métricas específicas de recursos

Google Ads no expone todas las métricas de cada recurso. Por ejemplo, algunos recursos no admiten métricas ni segmentos, mientras que otros solo admiten un conjunto limitado de métricas.

La disponibilidad de las métricas también varía según la publicidad, el recurso, la experiencia, la campaña y las consultas Máximo rendimiento.

Registros de experiencia derivados

Google Ads no proporciona una sola entidad de experiencia universal equivalente al modelo de experiencia utilizado por los esquemas XDM de medios de pago.

El conector deriva los registros de experiencia de los datos disponibles de anuncios, combinaciones de recursos y grupos de recursos.

Metadatos de vídeo

La API Google Ads proporciona identificadores de vídeo y referencias de recursos relacionadas. Sin embargo, algunas propiedades multimedia, como la duración del vídeo, el códec, la velocidad de bits, la velocidad de fotogramas y la presencia de audio, no están disponibles directamente a través de la API Google Ads.

Estos campos son nulos a menos que se agregue un servicio de enriquecimiento aprobado.

Disponibilidad de recursos

Los metadatos de los recursos y la compatibilidad con el rendimiento varían según el tipo de recurso. Por ejemplo, los metadatos de imagen y texto están disponibles directamente, mientras que algunas propiedades de vídeo requieren un enriquecimiento adicional.

Campos específicos de Google

Los conceptos de Google Ads sin un equivalente XDM de medios de pago directo se representan con additionalDetails o se establecen como nulos, según la asignación aprobada.

Asignaciones de enumeración

El conector asigna Google Ads valores de enumeración de API a valores de XDM usando coincidencias exactas, coincidencias semánticas cercanas o valores de reserva aprobados. Los valores no admitidos, desconocidos, obsoletos o no especificados se omiten o se establecen como nulos.

Próximos pasos

Después de confirmar tus credenciales de Google Ads y el modelo de acceso a la cuenta, continúa creando una conexión con Google Ads usando la interfaz de usuario de Experience Platform.

recommendation-more-help
experience-platform-help-sources