Detalles de Conexión de Google Ads¶

Introducción¶

Versión del conector

Esta documentación se basa en la versión 21.0.8361 del conector.

Empezando¶

Compatibilidad con la versión de Google Ads

El conector proporciona una vista relacional de los datos de Google Ads para su cuenta de Google o dominio de Google Apps. El conector incluye tablas que contienen dimensiones y métricas de uso frecuente; además, puede personalizar los esquemas de la tabla o escribir los suyos propios para combinar cualquier conjunto válido de dimensiones y métricas. El conector muestra las columnas disponibles a través de la versión v201809 de la API de AdWords.

Establecer una Conexión¶

Conexión a los Google Ads¶

Proporcione las siguientes propiedades de conexión antes de agregar las propiedades de autenticación.

• DeveloperToken: establezca esto en el token de desarrollador de la cuenta de AdWords. Puede obtener un token de desarrollador registrándose en la API de AdWords. Para ello, inicie sesión en el sitio de AdWords con su cuenta de MCC y vaya a Configuración -> Configuración de la cuenta -> Centro de la API de AdWords. Solicite el acceso a la API y espere a que Google se comunique con usted por correo con más instrucciones. Debería recibir un token con un estado pendiente. Este token es solo para pruebas y no le permite conectarse a datos en vivo. Google debe comunicarse con usted para completar un cuestionario y, una vez que Google lo haya recibido y aprobado, recibirá su token de desarrollador activo.

• ClientCustomerId: establezca esto en su ID de cliente de Google Ads. Puedes encontrar tu ClientCustomerId en la parte inferior del menú de ayuda después de hacer clic en el ícono de ayuda en la esquina superior derecha de la interfaz de usuario de Google Ads.

  Nota: Esta propiedad de conexión solo se requiere cuando se usa 'AdWords' Schema.

Recuperación de Datos de Varias Cuentas¶

Un uso común del controlador es la recuperación de datos de múltiples identificaciones de clientes. Esto es útil cuando tiene una cuenta de MCC de Google Ads que incluye numerosas cuentas/ClientCustomerIds. Puede consultar y obtener datos de las cuentas que desee especificando CustomerId en la cláusula WHERE, por ejemplo:

SELECT * FROM AdGroupAd WHERE CustomerId='3333333333'
SELECT * FROM AdGroupAd WHERE CustomerId IN ('1111111111', '2222222222')

El controlador ignora el ClientCustomerId propiedad de conexión cuando especifica el CustomerId en cláusulas WHERE.

Autenticación en Google Ads¶

Todas las conexiones a Google Ads se autentican mediante OAuth. El conector admite el uso de cuentas de usuario, cuentas de servicio y cuentas de instancias de GCP para la autenticación.

Autenticarse con una Cuenta de Usuario¶

AuthScheme debe establecerse en OAuth en todos los flujos de cuenta de usuario. Para las aplicaciones de escritorio, la aplicación predeterminada del conector es la forma más sencilla de autenticación. El único requisito adicional es establecer InitiateOAuth a GETANDREFRESH.

Cuando se inicie el controlador, se abrirá un navegador y Google Ads solicitará su información de inicio de sesión. El conector utilizará las credenciales que proporcione para acceder a sus datos de Google Ads. Estas credenciales se guardarán y actualizarán automáticamente según sea necesario.

Consulte Uso de la autenticación OAuth para obtener una guía de autenticación que cubra todos los métodos admitidos en detalle.

Autenticarse con una Cuenta de Servicio¶

Para autenticarse usando una cuenta de servicio, debe crear una nueva cuenta de servicio y tener una copia del certificado de la cuenta.

Para un archivo JSON, deberá establecer estas propiedades:

• AuthScheme: Requerido. Establézcalo en OAuthJWT.
• InitiateOAuth: Requerido. Establézcalo en GETANDREFRESH.
• OAuthJWTCertType: Requerido. Establézcalo en GOOGLEJSON.
• OAuthJWTCert: Requerido. Establézcalo en la ruta del archivo .json proporcionado por Google.
• OAuthJWTSubject: Requerido. La cuenta de servicio debe ser parte de un dominio de GSuite, con la delegación habilitada. El valor de esta propiedad debe ser la dirección de correo del usuario a cuyos datos desea acceder.

Para un archivo PFX, deberá establecer estas propiedades en su lugar:

• AuthScheme: Requerido. Establézcalo en OAuthJWT.
• InitiateOAuth: Requerido. Establézcalo en GETANDREFRESH.
• OAuthJWTCertType: Requerido. Establézcalo en PFXFILE.
• OAuthJWTCert: Requerido. Establézcalo en la ruta del archivo .pfx proporcionado por Google.
• OAuthJWTCertPassword: Opcional. Establézcalo en la contraseña del archivo .pfx. En la mayoría de los casos, será necesario proporcionarlo, ya que Google cifra los certificados PFX.
• OAuthJWTCertSubject: Opcional. Configure esto solo si está usando un OAuthJWTCertType que almacena múltiples certificados. No debe configurarse para certificados PFX generados por Google.
• OAuthJWTIssuer: Requerido. Establézcalo en la dirección de correo de la cuenta de servicio. Esta dirección generalmente incluirá el dominio iam.gserviceaccount.com.
• OAuthJWTSubject: Requerido. La cuenta de servicio debe ser parte de un dominio de GSuite, con la delegación habilitada. El valor de esta propiedad debe ser la dirección de correo del usuario a cuyos datos desea acceder.

Si aún no tiene una cuenta de servicio, puede crear una siguiendo el procedimiento en Crear una aplicación OAuth personalizada.

