View a markdown version of this page

Integración con Google Analytics - Amazon Quick

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Integración con Google Analytics

Con el conector de acciones de Google Analytics, puede acceder a Google Analytics directamente en Amazon Quick mediante lenguaje natural. Puede generar informes, recuperar datos de audiencia, supervisar eventos clave y acceder a métricas en tiempo real sin salir de Amazon Quick.

Amazon Quick admite varios métodos de autenticación para Google Analytics. Elija el método que mejor se adapte a los requisitos de seguridad de su organización.

  • Aplicación OAuth predeterminada: utiliza una aplicación OAuth AWS gestionada por usted. No se necesitan credenciales adicionales. Te autenticas directamente con tu cuenta de Google.

  • Aplicación OAuth personalizada: utiliza un cliente OAuth administrado por el cliente creado en Google Cloud Console. Esta opción le da a tu organización un control total sobre la configuración de OAuth.

Para obtener más información sobre los métodos de autenticación que admite Amazon Quick, consulteMétodos de autenticación.

Antes de empezar

Asegúrese de disponer de lo siguiente antes de configurar la integración.

  • Una cuenta de Google con acceso a las propiedades y los datos de Google Analytics que quieras usar.

  • Para una aplicación OAuth personalizada: accede a Google Cloud Console en el sitio web de Google con permisos para crear clientes de OAuth.

  • Para conocer los requisitos de suscripción a Amazon Quick, consulteConfigurar integraciones en la consola.

Configuración de Google Cloud

Si utilizas la autenticación por defecto de la aplicación OAuth, omite esta sección y ve a. Configuración del conector en Amazon Quick

Para la autenticación personalizada de aplicaciones OAuth, complete los siguientes pasos en Google Cloud Console antes de configurar Amazon Quick. Cuando habilites la API en el paso 3, busca y habilita la API de datos de Google Analytics.

Crea un cliente OAuth en Google Cloud Console

Crea un cliente OAuth en Google Cloud Console para obtener las credenciales de cliente que necesitas para Amazon Quick. Para obtener más información, consulta Cómo usar OAuth 2.0 para acceder a las API de Google en el sitio web de Google.

  1. Inicia sesión en Google Cloud Console en el sitio web de Google.

  2. Crea un proyecto nuevo o selecciona uno existente.

  3. En el panel de navegación izquierdo, selecciona API y servicios y, a continuación, selecciona Biblioteca. Busca la API que requiere tu integración y selecciona Activar.

  4. Selecciona la pantalla de consentimiento de OAuth y selecciona Comenzar.

  5. Configura la pantalla de consentimiento:

    • Introduzca un nombre de aplicación y seleccione un correo electrónico de asistencia al usuario.

    • En Audience, selecciona Interno (solo para tu organización) o Externo (para cualquier usuario de Google).

    • Añade los datos de contacto del desarrollador y selecciona Crear.

  6. Selecciona Crear cliente OAuth.

  7. Configura el cliente:

    • En Tipo de aplicación, elija Aplicación web.

    • Introduzca un nombre para su cliente.

    • En URI de redireccionamiento autorizado, añade la URL de devolución de llamada rápida de Amazon: https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

  8. Seleccione Crear.

  9. Registre los siguientes valores. Los necesitas cuando configuras Amazon Quick.

    • ID de cliente

    • Secreto del cliente

Ámbitos recomendados

Al conectarse a Google Analytics, se solicitan los siguientes ámbitos.

Ámbitos recomendados por Google Analytics
Alcance Description (Descripción)
https://www.googleapis.com/auth/analytics.readonly Lee los datos y la configuración de Analytics.
https://www.googleapis.com/auth/analytics.edit Edita la configuración y los datos de Analytics.
openid Autentica la identidad del usuario.
email Lee la dirección de correo electrónico del usuario.
nota

Los email ámbitos openid y se incluyen automáticamente en el flujo de consentimiento de OAuth para la autenticación de los usuarios. No son necesarios para OAuth. Service-to-Service

Configuración del conector en Amazon Quick

Conectarse desde la pestaña Disponible

Si quieres usar la autenticación de la aplicación OAuth predeterminada, puedes conectarte directamente desde la pestaña Disponible sin necesidad de realizar ninguna configuración adicional.

  1. En la consola Amazon Quick, selecciona Connectors.

  2. En la pestaña Disponible, busca Google Analytics y selecciona Conectar.

  3. Complete el flujo de inicio de sesión de Google y conceda los permisos solicitados.

Para configurar un conector con la aplicación OAuth personalizada, usa la pestaña Crear para tu equipo, tal y como se describe a continuación.

Crea desde la pestaña Crear para tu equipo

