> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-uploads-and-connections.md).

# Dépannage des téléversements et connexions des catalogues de produits

Avant qu’impact.com puisse traiter un catalogue de produits, il doit recevoir le fichier du catalogue. Ce guide est organisé par méthode de chargement. Accédez donc à la section correspondant à la méthode utilisée par votre catalogue : [*Récupération depuis une URL*](#pull-from-url-recommended), [*Import depuis un panier d’achat intégré*](#integrated-shopping-cart-import-recommended), [*Serveur FTP d’impact.com*](#impact.com-ftp-server), [*Serveur SFTP d’impact.com*](#impact.com-sftp-server), ou [*Chargement direct*](#direct-upload). Si vous ne savez pas quelle méthode votre catalogue utilise, modifiez le catalogue et consultez ses [*paramètres de* méthode de chargement](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md#upload-your-product-catalog).

impact.com recommande la *récupération depuis une URL* ou l’ *import depuis un panier d’achat intégré*, car impact.com contrôle le moment où votre catalogue est récupéré et la fréquence de ses mises à jour. Si vous utilisez le serveur FTP d’impact.com, le serveur SFTP d’impact.com ou le *chargement direct*, il vous incombe de fournir régulièrement des données de catalogue à jour, de préférence chaque jour, bien qu’une mise à jour hebdomadaire convienne également.

Si impact.com a reçu votre fichier, mais que votre catalogue affiche des erreurs ou des avertissements, consultez la page [Résoudre les erreurs et les avertissements des catalogues de produits](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md).

## Récupération depuis une URL (recommandé)

Les protocoles pris en charge pour la *récupération depuis une 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 le problème et le résoudre.

| Problème                                                                   | Points à vérifier                                                                                                                                                                                                                                                                                                                                                                                           | Solution                                                                                                                                                                                                                                                                                                                                                                                |
| -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| L’URL ne renvoie pas directement vers un fichier à télécharger             | 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, il ne s’agit pas d’un lien de téléchargement direct.                                                                                                                                                                                               | Remplacez l’URL par une URL qui télécharge directement le fichier ou qui affiche les données brutes lorsque vous l’ouvrez dans un navigateur.                                                                                                                                                                                                                                           |
| Le nom du fichier ne correspond pas                                        | Le *nom du fichier à charger* dans les paramètres de votre catalogue doit correspondre exactement au nom réel du fichier à l’URL, extension comprise (`.csv`, `.xml`, `.txt`, `.gz`).                                                                                                                                                                                                                       | Modifiez le *nom du fichier à charger* pour qu’il corresponde exactement au nom de votre fichier. Une légère différence entraîne une erreur *Aucun catalogue trouvé pour la requête* .                                                                                                                                                                                                  |
| Le format ou le délimiteur ne correspond pas                               | 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 à celui configuré.                                                                                                                                                                                   | Corrigez le format ou le séparateur dans les paramètres de votre catalogue. Une incompatibilité entraîne *Aucun enregistrement valide trouvé* erreurs.                                                                                                                                                                                                                                  |
| FTP/SFTP : identifiants ou chemin non valides                              | Vérifiez que votre URL respecte le format `sftp://{username}:{password}@{host}/{file_path}`. Le chemin doit pointer vers le fichier exact, et non simplement vers un répertoire. Les caractères spéciaux dans les identifiants doivent être encodés dans l’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.                                                                                                                                                                                                                                       |
| Le transfert expire ou la connexion échoue                                 | Le pare-feu de votre serveur bloque peut-être les requêtes d’impact.com.                                                                                                                                                                                                                                                                                                                                    | Contactez votre hébergeur ou votre équipe informatique pour autoriser les plages d’adresses IP d’impact.com.                                                                                                                                                                                                                                                                            |
| L’URL nécessite une authentification                                       | Cette méthode de transfert ne prend pas en charge l’authentification par session ou par cookie.                                                                                                                                                                                                                                                                                                             | Utilisez une URL de téléchargement direct accessible publiquement, l’authentification HTTP Basic intégrée à l’URL (`https://user:pass@host/path`), ou FTP/SFTP avec les identifiants dans l’URL. Si votre flux nécessite une connexion via navigateur, choisissez une autre méthode de transfert pour votre catalogue, par exemple *Transfert direct* ou le *serveur FTP d’impact.com*. |
| L’URL dépasse 2 048 caractères                                             | Les URL signées de stockage cloud peuvent dépasser la limite de 2 048 caractères et risquent d’ê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.                                                                                                                                                                                                                                                                   |
| Le catalogue reste bloqué sur « En cours de traitement » ou « En attente » | Vérifiez si le fichier est toujours accessible à l’URL et si sa taille est exceptionnellement élevée par rapport à la fréquence de récupération.                                                                                                                                                                                                                                                            | Vérifiez que le fichier est disponible. Si le catalogue reste *En cours de traitement* ou *En attente*, [contactez l’assistance](https://app.impact.com/support/portal.ihtml) pour demander un nouveau traitement manuel.                                                                                                                                                               |
| Le catalogue ne se met plus à jour automatiquement                         | Vérifiez si le fichier est toujours disponible à la même URL et si le nom du fichier, son format ou les paramètres d’accès au serveur ont changé.                                                                                                                                                                                                                                                           | Rétablissez le fichier à son URL d’origine ou mettez à jour les paramètres de votre catalogue pour tenir compte de la nouvelle URL ou du nouveau nom de fichier. Pour les catalogues volumineux (1 000 000 d’articles ou plus), envisagez de réduire la fréquence de récupération afin d’éviter les délais d’expiration.                                                                |
| Des champs ou des données manquent après le transfert                      | Vérifiez que les noms de vos champs correspondent aux spécifications du format sélectionné, par exemple [les champs Google Merchant Center](https://support.google.com/merchants/answer/7052112) pour le format GMC. Associez les champs personnalisés qui ne figurent pas dans les spécifications standard aux emplacements de champs personnalisés d’impact.com (`Numeric1`, `Text1`, et ainsi de suite). | Téléchargez depuis impact.com le catalogue que vous avez transféré et comparez-le à votre fichier source pour repérer les pertes de données. Mettez à jour les noms ou les correspondances de champs au besoin, puis transférez à nouveau le fichier.                                                                                                                                   |

## Importation depuis une plateforme de commerce intégrée (recommandé)

Cette méthode récupère votre catalogue depuis une plateforme de commerce électronique existante. La plupart des problèmes de connexion sont dus à des identifiants incorrects ou à l’absence d’autorisations de lecture. Trouvez votre plateforme ci-dessous.

### Shopify (recommandé)

Si vous voyez une erreur telle que *Code d’état HTTP non valide lors de la connexion à Shopify : 401* ou *Aucun enregistrement valide n’a été trouvé dans le fichier du catalogue*, le problème vient généralement de vos informations d’authentification ou de vos autorisations.

* Votre mot de passe doit être le **jeton d’accès à l’API d’administration**, qui commence par `shpat_` (ou `shap_`). Vous le trouverez dans votre interface d’administration Shopify, sous **Applications** **→** **Identifiants de l’API** **→** **jeton d’accès à l’API d’administration**.
* Si le **jeton d’accès à l’API d’administration**n’apparaît pas, sélectionnez **Installer l’application** dans Shopify pour le générer.
* Vérifiez que l’autorisation (portée) `read_products` est accordée à l’application. Sans elle, Shopify renvoie une erreur indiquant que l’action nécessite l’approbation du marchand pour la portée `read_products` .
* Pour les collections, recherchez l’ID de la collection dans votre interface d’administration Shopify, sous **Produits** **→** **Collections**. Sélectionnez la collection ; son ID apparaît à la fin de l’URL de la page.

Pour connaître toutes les étapes de configuration, consultez le [guide d’intégration du catalogue de produits Shopify](https://integrations.impact.com/integration-guides/for-brands/plugin-integrations/e-commerce/integrate-with-shopify/shopify-product-catalog).

### Amazon (recommandé)

L’intégration du panier Amazon est réservée aux marques disposant d’un [abonnement vendeur](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/seller-program/amazon-seller-program/amazon-seller-program-explained.md) et ne peut pas être configurée en libre-service. En raison des restrictions de l’API Amazon, l’importation automatique du catalogue Amazon est limitée à 1 000 produits. Si votre catalogue de vendeur compte plus de 1 000 produits, utilisez plutôt une méthode de téléversement de fichier, telle que *Récupérer depuis une URL*.

Pour connaître les étapes de configuration, consultez le [guide d’intégration Amazon](https://integrations.impact.com/integration-guides/for-brands/plugin-integrations/e-commerce/integrate-with-amazon).

### BigCommerce

La connexion à BigCommerce nécessite deux valeurs et les autorisations appropriées en lecture seule.

* Saisissez votre **hachage de boutique** et votre **jeton d’accès** dans l’interface utilisateur d’impact.com. Le hachage de votre boutique est l’identifiant figurant dans le chemin d’accès à l’API de votre boutique.
* Lors de la création du compte API dans BigCommerce, définissez les autorisations **Produits** et **Informations et paramètres** en lecture seule.

Pour référence, consultez le guide de BigCommerce sur la [création de jetons d’API](https://developer.bigcommerce.com/docs/storefront-auth/tokens#create-a-token).

### WooCommerce

Si vous voyez *La connexion à WooCommerce a échoué. Veuillez réessayer*, vérifier vos identifiants et les paramètres de l’API.

* Votre **nom d’utilisateur de l’API** est la *clé consommateur*, et votre **mot de passe de l’API** est votre *secret consommateur*.
* Activez l’API REST héritée dans WooCommerce : **WooCommerce** **→** **Réglages** **→** **Avancé** **→** **API héritée**, puis cochez la case pour l’activer.

Pour en savoir plus, consultez la [documentation de l’API REST de WooCommerce](https://woocommerce.com/document/woocommerce-rest-api/).

### Shoplazza

Votre application privée Shoplazza doit disposer d’un accès en lecture aux ressources suivantes : `product`, `collection`et `shop`.

Pour connaître les étapes de configuration, consultez le guide de Shoplazza sur la [création d’applications privées](https://www.shoplazza.dev/reference/quick-construction-of-private-apps).

## Serveur FTP d’impact.com

La plupart des problèmes FTP sont liés aux paramètres de connexion ou aux identifiants.

| Problème                              | Points à vérifier                                                                                     | Solution                                                                                                                                                                                                                                                    |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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 associés à votre compte pour vous connecter. | Recherchez vos *identifiants FTP du système de données produit* dans les paramètres de configuration technique de votre compte. Si vous ne les trouvez pas ou ne pouvez pas y accéder, [contactez le support](https://app.impact.com/support/portal.ihtml). |

## Serveur SFTP d’impact.com

Le serveur SFTP d’impact.com est une méthode de téléversement spécialisée réservée à certaines intégrations.

| Problème                                                | Points à vérifier                                                                                                                                            | Solution                                                                                                                                                                                                                                                                                  |
| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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 utilisés sont ceux associés à votre compte. | Testez ces mêmes identifiants dans un client SFTP standard, tel que FileZilla ou Cyberduck. Si le client se connecte, mais que votre plateforme de flux ne parvient toujours pas à se connecter, configurez le catalogue sur *Récupérer depuis une URL* en suivant les étapes ci-dessous. |

### Passer d’un envoi à une récupération

impact.com recommande de récupérer votre flux plutôt que de l’envoyer. Lorsque impact.com récupère le flux directement depuis le serveur SFTP de votre plateforme de flux (par exemple, SFTPGo), impact.com contrôle le moment et la fréquence de mise à jour de votre catalogue, et vous ne dépendez plus du serveur SFTP d’impact.com. Le passage à la récupération résout également les erreurs de connexion que votre plateforme de flux (par exemple, Feedonomics) peut rencontrer lors de l’envoi de fichiers au serveur SFTP d’impact.com.

Avant de changer de méthode, demandez à votre plateforme de flux (par exemple, Feedonomics) de configurer un emplacement SFTP sortant pour votre flux et de vous fournir les éléments suivants :

* Hôte et port SFTP/FTP (par exemple, sftpgo.feedonomics.com:22)
* Nom d’utilisateur et mot de passe
* Chemin d’accès au fichier (par exemple, incoming/catalog\_feed.txt.gz)

{% hint style="warning" %}
**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 de téléversement* renvoie une erreur *Nom de fichier déjà utilisé* , et votre catalogue existant peut déjà alimenter d’autres programmes.
{% endhint %}

1. Dans le menu de navigation de gauche, sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage]** **→** **Contenu** **→** **Produits** **→** [**Catalogues de produits**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml).
2. Pointez sur votre catalogue existant, puis sélectionnez **Modifier**.
3. Dans la section *Méthode de téléversement* , sélectionnez **Récupérer depuis une URL**.
4. Sélectionnez le **format** correspondant à votre fichier de flux.
5. Saisissez votre **Nom du fichier de téléversement**, en respectant exactement le nom du fichier, y compris son extension.
6. Saisissez votre **URL de récupération** au format `sftp://[username]:[password]@[host]:22/[path/to/file]`.
   * Encodez les caractères spéciaux de vos identifiants dans l’URL, par exemple `@` devient `%40`.
7. Sélectionnez votre **Fréquence de récupération**, **Heure de récupération**et le **Fuseau horaire**.
8. Sélectionnez **Enregistrer**.

## Téléversement direct

Les problèmes liés au téléversement direct sont généralement dus à un format ou à un nom de fichier incorrect, ou à un fichier dépassant la limite de 1 Go.

| Problème                                | Points à vérifier                                                                                                                                                                                               | Solution                                                                                                                                                                                                                      |
| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Mauvais format sélectionné              | Le format que vous avez choisi (par exemple, TXT) ne correspond pas au fichier que vous avez téléversé (par exemple, XML).                                                                                      | Téléversez à nouveau le fichier et sélectionnez le format qui lui correspond. Les fichiers XML utilisent l’extension `.xml` les fichiers CSV utilisent `.csv` et les fichiers délimités par des tabulations utilisent `.txt`. |
| Le nom du fichier ne correspond pas     | 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 modifiez le *Nom du fichier à importer* pour qu’ils correspondent exactement.                                                                                                                       |
| Le fichier compressé ne sera pas traité | impact.com prend en charge les fichiers compressés au format gzip et au format zip standard. Un fichier compressé peut comporter une deuxième extension indiquant la compression, par exemple `catalog.xml.gz`. | Vérifiez que votre type de compression est gzip ou zip et que le fichier possède les extensions appropriées pour son format et sa compression.                                                                                |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-uploads-and-connections.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