Autenticarse con una Cuenta de Instancia de GCP¶

Cuando se ejecuta en una máquina virtual de GCP, el conector puede autenticarse mediante una cuenta de servicio vinculada a la máquina virtual. Para usar este modo, establezca AuthScheme a GCPInstanceAccount.

Uso de la Autenticación OAuth¶

Utilice el estándar de autenticación OAuth para conectarse a Google Ads. Puede autenticarse con una cuenta de usuario o una cuenta de servicio. El conector facilita esto como se describe a continuación.

Uso de una Cuenta de Usuario para Autenticarse en Google Ads¶

El flujo de la cuenta de usuario requiere que el usuario que se autentica interactúe con Google Ads a través del navegador.

Credenciales Personalizadas¶

Cuándo Crear una Aplicación OAuth Personalizada¶

Es posible que desee crear una aplicación de OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en el extremo de OAuth de Google Ads para otorgar permisos al conector.

Uso de una Cuenta de Servicio para Conectarse a Google Ads¶

Las cuentas de servicio tienen autenticación silenciosa, sin autenticación de usuario en el navegador. También puede usar una cuenta de servicio para delegar ámbitos de acceso de toda la empresa al conector.

Debe crear una aplicación OAuth en este flujo. Luego puede conectarse a los datos de Google Ads a los que la cuenta de servicio tiene permiso para acceder. Consulte Credenciales personalizadas para obtener una guía de autenticación.

Creación de una Aplicación OAuth Personalizada¶

Consulte Crear una aplicación OAuth personalizada para un procedimiento.

Credenciales Personalizadas¶

Puede usar una aplicación OAuth personalizada para autenticarse con una cuenta de servicio o una cuenta de usuario. Consulte Uso de la autenticación OAuth para más información.

Autenticarse con una Cuenta de Usuario¶

Autenticación de Escritorio con una Aplicación OAuth Personalizada¶

Siga los pasos a continuación para autenticarse con las credenciales de una aplicación OAuth personalizada. Consulte Crear una aplicación OAuth personalizada.

Obtenga y actualice el token de acceso de OAuth

Después de configurar lo siguiente, está listo para conectarse:

• OAuthClientId: Establézcalo en el ID de cliente asignado cuando registró su aplicación.
• OAuthClientSecret: establezca esto en el secreto de cliente asignado cuando registró su aplicación.
• InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.
• DeveloperToken: establezca esto en el token de desarrollador de la cuenta de AdWords. Puede obtener un token de desarrollador registrándose en la API de AdWords. Para ello, inicie sesión en el sitio de AdWords con su cuenta de MCC y vaya a Configuración -> Configuración de la cuenta -> Centro de la API de AdWords. Solicite el acceso a la API y espere a que Google se comunique con usted por correo con más instrucciones. Debería recibir un token con un estado pendiente. Este token es solo para pruebas y no le permite conectarse a datos en vivo. Google debe comunicarse con usted para completar un cuestionario y, una vez que Google lo haya recibido y aprobado, recibirá su token de desarrollador activo.
• ClientCustomerId: Establézcalo en el ID de cliente de la cuenta de AdWords. Puede encontrar este valor en su cuenta de AdWords. Este valor no es el mismo que el ID de la cuenta de MCC. Debe proporcionar los ID de nivel más bajo para recuperar datos.

Cuando se conecta, el conector abre el extremo de OAuth en su navegador predeterminado. Inicie sesión y otorgue permisos a la aplicación. Luego, el conector completa el proceso de OAuth:

1. Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
2. Actualiza el token de acceso cuando caduca.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Autenticarse con una Cuenta de Servicio¶

Las cuentas de servicio tienen autenticación silenciosa, sin autenticación de usuario en el navegador. También puede usar una cuenta de servicio para delegar ámbitos de acceso de toda la empresa al conector.

Debe crear una aplicación OAuth en este flujo. Consulte Crear una aplicación OAuth personalizada para crear y autorizar una aplicación. Luego puede conectarse a los datos de Google Ads a los que la cuenta de servicio tiene permiso para acceder.

Después de configurar las siguientes propiedades de conexión, está listo para conectarse:

• InitiateOAuth: Establézcalo en GETANDREFRESH.
• OAuthJWTCertType: Ajústelo a "PFXFILE".
• OAuthJWTCert: Establézcalo en la ruta del archivo .p12 que generó.
• OAuthJWTCertPassword: establezca esto en la contraseña del archivo .pem.
• OAuthJWTCertSubject: establezca esto en "*" para elegir el primer certificado en el almacén de certificados.
• OAuthJWTIssuer: En la sección de cuentas de servicio, haga clic en Administrar cuentas de servicio y establezca este campo en la dirección de correo que se muestra en el campo ID de la cuenta de servicio.
• OAuthJWTSubject: establezca esto en la dirección de correo del usuario para quien la aplicación solicita acceso de delegado. Tenga en cuenta que el acceso de delegado debe ser otorgado por un administrador.
• DeveloperToken: establezca esto en el token de desarrollador de la cuenta de AdWords. Puede obtener un token de desarrollador registrándose en la API de AdWords. Para ello, inicie sesión en el sitio de AdWords con su cuenta de MCC y vaya a Configuración -> Configuración de la cuenta -> Centro de la API de AdWords. Solicite el acceso a la API y espere a que Google se comunique con usted por correo con más instrucciones. Debería recibir un token con un estado pendiente. Este token es solo para pruebas y no le permite conectarse a datos en vivo. Google debe comunicarse con usted para completar un cuestionario y, una vez que Google lo haya recibido y aprobado, recibirá su token de desarrollador activo.
• ClientCustomerId: Establézcalo en el ID de cliente de la cuenta de AdWords. Puede encontrar este valor en su cuenta de AdWords. Este valor no es el mismo que el ID de la cuenta de MCC. Debe proporcionar los ID de nivel más bajo para recuperar datos.

