Résoudre les erreurs et avertissements des catalogues de produits
Chaque catalogue de produits dispose d’un score de santé qui indique quels problèmes, le cas échéant, sont présents dans votre catalogue. Des problèmes peuvent apparaître à n’importe quelle étape : lorsque le fichier est importé ou connecté, après son traitement, ou lorsque vos partenaires essaient de consulter et de promouvoir vos produits. Utilisez ce guide pour résoudre les problèmes à chaque étape et faire passer votre catalogue dans la excellente plage.
Scores de santé du catalogue
Dans le menu de navigation de gauche, sélectionnez
[Engage] → Contenu → Produits → Catalogues de produits.Si un catalogue comporte des erreurs, des avertissements ou des lignes en double, la État de santé colonne indique combien de chacun sont présents.
Les méthodes d’import qui récupèrent automatiquement le catalogue se mettent à jour d’elles-mêmes lors du prochain événement de récupération.
Résoudre les problèmes d’import et de connexion
Avant qu’un catalogue puisse être traité, impact.com doit le recevoir correctement. Les étapes ci-dessous sont regroupées selon la méthode d’import que vous avez sélectionnée lors de la création du catalogue. Si vous ne savez pas quelle méthode est utilisée, sélectionnez le catalogue et consultez ses Méthode de téléversement les paramètres.
Importation directe
Les problèmes d’import direct sont généralement dus à un format ou à un nom de fichier incohérent, ou à un fichier dépassant la limite de 1 Go.
Format sélectionné incorrect
Le format choisi (par exemple, TXT) ne correspond pas au fichier que vous avez importé (par exemple, XML).
Réimportez et sélectionnez le format correspondant à votre fichier. Les fichiers XML utilisent le .xml comme extension, les fichiers CSV utilisent .csv, et les fichiers délimités par tabulation utilisent .txt.
Nom de fichier incohérent
Le nom du fichier que vous avez importé doit correspondre exactement au Nom du fichier à importer défini dans les paramètres de votre catalogue, y compris l’extension.
Renommez votre fichier ou mettez à jour le Nom du fichier à importer afin que les deux correspondent exactement.
Le fichier compressé ne sera pas traité
impact.com prend en charge les fichiers compressés gzip et zip standard. Un fichier compressé peut utiliser une seconde extension pour indiquer la compression, par exemple catalog.xml.gz.
Vérifiez que votre type de compression est gzip ou zip, et que le fichier utilise les extensions correctes pour son format et sa compression.
serveur FTP d’impact.com
La plupart des problèmes FTP sont liés aux paramètres de connexion ou aux identifiants.
Impossible de se connecter au serveur
Vérifiez que vous vous connectez à l’hôte products.impact.com sur le port 21.
Mettez à jour votre client FTP avec le bon hôte et le bon port, puis reconnectez-vous.
Identifiants FTP manquants
Vous avez besoin de l’identifiant et du mot de passe FTP fournis pour votre compte afin de vous connecter.
Localisez vos identifiants du système de données produit FTP dans les paramètres de configuration technique de votre compte. Si vous ne parvenez pas à les trouver ou à y accéder, contactez l’assistance.
serveur SFTP d’impact.com
Le serveur SFTP d’impact.com est une méthode d’import spécialisée réservée à certaines intégrations.
Votre plateforme de flux ne parvient pas à se connecter
Vérifiez que votre plateforme se connecte à l’hôte products.impact.com sur le port 22, et que les identifiants sont bien ceux fournis pour votre compte.
Testez les mêmes identifiants dans un client SFTP standard comme FileZilla ou Cyberduck. Si le client se connecte mais que votre plateforme de flux ne le peut toujours pas, basculez le catalogue vers Récupérer depuis l’URL en utilisant les étapes ci-dessous.
Passer d’un push à un pull
Si votre plateforme de flux (par exemple, Feedonomics) rencontre des erreurs de connexion lors de l’envoi de fichiers vers le serveur SFTP d’impact.com, vous pouvez reconfigurer impact.com pour qu’il récupère plutôt le flux directement depuis le serveur SFTP de votre plateforme (par exemple, SFTPGo). Il s’agit d’une solution recommandée, car elle supprime entièrement la dépendance d’impact.com au SFTP.
Avant de changer, demandez à votre plateforme de flux (par exemple, Feedonomics) de configurer un emplacement SFTP sortant pour votre flux et de fournir :
Hôte et port SFTP/FTP (par exemple, sftpgo.feedonomics.com:22)
Nom d’utilisateur et mot de passe
Chemin du fichier (par exemple, incoming/catalog_feed.txt.gz)
Avertissement : Mettez à jour votre catalogue existant plutôt que d’en créer un nouveau. Un nouveau catalogue utilisant le même Nom du fichier à importer renvoie une Nom de fichier déjà utilisé erreur, et votre catalogue existant alimente peut-être déjà d’autres programmes.
Dans le menu de navigation de gauche, sélectionnez
[Engage] → Contenu → Produits → Catalogues de produits.Survolez votre catalogue existant, puis sélectionnez Modifier.
Dans le Méthode de téléversement section, sélectionnez Récupérer depuis l’URL.
Sélectionnez le Format qui correspond à votre fichier de flux.
Entrez vos Nom du fichier à importer, en faisant correspondre exactement le nom du fichier, y compris son extension.
Entrez vos URL de récupération au format
sftp://[nom_utilisateur]:[mot_de_passe]@[hôte]:22/[chemin/vers/le/fichier].Encodez en URL tout caractère spécial dans vos identifiants, par exemple
@devient%40.
Sélectionnez votre Fréquence de récupération, Heure de récupération, et Fuseau horaire.
Sélectionnez Enregistrer.
Récupérer depuis l’URL
Les protocoles pris en charge pour Récupérer depuis l’URL sont http://, https://, ftp://, et sftp://. Si votre catalogue ne se charge pas, ne se met pas à jour ou ne se traite pas correctement, utilisez le tableau ci-dessous pour identifier et résoudre le problème.
L’URL n’est pas un lien de téléchargement direct
Ouvrez votre URL dans un navigateur. Si elle redirige vers une page de connexion, une page d’accueil de stockage cloud ou renvoie une erreur 404 ou 403, l’URL n’est pas un lien de téléchargement direct.
Mettez à jour l’URL avec une URL qui télécharge le fichier directement ou l’affiche en données brutes lorsqu’elle est ouverte dans un navigateur.
Nom de fichier incohérent
Le Nom du fichier à importer dans les paramètres de votre catalogue doit correspondre exactement au nom réel du fichier à l’URL, y compris l’extension (.csv, .xml, .txt, .gz).
Mettez à jour le Nom du fichier à importer pour correspondre exactement au nom de votre fichier. Un léger écart provoque une Aucun catalogue trouvé pour la requête erreur.
Format ou délimiteur incohérent
Vérifiez que le format sélectionné (CSV, TXT, XML, GMC) correspond à votre fichier. Si vous utilisez un fichier délimité, vérifiez que le délimiteur (virgule, tabulation, barre verticale) correspond à la configuration.
Corrigez le format ou le délimiteur dans les paramètres de votre catalogue. Une incohérence provoque Aucun enregistrement valide trouvé des erreurs.
FTP/SFTP : identifiants ou chemin invalides
Vérifiez que votre URL utilise le format sftp://{nom_utilisateur}:{mot_de_passe}@{hôte}/{chemin_du_fichier}. Le chemin doit pointer vers le fichier exact, et non vers un simple répertoire. Les caractères spéciaux dans les identifiants doivent être encodés en URL (par exemple, @ devient %40).
Testez vos identifiants avec un client FTP tel que FileZilla. Mettez à jour l’URL avec les identifiants corrigés et le chemin complet du fichier.
La récupération expire ou échoue à la connexion
Le pare-feu de votre serveur peut bloquer les requêtes d’impact.com.
Contactez votre fournisseur d’hébergement ou votre équipe informatique pour ajouter les plages d’adresses IP d’impact.com à la liste autorisée.
L’URL nécessite une authentification
Cette méthode d’import ne prend pas en charge l’authentification basée sur une session ou sur des cookies.
Utilisez une URL de téléchargement direct accessible publiquement, une authentification HTTP Basic intégrée dans l’URL (https://user:pass@host/path), ou FTP/SFTP avec les identifiants dans l’URL. Si votre flux nécessite une connexion via le navigateur, basculez votre catalogue vers une autre méthode d’import, comme Importation directe ou l’ serveur FTP d’impact.com.
L’URL dépasse 2 048 caractères
Les URL de stockage cloud signées peuvent dépasser la limite de 2 048 caractères et être tronquées.
Utilisez un raccourcisseur d’URL qui préserve le téléchargement direct, ou hébergez le fichier à une URL plus courte.
Catalogue bloqué en traitement ou en attente
Vérifiez si le fichier est toujours accessible à l’URL et si la taille du fichier est anormalement grande pour votre fréquence de récupération.
Vérifiez que le fichier est disponible. Si le catalogue reste en En cours de traitement ou En attente, contactez l’assistance pour demander un retraitement manuel.
Le catalogue a cessé de se mettre à jour automatiquement
Vérifiez si le fichier est toujours disponible à la même URL, et si le nom du fichier, le format ou les paramètres d’accès au serveur ont changé.
Restaurez le fichier à l’URL d’origine ou mettez à jour les paramètres de votre catalogue pour refléter la nouvelle URL ou le nouveau nom de fichier. Pour les grands catalogues (plus de 1 000 000 d’articles), envisagez de réduire la fréquence de récupération afin d’éviter les délais d’attente.
Champs ou données manquants après l’import
Vérifiez que les noms de vos champs correspondent à la spécification du format sélectionné, par exemple champs Google Merchant Center pour le format GMC. Mappez les champs personnalisés en dehors de la spécification standard vers les emplacements de champs personnalisés d’impact.com (Numérique1, Texte1, et ainsi de suite).
Téléchargez votre catalogue importé depuis impact.com et comparez-le à votre fichier source pour déterminer où les données sont perdues. Mettez à jour les noms de champs ou les mappages si nécessaire, puis réimportez.
Importation intégrée du panier d'achat
Cette méthode récupère votre catalogue depuis une plateforme e-commerce existante. La plupart des problèmes de connexion sont dus à des identifiants incorrects ou à des autorisations de lecture manquantes. Sélectionnez votre plateforme ci-dessous.
Si vous voyez une erreur telle que Code d’état HTTP non réussi lors de la connexion à Shopify : 401 ou Aucun enregistrement valide trouvé dans le fichier du catalogue, vos informations d’authentification ou vos autorisations sont généralement en cause.
Votre mot de passe doit être le jeton d’accès Admin API, qui commence par
shpat_(oushap_). Vous le trouverez dans votre administration Shopify sous Applications → Identifiants API → jeton d’accès Admin API.Si vous ne voyez pas le jeton d’accès Admin API, sélectionnez bouton Installer l’application dans Shopify pour le générer.
Vérifiez que l’autorisation
read_products(scope) est accordée à l’application. Sans elle, Shopify renvoie une erreur indiquant que l’action nécessite l’approbation du marchand pour leread_productsscope.Pour les collections, trouvez l’identifiant de la collection dans votre administration Shopify sous Produits → Collections. Sélectionnez la collection ; son identifiant apparaît à la fin de l’URL de la page.
Pour connaître les étapes complètes de configuration, consultez le guide d’intégration du catalogue produits Shopify.
Si vous voyez La connexion à WooCommerce a échoué. Veuillez réessayer, vérifiez vos identifiants et vos paramètres API.
Votre Nom d’utilisateur API est votre WooCommerce Clé clientet votre mot de passe API est votre Secret client.
Activez l’ancienne API REST dans WooCommerce : WooCommerce → Paramètres → Avancé → API héritée, puis cochez la case pour l’activer.
Pour référence, consultez la documentation de l’API REST WooCommerce.
La connexion à BigCommerce nécessite deux valeurs et les autorisations en lecture seule correctes.
Entrez vos Hachage de la boutique et Jeton d’accès dans l’interface utilisateur d’impact.com. Votre hash de boutique est l’identifiant dans le chemin API de votre boutique.
Définissez le Produits et Informations et paramètres les autorisations en lecture seule lorsque vous créez le compte API dans BigCommerce.
Pour référence, consultez le guide BigCommerce sur la création de jetons API.
Votre application privée Shoplazza a besoin d’un accès en lecture aux ressources suivantes : produit, collection, et boutique.
Pour connaître les étapes de configuration, consultez le guide Shoplazza sur la création d’applications privées.
Résoudre les erreurs et les avertissements après l’import
Une fois qu’un fichier est reçu, impact.com valide chaque enregistrement. Les erreurs empêchent le traitement des enregistrements, tandis que les avertissements signalent des données qui ont été acceptées mais qui peuvent poser problème. Utilisez les sections ci-dessous pour les interpréter et les résoudre.
Afficher les erreurs et les avertissements
Dans le État de santé colonne, sélectionnez le erreurs, des avertissements, ou des doublons lien.
Vous serez redirigé vers une page plus détaillée. Seul le premier élément d’un ensemble de doublons est représenté dans impact.com ; tous les éléments en double par rapport au premier sont ignorés.
En option, utilisez la Recherche champ et les filtres en haut de la page pour trier les problèmes.
Examinez les problèmes et apportez les modifications nécessaires, puis réimportez votre catalogue de produits.
Avertissements de formatage et de délimiteur
Problèmes de délimiteur : une virgule, une tabulation ou une ligne vide incorrecte rompt la séparation entre les champs.
Corrigez l’utilisation du délimiteur dans le fichier du catalogue afin que chaque champ soit séparé de manière cohérente, puis réimportez-le.
Les retours à la ligne dans un champ de description interrompent le traitement des enregistrements.
Les retours à la ligne ne sont pas pris en charge dans les formats de texte délimités (CSV et TSV). Supprimez les sauts de ligne des champs de texte tels que les descriptions avant l’import.
Erreurs de format Google Merchant Center
Si vous utilisez le format Google Merchant Center (GMC), la plupart des problèmes concernent la Catégorie section, les valeurs de champ prédéfinies ou la structure XML.
Lorsque vous sélectionnez erreurs sur l’ Catalogues de produits écran, vous pouvez voir Catégorie de produit Google manquante dans la Suggestions colonne. Cela signifie qu’aucun code de catégorie Google ni aucune chaîne complète de catégorie Google n’a été inclus dans votre catalogue.
Pour résoudre ce problème, consultez votre compte Google Merchant Center. Google suggère automatiquement des catégories pour les articles ; utilisez ces suggestions lors de l’import du catalogue corrigé.
Lorsque vous sélectionnez erreurs sur l’ Catalogues de produits écran, vous pouvez voir Incohérence de catégorie de produit Google dans la Invalide colonne. Cela signifie que la catégorie utilisée pour les articles de votre catalogue ne correspond pas au code de taxonomie attendu (par exemple, 7386) ou au format complet de catégorie fourni par Google, par exemple :
Animals & Pet Supplies > Pet Supplies > Bird Supplies > Bird Cage Accessories > Bird Cage Food & Water Dishes
Pour résoudre ce problème, corrigez le format dans lequel les catégories de produits Google sont répertoriées, puis réimportez votre catalogue.
Une erreur telle que Impossible d’analyser le champ : availability avec la valeur signifie qu’un champ prédéfini utilise une valeur que GMC ne reconnaît pas. Pour les catalogues GMC, les catégories et les valeurs doivent être exactes.
Utilisez
availabilitypour le champ de disponibilité.Les valeurs de disponibilité prises en charge sont
in_stock,out_of_stock,preorder, etbackorder.Vérifiez la présence de symboles spéciaux susceptibles d’affecter le formatage, comme un symbole monétaire apparaissant dans un champ de valeur.
Si vous importez un catalogue Google Merchant Center (format XML) et voyez Aucun enregistrement valide trouvé dans le fichier du catalogue. Veuillez corriger le fichier et le réimporter, la structure XML est probablement incorrecte.
Le fichier XML doit contenir rss, RDF, ou feed dans son élément de départ. Corrigez l’élément racine et réimportez.
Comprendre le seuil d’erreur de 10 %
Si plus de 10 % des enregistrements d’un fichier importé contiennent des erreurs, le fichier n’est pas traité. Lorsque cela se produit :
Votre catalogue continue d’afficher la version du dernier import réussi, donc un ancien dernier envoi réussi horodatage est attendu.
Le Voir les produits n’apparaît que si un fichier a déjà été importé avec succès pour cet ID de catalogue.
Corrigez les enregistrements signalés afin que moins de 10 % contiennent des erreurs, puis réimportez.
Rendez votre catalogue accessible aux partenaires
Un catalogue en bonne santé n’atteindra pas vos partenaires tant que vous ne l’aurez pas rendu disponible et que vous n’aurez pas satisfait aux exigences de visibilité pour les partenaires. Utilisez cette section si votre catalogue a été traité avec succès mais que les partenaires rencontrent des problèmes de visibilité, d’accès aux produits ou de liens de suivi.
Les partenaires ne peuvent pas voir le catalogue
Vérifiez les deux paramètres suivants :
Assurez-vous que le catalogue est disponible à l’utilisation :
Sélectionnez
[Engage] → Contenu → Produits → Catalogues de produits et recherchez le catalogue.Sélectionnez
[Plus] puis choisissez Rendre disponible à l'utilisation.
Vérifiez si l’accès partenaire est restreint :
Sélectionnez
[Engage] → Contenu → Produits → Catalogues de produits et recherchez le catalogue.Survolez le catalogue, puis sélectionnez Modifier.
Dans le Restreindre l'accès des partenaires section, vérifiez si Autoriser l'accès uniquement à des partenaires spécifiques est
activé.Si c’est le cas,
désactivez-le et sélectionnez Enregistrer.
Les partenaires ne peuvent pas voir ni rechercher des produits spécifiques
Pour qu’un produit soit visible dans l’interface utilisateur partenaire, il doit satisfaire à toutes les exigences suivantes :
Le prix d’origine est supérieur à 2,00 $ US.
La disponibilité du stock du produit n’est pas En rupture de stock.
Le produit possède une URL produit valide menant à une page de détails produit en ligne.
Le produit possède une URL d’image.
Le produit se trouve dans un catalogue sans règles appliquées.
Les liens de suivi des partenaires renvoient une erreur « malformed »
Si les partenaires voient « The link you clicked on is malformed » lorsqu’ils utilisent les liens de suivi de vos produits, le deep linking n’est généralement pas activé, ou le domaine de la page d’atterrissage du produit n’est pas défini comme domaine autorisé. Pour activer le deep linking, définissez vos domaines autorisés et résoudre cette erreur, voir Configurer les domaines autorisés pour le deep linking.
Mis à jour
Ce contenu vous a-t-il été utile ?