Article

Codes erreurs liés aux flux produits

Quand Affilae analyse votre flux produits et n’arrive pas à le lire, l’analyse s’arrête sur un code erreur, par exemple D15. Chaque code désigne précisément ce qui a bloqué : une URL injoignable, un format mal déclaré, un encodage, une balise produit ou une correspondance de colonnes manquante.

Cette page est une table de référence. Repérez votre code dans la liste, lisez le message qui lui correspond, appliquez l’action indiquée, puis relancez l’analyse de votre flux.

Prérequis : un flux produits déjà créé dans un de vos programmes, et l’accès à sa configuration via l’action Modifier le flux. Pour créer un flux depuis zéro, voir Ajouter un flux produits.

Où voir qu’un flux est en erreur

La page des flux se trouve dans le menu de votre programme, pas dans la barre latérale générale.

Affilae
GÉRER MES PROGRAMMES
Ma Boutique
Configuration
Mes affiliés
Elément pubs
Eléments créatifs
Flux produits
Codes promo
Clics
Conversions
Paiements
Le sous-menu « Flux produits » sous « Elément pubs », dans le menu du programme.
  1. Dans la barre latérale, ouvrez Gestion des programmes, puis cliquez sur le nom de votre programme.
  2. Dépliez Elément pubs et cliquez sur Flux produits.
  3. Dans la colonne Statut, un flux en erreur porte la pastille rouge Erreur et son titre s’affiche en rouge.
  4. Ouvrez le flux avec l’action Modifier le flux. Si un code est renvoyé par l’analyse, il apparaît dans le bandeau rouge en haut du formulaire.
À noter : le tableau des flux n’affiche jamais le code, seulement la pastille Erreur. Son infobulle indique « Ce flux contient des erreurs. Veuillez vérifier le mappage des colonnes. Après correction, le statut peut mettre quelques heures à se mettre à jour. » Si vous ne retrouvez pas votre code, demandez-le au support en précisant le nom et l’URL du flux.

Les grandes familles de causes

Onze familles couvrent tous les codes. Si vous n’avez pas de code sous les yeux, commencez par la famille qui ressemble le plus à votre situation.

  • Flux non téléchargeable : D3, D4, D5, D6, D7, D8, D9, D25, D28, D29
  • Format non reconnu ou fichier illisible : D1, D2, D13, D27, D30, D31, B2
  • Encodage : D10, D11, D12
  • Spécifique CSV : D19, D20, D21, D22, C6
  • Balise produit XML : D14, D15, D16, D17, D18, B3
  • JSON : D30, D32
  • Correspondance des colonnes : A1, D23, D24, C5
  • Détection automatique du mappage : B1
  • Partenariat : A3
  • États temporaires, aucune action de votre part : A2, A4, C1, C2
  • Erreurs techniques Affilae : C3, C4, D26

Les codes erreurs, un par un

La colonne Désactive le flux indique si ce code peut entraîner la désactivation du flux lors de son analyse. Un Oui demande donc une correction rapide, sinon vos affiliés perdent l’accès au catalogue.