Cuando se conecta, el conector completa el flujo de OAuth para una cuenta de servicio.

1. Crea y firma el JWT con el conjunto de notificaciones requerido por el conector.
2. Intercambia el JWT por el token de acceso.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.
4. Envía el JWT para un nuevo token de acceso cuando el token caduca.

Máquinas Sin Cabeza¶

Uso de OAuth en una Máquina Sin Cabeza¶

Las siguientes secciones muestran cómo autenticar un servidor sin periféricos u otra máquina en la que el conector no puede abrir un navegador. Puede autenticarse con una cuenta de usuario o con una cuenta de servicio.

Autenticarse con una Cuenta de Usuario¶

Para autenticarse con una cuenta de usuario, debe hacerlo desde otra máquina. La autenticación es un proceso de dos pasos.

1. En lugar de instalar el conector en otra máquina, puede seguir los pasos a continuación para obtener el OAuthVerifier valor. O bien, puede instalar el conector en otra máquina y transferir los valores de autenticación de OAuth, después de autenticarse a través del flujo habitual basado en el navegador.
2. A continuación, puede configurar el conector para actualizar automáticamente el token de acceso desde la máquina sin periféricos.

Puede seguir el flujo de autenticación de OAuth sin cabeza utilizando las credenciales de OAuth para su aplicación de OAuth personalizada.

Uso de las Credenciales para una Aplicación OAuth Personalizada¶

Cree una aplicación OAuth personalizada

Consulte Crear una aplicación OAuth personalizada para un procedimiento. Luego puede seguir los procedimientos a continuación para autenticarse y conectarse a los datos.

Obtenga un código verificador

Establezca las siguientes propiedades en la máquina sin periféricos:

• InitiateOAuth: Ajústelo a APAGADO.
• OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.
• DeveloperToken: establezca esto en el token de desarrollador de la cuenta de AdWords. Puede obtener un token de desarrollador registrándose en la API de AdWords. Para ello, inicie sesión en el sitio de AdWords con su cuenta de MCC y vaya a Configuración -> Configuración de la cuenta -> Centro de la API de AdWords. Solicite el acceso a la API y espere a que Google se comunique con usted por correo con más instrucciones. Debería recibir un token con un estado pendiente. Este token es solo para pruebas y no le permite conectarse a datos en vivo. Google debe comunicarse con usted para completar un cuestionario y, una vez que Google lo haya recibido y aprobado, recibirá su token de desarrollador activo.
• ClientCustomerId: Establézcalo en el ID de cliente de la cuenta de AdWords. Puede encontrar este valor en su cuenta de AdWords. Este valor no es el mismo que el ID de la cuenta de MCC. Debe proporcionar los ID de nivel más bajo para recuperar datos.

Luego puede seguir los pasos a continuación para autenticarse desde otra máquina y obtener el OAuthVerifier propiedad de conexión.

1. Llame a GetOAuthAuthorizationURL procedimiento almacenado* con el parámetro de entrada CallbackURL establecido en el URI de redirección exacto que especificó en la configuración de su aplicación.
2. Abra la URL devuelta en un navegador. Inicie sesión y otorgue permisos al conector. A continuación, se le redirige a la URL de devolución de llamada, que contiene el código verificador.
3. Guarde el valor del código verificador. Establecerá esto en el OAuthVerifier propiedad de conexión.

En la máquina sin periféricos, establezca las siguientes propiedades de conexión para obtener los valores de autenticación de OAuth:

• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
• OAuthVerifier: Establézcalo en el código del verificador.
• OAuthSettingsLocation: configure esto para conservar los valores de autenticación OAuth cifrados en el archivo especificado.
• InitiateOAuth: Establézcalo en ACTUALIZAR.
• DeveloperToken: establezca esto en el token de desarrollador de la cuenta de AdWords. Puede obtener un token de desarrollador registrándose en la API de AdWords. Para ello, inicie sesión en el sitio de AdWords con su cuenta de MCC y vaya a Configuración -> Configuración de la cuenta -> Centro de la API de AdWords. Solicite el acceso a la API y espere a que Google se comunique con usted por correo con más instrucciones. Debería recibir un token con un estado pendiente. Este token es solo para pruebas y no le permite conectarse a datos en vivo. Google debe comunicarse con usted para completar un cuestionario y, una vez que Google lo haya recibido y aprobado, recibirá su token de desarrollador activo.
• ClientCustomerId: Establézcalo en el ID de cliente de la cuenta de AdWords. Puede encontrar este valor en su cuenta de AdWords. Este valor no es el mismo que el ID de la cuenta de MCC. Debe proporcionar los ID de nivel más bajo para recuperar datos.

Después de generar el archivo de configuración de OAuth, configure las siguientes propiedades para conectarse a los datos:

• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
• OAuthSettingsLocation: Establézcalo en el archivo que contiene los valores de autenticación de OAuth cifrados. Asegúrese de que este archivo otorgue permisos de lectura y escritura al proveedor para habilitar la actualización automática del token de acceso.
• InitiateOAuth: Establézcalo en ACTUALIZAR.
• DeveloperToken: establezca esto en el token de desarrollador de la cuenta de AdWords. Puede obtener un token de desarrollador registrándose en la API de AdWords. Para ello, inicie sesión en el sitio de AdWords con su cuenta de MCC y vaya a Configuración -> Configuración de la cuenta -> Centro de la API de AdWords. Solicite el acceso a la API y espere a que Google se comunique con usted por correo con más instrucciones. Debería recibir un token con un estado pendiente. Este token es solo para pruebas y no le permite conectarse a datos en vivo. Google debe comunicarse con usted para completar un cuestionario y, una vez que Google lo haya recibido y aprobado, recibirá su token de desarrollador activo.
• ClientCustomerId: Establézcalo en el ID de cliente de la cuenta de AdWords. Puede encontrar este valor en su cuenta de AdWords. Este valor no es el mismo que el ID de la cuenta de MCC. Debe proporcionar los ID de nivel más bajo para recuperar datos.

Transferir configuración de OAuth

Siga los pasos a continuación para instalar el conector en otra máquina, autenticar y luego transferir los valores de OAuth resultantes.

En una segunda máquina, instale el conector y conéctese con el siguiente conjunto de propiedades:

• OAuthSettingsLocation: establezca esto en un archivo de texto grabable.
• InitiateOAuth: Establézcalo en GETANDREFRESH.
• OAuthClientId: Establézcalo en el ID de cliente asignado cuando registró su aplicación.
• OAuthClientSecret: establezca esto en el secreto de cliente asignado cuando registró su aplicación.
• DeveloperToken: establezca esto en el token de desarrollador de la cuenta de AdWords. Puede obtener un token de desarrollador registrándose en la API de AdWords. Para ello, inicie sesión en el sitio de AdWords con su cuenta de MCC y vaya a Configuración -> Configuración de la cuenta -> Centro de la API de AdWords. Solicite el acceso a la API y espere a que Google se comunique con usted por correo con más instrucciones. Debería recibir un token con un estado pendiente. Este token es solo para pruebas y no le permite conectarse a datos en vivo. Google debe comunicarse con usted para completar un cuestionario y, una vez que Google lo haya recibido y aprobado, recibirá su token de desarrollador activo.
• ClientCustomerId: Establézcalo en el ID de cliente de la cuenta de AdWords. Puede encontrar este valor en su cuenta de AdWords. Este valor no es el mismo que el ID de la cuenta de MCC. Debe proporcionar los ID de nivel más bajo para recuperar datos.

Pruebe la conexión para autenticarse. Los valores de autenticación resultantes se escriben, se cifran, en la ruta especificada por OAuthSettingsLocation. Una vez que haya probado con éxito la conexión, copie el archivo de configuración de OAuth en su máquina sin periféricos. En la máquina sin periféricos, configure las siguientes propiedades de conexión para conectarse a los datos:

• InitiateOAuth: Establézcalo en ACTUALIZAR.
• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
• OAuthSettingsLocation: establezca esto en la ruta a su archivo de configuración de OAuth. Asegúrese de que este archivo otorgue permisos de lectura y escritura al conector para habilitar la actualización automática del token de acceso.
• DeveloperToken: establezca esto en el token de desarrollador de la cuenta de AdWords. Puede obtener un token de desarrollador registrándose en la API de AdWords. Para ello, inicie sesión en el sitio de AdWords con su cuenta de MCC y vaya a Configuración -> Configuración de la cuenta -> Centro de la API de AdWords. Solicite el acceso a la API y espere a que Google se comunique con usted por correo con más instrucciones. Debería recibir un token con un estado pendiente. Este token es solo para pruebas y no le permite conectarse a datos en vivo. Google debe comunicarse con usted para completar un cuestionario y, una vez que Google lo haya recibido y aprobado, recibirá su token de desarrollador activo.
• ClientCustomerId: Establézcalo en el ID de cliente de la cuenta de AdWords. Puede encontrar este valor en su cuenta de AdWords. Este valor no es el mismo que el ID de la cuenta de MCC. Debe proporcionar los ID de nivel más bajo para recuperar datos.

Autenticarse con una Cuenta de Servicio¶

Las cuentas de servicio tienen autenticación silenciosa, sin autenticación de usuario en el navegador. También puede usar una cuenta de servicio para delegar ámbitos de acceso de toda la empresa al conector.

Debe crear una aplicación OAuth en este flujo. Consulte Crear una aplicación OAuth personalizada para crear y autorizar una aplicación. Luego puede conectarse a los datos de Google Ads a los que la cuenta de servicio tiene permiso para acceder.

Después de configurar las siguientes propiedades de conexión, está listo para conectarse:

• InitiateOAuth: Establézcalo en GETANDREFRESH.
• OAuthJWTCertType: Ajústelo a "PFXFILE".
• OAuthJWTCert: Establézcalo en la ruta del archivo .p12 que generó.
• OAuthJWTCertPassword: establezca esto en la contraseña del archivo .pem.
• OAuthJWTCertSubject: establezca esto en "*" para elegir el primer certificado en el almacén de certificados.
• OAuthJWTIssuer: En la sección de cuentas de servicio, haga clic en Administrar cuentas de servicio y establezca este campo en la dirección de correo que se muestra en el campo ID de la cuenta de servicio.
• OAuthJWTSubject: establezca esto en la dirección de correo del usuario para quien la aplicación solicita acceso de delegado. Tenga en cuenta que el acceso de delegado debe ser otorgado por un administrador.
• DeveloperToken: establezca esto en el token de desarrollador de la cuenta de AdWords. Puede obtener un token de desarrollador registrándose en la API de AdWords. Para ello, inicie sesión en el sitio de AdWords con su cuenta de MCC y vaya a Configuración -> Configuración de la cuenta -> Centro de la API de AdWords. Solicite el acceso a la API y espere a que Google se comunique con usted por correo con más instrucciones. Debería recibir un token con un estado pendiente. Este token es solo para pruebas y no le permite conectarse a datos en vivo. Google debe comunicarse con usted para completar un cuestionario y, una vez que Google lo haya recibido y aprobado, recibirá su token de desarrollador activo.
• ClientCustomerId: Establézcalo en el ID de cliente de la cuenta de AdWords. Puede encontrar este valor en su cuenta de AdWords. Este valor no es el mismo que el ID de la cuenta de MCC. Debe proporcionar los ID de nivel más bajo para recuperar datos.

