Aller au contenu principal

Connecteur source Google Analytics

Le connecteur source Google Analytics dans DataSync vous permet de récupérer des données de Google Analytics pour le chargement ou la synchronisation dans votre entrepôt de données. Avant de commencer, vous devez disposer d’un compte Google et créer un client OAuth dans Google Cloud Console afin que DataSync puisse s’authentifier.

Après avoir créé toutes les connexions sources requises, configurez votre connexion de destination pour finaliser la configuration.

Pour les tables basées sur les vues, Google Analytics limite les requêtes à 10 mesures et 7 dimensions. Consultez Limites des champs Google Analytics.

important

Authentifiez-vous avec le même compte Google que celui utilisé pour créer le projet Google Cloud et le client OAuth.

Configurer Google Cloud

Créer ou sélectionner un projet Google Cloud

  1. Ouvrez Google Cloud Console.
  2. Connectez-vous avec votre compte Google.
  3. Sélectionnez Sélectionner un projet, puis effectuez l’une des actions suivantes :
    • Sélectionnez un projet existant.
    • Sélectionnez réer un projet, saisissez un nom de projet, choisissez l’emplacement, puis sélectionnez Créer.

Activer les API requises

  1. Dans Google Cloud Console, sélectionnez API et services, puis API et services activés.
  2. Si vous avez plusieurs projets, vérifiez que le bon projet est sélectionné.
  3. Cliquez sur + Activer les APIs et services.
  4. Dans la barre de recherche, entrez Google Analytics, puis appuyez sur Entrée.
  5. Sélectionnez API Google Analytics et cliquez sur Activer.
  6. Dans la barre de recherche, entrez Google Drive, puis appuyez sur Entrée.
  7. Sélectionnez API Google Drive et cliquez sur Activer.

Créer des identifiants OAuth

  1. Dans Google Cloud Console, sélectionnez APIs et services, puis Identifiants.
  2. Cliquez sur + Créer des identifiants, puis ID client OAuth.
  3. Dans Type d'application, sélectionnez Application web.
  4. Dans Origines JavaScript autorisées, ajoutez l’URL de votre serveur DataSync et le domaine de votre entreprise.
  5. Laissez URI de redirection autorisés vide pour le moment.
  6. Sélectionnez Créer, puis notez le Client ID et le Client secret pour les renseigner plus tard dans DataSync.

remarque

Les valeurs dans Origines JavaScript autorisées doivent être des URL valides (par exemple, se terminant par .com ou .net).

Créer une connexion source dans DataSync

  1. Connectez-vous à DataSync.
  2. Depuis l'écran d'accueil, sélectionnez Connexions.
  3. À côté de Connexions Source, cliquez sur Nouveau.
  4. Sélectionnez Google Analytics.
  5. Dans le panneau Propriétés de la connexion, saisissez les valeurs requises.
  6. Copiez l'URL de rappel affichée dans Propriétés de connexion.
  7. Dans Google Cloud Console, allez à APIs et services, puis Identifiants.
  8. Sélectionnez votre client OAuth, puis ajoutez l’URL de rappel de DataSync dans URI de redirection autorisés. Cliquez sur Sauvegarder.
  9. (Optionnel) Dans le panneau Autres propriétés de la connexion, sélectionnez Ajouter une propriété et entrez les paramètres pour chaque propriété.
  10. Dans le panneau Paramètres avancés, configurez les paramètres, y compris le Type de suivi et d'autres valeurs selon vos besoins.
  11. Cliquez sur Enregistrer, puis terminez la connexion Google et l’écran de consentement.

Paramètres

Propriétés de la connexion

ParamètreDescription
DescriptionNom unique pour la connexion. Exemple : Google Analytics
URL de rappelURL générée par DataSync à ajouter dans URI de redirection autorisés dans la Google Cloud Console.
Identité du clientID client OAuth disponible dans la Google Cloud Console > API et services > Identifiants. Exemple : 1234567890-abc.apps.googleusercontent.com
Secret du clientSecret client OAuth disponible dans la Google Cloud Console > API et services > Identifiants. Exemple : XyZ123_ABCD
Verbosité
  • 1 – Journaliser les requêtes, les comptages de lignes, le début/fin d'exécution, les erreurs.
  • 2 – Inclut le niveau 1 plus les requêtes de cache, les en-têtes HTTP.
  • 3 – Inclut le niveau 2 plus les corps de requête/réponse.
  • 4 – Inclut le niveau 3 plus la communication au niveau du transport.
  • 5 – Inclut le niveau 4 plus toutes les commandes d'interface.
Délai d'inactivité du PoolTemps maximum d'inactivité pour les connexions avant de les renvoyer au pool, en secondes.
Taille maximale du PoolNombre maximal de connexions autorisées dans le pool.
Temps d'attente du PoolTemps d'attente maximal pour l'attribution de connexions avant qu'une erreur ne soit lancée, en secondes.

Autres propriétés de la connexion

Propriétés de chaîne de connexion supplémentaires non spécifiées dans le panneau Propriétés de connexion. Pour chaque propriété ajoutée, vous pouvez choisir Visible ou Crypé. En sélectionnant Crypé, la valeur est masquée dans l'interface et stockée de manière chiffrée dans le backend, par exemple lors de la définition de mots de passe.

ParamètreDescription
PropriétéPropriété de chaîne de connexion qui définit l'action ou le comportement. Exemple : LectureSeule
ValeurValeur pour la propriété. Exemple : Vrai
TypeVisibilité de la propriété : Visible ou Crypé.

Paramètres avancés

Les paramètres avancés contrôlent comment le connecteur Google Analytics suit les changements, gère la configuration régionale et horaire, et traite les lots de données lors de l'extraction. Ces options permettent un ajustement fin pour la performance et l'exactitude, et devraient être configurées selon votre environnement système et vos exigences opérationnelles.

ParamètreDescription
Type de suiviMéthode de suivi des changements : Aucun ou Date.
RégionParamètre de région pour le connecteur, si nécessaire pour votre configuration.
Fuseau horaireFuseau horaire correspondant au serveur d'application Google Analytics.
Décalage horaireDécalage de rafraîchissement en secondes pour compenser les problèmes de timing dans la sélection des enregistrements. La valeur minimale est 0 ; le maximum est 3600 secondes.
Taille du lotQuantité d'enregistrements traités dans chaque lot lors de l'extraction. Des tailles de lot plus grandes augmentent l'utilisation de la mémoire mais peuvent améliorer les performances jusqu'à un certain point. La valeur par défaut est 2000 et le maximum ne doit pas dépasser 10000 enregistrements. Ajustez selon la vitesse de votre réseau et la performance de votre disque ; dans la plupart des cas, la valeur par défaut (2000) fonctionne le mieux.