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 :

  1. Saisissez la date de début au format AAAA-MM-JJ.
  2. Saisissez « T » après la date de début.
  3. Saisissez l'heure de début au format 24 heures (00:00 à 23:59), suivie du fuseau horaire UTC (-12:00 à +14:00).
  4. 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