Paramétrez Openflow Connector for Meta Ads

Note

Le connecteur est soumis aux conditions d’utilisation du connecteur.

Cette rubrique décrit les étapes pour paramétrer Openflow Connector for Meta Ads.

Conditions préalables

  1. Assurez-vous d’avoir consulté À propos de Openflow Connector for Meta Ads.

  2. Assurez-vous d’avoir Configuration d’Openflow - BYOC ou Configuration d’Openflow - Déploiement Snowflake - Vue d’ensemble des tâches.

Obtenir les identifiants de connexion

En tant qu’administrateur de Meta Ads, effectuez les actions suivantes dans votre compte Meta Ads :

  1. Créez une application Meta ou assurez-vous que vous y avez accès.

  2. Activez l’API Marketing dans le tableau de bord App.

  3. Générez un jeton à longue durée de vie.

  4. Facultatif : Augmentez la limite de taux en changeant le type d’accès à l’application de Standard access à Advanced access de l’accès standard à la gestion des publicités. Activez les autorisations ads_read et ads_management https://developers.facebook.com/docs/permissions/.

Paramétrage du compte Snowflake

En tant qu’administrateur de compte Snowflake, effectuez les tâches suivantes :

  1. Créez un nouveau rôle ou utilisez un rôle existant et accordez le Privilèges de base de données.

  2. Créez un nouvel utilisateur du service Snowflake avec le type SERVICE.

  3. Autorisez l’utilisateur du service Snowflake le rôle que vous avez créé dans les étapes précédentes.

  4. Configurez avec l’authentification par paire de clés pour l’utilisateur de Snowflake SERVICE de l’étape 2.

  5. 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.

    1. 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é.

    2. Dans Openflow, configurez un fournisseur de paramètres associé à ce gestionnaire de secrets, à partir du menu hamburger en haut à droite. Naviguez jusqu’à Controller Settings » Parameter Provider, puis récupérez vos valeurs de paramètres.

    3. À 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.

  6. 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.

  7. 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

  1. Créez une base de données et un schéma dans Snowflake pour le connecteur afin de stocker les données ingérées. Autorisation Privilèges de base de données requise pour le rôle créé lors de la première étape. Remplacez l’espace réservé au rôle par la valeur réelle et utilisez les commandes SQL suivantes :

    CREATE DATABASE META_ADS_DESTINATION_DB;
CREATE SCHEMA META_ADS_DESTINATION_DB.META_ADS_DESTINATION_SCHEMA;
GRANT USAGE ON DATABASE META_ADS_DESTINATION_DB TO ROLE <META_ADS_CONNECTOR_ROLE>;
GRANT USAGE ON SCHEMA META_ADS_DESTINATION_DB.META_ADS_DESTINATION_SCHEMA TO ROLE <META_ADS_CONNECTOR_ROLE>;
GRANT CREATE TABLE ON SCHEMA META_ADS_DESTINATION_DB.META_ADS_DESTINATION_SCHEMA TO ROLE <META_ADS_CONNECTOR_ROLE>;
    Copy

  1. Naviguez jusqu’à la page d’aperçu d’Openflow. Dans la section Featured connectors, sélectionnez View more connectors.

  2. Sur la page des connecteurs Openflow, trouvez le connecteur et sélectionnez Add to runtime.

  3. Dans la boîte de dialogue Select runtime, sélectionnez votre environnement d’exécution dans la liste déroulante Available runtimes.

  4. 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.

  5. 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.

  6. 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

  1. Cliquez avec le bouton droit de la souris sur le groupe de processus importé et sélectionnez Parameters.

  2. Renseignez les valeurs des paramètres requis comme décrit dans Paramètres de débit.

Paramètres de débit

Cette section décrit les paramètres de flux que vous pouvez configurer en fonction des contextes de paramètres suivants :

Paramètres de la source Meta Ads

Paramètre

Description

Jeton d’accès

Jeton requis pour la requête de l’API Meta Ads Insights

Paramètres de destination Meta Ads

Paramètre

Description

Obligatoire

Base de données de destination

La base de données dans laquelle les données seront conservées. Elle doit déjà exister dans Snowflake. Le nom est sensible à la casse. Pour les identificateurs sans guillemets, indiquez le nom en majuscules.

Oui

Schéma de destination

Le schéma dans lequel les données seront conservées, qui doit déjà exister dans Snowflake. Le nom est sensible à la casse. Pour les identificateurs sans guillemets, indiquez le nom en majuscules.

Voir l’exemple suivant :

  • CREATE SCHEMA SCHEMA_NAME ou CREATE SCHEMA schema_name : utilisez SCHEMA_NAME.

  • CREATE SCHEMA "schema_name" ou CREATE SCHEMA "SCHEMA_NAME" : utilisez schema_name ou SCHEMA_NAME, respectivement.

Oui

Identificateur de compte Snowflake

Lorsque vous utilisez :

  • Stratégie d’authentification par jeton de session : doit être vide.

  • KEY_PAIR : nom du compte Snowflake au format [nom-organisation]-[nom-compte] où les données seront conservées.

