Planifier un transfert Facebook Ads

Le service de transfert de données BigQuery pour le connecteur d'annonces Facebook vous permet de planifier et de gérer automatiquement les jobs de chargement récurrents des annonces Facebook dans BigQuery.

Limites

Les transferts d'annonces Facebook sont soumis aux limitations suivantes :

• L'intervalle minimum entre les transferts récurrents des annonces Facebook est de 24 heures. L'intervalle par défaut entre transferts récurrents est de 24 heures.
• Le service de transfert de données BigQuery pour Facebook Ads n'accepte qu'un ensemble fixe de tables. Les rapports personnalisés ne sont pas acceptés.
• La durée maximale des transferts d'annonces Facebook est de six heures. Un transfert échoue si sa durée dépasse cette durée maximale.
• Les transferts incrémentiels ne sont pas acceptés pour les tables AdInsights et AdInsightsActions. Lorsque vous créez un transfert de données qui inclut des tables AdInsights et AdInsightsActions, et que vous avez spécifié une date dans les options de planification, toutes les données disponibles pour cette date sont transférées.
• Le service de transfert de données BigQuery permet une fenêtre d'actualisation d'un jour pour les tables AdInsights et AdInsightsActions. La fenêtre d'actualisation fait référence au nombre de jours pendant lesquels un transfert de données récupérera les données sources. Lorsque vous exécutez un transfert de données pour la première fois, celui-ci récupère toutes les données sources disponibles pendant l'intervalle d'actualisation.

• Le jeton d'accès utilisateur de longue durée requis pour les transferts Facebook Ads expire au bout de 60 jours.

  Si votre jeton d'accès de longue durée a expiré, vous pouvez obtenir le nouveau en accédant aux détails du transfert et en cliquant sur Modifier. Sur la page de modification du transfert, suivez la même procédure que dans la section Conditions préalables à l'utilisation des annonces Facebook pour générer un nouveau jeton d'accès de longue durée.

Ingestion de données à partir de transferts Facebook Ads

Pour les tables AdInsights et AdInsightsAction, la partition de la table dans laquelle les données sont chargées correspond à la date de la source de données.

Pour les tables AdAccounts, les instantanés sont réalisés une fois par jour et stockés dans la partition de la dernière date d'exécution du transfert. La fenêtre d'actualisation ne s'applique pas à la table AdAccounts.

Avant de commencer

Les sections suivantes décrivent la procédure à suivre avant de créer un transfert Facebook Ads.

Conditions préalables à l'utilisation des annonces Facebook

Vérifiez que vous disposez des informations Facebook Ads suivantes lorsque vous créez un transfert d'annonces Facebook.

Pour obtenir un clientID et un clientSecret, procédez comme suit :

1. Créez une application de développeur Facebook avec le type d'application Business.
2. Dans le tableau de bord des applications Facebook, cliquez sur Paramètres de l'application > Basic, puis recherchez l'ID de l'application. et le code secret de l'application correspondant à l'application.

Pour obtenir un jeton d'accès utilisateur de longue durée, également appelé jeton d'actualisation, procédez comme suit :

1. Dans la console Google Cloud, suivez les étapes permettant de créer un transfert Facebook Ads.

2. Dans la section Détails de la source de données, copiez l'URI de redirection répertorié après le champ Jeton d'actualisation.

   

3. Cliquez sur le tableau de bord des applications Facebook, puis sur Configurer dans la section Facebook Login for Business.

   

4. Sur la page Paramètres, saisissez l'URL de redirection dans le champ URI de redirection OAuth valides, puis cliquez sur Enregistrer.

5. Revenez à la console Google Cloud. Dans la section Détails de la source de données, cliquez sur Autoriser. Vous allez être redirigé vers une page d'authentification Facebook.

   

6. Sélectionnez l'application de développeur Facebook pour autoriser le compte qui se connecte au service de transfert de données BigQuery.

7. Une fois l'opération terminée, cliquez sur OK pour revenir à la console Google Cloud. Le jeton d'accès de longue durée est désormais renseigné dans la configuration de transfert.

