Charger des données Facebook Ads dans BigQuery

Vous pouvez charger des données depuis Facebook Ads vers BigQuery à l'aide du connecteur du service de transfert de données BigQuery pour Facebook Ads. Le service de transfert de données BigQuery vous permet de planifier des jobs de transfert récurrents qui ajoutent vos dernières données Facebook Ads à BigQuery.

Rapports acceptés

Le service de transfert de données BigQuery pour Facebook Ads permet de transférer les rapports Facebook Ads suivants :

• Ads
• AdInsights
• AdInsightsActions

Pour en savoir plus sur la transformation des rapports Facebook Ads en tables et vues BigQuery, consultez Transformation des données Facebook Ads.

Limites

Les transferts de données Facebook Ads sont soumis aux limitations suivantes :

• L'intervalle minimum entre les transferts récurrents des données 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 utilisateur 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 utilisateur de longue durée.

• Si votre association de réseau et votre instance de machine virtuelle (VM) configurées se trouvent dans des régions différentes, des transferts de données interrégionaux peuvent avoir lieu lorsque vous transférez des données depuis Facebook Ads.

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 Trusted 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 Trusted 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 Trusted Cloud . Le jeton d'accès utilisateur de longue durée est désormais renseigné dans la configuration de transfert.

Les jetons d'accès utilisateur de longue durée expirent au bout de 60 jours. Pour savoir comment obtenir un jeton d'accès utilisateur de longue durée, consultez Limites.

Alternatives aux jetons d'actualisation

Vous pouvez également fournir un jeton d'actualisation lorsque vous créez un transfert de données si vous en avez obtenu un à l'aide de l'une des méthodes suivantes :

• Générez 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 de données.
• Générez un jeton utilisateur système. Un jeton d'utilisateur système vous permet d'ajouter manuellement des composants, tels que des comptes publicitaires, à inclure dans le transfert de données. Si un jeton d'utilisateur système a expiré, vous devez mettre à jour manuellement la configuration du transfert avec de nouveaux identifiants. Vous pouvez également créer un jeton qui n'expire pas lorsque vous créez un jeton d'utilisateur système. Pour en savoir plus, consultez Jetons d'accès acceptés.

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 page Gérer l'accès aux projets, aux dossiers et aux organisations.

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 de données Facebook Ads, essayez les étapes de dépannage suivantes :

• Vérifiez si votre jeton d'accès utilisateur a expiré à l'aide du débogueur de jetons d'accès Facebook. Les jetons d'accès utilisateur de longue durée expirent au bout de 60 jours. Si votre jeton d'accès utilisateur 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 utilisateur 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 utilisateur 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 : 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 de passer à l'accès avancé pour obtenir un quota de limitation du débit plus important. Pour en savoir plus, consultez Limites de débit de l'API Marketing.

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 de données. Le tableau suivant regroupe certains messages ERROR_CODE courants pour les transferts de données Facebook Ads.

Tarifs

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.