CODE MESSAGE QUE FAIRE DÉSACTIVE LE FLUX
A1 La balise Url n’est pas spécifiée dans le mappage de ce flux. Rouvrez le flux et associez l’attribut Landing page à la colonne qui contient l’URL de la fiche produit. Sans elle, aucun lien tracké ne peut être construit. Non
A2 État temporaire : le flux est en erreur et sera repris automatiquement. Aucune action. Attendez la prochaine analyse. Si le code revient plusieurs jours de suite, traitez le flux comme un flux en erreur classique. Non
A3 Le partenariat est désactivé ou bloqué. Ce n’est pas un problème de fichier. Ouvrez Mes affiliés et vérifiez le statut du partenariat concerné : un partenariat désactivé ou bloqué ne peut pas recevoir de flux tracké. Non
A4 L’analyse du flux est en cours. Aucune action. L’analyse n’a pas encore été faite. C’est normal juste après la création ou la modification d’un flux. Non
B1 Une erreur s’est produite lors de la détection du mapping de ce flux. La détection automatique des colonnes a échoué. Vérifiez d’abord le fichier et le format déclaré, puis relancez l’étape de correspondance, ou renseignez les attributs à la main. Non
B2 Une erreur est apparue lors de l’analyse du flux. Le fichier a été téléchargé mais n’a pas pu être analysé. Contrôlez que le contenu réel correspond bien au format déclaré, et que le fichier est complet, non tronqué. Oui
B3 Délai d’attente du CML reader lors de la lecture du flux, vérifier l’URL du flux. La lecture du XML a été trop longue. Publiez un fichier statique plutôt qu’un export généré à la demande, et allégez-le si votre catalogue est très volumineux. Oui
C1 L’analyse du flux est en cours. Aucune action, comme pour A4. Attendez la fin de l’analyse. Non
C2 Ce flux a actuellement une erreur, il sera rétabli dès que possible. Aucune action immédiate. Le flux sera réanalysé automatiquement. Si le message persiste, cherchez la cause de fond dans les autres familles. Non
C3 Une erreur s’est produite lors de l’écriture des données Mongo pour le flux. Erreur technique côté Affilae, pas de votre côté. Contactez le support avec le nom du flux et le code. Non
C4 Une erreur s’est produite lors de l’insertion de données dans Mongo pour le flux. Erreur technique côté Affilae. Contactez le support avec le nom du flux et le code. Non
C5 La langue n’est pas définie pour ce flux, vérifiez que la langue soit correctement définie. Rouvrez le flux et renseignez la Langue du flux, parmi FR, EN et ES. Non
C6 Impossible de récupérer les produits, avec la balise actuelle. Vérifier à nouveau la balise. La balise ou la colonne déclarée ne renvoie aucun produit. Comparez les noms de colonnes de votre export avec ceux enregistrés dans la correspondance, puis corrigez-les. Non
D1 Impossible d’analyser le flux, vérifier si le séparateur est défini. Renseignez le Séparateur de champ réellement utilisé dans votre CSV : virgule, point-virgule, barre verticale ou tabulation. Non
D2 Impossible de lire le flux, vérifier si le séparateur est paramétré. Même cause que D1, avec un effet plus grave. Ouvrez votre fichier dans un éditeur de texte pour identifier le séparateur exact, puis déclarez-le. Oui
D3 Impossible de récupérer les données du flux, vérifiez à nouveau l’URL du flux. Testez l’URL en navigation privée. Elle doit renvoyer le fichier sans mot de passe, sans redirection vers une page de connexion et sans filtrage par adresse IP. Non
D4 Impossible de récupérer les données du flux, vérifiez à nouveau l’URL du flux. Même vérification que D3. Ce code désactive le flux, traitez-le en priorité. Oui
D5 Impossible de récupérer les données du flux, vérifiez à nouveau l’URL du flux. Même vérification que D3. Non
D6 Délai de connexion dépassé lors de la récupération du flux avec l’URL actuelle, vérifiez à nouveau l’URL du flux. Votre serveur a mis trop de temps à répondre. Générez le fichier à l’avance, par une tâche planifiée, plutôt qu’au moment de l’appel. Non
D7 Erreur de réinitialisation de la connexion lors de la récupération du flux avec l’URL actuelle, vérifiez à nouveau l’URL du flux. La connexion a été coupée en cours de téléchargement. Faites vérifier par votre hébergeur les protections anti-robot, le pare-feu applicatif et les limites de débit. Non
D8 Impossible de récupérer les données du flux, vérifiez à nouveau l’URL du flux. Même vérification que D3. Ce code désactive le flux. Oui
D9 Le serveur a renvoyé une erreur HTTP 500, vérifiez votre serveur. Le problème est sur votre serveur, pas dans le paramétrage Affilae. Transmettez l’URL du flux à votre équipe technique ou à votre hébergeur. Non
D10 L’encodage n’a pas été défini pour ce flux produit. Pensez à vérifier la paramétrage du flux. Renseignez l’Encodage du fichier, parmi UTF-8, UTF-16 et ISO-8859-1. En cas de doute, exportez en UTF-8 et déclarez UTF-8. Oui
D11 L’encodage n’a pas été défini pour ce flux produit. Penser à vérifier la paramétrage du flux. Même correction que D10. Oui
D12 Impossible d’encoder les données de flux avec l’encodage actuel. Veuillez vérifier à nouveau l’encodage. L’encodage déclaré ne correspond pas au fichier. Signe classique : les accents s’affichent en caractères bizarres. Réexportez en UTF-8 et déclarez UTF-8. Non
D13 Le format du flux n’est pas défini pour ce flux. Vérifiez si vous nous donnez le bon format dans paramétrage de flux. Déclarez le bon format : CSV, XML ou JSON. Attention, l’extension du fichier ne fait pas foi, c’est le contenu réel qui compte. Oui
D14 L’élément XML n’a pas été trouvé dans le mappage de ce flux. Renseignez le champ XML Item, c’est-à-dire la balise qui délimite un produit, répétée autant de fois qu’il y a de produits. Oui
D15 Aucun élément n’a été récupéré avec la balise xml_items actuelle. Vérifiez si vous avez défini la balise correctement. La balise existe mais ne renvoie rien. Indiquez la balise répétée pour chaque produit, souvent item ou entry, et non la balise qui englobe tout le catalogue. La casse compte, et le préfixe éventuel aussi. Non
D16 Impossible de récupérer les données de la page d’atterrissage. Vérifiez à nouveau l’information renseignée. Dans un flux XML, la balise associée à l’attribut Landing page ne renvoie pas d’URL exploitable. Vérifiez le nom exact de la balise, et que chaque produit en contient bien une. Oui
D17 Aucun produit trouvé avec la balise xml_items utilisée. Mettez à jour le mapping de votre flux. Même correction que D15, avec désactivation du flux à la clé. Reprenez l’étape de correspondance jusqu’au bout. Oui
D18 Aucun élément n’a été récupéré avec la balise xml_items actuelle. Vérifiez si vous avez défini correctement la balise. Même correction que D15, avec désactivation du flux à la clé. Oui
D19 Impossible de récupérer les données de la page d’atterrissage, balise utilisée. Vérifiez à nouveau la balise. Dans un CSV, la colonne associée à l’attribut Landing page est vide ou mal désignée. Vérifiez le nom de la colonne, à l’orthographe près. Oui
D20 Impossible de lire le header du csv. Vérifier si le csv contient un header. Votre CSV doit commencer par une ligne d’en-têtes qui nomme les colonnes. Ajoutez-la, sans ligne vide ni commentaire au-dessus. Non
D21 Impossible d’analyser le fichier csv avec le séparateur actuel. Vérifiez si vous avez correctement défini le séparateur. Le séparateur déclaré ne découpe pas vos lignes. Vérifiez aussi que les valeurs contenant le séparateur sont bien entourées de guillemets. Oui
D22 Impossible de récupérer les noms de champs csv. Les noms de colonnes n’ont pas pu être lus. Vérifiez la ligne d’en-têtes, le séparateur et l’encodage, dans cet ordre. Oui
D23 Information sur le mapping du flux non trouvée. Aucune correspondance de colonnes n’est enregistrée, souvent parce que la configuration n’a jamais été menée jusqu’au bouton Créer. Rouvrez le flux et terminez les trois étapes. Oui
D24 Aucune page d’atterrissage trouvée via balise actuellement utilisée. Mettez à jour le mapping de votre flux. L’attribut Landing page est bien associé, mais aucune valeur n’est remontée. Vérifiez que la colonne est remplie pour tous les produits, avec une URL complète. Oui
D25 Impossible de récupérer les informations du flux; Il peut être supprimé, désactivé ou il n’existe pas. Vérifiez à nouveau l’URL du flux. Le fichier n’est plus à l’adresse déclarée. Cas fréquents : export dépublié, document partagé repassé en privé, changement d’adresse après une refonte du site. Oui
D26 Internal Server Error Erreur interne côté Affilae. Contactez le support avec le nom du flux et l’heure de l’analyse. Non
D27 Impossible d’analyser le flux XML. Le XML n’est pas valide. Passez-le dans un validateur XML : balise non fermée, caractère interdit ou fichier tronqué sont les causes les plus courantes. Non
D28 Impossible de télécharger le flux à partir de l’hôte, vérifier à nouveau l’URL du flux. Le serveur qui héberge le fichier a refusé le téléchargement. Vérifiez le nom de domaine, le certificat et les éventuelles restrictions d’accès. Oui
D29 Impossible de télécharger le flux à partir de Lengow. Vérifier l’état de votre flux sur Lengow. Votre flux est hébergé chez Lengow. Connectez-vous à votre compte Lengow et vérifiez que le flux est bien actif et publié. Oui
D30 Impossible de lire le contenu du json, vérifier si le contenu json est correct. Le JSON n’est pas valide. Passez-le dans un validateur JSON avant de relancer l’analyse. Oui
D31 Votre flux est en erreur, veuillez vérifier les correspondance de votre mapping ou l’encoding. Code générique. Reprenez dans l’ordre : l’encodage déclaré, puis la correspondance de chaque attribut avec les colonnes réelles de votre fichier. Oui
D32 L’élément JSON n’a pas été trouvé dans le mappage de ce flux. Renseignez le champ JSON Item, c’est-à-dire la clé qui contient la liste des produits dans votre fichier. Oui