Oui

Stratégie d’authentification Snowflake

Lorsque vous utilisez :

  • Déploiement Snowflake Openflow : Utilisez SNOWFLAKE_SESSION_TOKEN. Ce jeton est géré automatiquement par Snowflake.

  • BYOC : utilisez KEY_PAIR comme valeur pour la stratégie d’authentification.

Oui

Clé privée de Snowflake

Lorsque vous utilisez :

  • Stratégie d’authentification par jeton de session : doit être vide.

  • KEY_PAIR : Doit correspondre à la clé privée RSA utilisée pour l’authentification.

    La clé RSA doit être formatée conformément aux normes PKCS8 et posséder des en-têtes et des pieds de page PEM standards. Notez que le fichier de la clé privée Snowflake ou que la clé privée Snowflake doit être défini.

Non

Fichier de clé privée de Snowflake

Lorsque vous utilisez :

  • Stratégie d’authentification par jeton de session : Le fichier de la clé privée doit être vide.

  • KEY_PAIR : Chargez le fichier qui contient la clé privée RSA utilisée pour l’authentification auprès de Snowflake, formatée conformément aux normes PKCS8 et possédant des en-têtes et des pieds de page PEM standards. La ligne d’en-tête commence par -----BEGIN PRIVATE. Pour charger le fichier de la clé privée, cochez la case Reference asset.

Non

Mot de passe de la clé privée de Snowflake

Lorsque vous utilisez :

  • Stratégie d’authentification par jeton de session : doit être vide.

  • KEY_PAIR : fournissez le mot de passe associé au fichier de la clé privée Snowflake.

Non

Rôle Snowflake

Lorsque vous utilisez :

  • Stratégie d’authentification par jeton de session : Utilisez votre rôle d’exécution. Vous pouvez trouver votre rôle d’exécution dans l’UI d’Openflow, en naviguant jusqu’à View Details pour votre exécution.

  • Stratégie d’authentification KEY_PAIR : Utilisez un rôle valide configuré pour votre utilisateur de service.

Oui

Nom d’utilisateur Snowflake

Lorsque vous utilisez :

  • Stratégie d’authentification par jeton de session : doit être vide.

  • KEY_PAIR : indiquez le nom d’utilisateur utilisé pour vous connecter à l’instance Snowflake.

Oui

Entrepôt Snowflake

Entrepôt Snowflake utilisé pour exécuter des requêtes.

Oui

Paramètres d’ingestion Meta Ads

Paramètre

Description

Report Name

Nom du rapport à utiliser comme nom de table de destination. Le nom doit être unique dans le schéma de destination.

Identité de l’objet du rapport

Identificateur de l’objet téléchargé à partir de Meta Ads.

Référence à l’API annonçant les différents objets :

Report Ingestion Strategy

Mode de récupération des données, instantané ou incrémental

Version de Meta Ads

Version de l’API Meta Ads utilisée pour le téléchargement des rapports. Valeur autorisée : v22.0.

Report Level

Présente le niveau d’agrégation du résultat.

Valeurs possibles :

  • account

  • campaign

  • ad

  • adset.

Report Fields

Liste de champs de rapport séparés par des virgules

Report Breakdowns

Liste de ventilations d’états séparée par des virgules. La liste complète des annonces disponibles est disponible à l’adresse suivante : https://developers.facebook.com/docs/marketing-api/insights/breakdowns.

Report Time Increment

Niveau d’agrégation basé sur le nombre de jours

Valeurs possibles :

  • 1 - Tous les jours.

  • 3 - Tous les 3 jours

  • 7 - Hebdomadaire

  • monthly - Mensuel

  • 90 - Trimestriel

  • all_days - Tous les jours ; résultat non tronqué

Rapport de temps d’action

Statistiques sur l’heure de l’action

Valeurs possibles :

  • conversion - Rapports d’action basés sur la date de conversion

  • impression - Action de signalement basée sur la date d’impression

  • mixed - Approche mixte entre la conversion et l’impression

Rapport de fenêtre d’attribution des clics

Fenêtre d’attribution pour l’action de clic

Valeurs possibles :

  • 1d_click

  • 7d_click

  • 28d_click

Rapport de fenêtre d’attribution des vues

Fenêtre d’attribution pour l’action de vue

Valeurs possibles :

  • 1d_view

  • 7d_view

  • 28d_view

Planification du rapport

Planifier le temps nécessaire à la création de rapports par le processeur

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.

Exécutez le flux

  1. Cliquez avec le bouton droit de la souris sur l’avion et sélectionnez Enable all Controller Services.

  2. 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 :

  1. Assurez-vous qu’il n’y a plus de fichiers de flux dans les files d’attente.

  2. Arrêtez tous les processeurs.

  3. Effacez l’état du processeur initial.

    1. Cliquez avec le bouton droit de la souris sur le processeur Create Meta Ads Report et sélectionnez View State.

    2. Sélectionnez l’option Clear State. Cette opération réinitialise l’état du processeur.

  4. Supprimez la table de destination dans Snowflake.

Langage: Français