[beta]{class="badge informative"}
Google Ads
Google Ads es la plataforma de publicidad en línea de Google que le ayuda a llegar a clientes potenciales en Search, YouTube, Maps y sitios web de socios. Puede dirigirse a la audiencia adecuada, controlar el presupuesto y rastrear los resultados para aumentar la concienciación, los posibles clientes y las ventas.
Utilice el origen Google Ads para autenticarse con la API Google Ads, conectar cuentas de anunciante o jerarquías de cuentas de administrador e ingerir datos de informes en Experience Platform para flujos de trabajo de activación y análisis descendentes.
Requisitos previos
Antes de conectar su cuenta de Google Ads a Experience Platform, asegúrese de que se cumplen los siguientes requisitos.
LISTA DE PERMITIDOS de direcciones IP
Debe añadir direcciones IP específicas de la región a la lista de permitidos antes de conectar los orígenes a Experience Platform. Para obtener más información, lea la guía de inclusión en la lista de permitidos de direcciones IP para conectarse a Experience Platform.
Configuración de permisos en Experience Platform
Debe tener los permisos para Ver fuentes y Administrar fuentes habilitados en su cuenta para conectar su cuenta de Google Ads a Experience Platform. Póngase en contacto con el administrador del producto para obtener los permisos necesarios. Para obtener más información, lea la guía de la interfaz de usuario de control de acceso.
Google Ads requisitos de acceso
Debe tener credenciales de API Google Ads válidas y acceso a la cuenta Google Ads desde la que desea leer. Si la cuenta del anunciante de destino se administra a través de una cuenta de administrador de Google Ads (MCC), la conexión también debe incluir el identificador de cliente de inicio de sesión correcto para que las solicitudes se puedan enrutar a través de la jerarquía de administrador adecuada.
En la práctica:
- Si el usuario autorizado por OAuth puede acceder directamente a la cuenta del anunciante de Target, es posible que
loginCustomerIdno sea necesario. - Si la cuenta del anunciante solo es accesible a través de una jerarquía MCC,
loginCustomerIddebe identificar la cuenta del administrador utilizada para acceder a esa cuenta secundaria. - Un elemento
loginCustomerIdincorrecto o que falta puede provocar errores de autorización al intentar consultar cuentas secundarias administradas.
Recopilar credenciales necesarias
Para conectar Google Ads a Experience Platform, debe proporcionar valores para las siguientes propiedades de conexión.
clientCustomerId123-456-7890.loginCustomerIddeveloperTokenrefreshTokenclientIdclientSecretgoogleAdsApiVersionv19 y posterior.connectionSpec.idd771e9c1-4f26-40dc-8617-ce58c4b53702.Acerca de loginCustomerId
El valor loginCustomerId es uno de los campos de configuración más importantes en el origen Google Ads.
Usar loginCustomerId cuando:
- El usuario autorizado por OAuth tiene acceso a través de una cuenta de administrador,
- La cuenta del anunciante de destino es una cuenta secundaria bajo un MCC,
- La cuenta no se devuelve directamente como una cuenta accesible de nivel superior.
No configure loginCustomerId de forma innecesaria para cuentas de anunciante accesibles directamente. Cuando sea posible, compruebe si la cuenta es directamente accesible primero y proporcione un ID de administrador únicamente cuando el acceso dependa realmente de esa jerarquía.
Comportamiento de autenticación y conexión
El origen Google Ads utiliza OAuth 2.0 para autenticar solicitudes en la API Google Ads. Experience Platform almacena los detalles de conexión en una conexión base y usa las credenciales suministradas para autorizar llamadas a la API Google Ads en nombre del cliente.
En los casos de cuenta de administrador, es posible que el conector tenga que resolver la jerarquía de administrador adecuada para acceder correctamente a la cuenta del anunciante de destino. Internamente, esto generalmente implica:
- Enumeración de cuentas accesibles,
- Determinar si una cuenta es una cuenta de administrador,
- Identificación de cuentas hoja que no son de gerente,
- Solución del loginCustomerId correcto cuando la cuenta de destino solo se puede alcanzar a través de una jerarquía MCC.
Este comportamiento es especialmente importante para los clientes que administran varias cuentas de anunciante desde una sola estructura de cuentas de administrador.
Selección de datos y comportamiento de informes
La selección de datos de Google Ads se basa en Google AdsQuery Language (GAQL). Durante la configuración, se especifican los atributos, segmentos y métricas que deben recuperarse para la ingesta.
Para las extracciones de informes grandes, Google Ads admite patrones de recuperación de flujo y búsqueda estándar. Internamente, la recuperación de flujo continuo es preferible para conjuntos de resultados más grandes porque permite que las filas del informe se consuman de forma incremental en lugar de almacenarse en el búfer página a página.
Al configurar la selección de datos en la interfaz de usuario de Experience Platform, utilice Google AdsQuery Builder para elegir el tipo de recurso y los campos que desea introducir, validar la consulta y, a continuación, copiar los atributos necesarios en el flujo de trabajo de origen.
Rutas de conexión compatibles
Puede conectar Google Ads a Experience Platform mediante las API o la interfaz de usuario.
Uso de API
Use la Flow Service API cuando necesite instalación mediante programación, configuración repetible o soporte para ingesta incremental. En un nivel superior, el flujo de trabajo de la API incluye:
- Creación de una conexión base,
- Exploración de la configuración de origen,
- Creación de una conexión de origen y destino,
- Creación de un flujo de datos para su ingesta
Uso de la IU
Use el espacio de trabajo de fuentes de Experience Platform para la configuración guiada cuando desee conectar Google Ads a través de la interfaz de usuario. El flujo de interfaz de usuario admite la entrada de credenciales, la selección de atributos, la previsualización y la creación de flujos de datos. Actualmente, la ruta de la interfaz de usuario sigue siendo beta y solo admite la ingesta única.
Limitaciones y notas conocidas
- El origen de Google Ads en la interfaz de usuario está actualmente en fase beta.
- Actualmente, la interfaz de usuario solo admite la ingesta única.
- Utilice la ruta basada en API para la ingesta incremental.
- Experience Platform admite actualmente Google Ads versión de API
v19y posterior. - Las jerarquías de cuentas de administrador requieren una administración cuidadosa de
loginCustomerId; los valores incorrectos pueden impedir el acceso a cuentas de anunciante secundarias.
Próximos pasos
Una vez que haya recopilado sus credenciales y confirmado el patrón de acceso a la cuenta, continúe con una de las siguientes rutas de configuración: