Codes d’erreur

Voici quels sont les codes d’erreur renvoyés par l’API :

Code d’erreur	Description
`-`	Negative-value error codes are internal Facebook errors. Check `error_subcode` for the actual failure code.
`1`	An unknown error occurred
`1`, sous-code `99`	Une erreur inconnue s’est produite. Cette erreur peut survenir quand vous configurez `level` sur `adset`, alors que la valeur devrait être `campaign`.
`4`	Application request limit reached
`10`	Application does not have permission for this action
`17`	User request limit reached
`100`	Invalid parameter
`100`, sous-code `33`	Unsupported post request. Cette erreur peut se produire si votre token d’accès n’est pas ajouté en tant qu’utilisateur·ice système avec autorisations appropriées au compte publicitaire qui possède une audience personnalisée. Vérifiez le compte publicitaire dans Business Manager et assurez-vous que tous les utilisateurs et toutes les utilisatrices système figurent en tant qu’`Admin` sous le compte publicitaire : Cliquez sur `Business Settings` Cliquez sur le compte publicitaire Sélectionnez `Add people` Recherchez les utilisateur·ices système et ajoutez-les en tant qu’admins Exécutez à nouveau l’appel d’API
`100`, sous-code `1487694`	Invalid parameter. La catégorie que vous avez sélectionnée n’est plus disponible. Plusieurs catégories de ciblage par comportement ont été abandonnées. Si vous tentez de les utiliser pour la création de publicités, votre demande échouera et renverra cette erreur. Utilisez Recherche de ciblage afin d’afficher les catégories disponibles pour un ciblage.
`100`, sous-code `1752129`	Invalid parameter. Cette combinaison de tâches n’est pas prise en charge. Pour attribuer à un·e utilisateur·ice de ce compte publicitaire des capacités valides, vous devez saisir une combinaison de tâches définies dans le mappage. Consultez API Business Manager, Rôles autorisés.
`102`	Session key invalid or no longer valid
`104`	Incorrect signature
`190`	Invalid OAuth 2.0 Access Token
`200`	Permission error
`200`, sous-code `1870034`	Conditions générales d’audience personnalisée non acceptées : vous devez accepter les conditions générales d’audience personnalisée pour pouvoir créer ou modifier une audience ou un ensemble de publicités. Consultez Conditions générales d’audience personnalisée Facebook
`200`, sous-code `1870047`	Audience Size too Low: You cannot remove users from this audience because it will result in a low audience size and may result in under-delivery or non-delivery of your ads.
`294`	Managing advertisements requires the extended permission `ads_management` and an application that is in our allow list to access the Marketing API
`2606`	Unable to display a preview of this ad
`2607`	The given currency is invalid for usage with ads.
`2615`	Invalid call to update this adaccount
`2654`	Failed to create custom audience.
`2654` sous-code `1713092`	No write permission for this ad account. Developer making this call must have permissions for the ad account to create an audience for it.
`5000`	Unknown Error Code
`1340029`	Actuellement, la suppression du contenu publicitaire dynamique n'est pas autorisée. Veuillez procéder à la suppression de l’ensemble de publicités parent
`1373054`	Aucun type de call-to-action n’était analysable. Veuillez vous référer à la documentation de l’API du call-to-action
`1404078`	Vous ne pouvez temporairement pas effectuer cette action.
`1404163`	Vous n’avez plus l’autorisation d’utiliser les produits Facebook à des fins publicitaires. Vous ne pouvez plus diffuser de publicités, ni gérer de ressources publicitaires ou créer des publicités ou comptes professionnels. En savoir plus
`1487007`	Vous ne pouvez pas modifier cette publicité, car elle fait partie d’un ensemble de publicités programmé qui est arrivé à échéance. Allez dans la rubrique Budget et calendrier de l’ensemble de publicités et reportez la date de fin à plus tard, puis réessayez d’apporter vos modifications.
`1487033`	La date de fin de votre campagne doit être dans le futur. Veuillez la modifier et réessayer.
`1487056`	Cet ensemble de publicités a été supprimé, vous ne pouvez donc modifier que son nom. Si vous voulez modifier d’autres champs, vous pouvez dupliquer cet ensemble de publicités : un nouvel ensemble de publicités sera créé avec les mêmes paramètres que vous pourrez ensuite modifier.
`1487472`	You are using {msg}, which can't be promoted in an ad. Please choose a different Page post to continue.
`1487566`	Cette campagne a été supprimée, vous ne pouvez donc modifier que son nom. Si vous voulez modifier d’autres champs, vous pouvez dupliquer cette campagne : une nouvelle campagne sera créée avec les mêmes paramètres que vous pourrez ensuite modifier.
`1487678`	L’application pour laquelle vous tentez de créer une publicité est exécutée sur un système d’exploitation autre que celui des paramètres de ciblage de cet ensemble de publicités.
`1487831`	Impossible de charger votre ensemble de produits. Il n’existe peut-être pas ou il n’est pas accessible pour des raisons de confidentialité.
`1487929`	L’objet que vous tentez de promouvoir est ambigu. Vous devez spécifier un seul objet promu.
`1487990`	Ce compte publicitaire a déjà trop de groupes publicitaires archivés. Vous devez en supprimer avant de pouvoir en archiver d’autres.
`1815199`	Le compte publicitaire n’a pas accès à ce compte Instagram. Veuillez utiliser le compte Instagram autorisé ou affectez-y d’abord le compte publicitaire.
`1815629`	Toutes les valeurs des ressources de la publicité doivent être uniques. Veuillez vérifier vos valeurs.
`1815694`	L’utilisateur·ice n’a pas l’autorisation de réaliser cette action.
`1870065`	Ne peut pas être utilisé, car il contient au moins une audience désactivée. Des audiences désactivées ont été partagées par des comptes qui ne sont plus actifs. Pour résoudre ce problème, supprimez les audiences concernées
`1870088`	Le ciblage par connexions sera bientôt obsolète. Veuillez supprimer les connexions de votre campagne pour la publier.
`1870090`	Pour créer ou modifier une audience ou un ensemble de publicités, veuillez accepter les conditions relatives à l’audience personnalisée.
`1870092`	Pour créer ou modifier une audience ou un ensemble de publicités, veuillez accepter les conditions des outils Meta Business
`1870165`	Cette audience contient des options de ciblage qui ne peuvent plus être utilisées pour cibler des personnes âgées de moins de 18 ans partout dans le monde, excepté en Thaïlande (moins de 20 ans) et en Indonésie (moins de 21 ans). Augmentez l’âge minimum de votre audience ou supprimez toutes les options de ciblage hors lieu, âge et genre.
`1870199`	L’ensemble du ciblage géographique touchera désormais les personnes qui résident ou se sont récemment trouvées dans les lieux que vous avez sélectionnés. Veuillez supprimer toutes les valeurs du champ location_types.
`1885029`	La Page sélectionnée pour votre publicité ne correspond pas à la Page associée à l’objet que vous souhaitez promouvoir, par exemple une publication de Page ou une application. Veuillez vérifier que les Pages sont bien les mêmes.
`1885088`	Cette publicité a été archivée et ne peut plus être modifiée. Seul le nom peut être modifié pour cette publicité. Si vous voulez modifier d’autres champs, vous pouvez dupliquer cette publicité. Un nouvel ensemble de publicités sera créé avec les mêmes paramètres, que vous pourrez ensuite modifier.
`1885183`	La publication du contenu publicitaire a été créée par une application en cours de développement. Elle doit être publique pour créer cette publicité.
`1885204`	Vous devez régler votre enchère sur automatique pour l’optimisation choisie. Supprimez les informations de facturation et d’enchère ou modifiez votre optimisation.
`1885272`	Le budget est trop faible.
`1885557`	Votre publicité fait la promotion d’une publication indisponible. Elle est soit supprimée soit non publiée, elle n’appartient pas à la Page de la publicité ou vous n’avez pas l’autorisation de la voir ou de la promouvoir.
`1885621`	Vous ne pouvez définir qu'un budget d'ensemble de publicités ou un budget de campagne.
`1885557`	Votre publicité fait la promotion d’une publication indisponible. Elle est soit supprimée soit non publiée, elle n’appartient pas à la Page de la publicité ou vous n’avez pas l’autorisation de la voir ou de la promouvoir.
`1885650`	Votre budget est trop faible. Ce montant minimum est nécessaire pour couvrir toutes les dépenses qui se produisent pendant la mise à jour de votre budget, qui peut prendre jusqu’à 15 minutes.
`2238055`	Vous ne pouvez pas passer « instagram_user_id » et « instagram_actor_id » ou « instagram_story_id » et « source_instagram_media_id » dans les spécifications du contenu publicitaire
`2446149`	Vous ne pouvez pas passer « instagram_user_id » et « instagram_actor_id » ou « instagram_story_id » et « source_instagram_media_id » dans les spécifications du contenu publicitaire
`2446307`	Le plafond de dépense des groupes de campagne est inférieur au minimum
`2238055`	Le budget de votre campagne doit être d’au moins {minimum_budget} pour prendre en compte tous les ensembles de publicités dans cette campagne.
`2446173`	L’étiquette de la règle de ciblage portant le nom {label} ne se réfère à aucune des étiquettes d’élément. Veuillez corriger ceci en supprimant tous les contenus publicitaires.
`2446289`	Le {post_type} que vous avez sélectionné pour votre publicité n’est pas disponible. Il a peut-être été supprimé ou vous ne possédez pas les autorisations pour le voir. Veuillez vérifier votre contenu publicitaire et réessayer.
`2446347`	La publicité d’une publication existante doit avoir le drapeau « use_existing_post » (règle par défaut dans « asset_feed_spec:target_rules ») défini sur « true ». Cette action fait partie de la requête POST envoyée au serveur et ne peut pas être effectuée via l’UI.
`2446383`	L’objectif de votre campagne doit contenir une URL de site Web externe. Sélectionnez un call-to-action et saisissez une URL de site Web dans la section Contenu publicitaire.
`2446394`	Cet ensemble de publicités comprend des options de ciblage avancé qui ne sont plus disponibles ou qui deviennent indisponibles lorsque certaines personnes sont exclues d’une audience. Vous aurez peut-être besoin de supprimer des éléments de votre ensemble de publicités ou de confirmer les modifications pour réactiver le ciblage avancé.
`2446509`	Le type de destination de la campagne publicitaire n’est pas valide
`2446580`	Impossible de spécifier les deux composants et le champ « child_attachments» quand les paramètres « interactive_components_spec » ont été fournis
`2446712`	Il n’est plus possible de créer ou de diffuser d’ensembles de publicités avec l’optimisation Visites en poins de vente. Choisissez plutôt l’optimisation Couverture ou Ventes en magasin.
`2446867`	Vous avez déjà atteint la limite de {campaigns_per_country_cap} campagnes de shopping Advantage+ pour les pays suivants : {country_names}. Si vous souhaitez créer des campagnes supplémentaires pour ces pays, utilisez une campagne de conversions standard.
`2446880`	Le numéro WhatsApp associé à votre Page Facebook ou profil Instagram a été dissocié. Vous pourrez rediffuser cette publicité en réassociant votre compte WhatsApp.
`2490085`	La dimension 191 × 100 ne sera plus disponible dans la dernière version de l’API Ads. La dimension recommandée sera 100 × 100.
`2490155`	La publication associée à votre publicité n’est pas disponible. Elle a peut-être été supprimée, ou vous ne disposez peut-être pas de l’autorisation pour l’afficher.
`2490372`	Vous devez choisir une destination de boutique pour pouvoir continuer.
`2490427`	Votre publicité a été rejetée au cours de son dernier examen et est actuellement désactivée. Pour l’activer, vous devez la modifier et créer une nouvelle publicité.
`2490468`	Votre publicité a été rejetée au cours de son dernier examen et est actuellement désactivée. Pour l’activer, vous devez la modifier et créer une nouvelle publicité.
`2708008`	Vous n’avez pas reçu l’autorisation de diffuser des publicités portant sur un enjeu social, électoral ou politique. Demandez à un utilisateur ou une utilisatrice de compte publicitaire autorisé·e de diffuser cette publicité, ou suivez le processus de validation d’identité sur https://www.facebook.com/id/
`2859015`	Vous ne pouvez temporairement pas effectuer cette action.
`3858064`	Cette campagne contient des options qui ne peuvent plus être utilisées dans des campagnes destinées à des audiences âgées de moins de 18 ans partout dans le monde, excepté en Thaïlande (moins de 20 ans) et en Indonésie (moins de 21 ans). Augmentez l’âge minimum de votre audience ou supprimez toutes les options de ciblage hormis l’âge et les lieux dont la taille est égale ou supérieure à celle des villes (sauf le code postal).
`3858082`	Ce contenu publicitaire est éligible aux améliorations standard, mais la valeur « enroll_status » n’a pas été fournie. Choisissez si vous voulez activer les améliorations standard ou non. Pour en savoir plus, consultez cette page
`3858152`	Cette publicité appartient à un ensemble de publicités qui doit être publié avec les informations relatives au bénéficiaire et au payeur. Accédez à l’ensemble de publicités pour ajouter ou examiner ces informations, puis cliquez sur « Publier ».
`3867105`	Ce contenu ne peut pas être utilisé pour votre co-publicité. Sélectionnez un autre contenu.
`3910001`	Nous rencontrons un problème avec votre compte. Veuillez réessayer ultérieurement.