Trois codes réservés aux flux de recherche produits

Trois codes supplémentaires existent, liés à des cas plus récents. Leur message exact n’est pas publié, mais la cause et l’action le sont.

  • A5 : une analyse identique était déjà en cours, celle-ci a été ignorée. État temporaire, aucune action de votre part.
  • D33 et D34 : l’identifiant produit est absent ou invalide sur un ou plusieurs produits. Vérifiez que l’attribut Id du produit est bien associé, et que chaque produit de votre fichier en porte un, unique et non vide.

Ce qui se passe si vous laissez un flux en erreur

  • Tant que le flux est en erreur, l’interrupteur d’activation disparaît de la ligne du tableau. Vous ne pouvez pas le réactiver à la main, il faut corriger la cause.
  • Un triangle d’alerte s’affiche à côté de Flux produits dans le menu du programme, ce qui vous évite de surveiller la page.
  • Le flux n’est plus présenté sur la fiche publique de votre programme dans la Marketplace : seuls les flux sans erreur y sont comptés.
  • Affilae vous alerte par e-mail lorsqu’un flux reste en erreur, puis vous envoie un avertissement avant sa suppression.
  • Un flux qui reste en erreur pendant plusieurs semaines finit par être supprimé automatiquement. Il faut alors le recréer entièrement.
