Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Intégration à Google Analytics
Grâce au connecteur d'action Google Analytics, vous pouvez accéder à Google Analytics directement dans Amazon Quick via le langage naturel. Vous pouvez générer des rapports, récupérer des données d'audience, surveiller les événements clés et accéder aux statistiques en temps réel sans quitter Amazon Quick.
Amazon Quick prend en charge plusieurs méthodes d'authentification pour Google Analytics. Choisissez la méthode qui répond le mieux aux exigences de sécurité de votre entreprise.
-
Application OAuth par défaut — Utilise une application OAuth AWS gérée. Aucune information d'identification supplémentaire n'est requise. Vous vous authentifiez directement avec votre compte Google.
-
Application OAuth personnalisée : utilise un client OAuth géré par le client créé dans la console Google Cloud. Cette option donne à votre organisation le contrôle total de la configuration OAuth.
Pour plus d'informations sur les méthodes d'authentification prises en charge par Amazon Quick, consultezMéthodes d’authentification.
Avant de commencer
Assurez-vous de disposer des éléments suivants avant de configurer l'intégration.
-
Un compte Google avec accès aux propriétés de Google Analytics et aux données que vous souhaitez utiliser.
-
Pour l'application OAuth personnalisée : accès à la console Google Cloud
sur le site Web de Google avec les autorisations nécessaires pour créer des clients OAuth. -
Pour connaître les exigences relatives à l'abonnement Amazon Quick, consultezConfiguration des intégrations dans la console.
Configuration de Google Cloud
Si vous utilisez l'authentification par défaut de l'application OAuth, ignorez cette section et passez à. Configuration du connecteur dans Amazon Quick
Pour l'authentification personnalisée de l'application OAuth, effectuez les étapes suivantes dans la console Google Cloud avant de configurer Amazon Quick. Lorsque vous activez l'API à l'étape 3, recherchez et activez l'API de données Google Analytics.
Création d'un client OAuth dans Google Cloud Console
Créez un client OAuth dans la console Google Cloud pour obtenir les informations d'identification client dont vous avez besoin pour Amazon Quick. Pour plus d'informations, consultez la section Utilisation d'OAuth 2.0 pour accéder aux API Google sur le site
-
Connectez-vous à la console Google Cloud
sur le site Web de Google. -
Créez un nouveau projet ou sélectionnez un projet existant.
-
Dans le volet de navigation de gauche, choisissez APIs & Services, puis Library. Recherchez l'API requise pour votre intégration et choisissez Activer.
-
Choisissez l'écran de consentement OAuth et choisissez Get Started.
-
Configurez l'écran de consentement :
-
Entrez un nom d'application et sélectionnez un e-mail d'assistance utilisateur.
-
Pour Audience, choisissez Interne (votre organisation uniquement) ou Externe (n'importe quel utilisateur de Google).
-
Ajoutez les coordonnées du développeur et choisissez Créer.
-
-
Choisissez Create OAuth client.
-
Configurez le client :
-
Pour Type d'application, sélectionnez Application Web.
-
Entrez le nom de votre client.
-
Sous URI de redirection autorisés, ajoutez l'URL de rappel Amazon Quick :
https://{region}.quicksight.aws.amazon.com/sn/oauthcallback
-
-
Choisissez Créer.
-
Enregistrez les valeurs suivantes. Vous en avez besoin lorsque vous configurez Amazon Quick.
-
Identifiant du client
-
Secret client
-
Éscopes recommandés
Les champs d'application suivants sont demandés lorsque vous vous connectez à Google Analytics.
| Scope | Description |
|---|---|
https://www.googleapis.com/auth/analytics.readonly |
Lit les données et la configuration d'Analytics. |
https://www.googleapis.com/auth/analytics.edit |
Modifie la configuration et les données d'Analytics. |
openid |
Authentifie l'identité de l'utilisateur. |
email |
Lit l'adresse e-mail de l'utilisateur. |
Note
Les email étendues openid et sont automatiquement incluses dans le flux de consentement OAuth pour l'authentification des utilisateurs. Ils ne sont pas obligatoires pour Service-to-Service OAuth.
Configuration du connecteur dans Amazon Quick
Se connecter depuis l'onglet Disponible
Si vous souhaitez utiliser l'authentification par défaut de l'application OAuth, vous pouvez vous connecter directement depuis l'onglet Disponible sans configuration supplémentaire.
-
Dans la console Amazon Quick, choisissez Connectors.
-
Dans l'onglet Disponible, recherchez Google Analytics et choisissez Connect.
-
Complétez le flux de connexion à Google et accordez les autorisations demandées.
Pour configurer un connecteur avec l'application OAuth personnalisée à la place, utilisez l'onglet Créer pour votre équipe, comme décrit ci-dessous.
Créez à partir de l'onglet Créer pour votre équipe
Après avoir effectué toute configuration requise de Google Cloud, créez le connecteur dans Amazon Quick.
-
Dans la console Amazon Quick, choisissez Connectors.
-
Choisissez l'onglet Créer pour votre équipe.
-
Recherchez et choisissez Google Analytics.
Note
Si un connecteur Google Analytics existe déjà, une boîte de dialogue contenant vos connecteurs existants s'affiche. Pour utiliser un connecteur existant, choisissez-le. Pour en créer un nouveau, choisissez Non, créer un nouveau.
-
Entrez un nom pour votre connecteur. Choisissez éventuellement + Ajouter une description pour ajouter une description.
-
Pour Type de connexion, sélectionnez Réseau public.
-
Pour la configuration OAuth, choisissez l'une des méthodes d'authentification suivantes et configurez les champs obligatoires.
-
Pour l'application OAuth par défaut :
Aucune information d'identification supplémentaire n'est requise. Choisissez Next (Suivant) pour continuer.
-
Pour l'application OAuth personnalisée, configurez les champs suivants :
-
URL de base (facultatif) — URL de base de l'API Google Analytics. Exemple :
https://analyticsdata.googleapis.com -
ID client : ID client de votre client Google Cloud OAuth.
-
Secret client : secret client de votre client Google Cloud OAuth.
-
URL du jeton : point de terminaison du jeton. Exemple :
https://oauth2.googleapis.com/token -
URL d'autorisation : point de terminaison d'autorisation. Exemple :
https://accounts.google.com/o/oauth2/v2/auth -
URL de redirection : Pre-filled avec l'URL de rappel Amazon Quick.
-
-
-
Choisissez Suivant.
-
Si vous avez choisi l'application OAuth par défaut ou l'application OAuth personnalisée, une fenêtre d'autorisation Google s'ouvre. Vérifiez les autorisations demandées et choisissez Autoriser.
-
Sur la page Révision, passez en revue les actions disponibles pour le connecteur. Choisissez Suivant.
-
Sur la page Publier, choisissez qui peut accéder au connecteur. Vous pouvez autoriser l'accès à tous les membres de votre organisation ou rechercher des équipes ou des groupes spécifiques.
-
Choisissez Publier.
Actions disponibles
Après avoir configuré le connecteur, les actions suivantes sont disponibles.
| Catégorie | Action | Description |
|---|---|---|
| Rapports | Créer un rapport | Exécute un rapport pour une propriété. |
| Rapports | Rapport de création par lots | Exécute plusieurs rapports en une seule demande. |
| Rapports | Création d'un rapport en temps réel | Exécute un rapport en temps réel pour une propriété. |
| Rapports | Créer un rapport sur l'entonnoir | Exécute un rapport d'entonnoir pour une propriété. |
| Audiences | Lister les audiences | Répertorie les audiences d'une propriété. |
| Audiences | Création d'une liste d'audience | Crée une liste d'audience à exporter. |
| Audiences | Lister les listes d'audience | Répertorie les listes d'audience d'une propriété. |
| Audiences | Obtenir la liste d'audience | Récupère les données d'une liste d'audience. |
| Audiences | Création d'une exportation d'audience | Crée une exportation d'audience. |
| Audiences | Obtenez Audience Export | Récupère les données d'une exportation d'audience. |
| Comptes | Récapitulatif des comptes | Répertorie les résumés des comptes accessibles à l'utilisateur. |
| Comptes | Lister les comptes | Répertorie tous les comptes accessibles à l'utilisateur. |
| Comptes | Obtenir un compte | Récupère les détails d'un compte spécifique. |
| Propriétés | Obtenir une propriété | Récupère les détails d'une propriété spécifique. |
| Propriétés | Propriétés de recherche | Recherche des propriétés à l'aide d'un filtrage. |
| Propriétés | Obtenir des quotas de propriété | Récupère l'utilisation du quota pour une propriété. |
| Événements | Répertorier les événements clés | Répertorie les événements clés (conversions) d'une propriété. |
| Métadonnées | Obtention des métadonnées | Récupère les dimensions et les métriques disponibles pour les rapports. |
| Métadonnées | Obtenez la compatibilité | Vérifie la compatibilité des dimensions et des métriques d'un rapport. |
| Annotations | Annotations de liste | Répertorie les annotations de données relatives à une propriété. |
Note
Les actions que vous pouvez utiliser dépendent des propriétés d'Analytics et des comptes accessibles à l'utilisateur authentifié.
Gestion et résolution des problèmes
Pour modifier, partager ou supprimer votre connecteur, consultezGestion des intégrations existantes.
Problèmes courants liés à l'authentification Google
-
Sign-in échoue (application OAuth par défaut ou application OAuth personnalisée) : vérifiez que votre compte Google est actif et que vous pouvez vous connecter directement au site Web de
Google. Pour l'application OAuth personnalisée, vérifiez que l'URI de redirection dans votre client Google Cloud OAuth correspond à l'URL de rappel Amazon Quick. -
Application bloquée par l'administrateur : si votre administrateur Google Workspace restreint l'accès aux applications tierces, un message d'erreur peut s'afficher lorsque vous tentez de vous connecter. Contactez votre administrateur Google Workspace pour autoriser l'application Amazon Quick.
-
Informations d'identification client non valides (application OAuth personnalisée) : vérifiez que l'ID client et le secret du client correspondent aux valeurs de votre client Google Cloud OAuth.
-
Échec de la fenêtre contextuelle d'authentification : vérifiez que votre navigateur autorise les fenêtres contextuelles provenant du domaine de la console Amazon Quick. Essayez d'utiliser un autre navigateur ou de vider le cache de votre navigateur.
-
Autorisations révoquées — Si vous avez précédemment révoqué l'accès à Amazon Quick depuis les paramètres d'autorisation de votre compte Google, vous devez vous authentifier à nouveau en modifiant le connecteur et en vous reconnectant.
-
Limitation du débit de l'API Google : Google peut limiter les demandes pendant les périodes de forte utilisation. Si les actions échouent, réessayez après quelques minutes.
Analytics-specific Problèmes liés à Google
-
API de données Google Analytics non activée : vérifiez que l'API de données Google Analytics est activée dans votre projet Google Cloud sous API et services, bibliothèque.
-
Aucune propriété visible : vérifiez que le compte Google authentifié a accès aux propriétés Google Analytics que vous souhaitez interroger.
