Aller au contenu principal
Dernière mise à jour le

Dépannage de l'ingestion des publicités Meta

info

Bêta

Cette fonctionnalité est en Bêta. Les administrateurs du Workspace peuvent contrôler l'accès à cette fonctionnalité à partir de la page Previews . Consultez Gérer les aperçus Databricks.

Lorsque l'ingestion Meta Ads dans Lakeflow Connect échoue, utilisez la classe d'erreur du connecteur pour identifier la cause et la résolution. Les conseils suivants couvrent l'authentification, les limites d'API, l'accès et les erreurs du service Meta.

Pour des conseils généraux de dépannage qui s'appliquent à tous les pipelines d'ingestion gérés, consultez Dépanner les pipelines d'ingestion gérés.

L’authentification a échoué​

Problème :

Vous recevez une erreur d'authentification lors de la création d'une connexion ou de l'exécution d'un pipeline.

Résolution :

  1. Confirmez que vous êtes connecté avec un compte Meta ayant accès aux comptes publicitaires à partir desquels vous souhaitez effectuer l'ingestion.
  2. Lorsque vous y êtes invité lors de la connexion, accordez toutes les autorisations demandées (ads_read, ads_management, business_management, pages_read_engagement, pages_show_list).
  3. Réautorisez la connexion pour terminer à nouveau le flux de connexion.

Limite de débit dépassée​

Problème :

Le pipeline échoue avec META_ADS_RATE_LIMIT_EXCEEDED.

Le connecteur réessaie automatiquement les erreurs de limitation de débit. Cette erreur apparaît lorsque ces tentatives sont épuisées.

Résolution :

  1. Attendez que vos limites Meta API reset.
  2. Réessayez le pipeline.
  3. Réduisez le nombre de tables ingérées en parallèle ou réduisez la fréquence du calendrier du pipeline.
  4. Si vous rencontrez fréquemment cette erreur, envisagez de demander un accès complet à Meta (si vous n'utilisez pas l'application OAuth gérée par Databricks).

Si vous contactez l'assistance Meta, incluez l'identifiant de trace Facebook provenant du message d'erreur.

Limite de données demandées dépassée​

Problème :

Le pipeline échoue avec META_ADS_REQUESTED_DATA_LIMIT_EXCEEDED.

Meta renvoie cette erreur lorsqu’une requête d’API est trop volumineuse ou trop complexe pour être traitée par ses serveurs. Cela peut se produire lorsqu’une requête sélectionne un grand nombre de champs ou lorsqu’un rapport d’insight associe une plage de dates étendue à des champs et des ventilations générant un résultat volumineux.

Résolution :

  1. Réessayez le pipeline.
  2. Si le problème persiste pour un rapport insight, réduisez le nombre de répartitions ou configurez une date de start plus récente.
  3. Si vous modifiez les parameter d’une table ad_insights existante, exécutez un refresh complet sur la table.

Accès non valide​

Problème :

Le pipeline échoue avec META_ADS_INVALID_ACCESS_ERROR.

Cette erreur se produit lorsque l’objet demandé n’existe pas, ne peut pas être chargé en raison d’autorisations manquantes ou ne prend pas en charge l’opération demandée.

Résolution :

  1. Vérifiez que l’ID de l’objet ou du compte publicitaire est correct.
  2. Confirmez que l’utilisateur qui s’authentifie dispose d’un accès au compte publicitaire demandé.
  3. Confirmez que l’utilisateur qui s’authentifie a accordé les autorisations requises lors de la connexion, y compris ads_read et ads_management.
  4. Réautorisez la connexion et réessayez le pipeline.

Aucun compte publicitaire accessible​

Problème :

Le pipeline échoue avec META_ADS_EMPTY_AD_ACCOUNTS_LIST.

Cette erreur se produit lorsque l'utilisateur authentifié ne peut accéder à aucun compte publicitaire.

Résolution :

  1. Dans Meta Business Manager, accordez à l’utilisateur qui s’authentifie l’accès à au moins un compte publicitaire.
  2. Réautorisez la connexion.
  3. Réessayez le pipeline.

Compte utilisateur Meta non confirmé​

Problème :

Le pipeline échoue avec META_ADS_UNCONFIRMED_USER_ERROR.

Cette erreur se produit lorsque le compte utilisateur Meta associé au jeton d'accès n'est pas confirmé.

Résolution :

  1. Effectuez les étapes de confirmation requises dans Meta, telles que la vérification par e-mail ou d'identité.
  2. Réautorisez la connexion.
  3. Réessayez le pipeline.

Service Meta indisponible​

Problème :

Le pipeline échoue avec META_ADS_SERVICE_UNAVAILABLE_ERROR.

Le connecteur réessaie automatiquement les erreurs de service transitoires reconnues. Cette erreur apparaît lorsque ces tentatives sont épuisées.

Résolution :

  1. Veuillez patienter et réessayer le pipeline plus tard.
  2. Si le problème persiste, contactez le support Meta et incluez l’identifiant de trace Facebook figurant dans le message d’erreur.

La date de start des insights est trop ancienne​

Problème :

Le pipeline échoue avec META_ADS_INSIGHTS_START_DATE_TOO_OLD.

Cette erreur se produit lorsque l'insight start_date configuré se trouve en dehors de la plage historique prise en charge.

Résolution :

Définissez start_date à une date plus récente. Si vous modifiez start_date pour une table ad_insights existante, effectuez un refresh complet de la table. Sinon, réessayez le pipeline. Consultez Start date pour connaître la plage prise en charge.

Paramètres d'insight modifiés​

Problème :

Le pipeline échoue avec META_ADS_PARAMETERS_CHANGED.

Cette erreur se produit lorsque les parameters d'une table ad_insights existante changent.

Résolution :

Exécuter un refresh complet sur la table concernée.

Autres erreurs de l’API Meta​

Problème :

Le pipeline échoue avec META_ADS_SOURCE_API_ERROR.

Cette erreur se produit lorsqu’une réponse de l’API Meta ne correspond pas à une erreur plus spécifique. Le message d’erreur inclut un identifiant de trace Facebook.

Résolution :

  1. Examinez l'erreur Meta sous-jacente dans l'event Logs du pipeline et suivez la procédure de correction dans la documentation de gestion des erreurs de l'API Graph de Meta.
  2. Si vous contactez l'assistance Meta, incluez l'identifiant de trace Facebook provenant du message d'erreur.

Ressources supplémentaires​

Sur cette page