Attention : après correction, le statut peut mettre quelques heures à repasser en Actif. C’est normal : l’analyse est relancée périodiquement, pas à la seconde. Ne recréez pas un second flux en pensant que la correction n’a pas fonctionné, vous obtiendriez un doublon.

Éviter les erreurs les plus fréquentes

Astuce : avant toute chose, ouvrez l’URL de votre flux dans une fenêtre de navigation privée. Si le fichier ne s’affiche pas, s’il demande un mot de passe ou s’il renvoie une page HTML, Affilae ne pourra pas le lire non plus. Cette seule vérification élimine la moitié des codes de la famille « Flux non téléchargeable ».
  • Publiez un fichier statique plutôt qu’un export généré à chaque appel. C’est la meilleure protection contre D6, D7 et B3.
  • Ne changez pas l’URL d’un flux déjà en place. Une refonte de site qui déplace l’export provoque un D25 quelques heures plus tard.
  • Si votre serveur filtre les adresses IP, autorisez celle depuis laquelle Affilae télécharge les flux, 34.76.237.145. En cas de doute, faites confirmer l’adresse par le support avant de la mettre en place.
  • Exportez en UTF-8 et déclarez UTF-8. C’est le réglage qui provoque le moins d’erreurs d’encodage.
  • Après un changement de structure de votre export, rouvrez le flux et revalidez la correspondance des colonnes. Une colonne renommée suffit à faire tomber le flux en erreur.
  • Traitez en priorité les codes marqués Oui dans la colonne Désactive le flux : ce sont ceux qui coupent réellement l’accès de vos affiliés à votre catalogue.

