Ce guide explique comment générer un fichier XML contenant l'intégralité du catalogue produits, essentiel pour synchroniser vos produits avec des plateformes publicitaires et de vente telles que Google Merchant Center, TikTok Shop ou Facebook Catalog.
Puisque la génération du flux se fait via une adresse web spécifique (URL), la configuration est réalisée en ajoutant des paramètres à cette adresse.
1. Construction de l'URL de Base
Pour générer le flux, vous devez accéder à une URL spécifique de votre site. L'URL de base dépend du format et de la plateforme cible.
1. Identifiez votre domaine (ex. https://votresite.com).
2. Ajoutez le chemin du flux /api/plugin/ecommerceFeeds/.
3. Choisissez le type de flux à générer :
| Plateforme | Type de Flux | Exemple d'URL de Base |
|---|---|---|
| Google Merchant / Standard | standard.xml | https://votresite.com/api/plugin/ecommerceFeeds/standard.xml |
| TikTok Shop | tiktok.xml | https://votresite.com/api/plugin/ecommerceFeeds/tiktok.xml |
> Note : Si vous accédez à cette URL sans paramètres supplémentaires, le flux complet de tous les produits actifs sera généré.
2. Configuration Avancée du Flux (Filtres et Variantes)
Vous pouvez personnaliser le contenu du flux en ajoutant des paramètres de configuration après un point d'interrogation (?) dans l'URL de base.
2.1. Inclusion des Variantes (Taille, Couleur, Marque)
Si vos produits ont des variantes (ex. tailles ou couleurs), vous devez spécifier quels attributs doivent être mappés aux champs standards de Google/TikTok (color, size, brand).
Vous devez identifier l'ID numérique de l'attribut qui représente la Taille, la Couleur, etc., dans votre système de gestion produit.
| Objectif | Paramètre | Exemple (Si l'ID 5 est la Couleur) |
|---|---|---|
| Couleur | v[c]=ID_ATTRIBUT | ?v[c]=5 |
| Taille | v[s]=ID_ATTRIBUT | ?v[s]=12 |
| Marque | v[b]=ID_ATTRIBUT | ?v[b]=8 |
Exemple d'URL avec Variantes :
Si vous souhaitez inclure les variantes Taille (ID 12) et Couleur (ID 5) :
.../tiktok.xml?v[s]=12&v[c]=5
2.2. Filtrer par Catégorie
Il est possible d'inclure ou d'exclure des produits selon les catégories, en utilisant les ID des catégories.
| Objectif | Paramètre | Exemple |
|---|---|---|
| Inclure Catégories | include_cats=ID1,ID2 | ?include_cats=1,2,5 |
| Exclure Catégories | exclude_cats=ID1,ID2 | ?exclude_cats=10,11 |
2.3. Mappage des Étiquettes Personnalisées (Custom Labels)
Les étiquettes personnalisées (customlabel0 jusqu'à customlabel4) sont utiles pour organiser les produits dans les campagnes publicitaires. Vous pouvez mapper ces étiquettes à :
- Catégories : Pour insérer la hiérarchie des catégories du produit.
- Attributs : Pour insérer la valeur d'un attribut spécifique (ID numérique).
- Texte Fixe : Pour insérer une chaîne fixe.
| Étiquette | Paramètre | Valeur Exemple | Description |
|---|---|---|---|
customlabel0 | c[0] | categories | Insère le chemin complet des catégories. |
customlabel1 | c[1] | 15 | Insère la valeur de l’Attribut avec ID 15. |
customlabel2 | c[2] | Estate2024 | Insère la chaîne fixe "Estate2024". |
3. Génération du Flux Final
Pour générer le flux, collez l'URL complète dans le navigateur (ou fournissez-la à la plateforme cible).
Exemple d'URL Complète (TikTok Shop) :
Générez le flux pour TikTok Shop, incluant les variantes Taille (ID 12) et Couleur (ID 5), et mappant customlabel0 au chemin des catégories :
https://votresite.com/api/plugin/ecommerceFeeds/tiktok.xml?v[s]=12&v[c]=5&c[0]=categories
Une fois l’URL ouverte, le système traitera les données et renverra directement le fichier XML (ou CSV, si demandé) que vous pourrez sauvegarder ou utiliser pour la synchronisation automatique.
> Important : Le processus de génération du flux peut prendre plusieurs secondes (jusqu’à 120 secondes selon le nombre de produits) afin d’éviter toute interruption.
