En tant que commerçant, vous souhaitez peut-être importer vos produits dans Pinterest en tant qu’Épingles Produit. Le format des Épingles Produit est destiné spécialement à indiquer aux utilisateurs de Pinterest qu’elles présentent des produits disponibles à l’achat. Elles contiennent un titre et une description du produit, mais aussi des informations sur son prix et sa disponibilité.
Ajoutez la source de données de votre catalogue de retail à Pinterest pour importer plusieurs produits à la fois, en tant qu’Épingles Produit. Vous pourrez ensuite les sponsoriser sur Pinterest en tant qu’annonces Shopping. Vous pouvez fournir le lien URL de votre source de données hébergée ou importer votre source de données manuellement.
Avant d’ajouter votre catalogue de retail, vous devrez :
Si vous ne remplissez pas les conditions ci-dessus,
Le fonctionnement des catalogues de retail dépend de la façon dont vous ajoutez votre source de données, à partir de laquelle nous pouvons accéder à votre catalogue de retail.
Si vous fournissez le lien URL de votre source de données hébergée, nous accéderons à votre source de données quotidiennement afin de pouvoir créer des Épingles Produit de manière dynamique pour chaque produit de votre catalogue de retail. Assurez-vous que votre source de données à jour est disponible tous les jours afin que les détails de vos produits soient également à jour. Vous pouvez même programmer à l’avance l’ingestion de vos données.
Si vous importez votre source de données manuellement, nous y accéderons lors de son importation, mais également à chaque fois que vous importerez une source à jour. L’objectif est de pouvoir créer des Épingles Produit ou mettre à jour les métadonnées des Épingles existantes, et ce, pour chaque produit présent dans votre catalogue de retail.
Nous vous alerterons en cas d’erreur. Vous devrez les vérifier et les corriger dès que possible pour garantir l’exactitude et l’actualisation des informations sur les produits. Il est possible que l’ensemble de votre page de produits ou seulement certains articles ne soient pas à jour ou que vous deviez procéder à certaines modifications de format.
Nous pouvons traiter jusqu’à 20 millions de produits par catalogue de retail. Si vous avez plus de 20 millions de produits,
Cela n’est pertinent que si vous hébergez votre source de données. Si vous importez votre source de données manuellement, vous pouvez ignorer cette section.
Vous devrez héberger votre propre source de données sur un serveur FTP/SFTP/WebDAV ou avec un lien de téléchargement direct HTTP/HTTPS. Celui-ci doit être accessible par un agent-utilisateur et ne doit nécessiter aucune liste blanche par adresse IP ou clé SSH. Si vous utilisez un lien de téléchargement direct, il ne doit comporter aucune navigation supplémentaire, pour que nous puissions accéder au fichier.
Nous prenons en charge les formats suivants :
| Valeurs séparées par des tabulations (TSV) | (Télécharger un exemple de fichier TSV) |
| Valeurs séparées par des virgules (CSV) | (Télécharger un exemple de fichier CSV) |
| XML (RSS 2.0, ATOM 1.0) | (Télécharger un exemple de fichier XML) |
Remarque : nous acceptons les fichiers compressés (.zip, .giz, .gz, .bz2 etc.), mais nous ne prenons pas en charge les fichiers chiffrés, protégés par mot de passe, les fichiers Google Drive ou les fichiers Dropbox.
Votre catalogue de retail doit inclure les champs suivants, au format identique à ce que vous voyez. S’ils sont manquants ou n’ont pas le bon format, l’ingestion de votre catalogue de retail échouera.
| Nom de la colonne | Description | Syntaxe/valeurs compatibles | Exemple |
|---|---|---|---|
| id |
Identifiant unique correspondant au produit. |
127 caractères maximum. | DS0294-L |
| title | Nom du produit (doit être identique au nom du produit de la page de renvoi et comprendre des détails de variante, tels que la couleur et la taille). | 500 caractères maximum. | Chemise en jean pour femme, taille L |
| description | Description du produit. | 10 000 caractères maximum en texte brut (pas HTML). | Chemise en jean décontractée fabriquée en denim japonais d’excellente qualité |
| link | Page de destination du produit (doit diriger directement vers le même produit et présenter les mêmes données) |
URL de la chaîne. 511 caractères maximum et l’URL doit commencer par http:// (nous déconseillons d’utiliser des hardwalls). |
https://www.exemple.com/cat/vetements-femme/chemise-jean-0294 |
| image_link |
Lien vers l’image principale du produit (au moins 75x75 pixels, accessible par notre agent utilisateur, sans image de modèle ni d’espace réservé). Si vous modifiez l’image ultérieurement, vous devrez utiliser un autre lien, sinon l’image ne sera pas mise à jour. |
URL de la chaîne. Maximum de 2 000 caractères, commençant par http:// ou https:// (encoder ou supprimer des virgules). Recommandation : entourez la chaîne de guillemets. |
https://scene.exemple.com/image/image.jpg |
| price |
Prix du produit (doit refléter le coût réel du produit et inclure une devise au format ISO-4217 s’il ne s’agit pas de dollars américains, sinon nous utiliserons par défaut des dollars américains). |
<valeur chiffrée> <ISO 4217> La devise peut être affichée avant ou après la valeur numérique du prix, avec ou sans espace, et doit respecter le code de la norme ISO-4217. N’utilisez pas de valeurs ou de symboles monétaires 0. |
24.99 USD 24.99USD 24,99 USD 24,99USD 24.99 24,99 GBP24.99 GBP 24.99 GBP24,99 GBP 24,99 |
| availability | Disponibilité du produit. |
Doit correspondre à l’une des valeurs suivantes : in stock |
in stock |
| item_group_id (obligatoire uniquement lorsque les produits ont plusieurs variantes) | ID parent du produit. | 127 caractères maximum. | DS0294 |
Vous pouvez ajouter des champs facultatifs à votre catalogue de retail pour nous aider à mieux mapper vos produits aux utilisateurs. Plus les informations fournies seront nombreuses, plus les Épingles présentées aux utilisateurs seront pertinentes. Jetez un œil ci-dessous pour en savoir plus sur les champs facultatifs.
| Nom de la colonne | Description | Syntaxe/valeurs compatibles | Exemple |
|---|---|---|---|
| product_type | Catégorisation de votre produit en fonction de votre propre taxonomie de produits. |
Cinq sous-catégories maximum, contenant 1 000 caractères maximum, doivent être séparées par le symbole > et entouré d’espaces (nous n’acceptons aucun autre séparateur, virgule ou barre verticale par exemple). |
Vêtements > Femmes > Chemises > Jean |
| additional_image_link |
Liens vers un maximum de 10 images supplémentaires de votre produit (au moins 75x75 pixels, accessible par notre agent utilisateur, sans image de modèle ni d’espace réservé). Nous créerons une nouvelle Épingle pour chaque lien d’image supplémentaire. Si vous modifiez l’image ultérieurement, vous devrez utiliser un autre lien, sinon l’image ne sera pas mise à jour. |
Maximum de 2 000 caractères chacun, commençant par http:// ou https:// (encoder ou supprimer des virgules). Recommandation : entourez la chaîne de guillemets. |
"https://scene.exemple.com/image/image_v2.jpg, https://scene.exemple.com/image/image_v3.jpg” |
| mobile_link | Version optimisée pour mobile de votre page de renvoi. | Doit commencer par http:// ou https:// | https://m.exemple.com/cat/vetements-femme/chemise-jean-0294 |
| sale_price |
Prix du produit avec la réduction (doit être inférieur au prix et inclure une devise au format ISO-4217 s’il ne s’agit pas de dollars américains, sinon nous utiliserons par défaut des dollars américains). Le cas échéant, le prix soldé sera considéré comme le prix actuel de l’article. |
<valeur chiffrée> <ISO 4217> La devise peut être affichée avant ou après la valeur numérique du prix, avec ou sans espace, et doit respecter le code de la norme ISO-4217. N’utilisez pas de valeurs ou de symboles monétaires 0. |
14.99 USD 14.99USD 14,99 USD 14,99USD 14.99 14,99 GBP 14.99 GBP14.99 GBP 14,99 GBP14,99 |
| average_review_rating | Nombre moyen d’avis pour ce produit. |
<valeur chiffrée> Entre 1 et 5 |
5 |
| number_of_ratings | Nombre de notes pour ce produit. | <valeur chiffrée> | 2 |
| number_of_reviews | Nombre d’avis pour ce produit. | <valeur chiffrée> | 4 |
| description_html |
Description HTML du produit. Recommandation : utilisez ceci si votre description comporte plus de 200 caractères. Si ce champ est renseigné, nous l’utiliserons à la place du champ de description obligatoire. |
Formatage HTML | <body> <h1>Mon produit</h1> <p>Acheter Maintenant</p> </body> |
| video_link |
Lien hébergé de la vidéo du produit. Les vidéos liées doivent être au format .mp4, .mov ou .m4v. La taille du fichier ne peut pas dépasser 2 Go. |
URL de la chaîne. 2 000 caractères maximum, en commençant par http:// ou https:// |
https://www.exemple.com/exemple.mp4 |
| Nom de la colonne | Description | Syntaxe/valeurs compatibles | Exemple |
|---|---|---|---|
| item_group_id | ID parent du produit. | 127 caractères maximum | DS0294 |
|
brand |
Marque du produit | 100 caractères maximum | Les jeans de Marie |
| gtin | Identifiant universel unique du produit | Valeur chiffrée suivant les consignes du GTIN | 3234567890126 |
| mpn | Numéro de référence fabricant du produit |
70 caractères alphanumériques maximum |
"mpn" : "PI12345NTEREST" |
| Nom de la colonne | Description | Syntaxe/valeurs compatibles | Exemple |
|---|---|---|---|
|
color |
Couleur principale du produit. | 30 caractères maximum. | bleu |
| gender | Identité de genre associée au produit. | Doit être l’une des valeurs suivantes : masculin féminin unisexe |
homme |
| age_group | Âge associé au produit. |
Doit correspondre à l’une des valeurs suivantes : newborn |
newborn |
| material | Matière utilisée pour fabriquer le produit. | 30 caractères maximum. | coton |
| pattern | Modèle utilisé pour le produit. | 30 caractères maximum. | plaid |
| size | Dimensions du produit. | 30 caractères maximum. | M |
| size_type | Description supplémentaire pour la taille du produit. |
Doit correspondre à l’une des valeurs suivantes : regular |
regular |
| size_system | Système de taille du pays dans lequel vous soumettez votre produit. | Code pays. |
États-Unis |
| alt_text | Description de ce qui apparaît dans les images principales du produit. | Une ou plusieurs valeurs de texte alternatif, séparées par des virgules. Le nombre de valeurs de texte alternatif doit correspondre au nombre d’images dans votre champ image_link. Les virgules doivent être codées au format , ou supprimées si elles font partie du texte alternatif. Les virgules doivent être utilisées pour séparer plusieurs textes alternatifs. | Chapeau bébé en crochet bleu avec pampilles |
| variant_names | Options pour cette variante du produit (les utilisateurs de Pinterest verront ces options à côté de votre Épingle et pourront sélectionner celle de leur choix). | Textes séparés par des virgules, répertoriés dans l’ordre dans lequel vous souhaitez qu’ils soient affichés. | Couleur,Taille |
| variant_values | Options de valeur pour cette variante du produit (les utilisateurs de Pinterest verront ces options à côté de votre Épingle et pourront sélectionner celle de leur choix). |
Textes séparés par des virgules, répertoriés dans l’ordre dans lequel vous souhaitez qu’ils soient affichés. Doit être conforme à l’ordre du champ variant_names. |
Rouge,Petit |
| adult | Que le produit soit réservé ou non aux adultes. Les produits réservés aux adultes ne seront pas affichés sur Pinterest. |
Doit correspondre à l’une des valeurs suivantes : TRUE |
false |
| Nom de la colonne | Description | Syntaxe/valeurs compatibles | Exemple |
|---|---|---|---|
| tax | Détails des taxes pour le produit |
Composé d’un groupe formé de quatre éléments maximum : pays, région, taux (tous obligatoires) et tax_ship (facultatif). Les deux-points sont obligatoires, même pour les valeurs vides. pays:région:taux (obligatoire):tax_ship |
US:1025433:6.00:y |
| shipping | Informations d’expédition du produit |
Composé d’un groupe formé de quatre éléments maximum : pays, région, service (tous facultatifs) et prix (obligatoire). Les deux-points sont obligatoires, même pour les valeurs vides. pays:région:service:prix (obligatoire) |
US::Express:13.12 |
|
shipping_weight |
Le poids du produit. |
<valeur chiffrée> <unité de mesure> Assurez-vous d’insérer une espace entre la chaîne numérique et la métrique. |
5 lbs |
| shipping_width | Largeur du colis nécessaire pour expédier le produit. |
<valeur chiffrée> <unité de mesure> Assurez-vous d’insérer une espace entre la chaîne numérique et la métrique. |
40 cm |
| shipping_height | Hauteur du colis nécessaire pour expédier le produit. |
<valeur chiffrée> <unité de mesure> Assurez-vous d’insérer une espace entre la chaîne numérique et la métrique. |
30 cm |
| free_shipping_label |
Proposez-vous la livraison gratuite pour ce produit ou non ? Dans l’affirmative, saisissez 0 dans le champ free_shipping_limit. Si vous ne proposez la livraison gratuite qu’à partir d’un certain montant dépensé, indiquez-le dans le champ free_shipping_limit. |
Doit correspondre à l’une des valeurs suivantes : TRUE |
vrai |
| free_shipping_limit | Montant d’achat minimum nécessaire pour bénéficier de la livraison gratuite du produit. |
<valeur chiffrée> <ISO 4217> |
31 EUR |
| Nom de la colonne | Description | Syntaxe/valeurs compatibles | Exemple |
|---|---|---|---|
| custom_label_0 | Groupement personnalisé de produits (jusqu’à cinq) | 200 caractères maximum |
Soldes d’été |
| custom_label_1 | Groupement personnalisé de produits (jusqu’à cinq) | 200 caractères maximum | Meilleures ventes |
| custom_label_2 | Groupement personnalisé de produits (jusqu’à cinq) | 200 caractères maximum | De nouveaux produits |
| custom_label_3 | Groupement personnalisé de produits (jusqu’à cinq) | 200 caractères maximum | En solde |
| custom_label_4 | Groupement personnalisé de produits (jusqu’à cinq) | 200 caractères maximum | Moitié prix |
| Nom de la colonne | Description | Syntaxe/valeurs compatibles | Exemple |
|---|---|---|---|
| ad_link | Lien pouvant être utilisé pour suivre le trafic provenant des annonces Shopping Pinterest. |
URL de la chaîne. Il est nécessaire d’indiquer une URL complète incluant le suivi, pas uniquement les paramètres de suivi. Nous ne prenons pas en charge le suivi des impressions pour le moment. L'URL doit commencer par http:// ou https:// |
https://www.exemple.com/cat/chemise-jean/item012?utm_source=Pinterest |
| condition | État du produit. |
Doit correspondre à l’une des valeurs suivantes : new |
new |
| google_product_category | Catégorisation du produit en fonction de la classification des produits Google. |
Voir la taxonomie complète de l’anglais. Consultez le Centre d’aide de Google pour accéder aux taxonomies d’autres langues. Les textes et les valeurs numériques sont acceptés. |
Vêtements et accessoires > Vêtements > Hauts 21 |
Assurez-vous de respecter nos
Découvrez comment