Cuando se conecta, el conector completa el flujo de OAuth para una cuenta de servicio.

1. Crea y firma el JWT con el conjunto de notificaciones requerido por el conector.
2. Intercambia el JWT por el token de acceso.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.
4. Envía el JWT para un nuevo token de acceso cuando el token caduca.

Creación de una Aplicación OAuth Personalizada¶

Puede usar una aplicación OAuth personalizada para autenticar una cuenta de servicio o una cuenta de usuario. Consulte Uso de la autenticación OAuth para más información.

Cree una Aplicación OAuth para la Autenticación de Cuentas de Usuario¶

Siga el procedimiento a continuación para registrar una aplicación y obtener el OAuthClientId y OAuthClientSecret.

Crear una Aplicación OAuth Personalizada: Escritorio¶

1. Inicie sesión en la Consola API de Google y abra un proyecto. Seleccione el API Manager en el menú principal.
2. Haga clic en Credenciales -> Crear credenciales -> ID de cliente de OAuth. Haz clic en Otro.

Cree una Aplicación OAuth para la Autenticación de Cuentas de Servicio¶

Siga los pasos a continuación para crear una aplicación OAuth y generar una clave privada. A continuación, autorizará la cuenta de servicio.

1. Inicie sesión en la Consola API de Google y abra un proyecto. Seleccione el API Manager en el menú principal.
2. Haga clic en Crear credenciales -> Clave de cuenta de servicio.
3. En el menú Cuenta de servicio, seleccione Nueva cuenta de servicio o seleccione una cuenta de servicio existente.
4. Si está creando una nueva cuenta de servicio, seleccione además uno o más roles. Puede asignar roles primitivos a nivel de proyecto en la sección IAM y Admin; otras funciones le permiten personalizar aún más el acceso a las APIs de Google.
5. En la sección Tipo de clave, seleccione el tipo de clave P12.
6. Cree la aplicación para descargar el par de claves. Se muestra la contraseña de la clave privada: Configure esto en OAuthJWTCertPassword.
7. En la sección de cuentas de servicio, haga clic en Administrar cuentas de servicio y configure OAuthJWTIssuer a la dirección de correo que se muestra en el campo ID de la cuenta de servicio.

Recuperación de Datos de Google AdWords¶

Los datos de Google AdWords se organizan en varias métricas (por ejemplo, Conversiones, Impresiones y Clics no válidos), que se pueden agrupar por varios segmentos (por ejemplo, Fecha y Dispositivo). Además, hay atributos que representan datos fijos o configuraciones de cuenta (por ejemplo, CampaignName, AdType y AdGroupStatus). Estos se denominan Comportamiento para el campo. Hay muchas combinaciones válidas de métricas, segmentos y atributos. El conector muestra cada tipo de informe por separado en AdWords como una tabla.

Selección de Datos¶

A diferencia de la mayoría de las tablas de bases de datos, no es muy útil seleccionar todas las métricas, segmentos y atributos en una tabla determinada. En algunos casos, ni siquiera es posible hacer esto, ya que algunos datos entran en conflicto entre sí cuando se seleccionan. Como resultado, el conector interpreta la consultar SELECT * para indicar que se solicita un conjunto predeterminado de métricas, segmentos y atributos. Esto incluye consultas que seleccionan explícitamente todas las columnas para tener en cuenta las herramientas que usan proyección al devolver resultados. Estos campos predeterminados representan las columnas predeterminadas expuestas a través de la consola de Google AdWords. Para seleccionar columnas no predeterminadas, simplemente seleccione explícitamente estas columnas en la consultar en lugar de emitir una consultar SELECT *. Finalmente, es importante tener en cuenta que se debe incluir al menos una métrica en la solicitud para que se devuelvan los datos.

De forma predeterminada, los nombres de las columnas son los valores utilizados por la API.

Otras Consideraciones¶

Ciertos campos de porcentaje pueden devolver los valores '< 10%' o '> 90 %'. Para permitirle usar esta columna como un campo numérico, estos valores se informan exactamente como '10' y '90' respectivamente.

Ajuste Fino del Acceso a los Datos¶

Google Ads¶

Selección de la Versión de la API¶

La API de Google Ads se adhiere a un programa de desactivación de aproximadamente cada 10 meses.
Para la compatibilidad con versiones anteriores, el conector mantiene las APIs que han quedado en desuso pero que no han caducado; si su aplicación requiere una API obsoleta, puede configurarla en Schema propiedad.

Ajuste Fino del Acceso a los Datos¶

Puede usar las siguientes propiedades para obtener un mayor control sobre las funciones de la API de Google Ads y las estrategias que usa el conector para mostrarlas:

• IncludeZeroImpressions: esta propiedad controla si los registros con cero impresiones se incluyen en los informes.

Notas Importantes¶

Procedimientos Almacenados¶

