Introduction
Le XML personnalisé offre une flexibilité maximale pour distribuer vos données produits vers des canaux qui ne disposent pas d'intégration directe. Contrairement aux flux prédéfinis pour Amazon, Awin ou Criteo, le format XML personnalisé vous permet de définir entièrement la structure, les champs et les mappages pour correspondre aux exigences spécifiques de votre destination.
Cet article explique comment créer, valider et optimiser un flux XML personnalisé pour garantir l'approbation de vos annonces et la qualité de vos listes produits.
Structure fondamentale du XML personnalisé
Un flux XML personnalisé suit une hiérarchie définie : un élément racine contenant une collection d'éléments produits, chacun avec ses propres champs de données.
<?xml version="1.0" encoding="UTF-8"?>
<produits>
<produit>
<id>SKU-001</id>
<title>Nom du produit</title>
<description>Description détaillée</description>
<price>49.99</price>
<currency>EUR</currency>
</produit>
</produits>
La structure de base comprend :
- Déclaration XML : spécifie la version et l'encodage (UTF-8 recommandé).
- Élément racine : conteneur unique englobant tous les produits.
- Éléments produits : chaque produit occupe son propre bloc avec ses champs enfants.
- Champs de données : les éléments individuels contenant les valeurs produit.
La plateforme destinataire détermine les champs obligatoires et optionnels. Vérifiez la documentation de votre destination avant de générer le flux.
Champs essentiels et mappages
Bien que vous puissiez personnaliser les noms de champs, certains éléments de données sont critiques pour l'approbation et la qualité des annonces.
| Champ | Type | Obligatoire | Impact sur l'approbation |
|---|---|---|---|
| id | Chaîne alphanumérique | Oui | Identifie chaque produit de manière unique ; les doublons causent des rejets |
| title | Texte (max 150 caractères) | Oui | Affiche le nom du produit ; les titres vagues réduisent la visibilité |
| description | Texte structuré | Oui | Détaille les caractéristiques ; les descriptions insuffisantes entraînent des avertissements de qualité |
| price | Nombre décimal | Oui | Prix actuel ; les prix manquants bloquent l'approbation |
| currency | Code ISO (EUR, GBP, USD) | Oui | Devise du prix ; les erreurs créent des incohérences de facturation |
| availability | Énumération (in stock, out of stock) | Recommandé | Indique la disponibilité ; les annonces indisponibles sont supprimées |
| image_link | URL HTTPS | Recommandé | Image produit principale ; l'absence réduit le taux de clic |
| link | URL HTTPS | Recommandé | Lien vers la page produit ; essentiel pour le suivi des conversions |
| brand | Texte | Recommandé | Marque du produit ; aide au filtrage et à la pertinence |
| condition | Énumération (new, used, refurbished) | Recommandé | État du produit ; critique pour la conformité légale |
| google_product_category | Numéro de catégorie Google | Recommandé | Classe le produit ; améliore le ciblage des annonces |
| product_type | Texte (catégorie personnalisée) | Optionnel | Votre propre taxonomie de catégories |
| item_group_id | Chaîne alphanumérique | Optionnel | Regroupe les variantes (couleur, taille) ; facilite la gestion des stocks |
| mpn | Numéro de pièce fabricant | Optionnel | Identifie le produit au niveau du fabricant |
| gtin | Code EAN/UPC (8, 12, 13, 14 chiffres) | Optionnel | Code-barres standardisé ; utilisé pour la dédupplication |
Les champs id, title, description, price et currency sont non négociables. Leur absence ou malformation provoque des rejets au niveau du flux entier.
Configuration pratique du flux personnalisé
Étape 1 : Valider le schéma XML
Avant de soumettre votre flux, validez sa structure. Utilisez un validateur XML en ligne ou intégrez une vérification dans votre processus de génération.
Les erreurs courantes incluent :
- Balises mal fermées ou mal imbriquées.
- Caractères spéciaux non échappés (utilisez
&pour&,<pour<,"pour"). - Encodage incorrect (UTF-8 obligatoire).
- Espaces ou sauts de ligne superflus dans les valeurs numériques.
Étape 2 : Mapper vos données internes
Identifiez comment vos données internes correspondent aux champs XML. Par exemple :
- Votre base de données utilise
product_sku: mappez-le à<id>. - Vous stockez les images en local : convertissez les chemins en URLs HTTPS accessibles.
- Vos prix incluent les taxes : clarifiez si la destination attend TTC ou HT.
Étape 3 : Gérer les valeurs nulles et les variantes
Ne laissez jamais les champs obligatoires vides. Si une valeur n'existe pas :
- Utilisez une valeur par défaut cohérente (par exemple, une description générique pour les produits sans détails).
- Pour les variantes (couleur, taille), créez des éléments
<produit>distincts avec des<id>uniques et un<item_group_id>commun.
Étape 4 : Optimiser les URLs et les images
Chaque image_link et link doit être une URL HTTPS complète et accessible. Les URLs relatives causent des erreurs de validation. Les images doivent respecter les dimensions recommandées (minimum 100 x 100 pixels, idéalement 1200 x 1200 pixels pour les miniatures haute résolution).
Étape 5 : Tester le flux avant soumission
Soumettez votre flux à un environnement de test si la destination le propose. Vérifiez :
- Aucune erreur d'analyse XML.
- Tous les produits importés correctement.
- Les prix, images et liens s'affichent correctement.
- Les codes de catégorie Google correspondent aux produits appropriés.
Bonnes pratiques pour l'approbation et la qualité
Titres et descriptions
Les titres doivent être concis, informatifs et exemptes de remplissage de mots-clés. Une description doit inclure les caractéristiques principales, les dimensions, les matériaux et les bénéfices.
Exemple déficient : "Produit de haute qualité, très bon".
Exemple optimisé : "Chaise de bureau ergonomique, hauteur réglable 47-57 cm, tissu respirant, capacité 120 kg, roulettes silencieuses".
Cohérence des données
Assurez-vous que chaque produit conserve des valeurs cohérentes entre les mises à jour. Un prix qui change de 10 % d'un jour à l'autre, ou une image qui disparaît, signale un problème de qualité à la plateforme destinataire.
Fréquence de mise à jour
Définissez un calendrier de mise à jour régulier (quotidien, hebdomadaire ou mensuel selon votre secteur). Les stocks doivent être actualisés au moins quotidiennement pour les produits à rotation rapide.
Gestion des caractères spéciaux
Échappez correctement les caractères spéciaux en XML :
&devient&<devient<>devient>"devient"'devient'
Débogage et amélioration continue
Si vos produits sont rejetés ou affichent des avertissements de qualité :
- Consultez les rapports d'erreur fournis par la destination.
- Identifiez les champs problématiques (souvent title, description ou price).
- Corrigez les valeurs dans votre flux source.
- Régénérez et résoumettez le flux.
Tracez les taux d'approbation au fil du temps. Une baisse soudaine indique un changement dans vos données ou dans les exigences de la destination.
Conclusion
Le XML personnalisé vous permet de distribuer vos produits vers pratiquement n'importe quel canal. Le succès repose sur une structure valide, des champs obligatoires complets et des données de haute qualité. Validez votre flux avant soumission, testez en environnement de test si possible, et maintenez une cohérence des données lors des mises à jour. En respectant ces principes, vous garantissez l'approbation de vos annonces et optimisez la visibilité de vos produits sur votre destination cible.