Dépannage de l'ingestion des publicités Meta
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.
Cette page décrit les problèmes courants liés au connecteur d'ingestion Meta Ads dans Databricks Lakeflow Connect et la manière de les résoudre.
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 :
- Confirmez que vous êtes connecté avec un compte Meta ayant accès aux comptes publicitaires à partir desquels vous souhaitez effectuer l'ingestion.
- 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). - Réautorisez la connexion pour terminer à nouveau le flux de connexion.
- Si l'erreur persiste, essayez de supprimer et de recréer la connexion.
Limite de débit dépassée
Problème :
[SAAS_CONNECTOR_SOURCE_API_ERROR] An error occurred in the Meta API call. Error code: RATE_LIMIT_EXCEEDED.
Cela se produit lorsque vous atteignez une limite de débit d'API sur votre compte Meta Ads.
Résolution :
- Attendez que vos limites d'API se Reset (généralement 1 heure).
- Réessayez le pipeline.
- Envisagez de réduire la fréquence de votre calendrier de pipeline.
- Envisagez de diviser les grands pipelines en plusieurs pipelines plus petits.
Combinaison de répartition invalide
Problème :
[SAAS_CONNECTOR_SOURCE_API_ERROR] An error occurred in the Meta API call. Error code: INVALID_PARAMETER. Invalid breakdown combination.
Cela se produit lorsque vous configurez une combinaison de répartition ou de répartition d'actions non valide pour l'objet ad_insights.
Résolution :
- Consultez la documentation de l'API Insights pour les combinaisons de ventilation valides.
- Mettez à jour la configuration de votre pipeline pour utiliser une combinaison de ventilation valide.
- Réessayez le pipeline.
Autorisations insuffisantes
Problème :
[SAAS_CONNECTOR_SOURCE_API_ERROR] An error occurred in the Meta API call. Error code: INSUFFICIENT_PERMISSIONS.
Cela se produit lorsque l'utilisateur s'authentifiant ne dispose pas des autorisations suffisantes pour accéder aux données demandées.
Résolution :
- Confirmez que l'utilisateur qui s'authentifie a accès aux comptes publicitaires que vous essayez d'ingérer.
- Vérifiez que l'utilisateur qui s'authentifie a accordé toutes les autorisations demandées lors de la connexion.
- Réautorisez la connexion si nécessaire.
Jeton d'accès expiré
Problème :
[SAAS_CONNECTOR_SOURCE_API_ERROR] An error occurred in the Meta API call. Error code: TOKEN_EXPIRED.
Cela se produit lorsque le jeton d'accès OAuth a expiré.
Résolution :
- Modifier la connexion dans Catalog Explorer.
- Réautorisez la connexion en cliquant sur Authentifier .
- Réessayez le pipeline.
Le connecteur gère automatiquement le refresh des jetons, mais dans certains cas, vous devrez peut-être réautoriser manuellement la connexion.
Compte publicitaire introuvable
Problème :
[SAAS_CONNECTOR_SOURCE_API_ERROR] An error occurred in the Meta API call. Error code: ACCOUNT_NOT_FOUND.
Cela se produit lorsque l'ID de compte publicitaire spécifié n'existe pas ou que l'utilisateur authentifié n'y a pas accès.
Résolution :
- Vérifiez que l'ID de compte publicitaire dans la configuration du pipeline est correct.
- Confirmez que l'utilisateur qui s'authentifie a accès au compte publicitaire dans Meta Business Manager.
- Vérifiez que le compte publicitaire n'a pas été supprimé ou désactivé.
Données ad_insights incomplètes
Problème :
La table ad_insights contient des données manquantes ou incomplètes pour les dates récentes.
Résolution :
C'est un comportement attendu. L'objet ad_insights utilise des fenêtres d'attribution pour tenir compte des événements de conversion retardés. Les données pour les dates récentes pourraient être incomplètes tant que la fenêtre d'attribution configurée n'est pas fermée.
Le connecteur réingère automatiquement ces données lors des exécutions ultérieures du pipeline. Aucune action n'est nécessaire. Pour configurer la fenêtre d'attribution, consultez Fenêtres d'attribution.
Objet ou champ introuvable
Problème :
Il est impossible de trouver un objet ou un champ attendu dans les données ingérées.
Résolution :
- Vérifiez que le nom de l'objet ou du champ est correct. Les noms d'objet et de champ sont sensibles à la casse.
- Vérifiez que l'utilisateur d'authentification dispose des autorisations pour accéder à l'objet ou au champ.
- Confirmez que l'objet ou le champ est pris en charge par le connecteur. Consultez la documentation du connecteur d'ingestion Meta Ads pour obtenir la liste des objets pris en charge.
- Certains champs peuvent être disponibles uniquement avec des autorisations ou des versions d'API spécifiques.
Délai d'expiration du pipeline
Problème :
Le pipeline expire lors de l'exécution.
Résolution :
- Vérifiez si vous ingérez une grande quantité de données. Pensez à diviser le pipeline en pipelines plus petits.
- Vérifiez que les limites de débit de votre API Meta n'ont pas été dépassées.
- Réessayez le pipeline. Certains délais d'expiration sont transitoires.
Si le problème persiste, ouvrez un ticket d'assistance.