• Las funciones de procedimientos almacenados descritas en esta documentación no se admiten actualmente.
• Debido a que los procedimientos almacenados no se admiten actualmente, cualquier característica que dependa de los procedimientos almacenados tampoco se admite actualmente.

Archivos de Configuración y Sus Rutas¶

• Todas las referencias a la adición de archivos de configuración y sus rutas se refieren a archivos y ubicaciones en Harmony Agente donde está instalado el conector. Estas rutas deben ajustarse según corresponda según el agente y el sistema operativo. Si se utilizan varios agentes en un grupo de agentes, se requerirán archivos idénticos en cada agente.

Características Avanzadas¶

Esta sección detalla una selección de funciones avanzadas del conector de Google Ads.

Vistas definidas por el usuario

El conector le permite definir tablas virtuales, llamadas vistas definidas por el usuario, cuyo contenido se decide mediante una consultar preconfigurada. Estas vistas son útiles cuando no puede controlar directamente las consultas que se envían a los controladores. Consulte Vistas definidas por el usuario para obtener una descripción general de la creación y configuración de vistas personalizadas.

Configuración SSL

Usar Configuración SSL para ajustar cómo el conector maneja las negociaciones de certificados TLS/SSL. Puede elegir entre varios formatos de certificado; ver el SSLServerCert propiedad en "Opciones de cadena de conexión" para obtener más información.

Apoderado

Para configurar el conector mediante Configuración de proxy de Agente Privado, Selecciona el Use Proxy Settings casilla de verificación en la pantalla de configuración de la conexión.

Vistas Definidas por el Usuario¶

El Jitterbit Connector para Google Ads te permite definir una tabla virtual cuyos contenidos se deciden mediante una consultar preconfigurada. Estas se denominan Vistas definidas por el usuario, que son útiles en situaciones en las que no puede controlar directamente la consultar que se envía al controlador, por ejemplo, cuando se utiliza el controlador de Jitterbit. Las vistas definidas por el usuario se pueden utilizar para definir predicados que siempre se aplican. Si especifica predicados adicionales en la consultar a la vista, se combinan con la consultar ya definida como parte de la vista.

Hay dos formas de crear vistas definidas por el usuario:

• Cree un archivo de configuración con formato JSON que defina las vistas que desea.
• Declaraciones DDL.

Definición de Vistas Usando un Archivo de Configuración¶

Las vistas definidas por el usuario se definen en un archivo de configuración con formato JSON llamado UserDefinedViews.json. El conector detecta automáticamente las vistas especificadas en este archivo.

También puede tener múltiples definiciones de vista y controlarlas usando UserDefinedViews propiedad de conexión. Cuando utiliza esta propiedad, el conector solo ve las vistas especificadas.

Este archivo de configuración de vista definida por el usuario tiene el siguiente formato:

• Cada elemento raíz define el nombre de una vista.
• Cada elemento raíz contiene un elemento hijo, llamado query, que contiene la consultar SQL personalizada para la vista.

Por ejemplo:

