Introduction au flux XML Awin
Le flux XML Awin est le format de syndication de produits utilisé par la plateforme Awin pour distribuer les données de votre catalogue aux affiliés du réseau. Awin est l'une des plus grandes plateformes de marketing d'affiliation en Europe, reliant marchands et affiliés pour générer des ventes à la commission. Un flux XML bien structuré est essentiel pour que vos produits apparaissent correctement dans les outils des affiliés, les comparateurs de prix partenaires et les réseaux de contenu.
Le format XML Awin permet de transmettre des informations détaillées sur chaque produit : prix, description, images, stock, conditions de livraison et bien d'autres métadonnées. Une configuration précise du flux améliore la qualité des listes de produits, augmente les clics des affiliés et réduit les taux de rejet lors de l'approbation des campagnes.
Structure et champs essentiels du flux Awin
Le flux XML Awin s'organise autour de champs spécifiques qui décrivent chaque produit. Voici les champs critiques pour une distribution efficace.
Identifiants et informations de base
| Champ | Description | Importance |
|---|---|---|
| pid | Identifiant unique du produit dans votre système | Obligatoire. Permet à Awin d'associer les clics et commandes à votre produit |
| name | Nom ou titre du produit | Obligatoire. Doit être clair et contenir les mots-clés principaux |
| brand | Marque du produit | Recommandé. Les affiliés filtrent souvent par marque |
| ptype | Type de produit (simple, variable, etc.) | Recommandé pour les flux complexes avec variantes |
| parentpid | Identifiant du produit parent (pour les variantes) | Utilisé si le produit est une variante d'un produit parent |
Le champ pid doit être stable et unique pour chaque produit. Si vous changez ce numéro, Awin perd la trace historique des ventes et des clics associés. Utilisez votre SKU interne ou un code produit permanent.
Le champ name doit contenir le nom commercial du produit, pas un code interne. Les affiliés et les clients voient ce nom dans les résultats de recherche. Incluez les caractéristiques principales (couleur, taille, capacité) si elles sont pertinentes, mais restez concis : moins de 150 caractères en général.
Tarification et disponibilité
| Champ | Description | Impact |
|---|---|---|
| price | Prix de vente public | Obligatoire. Doit être à jour et correspondre à votre site |
| currency | Code devise (EUR, GBP, etc.) | Obligatoire. Spécifiez le format de la monnaie |
| instock | Booléen : produit en stock (true/false) | Critique. Les affiliés ne promeuvent que les produits disponibles |
| stockquant | Quantité disponible en stock | Recommandé. Aide à gérer les campagnes limitées |
| deltime | Délai de livraison en jours | Important pour la confiance des clients |
| delcost | Coût de livraison | Influence la décision d'achat |
| delivery_restrictions | Restrictions géographiques ou autres | Critique pour les affiliés internationaux |
Le champ price doit être mis à jour régulièrement. Un prix obsolète entraîne des abandons de panier et des retours. Si vous proposez des prix dynamiques ou des réductions, incluez le prix réduit dans ce champ et utilisez saving pour indiquer l'économie réalisée.
Le champ instock est binaire : true signifie que le produit peut être commandé immédiatement. Si vous mettez false, le produit n'apparaîtra pas dans les campagnes actives des affiliés. Utilisez preorder pour les produits en pré-commande.
Le champ deltime doit être réaliste. Un délai inexact génère des plaintes clients et des retours, ce qui pénalise votre réputation auprès d'Awin.
Images et présentation visuelle
| Champ | Description | Utilisation |
|---|---|---|
| imgurl | URL de l'image principale du produit | Obligatoire. Doit être accessible et de bonne qualité |
| thumburl | Petite version de l'image (vignette) | Optionnel. Utilisé dans les listes compactes |
| large_image | Image en haute résolution | Recommandé pour les affiliés premium |
| alternate_image | Image alternative 1 | Augmente l'attrait visuel |
| alternate_image_two | Image alternative 2 | Idem |
| alternate_image_three | Image alternative 3 | Idem |
| alternate_image_four | Image alternative 4 | Idem |
Les images doivent être en JPEG ou PNG, accessibles via HTTPS et de taille raisonnable (moins de 5 Mo). Une image floue ou manquante réduit le taux de clics de 30 à 40 %. Utilisez au moins trois images pour les produits complexes (vêtements, électronique, meubles).
Description et contenu textuel
| Champ | Description | Recommandation |
|---|---|---|
| desc | Description longue du produit | Doit contenir les caractéristiques principales et les bénéfices |
| promotext | Texte promotionnel ou offre spéciale | Utilisé pour les campagnes limitées |
| keywords | Mots-clés pertinents (séparés par des virgules) | Améliore la recherche et le filtrage |
| spec | Spécifications techniques détaillées | Critiques pour l'électronique et les articles techniques |
Le champ desc doit contenir 150 à 500 caractères. Commencez par le bénéfice principal, puis énumérez les caractéristiques techniques. Évitez le langage marketing excessif ; les affiliés et les clients préfèrent les informations factuelles.
Le champ spec peut être structuré comme des paires clé/valeur (exemple : "Processeur: Intel i7, RAM: 16 Go, Stockage: 512 Go SSD"). Cela permet aux affiliés et aux comparateurs de filtrer par spécification.
Identifiants de produit et conformité
| Champ | Description | Quand l'utiliser |
|---|---|---|
| ean | Code-barres EAN 13 | Pour tous les produits commercialisés en Europe |
| upc | Code universel de produit (États-Unis) | Pour les produits vendus aux États-Unis |
| mpn | Numéro de pièce du fabricant | Pour l'électronique et les pièces détachées |
| isbn | Numéro ISBN | Pour les livres |
| modelno | Numéro de modèle | Pour l'électronique et les appareils |
These identifiers improve product matching and reduce duplicate listings. Awin uses them to consolidate product data across multiple merchants and to verify product authenticity.
Champs optionnels pour l'optimisation avancée
Au-delà des champs essentiels, plusieurs champs optionnels améliorent la performance du flux.
Attributs de produit
Les champs colour, size, material, pattern et suitable_for permettent une segmentation plus fine. Si votre catalogue contient des variantes (un t-shirt en rouge, bleu et vert), utilisez parentpid pour lier les variantes au produit parent, et remplissez colour pour chaque variante. Cela aide les affiliés à créer des campagnes ciblées et améliore la pertinence des résultats de recherche.
Validité et conditions
| Champ | Utilisation |
|---|---|
| validfrom | Date de début de validité de l'offre (YYYY-MM-DD) |
| validto | Date de fin de validité de l'offre (YYYY-MM-DD) |
| condition | État du produit (new, refurbished, used) |
| warranty | Garantie fournie avec le produit |
Les champs validfrom et validto sont essentiels pour les offres temporaires. Awin supprime automatiquement les produits expirés des campagnes actives.
Le champ condition est critique pour les produits d'occasion ou reconditionnés. Un produit marqué comme "refurbished" sans le spécifier génère des retours et des plaintes.
Éléments de confiance et évaluation
| Champ | Impact |
|---|---|
| average_rating | Note moyenne (0 à 5 étoiles) |
| rating | Nombre d'avis |
| reviews | Avis détaillés ou lien vers les avis |
Les produits avec des notes élevées et un nombre d'avis significatif convertissent mieux. Si vous avez accès à des données d'avis, incluez-les.
Champs personnalisés
Awin propose huit champs personnalisés : custom1 à custom8. Utilisez-les pour des données propres à votre secteur : marges bénéficiaires, codes promotionnels, niveaux de stock critiques, ou catégories internes. Documentez l'utilisation de ces champs auprès de vos affiliés.
Configuration pratique du flux Awin
Génération et mise à jour
Votre flux XML doit être généré quotidiennement ou à chaque modification de produit. Utilisez votre système de gestion de catalogue (CMS, ERP ou plateforme e-commerce) pour exporter les données au format XML. Validez le XML avec un outil en ligne (xmllint ou un validateur W3C) avant de le soumettre à Awin.
L'URL du flux doit être stable et accessible sans authentification. Awin télécharge le flux automatiquement selon un calendrier défini. Si le flux est indisponible pendant plus de 48 heures, Awin utilise la dernière version valide, ce qui entraîne une désynchronisation.
Mapping des colonnes
Si vous utilisez un fichier CSV avant de le convertir en XML, mappez chaque colonne CSV à un champ Awin correspondant. Par exemple :
- Colonne "Product ID" → pid
- Colonne "Product Title" → name
- Colonne "Product Price (EUR)" → price
- Colonne "Product Description" → desc
- Colonne "Product Image URL" → imgurl
- Colonne "Stock Status" → instock
Ce mapping doit être documenté et testé avec un sous-ensemble de produits avant de l'appliquer au flux complet.
Validation et contrôle de qualité
Avant de soumettre votre flux à Awin, vérifiez les points suivants :
- Complétude : tous les champs obligatoires sont remplis pour chaque produit.
- Cohérence : les prix correspondent à votre site web, les images sont accessibles, les délais de livraison sont réalistes.
- Unicité : aucun doublon (même pid).
- Encodage : le fichier XML utilise UTF-8.
- Syntaxe : le XML est valide (pas de caractères non échappés, balises fermées correctement).
Awin fournit un rapport de validation qui identifie les erreurs et les avertissements. Corrigez les erreurs critiques (champs manquants, valeurs invalides) avant de publier le flux.
Optimisation pour la performance des affiliés
Amélioration des taux de clic
Les affiliés cliquent davantage sur les produits avec :
- Des images de haute qualité et multiples.
- Des prix compétitifs et à jour.
- Des descriptions claires et convaincantes.
- Un stock disponible et un délai de livraison court.
- Des notes et avis visibles.
Mettez à jour ces éléments régulièrement. Un produit avec un prix obsolète entraîne des clics non convertis et pénalise votre classement auprès des affiliés.
Gestion des variantes et des bundles
Si vous proposez des variantes (couleur, taille, capacité), créez un produit parent avec parentpid et des produits enfants avec des pid distincts. Chaque variante doit avoir son propre prix, son propre stock et ses propres images. Cela permet aux affiliés de créer des campagnes granulaires et améliore la pertinence des résultats de recherche.
Pour les bundles ou les offres groupées, utilisez promotext pour décrire l'offre et saving pour indiquer l'économie réalisée.
Catégorisation et mots-clés
Le champ category doit être cohérent avec la taxonomie Awin. Utilisez des catégories standards (Electronics, Fashion, Home & Garden, etc.) pour que vos produits s'affichent dans les bons filtres. Si vous avez une taxonomie interne, mappez-la à la taxonomie Awin.
Le champ keywords améliore la recherche interne. Incluez les variantes orthographiques, les synonymes et les termes de recherche populaires.
Gestion des codes promotionnels et des offres
Si vous proposez des codes de réduction ou des offres spéciales, utilisez promotext pour les décrire et validfrom / validto pour délimiter la période. Cela permet aux affiliés de promouvoir vos offres au bon moment.
Dépannage et maintenance
Problèmes courants
Les produits n'apparaissent pas dans les campagnes Awin
Vérifiez que :
- instock est défini à true.
- price est supérieur à zéro.
- Le flux a été téléchargé avec succès (consultez le journal de synchronisation dans votre compte Awin).
- validto n'a pas expiré.
Les images ne s'affichent pas
Vérifiez que :
- Les URLs sont complètes et commencent par https://.
- Les images sont accessibles sans authentification.
- Le format est JPEG ou PNG.
- La taille du fichier est raisonnable (moins de 5 Mo).
Les prix ou le stock sont incorrects
Vérifiez que :
- Le flux est généré à partir de votre base de données en temps réel.
- La fréquence de mise à jour est suffisante (quotidienne au minimum).
- Les conversions de devise sont correctes si vous vendez dans plusieurs pays.
Monitoring et alertes
Configurer des alertes pour :
- Les erreurs de synchronisation du flux.
- Les variations importantes de prix ou de stock.
- Les produits avec un taux de clics anormalement bas.
Awin fournit des rapports de performance par produit. Utilisez-les pour identifier les produits mal optimisés et les améliorer.
Résumé et bonnes pratiques
Le flux XML Awin est votre principal canal de communication avec la plateforme d'affiliation. Un flux bien structuré et régulièrement mis à jour augmente la visibilité de vos produits, améliore les taux de conversion et renforce votre présence auprès des affiliés.
Les points clés à retenir :
- Remplissez tous les champs obligatoires (pid, name, price, currency, instock, imgurl).
- Maintenez les données à jour : prix, stock, images, délais de livraison.
- Utilisez des images de haute qualité et multiples.
- Catégorisez correctement vos produits et utilisez des mots-clés pertinents.
- Validez votre flux régulièrement et corrigez les erreurs rapidement.
- Documentez les champs personnalisés et communiquez avec vos affiliés sur les éléments importants.
- Analysez les rapports de performance pour identifier les produits à optimiser.
Une maintenance régulière du flux garantit que vos produits restent compétitifs et visibles dans le réseau Awin, maximisant ainsi votre retour sur investissement en marketing d'affiliation.