Gestionnaire des achats sur X
Guide des spécifications de produits
Le Gestionnaire des achats sur X est votre plateforme centrale contenant des outils d'intégration et de gestion des catalogues de produits pour les commerçants. Utilisez le guide ci-dessous pour structurer et télécharger correctement le fichier CSV de votre catalogue de produits dans le Gestionnaire des achats sur X. Vous pouvez à tout moment télécharger un fichier d'une taille maximum de 100 Mo dans le Gestionnaire des achats sur X.
Ces produits seront utilisés pour créer vos ensembles de produits et mettre en place votre présence commerciale, notamment sur le module Achats, X Shops, Live Shopping et Dynamic Product Ads.
Rendez-vous à la section : Spécifications requises || Spécifications facultatives
Spécifications requises
Veuillez vous assurer que tous les champs ci-dessous sont inclus dans votre fichier CSV lorsque vous le téléchargez dans le Gestionnaire des achats X.
Attribut et type pour les produits
Description
Attribut et type pour les produits
id
Type : chaîne
Description
Nombre de caractères maximum : 100
Identifiant unique de l'article. Utilisez la référence (SKU) si possible. S'il existe plusieurs instances du même identifiant, toutes les instances seront ignorées.
Exemple de valeur :
- TWSHOES-22
Attribut et type pour les produits
title
Type : chaîne
Description
Nombre de caractères maximum : 150
Nom du produit. Doit être identique au nom figurant sur la page d'accueil du produit, indiqué par les attributs link ou mobile_link.
Exemple de valeur :
- Baskets bleues X
Attribut et type pour les produits
description
Type : chaîne
Description
Nombre de caractères maximum : 5 000 (texte ouvert)
Description du produit. Ce champ ne prend pas en charge le langage HTML et doit être en texte brut.
Exemple de valeur :
- Exclusivité sur X, les baskets bleues X sont des chaussures athlétiques, élégantes et à la mode. Elles sont fabriquées avec du coton doux et respirant. Elles sont disponibles en bleu tout comme la marque de X.
Attribut et type pour les produits
availability
Type : chaîne
Description
Disponibilité actuelle de votre article. Sélectionnez l'une des valeurs possibles dans la liste ci-dessous.
Valeurs possibles :
- en stock
- disponible à la commande
- précommande
- rupture de stock
- abandonné
Attribut et type pour les produits
condition
Type : chaîne
Description
État de l'objet vendu. Sélectionnez l'une des valeurs possibles dans la liste ci-dessous.
Valeurs possibles :
- nouveau
- occasion
- reconditionné
Attribut et type pour les produits
price
Type : chaîne
Description
Prix de l'article. Formatez le prix avec un nombre, suivi du code monétaire ISO à 3 chiffres (normes ISO 4217) et ajoutez un espace entre le coût et la devise. Utilisez un point (« . ») pour les décimales.
Exemples de valeur :
- 99.99 USD
- 20.00 CAD
Attribut et type pour les produits
link
Type : chaîne
Description
URL de la page spécifique au produit où les clients peuvent acheter l'article. Si un utilisateur se trouve sur un appareil mobile et qu'un lien mobile est inclus, l'utilisateur sera dirigé vers l'URL fournie par l'attribut mobile_link.
Nous validerons l'URL selon les normes RFC. Plus précisément, elle doit inclure les attributs « https » ou « http ».
Exemple de valeur :
- https://www.X.com/twtr_blue
Attribut et type pour les produits
image_link
Type : chaîne
Description
URL de l'image principale de votre article. Si vous modifiez l'image ultérieurement, la nouvelle image doit utiliser une URL différente, sinon l'image ne sera pas mise à jour.
Spécifications pour l'image :
- Toutes les images doivent être au format JPG, GIF, WEBP ou PNG.
- Nous vous recommandons vivement d'utiliser des images de produit au format carré (1:1).
- Une image doit avoir une taille minimale de 500 x 500 pixels.
- Limite de la taille du fichier image : 5 Mo.
Exemple de valeur :
- https://t.co/demin_jeans_452.jpg
Attribut et type pour les produits
brand, gtin et/ou mpn
Type : chaîne
Description
Un (1) seul des attributs brand, gtin et/ou mpn est requis, mais nous vous recommandons de les inclure tous si possible.
Nombre de caractères maximum pour tous : 100
- « brand » fait référence au nom de la marque de l'article. Exemple de valeur : X
- « gtin » fait référence au Global Trade Item Number (identifiant universel unique du produit) de l'article. Saisissez le code UPC, EAN, JAN ou ISBN de l'article, par exemple : 012345678901.
- « mpn » désigne la référence du fabricant de l'article. Exemple de valeur : TW123456TTER
Spécifications facultatives
Tous les champs ci-dessous sont facultatifs et doivent être inclus dans votre fichier CSV avant de le télécharger dans le Gestionnaire des achats sur X, mais dans de nombreux cas, ces paramètres sont recommandés pour fournir un contexte supplémentaire à vos produits présentés sur X.
Attribut et type pour les produits
Description
Attribut et type pour les produits
mobile_link
Type : chaîne
Description
URL d'une version optimisée pour les appareils mobiles de la page spécifique du produit où les clients peuvent acheter l'article. Si un utilisateur se trouve sur un appareil mobile, celui-ci sera dirigé vers l'URL fournie par l'attribut mobile_link.
Nous validerons l'URL selon les normes RFC. Plus précisément, elle doit inclure les attributs « https » ou « http ».
Exemple de valeur :
- https://lite.twttr.com/twtr_blue
Attribut et type pour les produits
additional_image_link
Type : chaîne
Description
Pour ajouter d'autres images de votre article, utilisez additional_image_link. Les URL doivent être séparées par des virgules. Suivez les mêmes spécifications que celles mentionnées dans l'attribut image_link. Vous pouvez inclure jusqu'à 10 images supplémentaires.
Exemple de valeur :
- https://t.co/jeans_1.jpg, https://t.co/jeans_2.jpg, https://t.co/demin_jeans_3.jpg
Attribut et type pour les produits
google_product_category
Type : chaîne
Description
Catégorie de l'article, selon la taxonomie des produits de Google. Utilisez le chemin taxonomique de la catégorie ou son numéro d'identification. Sachez que dans certains cas cette catégorie sera montrée aux utilisateurs de X.
Exemples de valeur :
- Électronique > Consoles de jeux vidéo
- 1294
Attribut et type pour les produits
product_type
Type : chaîne
Description
Catégorie à laquelle appartient l'article, selon la taxonomie de produit personnalisée de votre entreprise, si vous en avez une. Vous pouvez également saisir une catégorie de produit Google (google_product_category). Les sous-catégories doivent être séparées par le symbole « > ». Le symbole > doit être entouré d'espaces. Sachez que dans certains cas cette catégorie sera montrée aux utilisateurs de X.
Exemple de valeur :
- Vêtements > Hommes > Pantalons > Denim
Attribut et type pour les produits
inventory
Type : nombre entier
Description
Doit être >= 0
La quantité de cet article dont vous disposez pour le vendre sur X. Si elle est incluse, la valeur d'inventaire d'un article doit être égale ou supérieure à 1 lorsque son champ de disponibilité est défini sur « en stock » pour que l'article soit visible pour les utilisateurs. Sinon, cette valeur doit être supérieure ou égale à 0 lorsque son champ de disponibilité est défini sur « disponible à la commande » ou sur « précommande » pour que l'article soit visible pour les utilisateurs.
Exemple de valeur :
- 10000
Attribut et type pour les produits
sale_price
Type : chaîne
Description
Doit être >= 0
Prix réduit de l'article. Formatez le prix avec un nombre, suivi du code monétaire ISO à 3 chiffres (normes ISO 4217) et ajoutez un espace entre le coût et la devise. Utilisez un point (« . ») pour les décimales. L'attribut sale_price doit être inférieur au prix.
Exemples de valeur :
- 89.99 USD
- 15.00 CAD
Attribut et type pour les produits
sale_price_effective_date
Type : un ou deux horodatages ISO-8601
Description
Période de vente de l'article, y compris la date, l'heure et le fuseau horaire de début et de fin de la vente. Si aucune date de vente n'est saisie, tous les articles dotés d'un prix de vente resteront en vente jusqu'à ce que vous supprimiez leur prix de vente.
Il est possible de fournir uniquement une date de début sans date de fin, auquel cas le prix de vente sera actif à partir de la date de début jusqu'à ce que le prix de vente soit supprimé.
Format : AAAA-MM-JJT23:59+00:00/AAAA-MM-JJT23:59+00:00
La date de début doit être antérieure à la date de fin.
Instructions détaillées :
- Saisissez la date de début au format AAAA-MM-JJ.
- Saisissez « T » après la date de début.
- Saisissez l'heure de début au format 24 heures (00:00 à 23:59), suivie du fuseau horaire UTC (-12:00 à +14:00).
- Saisissez une barre oblique « / », puis répétez le même format pour la date et l'heure de fin de vente de l'article.
L'exemple ci-dessous utilise le fuseau horaire PST (-08:00).
Exemple de valeur :
- 2020-06-28T09:00-08:00/2020-07-28T23:59-08:00
Attribut et type pour les produits
item_group_id
Type : chaîne
Description
Nombre de caractères maximum : 100
Utilisez l'attribut item_group_id pour regrouper les variantes de produits. Les variantes sont un groupe d'articles similaires qui ne diffèrent les uns des autres que par des détails du produit comme la taille, la couleur, le groupe d'âge et le sexe. Ce champ est obligatoire si votre produit comporte des variantes.
Exemple de valeur :
- twtrshoes1234_12
Attribut et type pour les produits
gender
Type : chaîne
Description
Détermine le sexe pour lequel les articles sont destinés. Sélectionnez l'une des valeurs possibles dans la liste ci-dessous.
Valeurs possibles :
- femme
- homme
- unisexe
Attribut et type pour les produits
color
Type : chaîne
Description
Nombre de caractères maximum : 100
Couleur principale du produit. Utilisez un ou plusieurs mots pour décrire la couleur. N'utilisez pas le code hexadécimal.
Exemples de valeur :
- bleu
- vert forêt
Attribut et type pour les produits
size
Type : chaîne
Description
Nombre de caractères maximum : 100
Taille de l'article écrit sous forme de mot, d'abréviation ou de chiffre.
Exemples de valeur :
- medium
- M
- 6
Attribut et type pour les produits
age_group
Type : chaîne
Description
Tranche d'âge associée à l'article. Sélectionnez l'une des valeurs possibles dans la liste ci-dessous.
Valeurs possibles :
- adultes
- tous les âges
- ados
- enfants
- tout-petits
- nourrisson
- nouveau-né
Attribut et type pour les produits
custom_label
Type : chaîne
Description
Définissez jusqu'à cinq champs personnalisés (custom_label_0, custom_label_1, custom_label_2, custom_label_3, custom_label_4) pour toute information supplémentaire sur laquelle vous souhaitez filtrer les articles lorsque vous créez des ensembles de produits basés sur des filtres.
Par exemple, vous pouvez utiliser un champ d'étiquette personnalisée pour indiquer tous les produits qui font partie d'une offre d'été, puis filtrer ces produits dans un ensemble de produits. Ces champs peuvent prendre en charge n'importe quelle valeur de chaîne.
Par exemple :
- Offre pour les fêtes de fin d'année