Paramétrer le connecteur Openflow pour Google Ads¶
Note
Le connecteur est soumis aux conditions d’utilisation du connecteur.
Cette rubrique décrit les étapes de paramétrage du connecteur Openflow pour Google Ads.
Conditions préalables¶
Assurez-vous d’avoir consulté Connecteur Openflow pour Google Ads.
Assurez-vous que vous avez paramétré Openflow.
Obtenir les identifiants de connexion¶
En tant qu’administrateur de Google Ads, effectuez les performances suivantes :
Assurez-vous d’avoir accès à un projet Google Cloud ou créez-en un nouveau.
Assurez-vous que l’API Google Ads est activée pour votre projet Google Cloud. L’accès à l’API Google Ads est requis pour l’ingestion des données.
Configurez l’authentification du compte Service pour Google Ads.
Obtenez le jeton de développeur pour votre organisation en suivant les instructions https://developers.google.com/google-ads/api/docs/get-started/dev-token.
Note
Le jeton d’accès du développeur doit avoir un niveau d’accès de base ou standard. Pour plus d’informations sur le niveau d’accès, veuillez consulter la documentation https://developers.google.com/google-ads/api/docs/access-levels.
Paramétrage du compte Snowflake¶
En tant qu’administrateur de compte Snowflake, effectuez les tâches suivantes :
Créez un nouveau rôle ou utilisez un rôle existant et accordez le Privilèges de base de données.
Créez un nouvel utilisateur du service Snowflake avec le type SERVICE.
Autorisez l’utilisateur du service Snowflake le rôle que vous avez créé dans les étapes précédentes.
Configurez avec l’authentification par paire de clés pour l’utilisateur de Snowflake SERVICE de l’étape 2.
Snowflake recommande vivement cette étape. Configurez un gestionnaire de secrets pris en charge par Openflow, par exemple AWS, Azure et Hashicorp, et stockez les clés publiques et privées dans le magasin de secrets.
Note
Si, pour une raison quelconque, vous ne souhaitez pas utiliser un gestionnaire de secrets, il vous incombe de protéger les fichiers de clés publiques et privées utilisés pour l’authentification par paires de clés conformément aux politiques de sécurité de votre organisation.
Une fois le gestionnaire de secrets configuré, déterminez comment vous vous y authentifierez. Sur AWS, il est recommandé d’utiliser le rôle de l’instance EC2 associée à Openflow, car de cette manière, aucun autre secret ne doit être conservé.
Dans Openflow, configurez un fournisseur de paramètres associé à ce gestionnaire de secrets, à partir du menu hamburger en haut à droite. Naviguez vers Controller Settings » Parameter Provider et récupérez les valeurs de vos paramètres.
À ce stade, tous les identifiants peuvent être référencés avec les chemins de paramètres associés et aucune valeur sensible ne doit être conservée dans Openflow.
Si d’autres utilisateurs de Snowflake ont besoin d’accéder aux documents bruts ingérés et aux tables ingérées par le connecteur (par exemple, pour un traitement personnalisé dans Snowflake), accordez à ces utilisateurs le rôle créé à l’étape 1.
Désignez un entrepôt à utiliser par le connecteur. Commencez par la taille d’entrepôt la plus petite, puis faites des essais en fonction du nombre de tables répliquées et de la quantité de données transférées. Les tables de grande taille s’adaptent généralement mieux aux entrepôts multi-clusters, plutôt qu’aux entrepôts de grande taille.
Définir le connecteur¶
En tant qu’ingénieur des données, effectuez les tâches suivantes pour installer et configurer le connecteur :
Installer le connecteur¶
#. Create a database and schema in Snowflake for the connector to store ingested data. Grant required Privilèges de base de données to the role created in the first step. Substitute the role placeholder with the actual value and use the following sql commands:
CREATE DATABASE GOOGLE_ADS_DESTINATION_DB; CREATE SCHEMA GOOGLE_ADS_DESTINATION_DB.GOOGLE_ADS_DESTINATION_SCHEMA; GRANT USAGE ON DATABASE GOOGLE_ADS_DESTINATION_DB TO ROLE <GOOGLE_ADS_CONNECTOR_ROLE>; GRANT USAGE ON SCHEMA GOOGLE_ADS_DESTINATION_DB.GOOGLE_ADS_DESTINATION_SCHEMA TO ROLE <GOOGLE_ADS_CONNECTOR_ROLE>; GRANT CREATE TABLE ON SCHEMA GOOGLE_ADS_DESTINATION_DB.GOOGLE_ADS_DESTINATION_SCHEMA TO ROLE <GOOGLE_ADS_CONNECTOR_ROLE>;
Naviguez jusqu’à la page d’aperçu d’Openflow. Dans la section Featured connectors, sélectionnez View more connectors.
Sur la page des connecteurs Openflow, trouvez le connecteur et sélectionnez Add to runtime.
Dans la boîte de dialogue Select runtime, sélectionnez votre environnement d’exécution dans la liste déroulante Available runtimes.
Sélectionnez Add.
Note
Avant d’installer le connecteur, assurez-vous que vous avez créé une base de données et un schéma dans Snowflake pour que le connecteur puisse stocker les données ingérées.
Authentifiez-vous au déploiement avec les identifiants de votre compte Snowflake et sélectionnez Allow lorsque vous êtes invité à autoriser l’application d’exécution à accéder à votre compte Snowflake. Le processus d’installation du connecteur prend quelques minutes.
Authentifiez-vous auprès de l’environnement d’exécution avec les identifiants de votre compte Snowflake.
Le canevas Openflow apparaît avec le groupe de processus du connecteur ajouté.
Configuration du connecteur¶
Cliquez avec le bouton droit de la souris sur le groupe de processus importé et sélectionnez Parameters.
Renseignez les valeurs des paramètres requis comme décrit dans Paramètres de débit.
Paramètres de débit¶
Il existe trois contextes de paramètres. Les paramètres de destination des annonces Google
et Les paramètres de source des annonces Google
sont respectivement chargés d’autoriser les connexions avec l’API GoogleAds et Snowflake. Google Ads Ingestion Parameters
est utilisé pour définir la reconfiguration des données téléchargées depuis Google Ads. Google Ads Parameters
les regroupe toutes en une seule.
Paramètres d’ingestion Google Ads¶
Paramètre |
Description |
Obligatoire |
---|---|---|
ID de compte client |
ID du compte dans Google Ads pour lequel le rapport doit être ingéré |
true |
Nom de la ressource Google Ads |
Nom de la ressource dans Google Ads qui est une source pour le rapport |
true |
Attributs du rapport |
Attributs de la ressource sélectionnée |
true |
Métriques du rapport |
Métriques collectées dans le contexte d’une ressource donnée |
false |
Segments du rapport |
Compartiments dans lesquels les métriques doivent être regroupées |
false |
Report Start Date |
Date de début à partir de laquelle l’ingestion doit avoir lieu. Le format de la date est le suivant : YYYY-MM-DD. |
false |
Planification |
Obtenir la planification du processeur du rapport Google Ads |
true |
Note
La façon la plus simple d’obtenir une combinaison appropriée d'attributs de rapport
, de mesures de rapport
et de segments de rapport
est d’utiliser Google Ads Query Builder. Sélectionnez la ressource en fonction de celle insérée dans le paramètre Google Ads Resource Name
et construisez la requête. Copiez et collez ensuite les attributs, les métriques et les segments aux paramètres correspondants.
Paramètres de la source Google Ads¶
Paramètre |
Description |
Obligatoire |
---|---|---|
Jeton de développeur Google |
Jeton de développeur obligatoire pour effectuer une requête de l’API Google Ads |
true |
Compte de service Google JSON |
Compte de service JSON requis pour l’authentification de Google Ads |
true |
Paramètres de destination Google Ads¶
Paramètre |
Description |
Obligatoire |
---|---|---|
Base de données de destination |
La base de données dans laquelle les données seront conservées. Doit déjà exister dans Snowflake. |
true |
Schéma de destination |
Le schéma dans lequel les données seront conservées. Doit déjà exister dans Snowflake. |
true |
Identificateur de compte Snowflake |
Nom du compte Snowflake formaté comme suit : [[nom de l’organisation] -[[nom du compte] où les données seront conservées |
true |
Stratégie d’authentification Snowflake |
Stratégie d’authentification auprès de Snowflake. Valeurs possibles : |
true |
Clé privée de Snowflake |
La clé privée RSA utilisée pour l’authentification. La clé RSA doit être formatée selon les normes PKCS8 et comporter les en-têtes et pieds de page standard PEM. Notez que vous devez définir soit le fichier de clé privée de Snowflake, soit la clé privée de Snowflake |
false |
Fichier de clé privée de Snowflake |
Le fichier qui contient la clé privée RSA utilisée pour l’authentification à Snowflake, formaté selon les normes PKCS8 et comportant les en-têtes et pieds de page standard PEM. La ligne d’en-tête commence par |
false |
Mot de passe de la clé privée de Snowflake |
Le mot de passe associé au fichier de la clé privée de Snowflake |
false |
Rôle Snowflake |
Rôle Snowflake utilisé lors de l’exécution de la requête |
true |
Nom d’utilisateur Snowflake |
Nom d’utilisateur utilisé pour se connecter à l’instance de Snowflake |
true |
Entrepôt Snowflake |
L’entrepôt de Snowflake est utilisé pour exécuter des requêtes |
true |
Exécutez le flux¶
Cliquez avec le bouton droit de la souris sur l’avion et sélectionnez Enable all Controller Services.
Cliquez avec le bouton droit de la souris sur le groupe de processus importé et sélectionnez Start. Le connecteur démarre l’ingestion des données.
Comment réinitialiser le connecteur¶
Pour réinitialiser complètement le connecteur à l’état initial, procédez comme suit :
Assurez-vous qu’il n’y a plus de fichiers de flux dans les files d’attente.
Arrêtez tous les processeurs.
Effacez l’état du processeur initial.
Cliquez avec le bouton droit de la souris sur le processeur
Get Google Ads Report
et sélectionnez View State.Sélectionnez l’option Clear State. Cette opération réinitialise l’état du processeur.
Supprimez la table de destination dans Snowflake.