Les erreurs doivent être gérées en utilisant uniquement les codes d’erreur. La chaîne Description est susceptible d’être modifiée sans préavis.

blame_field_specs

Il s’agit d’une propriété incluse dans le grand objet binaire error_data de tout appel d’API qui entraîne une erreur de validation, qui indique le ou les champs à l’origine de l’erreur de validation. Vous pouvez l’utiliser pour fournir des erreurs contextuelles, par exemple, pour afficher une erreur juste à côté du ou des champs fautifs dans l’interface utilisateur graphique d’un outil de création de publicités.

blame_field_specs est un ensemble dans lequel chaque élément est une blame_field_spec qui indique un champ unique des spécifications de l’API qui est fautif.

Une blame_field_spec en elle-même est également une grille, qui indique le nom du champ fautif et l’emplacement de ce champ au sein des spécifications globales de l’API fournies.

Exemples :

Champ unique fautif

{  
  "error":{  
    "type":"Exception",
    "message":"The budget for your Ad-Set is too low.  It must be at least $1.00 per day.",
    "code":1487901,
    "is_transient":false,
    "error_data":{  
      "blame_field_specs":[  
        ["daily_budget"]
      ]
    }
  }
}

Indique que le champ daily_budget de la spécification de l’API est fautif et, dans ce cas, était trop bas.

Plusieurs champs fautifs

"blame_field_specs":[  
  ["targeting_spec", "interested_in"], 
  ["bid_info", "impressions"]
]

Indique qu’une erreur est liée au sous-champ interested_in du champ targeting_spec des spécifications de l’API, et que cette erreur est également liée au champ impressions du champ bid_info des spécifications de l’API.