Vous pouvez également générer un jeton d'accès utilisateur de longue durée à l'aide de l'API Graph. Les autorisations ads_management, ads_read et business_management sont requises pour un jeton valide pour le transfert.

Les jetons d'accès utilisateur de longue durée expirent au bout de 60 jours.

Prérequis pour BigQuery

• Vérifiez que vous avez effectué toutes les actions requises pour activer le service de transfert de données BigQuery.
• Créez un ensemble de données BigQuery pour stocker vos données.
• Si vous avez l'intention de configurer des notifications d'exécution de transfert pour Pub/Sub, assurez-vous de disposer de l'autorisation Identity and Access Management (IAM) pubsub.topics.setIamPolicy. Si vous ne configurez que des notifications par e-mail, les autorisations Pub/Sub ne sont pas nécessaires. Pour plus d'informations, consultez la page Notifications d'exécution du service de transfert de données BigQuery.

Rôles BigQuery requis

Pour obtenir les autorisations nécessaires pour créer un transfert, demandez à votre administrateur de vous accorder le rôle IAM Administrateur BigQuery (roles/bigquery.admin). Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Ce rôle prédéfini contient les autorisations requises pour créer un transfert. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Créer un transfert de données Facebook Ads

Sélectionnez l'une des options suivantes :

bq mk \
    --transfer_config \
    --project_id=PROJECT_ID \
    --data_source=DATA_SOURCE \
    --display_name=DISPLAY_NAME \
    --target_dataset=DATASET \
    --params='PARAMETERS'

    bq mk 

        --transfer_config 

        --target_dataset=mydataset 

        --data_source=facebook_ads 

        --display_name='My Transfer' 

        --params='{"connector.authentication.oauth.clientId": "1650000000",
            "connector.authentication.oauth.clientSecret":"TBA99550",
            "connector.authentication.oauth.refreshToken":"abcdef"}'
  

Résoudre les problèmes liés à la configuration d'un transfert

Si vous rencontrez des problèmes lors de la configuration d'un transfert d'annonces Facebook, essayez les étapes de dépannage suivantes :

• Vérifiez que le jeton d'accès de longue durée n'a pas expiré. Les jetons d'accès utilisateur de longue durée expirent au bout de 60 jours. Si votre jeton d'accès de longue durée a expiré, accédez aux détails de votre transfert, puis cliquez sur Modifier pour modifier la configuration de votre transfert. Sur la page de modification du transfert, suivez la même procédure que dans la section Conditions préalables à l'utilisation des annonces Facebook pour en générer un nouveau.
• Vérifiez que le jeton d'accès de longue durée est généré avec les autorisations requises : ads_management, ads_read et business_management. Si ce n'est pas le cas, suivez les étapes de la section Conditions préalables à l'utilisation des annonces Facebook pour générer un nouveau jeton d'accès de longue durée.
• Consultez l'onglet Actions requises du tableau de bord de l'application Facebook pour rechercher tous les éléments nécessitant attention.

Vous pouvez rencontrer les messages d'erreur suivants liés aux erreurs de limite de débit de l'API Meta :

Erreur : Please reduce the amount of data you're asking for, then retry your request.

Erreur : There have been too many calls from this ad-account. Wait a bit and try again.

Solution : vérifiez qu'il n'existe pas de workflows parallèles utilisant les mêmes applications ou identifiants. Si ces erreurs persistent, essayez d'améliorer le niveau de votre application pour réduire la limitation du débit.

Messages courants concernant les métriques de surveillance

Vous pouvez également consulter les métriques de surveillance du service de transfert de données BigQuery pour déterminer la cause d'un échec de transfert. Le tableau suivant regroupe certaines messages ERROR_CODE courants pour les transferts d'annonces Facebook.

Tarification

Le transfert des données Facebook Ads vers BigQuery est gratuit tant que cette fonctionnalité est en version bêta.

Étapes suivantes

• Découvrez comment utiliser le service de transfert de données BigQuery.
• Découvrez comment utiliser les transferts, par exemple comment afficher les configurations et l'historique d'exécution.
• Découvrez comment charger des données avec des opérations multicloud.