Erreurs de flux catalogue Facebook : solutions et explications
Comprenez les erreurs de flux catalogue Facebook et corrigez les problèmes de prix, disponibilité, images et identifiants grâce à un validateur.
Long Nguyen
Développeur fullstack · Ingénieur IA · Chercheur
Erreurs fatales ou avertissements : lesquelles bloquent vos produits Facebook ?
L’API de Meta classe chaque erreur d’importation selon l’un de ces deux niveaux de gravité. Une erreur fatale signifie que l’article concerné n’est pas créé. Un avertissement signifie que l’article est tout de même créé et que l’erreur est donnée à titre informatif.
Le détail que beaucoup oublient : les erreurs fatales sont traitées ligne par ligne. Selon la référence des erreurs d’importation de flux produits de Meta, les produits du même fichier qui ne contiennent aucune erreur sont quand même créés, même si d’autres lignes comportent des erreurs fatales.
Cette distinction a une conséquence pratique. Si quelques produits seulement sont absents, recherchez des erreurs fatales propres à certaines lignes. Si tous les produits sont absents, le problème est presque certainement systématique : nom de colonne incorrect ou colonne associée au mauvais attribut, par exemple. Toutes les lignes deviennent alors fatales simultanément.
Un avertissement ne signifie pas que l’article est correct. Il indique seulement qu’il existe. Pour ma part, je traite tout de même les avertissements liés au prix comme des blocages, car un produit actif avec un prix mal interprété peut faire plus de dégâts dans une publicité qu’un produit absent.
Où trouver les erreurs de flux catalogue Facebook
Dans Commerce Manager, commencez par l’onglet « Problèmes » du catalogue pour les erreurs propres aux articles, puis consultez l’historique des importations de la source de données pour connaître le résultat de chaque exécution du flux. Cela suffit pour un petit catalogue. Pour un catalogue plus important, l’API fournit les lignes et les colonnes exactes.
| Ce dont vous avez besoin | Appel | Résultat |
|---|---|---|
| Sessions d’importation récentes | GET /{feed-id}/uploads |
Identifiants des sessions d’importation |
| Erreurs d’une importation | GET /{upload-id}/errors |
summary, description, severity, row_number, column_number, id, ainsi que le nombre total d’erreurs |
| Uniquement les erreurs bloquantes | error_priority=HIGH dans le même appel |
Les erreurs fatales uniquement. MEDIUM et LOW renvoient les avertissements |
| Une liste à télécharger | POST /{upload-id}/error_report |
Un fichier CSV une fois le statut passé à WRITE_FINISHED. Les rapports de plus de 30 jours affichent ERROR_REPORT_OUTDATED |
| Des corrections suggérées | GET /{error-id}/suggested_rules |
Des recommandations automatisées de règles pour cette erreur |
curl -G "https://graph.facebook.com/v26.0/UPLOAD_ID/errors" \
-d "error_priority=HIGH" \
-d "access_token=YOUR_TOKEN"
Utilisez la version de l’API Graph disponible au moment où vous exécutez l’appel. Au moment de la rédaction, l’exemple de la documentation utilisait v26.0. Les valeurs row_number et column_number vous permettent d’accéder directement à la cellule concernée au lieu de chercher le mauvais produit à l’œil.
Les erreurs de flux les plus courantes et leurs solutions
La plupart des erreurs de flux concernent un nombre limité de champs obligatoires. Les formats ci-dessous proviennent de la référence des champs de catalogue de Meta.
| Problème | Cause habituelle | Solution |
|---|---|---|
| Prix sans devise (avertissement) | Prix exporté sous la forme 9.99 ou 45$ |
Un nombre, une espace, puis un code ISO à 3 lettres : 9.99 USD. Utilisez un point comme séparateur décimal, jamais une virgule |
| Valeur de disponibilité invalide | La plateforme exporte InStock, in_stock ou un terme traduit |
Utilisez exactement in stock ou out of stock. Les articles en rupture sont valides et apparaissent comme indisponibles dans les boutiques |
| Valeur d’état invalide | Champ vide ou terme localisé comme Neu |
Utilisez new, refurbished ou used |
| Identifiant dupliqué | L’identifiant du produit parent est utilisé pour chaque variante, ou le même SKU apparaît deux fois | Chaque identifiant de contenu ne doit apparaître qu’une fois dans le catalogue et comporter au maximum 100 caractères. Utilisez le SKU de la variante, pas celui du produit parent |
| Image refusée ou non mise à jour | Format incorrect, dimensions insuffisantes ou excessives, ou fichier remplacé à la même URL | JPEG ou PNG, au moins 500 x 500 pixels et moins de 8 Mo. Une image modifiée doit utiliser une nouvelle URL |
| Lien invalide | Protocole manquant, redirection vers un domaine Facebook ou URL de préproduction | Commencez par http:// ou https:// et dirigez le lien vers la véritable page produit de votre propre domaine |
| Problèmes de description | Balises HTML, texte entièrement en majuscules ou liens dans le contenu | Texte brut uniquement, jusqu’à 9 999 caractères, sans liens ni texte en majuscules |
| Problèmes de titre | Titre de plus de 200 caractères ou identique à la description | Rendez-le précis et différent de la description. Meta recommande 65 caractères ou moins |
| Taille manquante (fatal pour Shop) | Vêtement ou chaussure exporté sans taille | La taille est conditionnelle : elle est obligatoire pour vendre dans Shop dans des catégories comme les vêtements et les chaussures. Écrivez-la avec des espaces, par exemple US 12 |
| Group Mismatch for Property (fatal) | Meta le répertorie comme une erreur fatale, mais la page de documentation le nomme sans l’expliquer | À mon sens, cela concerne des variantes regroupées avec des données d’attribut incohérentes. Vérifiez la manière dont item_group_id regroupe vos variantes |
Deux de ces problèmes passent facilement inaperçus. Les erreurs de prix et de disponibilité sont presque toujours dues au format de l’export, et non aux données de la boutique. Corrigez le modèle d’exportation une seule fois et toute cette catégorie d’erreurs disparaîtra. Les identifiants dupliqués sont différents : ils proviennent de la façon dont la boutique gère les variantes. Corriger uniquement le fichier ne fait que masquer le problème jusqu’à la prochaine synchronisation.
Corriger les erreurs de flux en masse avec les règles de flux
Lorsque vous ne pouvez pas modifier la source, Commerce Manager peut réécrire les valeurs lors de l’intégration. La documentation de dépannage des flux de Meta décrit trois types de règles.
- Les règles de mappage corrigent le nom d’un attribut, par exemple une colonne mal orthographiée que Meta interprète comme un autre champ.
- Les règles de mappage des valeurs traduisent les valeurs non reconnues :
InStockenin stock,45$en45.00 USD,Neuennew. - Les règles de casse normalisent le texte, par exemple en transformant un titre entièrement en majuscules en texte correctement capitalisé.
Avec l’API, il faut d’abord lire les erreurs d’une importation, puis appeler le point de terminaison des règles suggérées avec l’identifiant d’une erreur afin d’obtenir une règle recommandée.
Ma règle générale : corrigez la source chaque fois que vous contrôlez le générateur du flux, et utilisez les règles de flux lorsque le flux provient d’un plugin ou d’une plateforme que vous ne pouvez pas modifier. Les règles fonctionnent, mais elles constituent une logique invisible. Six mois plus tard, plus personne ne se souvient qu’une règle réécrit la disponibilité et, le jour où le format de la source change, la règle cesse discrètement de s’appliquer. Si vous gérez plusieurs flux sur différents canaux, c’est exactement le type de dérive que la gestion des flux produits est censée éliminer : un modèle de flux propre, puis une sortie adaptée à chaque canal.
Produits toujours absents ou non associés après une importation réussie
Une importation sans erreur fatale peut tout de même laisser un catalogue inutilisable dans les publicités. La cause habituelle est une incohérence d’identifiant, et non un problème de format.
Les recommandations de Meta pour les articles manquants reposent sur trois vérifications :
- Les identifiants de contenu de vos événements Pixel ou d’application correspondent aux identifiants du flux.
- Le Pixel est associé au catalogue.
- L’article existe réellement dans le flux.
Le cas classique est celui d’une boutique qui envoie l’identifiant du produit parent dans les événements Pixel, tandis que le flux utilise les SKU des variantes. Chaque événement renvoie alors vers un identifiant inexistant dans le catalogue. Choisissez une seule méthode d’identification, appliquez-la au flux et aux événements, puis vérifiez-la sur quelques pages produit réelles avant de faire confiance à une publicité dynamique.
Validez votre flux avant Meta
Détecter les erreurs avant l’importation évite un échec et l’attente de la prochaine récupération planifiée. Ce script vérifie un flux CSV par rapport aux règles de la référence des champs ci-dessus. Il ne nécessite aucune dépendance.
import csv
import re
import sys
from collections import Counter
PRICE = re.compile(r'^\d+(\.\d+)?\s[A-Z]{3}$')
AVAILABILITY = {'in stock', 'out of stock'}
CONDITION = {'new', 'refurbished', 'used'}
def check(path):
with open(path, newline='', encoding='utf-8') as f:
rows = list(csv.DictReader(f))
id_counts = Counter(r.get('id', '').strip() for r in rows)
problems = []
for line, r in enumerate(rows, start=2): # line 1 is the header
pid = r.get('id', '').strip()
if not pid or len(pid) > 100:
problems.append((line, 'id', 'missing or over 100 characters'))
elif id_counts[pid] > 1:
problems.append((line, 'id', 'duplicate id ' + pid))
if not PRICE.match(r.get('price', '').strip()):
problems.append((line, 'price', 'expected 9.99 USD format'))
if r.get('availability', '').strip() not in AVAILABILITY:
problems.append((line, 'availability', 'use in stock / out of stock'))
if r.get('condition', '').strip() not in CONDITION:
problems.append((line, 'condition', 'use new / refurbished / used'))
if not r.get('link', '').startswith(('http://', 'https://')):
problems.append((line, 'link', 'must start with http(s)://'))
if not r.get('image_link', '').startswith(('http://', 'https://')):
problems.append((line, 'image_link', 'must be a full URL'))
title = r.get('title', '').strip()
if not title or len(title) > 200:
problems.append((line, 'title', 'empty or over 200 characters'))
if title and title == r.get('description', '').strip():
problems.append((line, 'title', 'identical to description'))
for line, column, message in problems:
print('row ' + str(line) + ' | ' + column + ' | ' + message)
print(str(len(problems)) + ' problem(s) in ' + str(len(rows)) + ' rows')
return len(problems)
if __name__ == '__main__':
sys.exit(1 if check(sys.argv[1]) else 0)
Étendez l’ensemble AVAILABILITY si la version des spécifications de votre flux accepte d’autres valeurs. La vérification des images est volontairement limitée : elle confirme que l’URL est présente, mais pas que le fichier est un JPEG ou un PNG d’au moins 500 x 500 pixels. Ajoutez une requête HEAD si vous souhaitez contrôler ce point.
Quand les mêmes erreurs de flux reviennent sans cesse
Des erreurs récurrentes après la correction du fichier signifient généralement que le problème se situe en amont : modèle d’exportation qui réintroduit de mauvaises valeurs à chaque synchronisation, modèle de variantes qui génère des identifiants dupliqués ou plusieurs canaux alimentés par une feuille de calcul non entretenue. Corriger les lignes une importation après l’autre ne résoudra pas le problème.
Si vous souhaitez qu’un spécialiste identifie la cause et la corrige à la source, envoyez à Netalith une demande de devis gratuite avec l’URL de votre flux ou un échantillon des erreurs rencontrées.
FAQ
Questions fréquentes
Pourquoi mon catalogue Facebook affiche-t-il des erreurs alors que mes produits apparaissent toujours ?
Meta distingue les erreurs fatales des avertissements. Les erreurs fatales empêchent la création de l’article concerné. Les avertissements, comme un prix sans code devise, permettent tout de même de créer l’article et sont informatifs. Les erreurs fatales s’appliquent également ligne par ligne : les produits sans erreur du même fichier sont donc créés.
Que signifie « Price Without Currency » et comment corriger cette erreur ?
La valeur du prix ne contient pas de code devise. Meta attend un nombre, une espace et un code devise ISO à trois lettres, par exemple 9.99 USD, avec un point comme séparateur décimal. Corrigez le modèle d’exportation afin que tous les prix utilisent ce format.
Comment corriger les identifiants dupliqués dans un flux produits Facebook ?
Chaque identifiant de contenu ne doit apparaître qu’une seule fois dans le catalogue et comporter au maximum 100 caractères. Utilisez une valeur unique pour chaque article vendable, de préférence le SKU de la variante, plutôt que de répéter l’identifiant du produit parent pour toutes les variantes.
Puis-je corriger les erreurs de flux sans modifier le fichier source ?
En partie. Les règles de flux de Commerce Manager peuvent associer les noms d’attributs, traduire des valeurs non reconnues comme InStock en in stock et modifier la casse. Elles constituent une solution de contournement pour les flux que vous ne pouvez pas modifier ; corriger la source reste toutefois l’option la plus durable.
Combien de temps puis-je télécharger un rapport d’erreurs d’importation du flux ?
Demandez le rapport via le point de terminaison error_report de l’importation, puis téléchargez le fichier CSV lorsque son statut est WRITE_FINISHED. Les rapports de plus de 30 jours sont marqués ERROR_REPORT_OUTDATED : demandez donc un nouveau rapport à partir d’une importation récente.
Les produits en rupture de stock constituent-ils une erreur de flux ?
Non. Out of stock est une valeur de disponibilité valide. Ces articles restent dans le catalogue et apparaissent comme indisponibles dans les boutiques.