Trois situations typiques

  • Une boutique qui vient de refondre son site. Le flux passe en D25 du jour au lendemain, parce que l’ancienne adresse d’export n’existe plus. Il suffit de mettre à jour le champ URL ou Flux avec la nouvelle adresse.
  • Un catalogue XML repris d’un flux Google Shopping. Le flux affiche D15 ou D17 parce que la balise déclarée est celle qui englobe tout le catalogue. Remplacez-la par la balise répétée pour chaque produit et l’analyse repart.
  • Un export CSV ouvert puis réenregistré dans un tableur. Le séparateur a changé, ou les accents sont cassés : selon le cas, le flux tombe en D21 ou en D12. Réexportez depuis votre outil de gestion, sans passer par le tableur.

Articles liés

Questions
fréquentes

Voir plus de questions reponses

Le tableau des flux n’affiche pas le code, seulement la pastille Erreur. Ouvrez le flux avec l’action Modifier le flux : si l’analyse renvoie un code, il apparaît dans le bandeau rouge en haut du formulaire. Si vous ne voyez aucun code, demandez-le au support en précisant le nom et l’URL du flux.

Suivez cet ordre, il couvre la grande majorité des cas. 1. Ouvrez l’URL du flux en navigation privée : le fichier doit s’afficher sans mot de passe. 2. Vérifiez le format déclaré, CSV, XML ou JSON, face au contenu réel. 3. Vérifiez l’encodage, et le séparateur si c’est un CSV. 4. Reprenez la correspondance des colonnes, en particulier l’attribut Landing page.

Oui. L’infobulle du statut le précise : après correction, le statut peut mettre quelques heures à se mettre à jour, car l’analyse est relancée périodiquement. Attendez la prochaine analyse avant de conclure. Surtout, ne créez pas un second flux avec la même URL, elle serait refusée et vous auriez un doublon.

Elle indique si le code peut entraîner la désactivation du flux au moment de son analyse. Un Oui signifie que vos affiliés risquent de perdre l’accès au catalogue, traitez-le en priorité. Un Non signale un problème réel mais qui ne coupe pas la diffusion dans l’immédiat.

Affilae vous alerte par e-mail, puis vous envoie un avertissement avant suppression. Au bout de plusieurs semaines d’erreur continue, le flux est supprimé automatiquement et vous devez le recréer entièrement, correspondance des colonnes comprise. Entre-temps, le flux n’est plus présenté sur la fiche publique de votre programme dans la Marketplace.

Celle qui délimite un produit et qui se répète autant de fois qu’il y a de produits, souvent item ou entry. Ce n’est pas la balise qui englobe tout le catalogue. Deux pièges classiques : la casse, qui compte, et le préfixe que certains exports ajoutent devant le nom de balise.

Votre navigateur est déjà authentifié sur votre site, Affilae non. Testez donc l’URL en navigation privée. Si votre serveur filtre les adresses IP, ou si un pare-feu applicatif bloque les téléchargements automatisés, l’appel d’Affilae est rejeté alors que le vôtre passe. Dans ce cas, autorisez l’adresse depuis laquelle Affilae télécharge les flux, et faites-la confirmer par le support.

Non. Ces trois codes correspondent à une erreur technique interne à Affilae, pas à un problème dans votre fichier. Contactez le support en indiquant le nom du flux, son URL et l’heure approximative de l’analyse. Il n’y a rien à corriger de votre côté.

Besoin d’aide ?

Restez informés des dernières tendances en affiliation marketing et ne manquez aucun de nos articles.

Contactez-nous