Tras completar cualquier configuración de Google Cloud requerida, crea el conector en Amazon Quick.

  1. En la consola Amazon Quick, selecciona Connectors.

  2. Selecciona la pestaña Crear para tu equipo.

  3. Busca y elige Google Analytics.

    nota

    Si ya existe un conector de Google Analytics, aparecerá un cuadro de diálogo con los conectores existentes. Para usar un conector existente, elíjalo. Para crear uno nuevo, elija No, crear nuevo.

  4. Introduzca un nombre para el conector. Si lo desea, elija + Añadir descripción para añadir una descripción.

  5. En Tipo de conexión, elija Red pública.

  6. Para la configuración de OAuth, elija uno de los siguientes métodos de autenticación y configure los campos obligatorios.

    1. Para la aplicación OAuth predeterminada:

      No se necesitan credenciales adicionales. Elija Siguiente para continuar.

    2. Para la aplicación OAuth personalizada, configura los siguientes campos:

      • URL base (opcional): la URL base de la API de Google Analytics. Ejemplo: https://analyticsdata.googleapis.com

      • ID de cliente: el ID de cliente de tu cliente OAuth de Google Cloud.

      • Secreto de cliente: el secreto de cliente de tu cliente OAuth de Google Cloud.

      • URL del token: el punto final del token. Ejemplo: https://oauth2.googleapis.com/token

      • URL de autorización: el punto final de autorización. Ejemplo: https://accounts.google.com/o/oauth2/v2/auth

      • URL de redireccionamiento: Pre-filled con la URL de devolución de llamada rápida de Amazon.

  7. Elija Siguiente.

  8. Si seleccionas la aplicación OAuth predeterminada o la aplicación OAuth personalizada, se abrirá una ventana de autorización de Google. Revisa los permisos solicitados y selecciona Permitir.

  9. En la página de revisión, revise las acciones disponibles para el conector. Elija Siguiente.

  10. En la página de publicación, elija quién puede acceder al conector. Puedes habilitar el acceso para todos los miembros de tu organización o buscar equipos o grupos específicos.

  11. Elija Publicar.

Acciones disponibles

Tras configurar el conector, estarán disponibles las siguientes acciones.

Acciones disponibles de Google Analytics
Categoría Action Description (Descripción)
Informes Crear informe Realiza un informe para una propiedad.
Informes Informe de creación de lotes Ejecuta varios informes en una sola solicitud.
Informes Cree un informe en tiempo real Genera un informe en tiempo real para una propiedad.
Informes Crea un informe de embudo Realiza un informe de embudo para una propiedad.
Audiencias Enumere las audiencias Enumera las audiencias de una propiedad.
Audiencias Crea una lista de audiencias Crea una lista de audiencias para exportarla.
Audiencias Listar listas de audiencias Enumera las listas de audiencia de una propiedad.
Audiencias Obtenga una lista de audiencias Recupera datos de una lista de audiencias.
Audiencias Crea una audiencia, exporta Crea una exportación de audiencia.
Audiencias Obtenga Audience Export Recupera los datos de una exportación de audiencias.
Cuentas Enumere los resúmenes de las cuentas Muestra los resúmenes de cuentas a los que puede acceder el usuario.
Cuentas Enumere las cuentas Muestra todas las cuentas a las que puede acceder el usuario.
Cuentas Obtenga una cuenta Recupera los detalles de una cuenta específica.
Propiedades Obtenga una propiedad Recupera los detalles de una propiedad específica.
Propiedades Buscar propiedades Busca propiedades con filtrado.
Propiedades Obtenga cuotas de propiedades Recupera el uso de la cuota de una propiedad.
Events (Eventos) Enumere los eventos clave Enumera los eventos clave (conversiones) de una propiedad.
Metadatos Obtención de metadatos Recupera las dimensiones y métricas disponibles para la elaboración de informes.
Metadatos Obtenga compatibilidad Comprueba la compatibilidad de las dimensiones y las métricas de un informe.
Anotaciones Listar anotaciones Enumera las anotaciones de los datos de los informes de una propiedad.
nota

Las acciones que puede utilizar dependen de las propiedades y cuentas de Analytics a las que pueda acceder el usuario autenticado.

Administración y solución de problemas

Para editar, compartir o eliminar el conector, consulteAdministrar las integraciones existentes.

Problemas comunes de autenticación de Google

  • Sign-in falla (aplicación OAuth predeterminada o aplicación OAuth personalizada): comprueba que tu cuenta de Google esté activa y que puedas iniciar sesión directamente en el sitio web de Google. En el caso de la aplicación OAuth personalizada, confirma que el URI de redireccionamiento de tu cliente OAuth de Google Cloud coincide con la URL de devolución de llamada rápida de Amazon.

  • Aplicación bloqueada por el administrador: si el administrador de Google Workspace restringe el acceso a aplicaciones de terceros, es posible que veas un error al intentar iniciar sesión. Ponte en contacto con el administrador de Google Workspace para permitir la aplicación Amazon Quick.

  • Credenciales de cliente no válidas (aplicación OAuth personalizada): comprueba que el ID de cliente y el secreto del cliente coincidan con los valores de tu cliente OAuth de Google Cloud.

  • La ventana emergente de autenticación falla: compruebe que su navegador permite ventanas emergentes del dominio de Amazon Quick console. Intente utilizar un navegador diferente o borrar la memoria caché del navegador.

  • Permisos revocados: si anteriormente revocaste el acceso rápido a Amazon desde la configuración de permisos de tu cuenta de Google, tendrás que volver a autenticarte editando el conector e iniciando sesión de nuevo.

  • Limitación de la velocidad de las API de Google: es posible que Google limite las solicitudes durante los períodos de uso intensivo. Si las acciones fallan, vuelve a intentarlo transcurridos unos minutos.

Problemas con Google Analytics-specific

  • La API de datos de Google Analytics no está habilitada: verifica que la API de datos de Google Analytics esté habilitada en tu proyecto de Google Cloud en la sección API y servicios de la biblioteca.

  • No hay propiedades visibles: verifica que la cuenta de Google autenticada tenga acceso a las propiedades de Google Analytics que deseas consultar.