{
    "MyView": {
        "query": "SELECT * FROM CampaignPerformance WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Utilizar el UserDefinedViews propiedad de conexión para especificar la ubicación de su archivo de configuración JSON. Por ejemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Esquema para Vistas Definidas por el Usuario¶

Las vistas definidas por el usuario se exponen en UserViews esquema por defecto. Esto se hace para evitar que el nombre de la vista entre en conflicto con una entidad real en el modelo de datos. Puede cambiar el nombre del esquema utilizado para UserViews configurando UserViewsSchemaName propiedad.

Trabajar con Vistas Definidas por el Usuario¶

Por ejemplo, una instrucción SQL con una vista definida por el usuario llamada UserViews.RCustomers solo enumera clientes en Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Un ejemplo de una consultar al controlador:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Dando como resultado la consultar efectiva a la fuente:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Ese es un ejemplo muy simple de una consultar a una vista definida por el usuario que es efectivamente una combinación de la consultar de vista y la definición de vista. Es posible componer estas consultas en patrones mucho más complejos. Todas las operaciones de SQL están permitidas en ambas consultas y se combinan cuando corresponde.

Configuración SSL¶

Personalización de la Configuración SSL¶

De forma predeterminada, el conector intenta negociar SSL/TLS comparando el certificado del servidor con el almacén de certificados de confianza del sistema.

Para especificar otro certificado, consulte SSLServerCert propiedad de los formatos disponibles para hacerlo.

Modelo de Datos¶

Jitterbit Connector para Google Ads admite dos esquemas distintos.

Modelo de datos de AdWords

Consulte Modelo de datos de AdWords.

Google Ads

Consulte Modelo de datos de Google Ads.

Modelo de Datos de AdWords¶

Jitterbit Connector para Google Ads modela entidades de Google Ads en vistas relacionales y procedimientos almacenados. Las vistas proporcionadas le darán acceso a los datos de su informe de Google AdWords utilizando la versión 201809 de la API de informes de Google AdWords.

Puntos de Vista¶

Puntos de vista son tablas que no se pueden modificar. Normalmente, los datos que son de solo lectura y no se pueden actualizar se muestran como vistas. Además, las limitaciones y los requisitos de la API se documentan en esta sección.

Procedimientos Almacenados¶

NOTE: Los procedimientos almacenados no se admiten actualmente. Consulte la nota anterior para detalles.

Procedimientos almacenados son interfaces similares a funciones para la fuente de datos. Se pueden utilizar para buscar, actualizar y modificar información en la fuente de datos.

Puntos de Vista¶

Las vistas se componen de columnas y pseudocolumnas. Las vistas son similares a las tablas en la forma en que se representan los datos; sin embargo, las vistas no admiten actualizaciones. Las entidades que se representan como vistas suelen ser entidades de solo lectura. A menudo, un procedimiento almacenado* está disponible para actualizar los datos si dicha funcionalidad es aplicable a la fuente de datos.

Las consultas se pueden ejecutar contra una vista como si fuera una tabla normal, y los datos que regresan son similares en ese sentido. Para obtener más información sobre las tablas y los procedimientos almacenados, vaya a sus entradas correspondientes en este documento de ayuda.

Conector Jitterbit para Visualizaciones de Google Ads¶

Rendimiento de la Cuenta¶

El informe de rendimiento de la cuenta incluye todas las estadísticas agregadas de forma predeterminada a nivel de cuenta, una fila por cuenta.

Información Específica de la Tabla¶

Seleccionar

Google AdWords no permite que se seleccionen todas las columnas en una sola consultar, ya que algunos datos entrarán en conflicto si se seleccionan juntos. Por lo tanto, al emitir una consultar que selecciona todas las columnas, solo se devolverán las métricas, los segmentos y los atributos predeterminados. En general, estos valores predeterminados son los mismos campos que se exponen a través de la consola de AdWords.

Para usar los campos no predeterminados, selecciónelos explícitamente en su consultar.

Los filtros también se pueden usar en la cláusula WHERE. Los operadores admitidos son los operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN y NOT IN. Todos los filtros deben estar unidos por la palabra clave AND, ya que OR no es compatible con la API de AdWords.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

AdCustomizersFeedItem¶

El informe Elemento de fuente de personalizadores de anuncios proporciona estadísticas para los elementos de fuente utilizados en Personalizadores de anuncios. Las estadísticas se agregan a nivel de elemento de noticias en tiempo real, una fila por elemento de noticias en tiempo real.

Información Específica de la Tabla¶

Seleccionar

Google AdWords no permite que se seleccionen todas las columnas en una sola consultar, ya que algunos datos entrarán en conflicto si se seleccionan juntos. Por lo tanto, al emitir una consultar que selecciona todas las columnas, solo se devolverán las métricas, los segmentos y los atributos predeterminados. En general, estos valores predeterminados son los mismos campos que se exponen a través de la consola de AdWords.

Para usar los campos no predeterminados, selecciónelos explícitamente en su consultar.

Los filtros también se pueden usar en la cláusula WHERE. Los operadores admitidos son los operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN y NOT IN. Todos los filtros deben estar unidos por la palabra clave AND, ya que OR no es compatible con la API de AdWords.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Oferta de Grupo de Anuncioshorizontal¶

Representa datos sobre un panorama de ofertas para un grupo de anuncios.

Columnas¶

Rendimiento del Grupo de Anuncios¶

El informe de rendimiento del grupo de anuncios incluye todas las estadísticas agregadas de forma predeterminada en el nivel del grupo de anuncios, una fila por grupo de anuncios.

Información Específica de la Tabla¶

Seleccionar

Google AdWords no permite que se seleccionen todas las columnas en una sola consultar, ya que algunos datos entrarán en conflicto si se seleccionan juntos. Por lo tanto, al emitir una consultar que selecciona todas las columnas, solo se devolverán las métricas, los segmentos y los atributos predeterminados. En general, estos valores predeterminados son los mismos campos que se exponen a través de la consola de AdWords.

Para usar los campos no predeterminados, selecciónelos explícitamente en su consultar. Por ejemplo, la siguiente consultar utiliza el dispositivo en lugar del segmento de fecha predeterminado para consultar los datos de rendimiento del grupo de anuncios:

SELECT AdGroupId, AdGroupName, CampaignName, Device, Clicks, ConversionRate, Impressions FROM AdGroupPerformance

Los filtros también se pueden usar en la cláusula WHERE. Los operadores admitidos son los operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN y NOT IN. Todos los filtros deben estar unidos por la palabra clave AND, ya que OR no es compatible con la API de AdWords. Todos los filtros deben estar unidos por la palabra clave AND, ya que OR no es compatible con la API de AdWords. Por ejemplo, la siguiente consultar devolverá solo grupos de anuncios en campañas habilitadas con una tasa de conversión superior a 0:

SELECT AdGroupId, AdGroupName, CampaignName, Device, Clicks, ConversionRate, Impressions FROM AdGroupPerformance WHERE CampaignStatus='ENABLED' AND ConversionRate > 0

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Grupos de Anuncios¶

Servicio para acceder a detalles sobre cualquier grupo de anuncios.

Información Específica de la Tabla¶

Seleccionar

Hay dos formas de consultar los grupos de anuncios.

• La siguiente consultar devuelve el grupo de anuncios especificado.

  SELECT * FROM [Grupos de anuncios] WHERE Id=123456789
  

• La siguiente consultar devuelve todos los grupos de anuncios.

  SELECT * FROM [AdGroups]
  

Columnas¶

Rendimiento del Anuncio¶

El informe de rendimiento de anuncios incluye todas las estadísticas agregadas a nivel de anuncio, una fila por anuncio.

Información Específica de la Tabla¶

Seleccionar

Google AdWords no permite que se seleccionen todas las columnas en una sola consultar, ya que algunos datos entrarán en conflicto si se seleccionan juntos. Por lo tanto, al emitir una consultar que selecciona todas las columnas, solo se devolverán las métricas, los segmentos y los atributos predeterminados. En general, estos valores predeterminados son los mismos campos que se exponen a través de la consola de AdWords.

Para usar los campos no predeterminados, selecciónelos explícitamente en su consultar. Por ejemplo, la siguiente consultar utiliza ClickType en lugar del segmento de fecha predeterminado para consultar los datos de rendimiento de anuncios:

SELECT AdType, Headline, CampaignName, ClickType, Clicks, ConversionRate, Impressions FROM AdPerformance

Los filtros también se pueden usar en la cláusula WHERE. Los operadores admitidos son los operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN y NOT IN. Todos los filtros deben estar unidos por la palabra clave AND, ya que OR no es compatible con la API de AdWords. Todos los filtros deben estar unidos por la palabra clave AND, ya que OR no es compatible con la API de AdWords. Por ejemplo, esta consultar devolverá solo los anuncios que están habilitados con una tasa de conversión superior a 0:

SELECT AdType, Headline, CampaignName, Device, Clicks, ConversionRate, Impressions FROM AdPerformance WHERE Status='ENABLED' AND ConversionRate > 0

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Rango de Edadrendimiento¶

El informe de rendimiento del rango de edad incluye todas las estadísticas de la red de visualización agregadas por rango de edad. También incluye rendimiento de audiencia automático.

Información Específica de la Tabla¶

Seleccionar

Google AdWords no permite que se seleccionen todas las columnas en una sola consultar, ya que algunos datos entrarán en conflicto si se seleccionan juntos. Por lo tanto, al emitir una consultar que selecciona todas las columnas, solo se devolverán las métricas, los segmentos y los atributos predeterminados. En general, estos valores predeterminados son los mismos campos que se exponen a través de la consola de AdWords.

Para usar los campos no predeterminados, selecciónelos explícitamente en su consultar.

Los filtros también se pueden usar en la cláusula WHERE. Los operadores admitidos son los operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN y NOT IN. Todos los filtros deben estar unidos por la palabra clave AND, ya que OR no es compatible con la API de AdWords.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

AudienciaRendimiento¶

El informe Rendimiento de la audiencia incluye datos de rendimiento de intereses y listas de remarketing para anuncios gráficos y listas de remarketing para anuncios de búsqueda (RLSA), agregados a nivel de audiencia, una fila por audiencia.

Información Específica de la Tabla¶

Seleccionar

Google AdWords no permite que se seleccionen todas las columnas en una sola consultar, ya que algunos datos entrarán en conflicto si se seleccionan juntos. Por lo tanto, al emitir una consultar que selecciona todas las columnas, solo se devolverán las métricas, los segmentos y los atributos predeterminados. En general, estos valores predeterminados son los mismos campos que se exponen a través de la consola de AdWords.

Para usar los campos no predeterminados, selecciónelos explícitamente en su consultar.

Los filtros también se pueden usar en la cláusula WHERE. Los operadores admitidos son los operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN y NOT IN. Todos los filtros deben estar unidos por la palabra clave AND, ya que OR no es compatible con la API de AdWords.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Ubicaciones Automáticasrendimiento¶

El informe de rendimiento de ubicaciones automáticas incluye todas las estadísticas agregadas en el nivel de ubicación, una fila por ubicación.

Información Específica de la Tabla¶

Seleccionar

Google AdWords no permite que se seleccionen todas las columnas en una sola consultar, ya que algunos datos entrarán en conflicto si se seleccionan juntos. Por lo tanto, al emitir una consultar que selecciona todas las columnas, solo se devolverán las métricas, los segmentos y los atributos predeterminados. En general, estos valores predeterminados son los mismos campos que se exponen a través de la consola de AdWords.

Para usar los campos no predeterminados, selecciónelos explícitamente en su consultar.

Los filtros también se pueden usar en la cláusula WHERE. Los operadores admitidos son los operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN y NOT IN. Todos los filtros deben estar unidos por la palabra clave AND, ya que OR no es compatible con la API de AdWords.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

OfertaObjetivoRendimiento¶

El informe de rendimiento del objetivo de oferta incluye estadísticas para sus estrategias de oferta.

Información Específica de la Tabla¶

Seleccionar

Google AdWords no permite que se seleccionen todas las columnas en una sola consultar, ya que algunos datos entrarán en conflicto si se seleccionan juntos. Por lo tanto, al emitir una consultar que selecciona todas las columnas, solo se devolverán las métricas, los segmentos y los atributos predeterminados. En general, estos valores predeterminados son los mismos campos que se exponen a través de la consola de AdWords.

Para usar los campos no predeterminados, selecciónelos explícitamente en su consultar.

Los filtros también se pueden usar en la cláusula WHERE. Los operadores admitidos son los operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN y NOT IN. Todos los filtros deben estar unidos por la palabra clave AND, ya que OR no es compatible con la API de AdWords.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

PresupuestoRendimiento¶

El informe de rendimiento del presupuesto incluye todas las estadísticas agregadas de forma predeterminada a nivel de presupuesto, una fila por presupuesto.

Información Específica de la Tabla¶

Seleccionar

Google AdWords no permite que se seleccionen todas las columnas en una sola consultar, ya que algunos datos entrarán en conflicto si se seleccionan juntos. Por lo tanto, al emitir una consultar que selecciona todas las columnas, solo se devolverán las métricas, los segmentos y los atributos predeterminados. En general, estos valores predeterminados son los mismos campos que se exponen a través de la consola de AdWords.

Para usar los campos no predeterminados, selecciónelos explícitamente en su consultar.

Los filtros también se pueden usar en la cláusula WHERE. Los operadores admitidos son los operadores =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN y NOT IN. Todos los filtros deben estar unidos por la palabra clave AND, ya que OR no es compatible con la API de AdWords.

Columnas¶