Connexion

Bienvenue sur notre Centre de Support

Obtenez de l'aide sur l'intégration et sur vos campagnes.

Bienvenue sur notre Centre de Support. Obtenez de l'aide sur l'intégration et sur vos campagnes.

Caractéristiques de flux produit Criteo

1. Vue d'ensemble

Un flux produit est un fichier qui contient les informations concernant les produits disponibles sur votre site. Nous utiliserons ces informations pour créer des bannières de produits dynamiques.

Dans cet article, vous trouverez des détails sur les éléments que vous pouvez inclure dans votre flux et la façon de formater chaque champ.

2 - Formats de flux pris en charge par Criteo

Pour vous assurer que Criteo peut récupérer votre flux produit, veuillez utiliser l'un de ces formats :

Format du flux Détails Télécharger

TSV

Ce format repose sur des valeurs séparées par une tabulation. Le titre doit être indiqué dans la première ligne du fichier. Les noms de champ contenant des espaces doivent être retirés.

Exemple de flux

CSV

Ce format repose sur des valeurs séparées par une virgule. Le titre doit être indiqué dans la première ligne du fichier. Les noms de champ contenant des espaces doivent être retirés.

Exemple de flux

XML

Ce format doit respecter les bases de la structure XML. Les produits sont représentés par un ensemble de nœuds XML. La liste des produits doit commencer par une balise de déclaration <?xml.

Exemple de flux

3 - Informations à fournir sur les produits

Tous les noms de champ doivent être en anglais. Les informations sur les produits ne doivent contenir aucune balise HTML ou de style.

3.1 - Champs requis pour diffuser vos produits

3.1.1 id (identifiant)

Ce champ est requis pour tous les produits du flux et ne peut pas rester vide.

L’id est un identifiant unique de produit. Il contient des caractères alphanumériques qui représentent un seul produit. Une fois que l’id est attribué à un produit et importé, il ne peut pas être utilisé pour un autre produit et ne peut changer pour un même produit. Si le champ item_group_id est également rempli dans votre flux, déclarez l'id avec l'ID/SKU enfant.

Exigences relatives aux caractères : l'identifiant doit commencer par une lettre ou un chiffre, et ne peut contenir que des caractères ASCII.

Limite : 250

Type : chaîne

Exemple : abc123-noir-7.5

3.1.2 titre (title)

Ce champ est requis pour tous les produits du flux et ne peut pas rester vide.

L'intitulé (Title) est le nom du produit. En général, c’est le même nom que celui qui figure sur la page de détail de ce produit sur votre site. Il sera utilisé comme description principale dans les bannières pour chaque produit. Les noms les plus courts (moins de 25 caractères) s’adaptent mieux aux formats et à la disposition des bannières Criteo.

Exigences relatives aux caractères : le nom doit commencer par une lettre ou un chiffre, et ne peut contenir que des caractères ASCII.

Limite : 150 (nous recommandons 25)

Type : chaîne

Exemple : chaussures de travail – taille 40

3.1.3 description

La description est un texte court qui donne plus d’informations sur le produit que son simple nom. Les descriptions les plus courtes (moins de 50 caractères) s’adaptent mieux aux formats et à la disposition des bannières Criteo, cependant, une description ne sera pas présente pour tous les formats et les dispositions.

Exigences relatives aux caractères : le nom doit commencer par une lettre ou un chiffre, et ne peut contenir que des caractères ASCII. Retirer toutes les balises HTML de ce champ, y compris les balises d'intégration, d'objets et d'ancrage.

Limite : 5000 (nous recommandons 50)

Type : chaîne

Exemple : Parfait pour un usage quotidien.

3.1.4 google_product_category

Les caractéristiques de niveau de catégorie indiquent la catégorie du produit soumis, selon la classification des produits de Google.

Si votre produit peut être associé à différentes catégories, ne choisissez que la catégorie la plus pertinente.

Exigences relatives aux caractères : nous ne prenons en charge que le chemin complet de la catégorie. Nous n'acceptons pas les identifiants de catégories du chemin.

Type : chaîne

Exemple : Femme > Chaussures > Chaussures de travail

3.1.5 lien (link)

Ce champ est requis pour tous les produits du flux et ne peut pas rester vide.

Le lien (producturl) est la page de votre site concernant le produit spécifique. Le lien est en général spécifique à chaque produit, mais il existe des exceptions. L’information du produit à cette adresse URL doit correspondre à l’information fournie dans le flux. Veuillez préciser le procotole (http:// ou https://) pour toutes les adresses URL.

Exigences relatives aux caractères : le lien doit commencer par le protocole (http:// ou https://) suivi de l’adresse URL complète de la page des détails du produit. Tous les symboles doivent être encodés. Ex : $ doit être remplacé par %24.

Limite : 1024

Type : chaîne

Exemple : http://www.example.com/product/working-boots

3.1.6 image_link

Ce champ est requis pour tous les produits du flux et ne peut pas rester vide.

image_link est une adresse URL qui envoie à l'image d’un produit donné. image_link permettra d'afficher l'image des produits dans les bannières.Idéalement, les images font entre 300 et 400 pixels de large et moins de 1 Mo. Vous devez spécifier un Content-Type Header (en-tête) pour l'image, qu'il s'agisse d'une image/png ou d'une image/jpeg. Si vous souhaitez restreindre l'accès de vos images via cURL, veuillez mettre notre user-agent en liste blanche pour que nous puissions afficher vos images dans les bannières Criteo : curl/7.15+ (x64-criteo) libcurl/7.15+ OpenSSL zlib libidn.

Exigences relatives aux caractères : image_link doit commencer par http:// (pas https://) suivi de l’adresse URL complète de l’image du produit. Tous les symboles doivent être encodés. Ex : $ doit être remplacé par %24. Cependant, image_link ne peut contenir aucun symbole dans la chaîne de requête (tous les caractères après le ?)

Limite : 2000

Type : chaîne

Exemple : http://www.example.com/product/image/working-boots.png

3.1.7 additional_image_link

additional_image_link est une adresse URL qui renvoie au chemin d’accès de l'image d’un produit donné, différent de celui fourni dans image_link. additional_image_link sera utilisé pour présenter l’image du produit dans les bannières. Idéalement, les images mesurent entre 300 et 400 pixels et pèsent moins d’un mégaoctet. L'image doit avoir un Content-Type header spécifié, qu'il s'agisse d'image/png ou d'image/jpeg. Si vous souhaitez restreindre l'accès de vos images via cURL, veuillez mettre notre user-agent en liste blanche pour que nous puissions afficher vos images dans les bannières Criteo : curl/7.15+ (x64-criteo) libcurl/7.15+ OpenSSL zlib libidn.

Exigences relatives aux caractères : additional_image_link doit commencer par http:// (pas https://) suivi de l’adresse URL complète de l’image du produit. Tous les symboles doivent être encodés. Ex : $ doit être remplacé par %24. Cependant, additional_image_link ne peut contenir aucun symbole dans la chaîne de requête (tous les caractères après le ?).

Limite : 1024

Type : chaîne

Exemple : http://www.example.com/product/image/working-boots-side.png

3.1.8 disponibilité (availability)

La disponibilité (availability) indique que le produit peut être acheté sur le site. Vous pouvez remplir le champ avec 3 valeurs : précommande (l'article n'est pas actuellement expédié, mais peut être acheté), rupture de stock (l'article n'est pas expédié et vous n'acceptez aucune commande) et en stock (l'article est expédié et des commandes peuvent être faites). Les articles marqués en rupture de stock seront exclus des bannières.

Exigences relatives aux caractères : la disponibilité doit être renseignée par l'une des trois valeurs suivantes :

· preorder

· out of stock

· in stock

Limite : 25

Type : chaîne

Exemple : in stock

3.1.9 prix (price)

Il s'agit du prix de vente du produit recommandé par le fabricant. Si un produit particulier est soldé, le prix affiché sera le prix le plus élevé. Le prix doit être dans la même monnaie que sur le site. Ne remplissez le champ prix qu’avec les valeurs numériques qui utilisent le point (.) comme séparateur décimal et pas de séparateur de milliers.

Exigences relatives aux caractères : le séparateur décimal doit être un point (.) sans séparateur de milliers.

Limite : 14

Type : chaîne

Exemple : 1299.99

3.1.10 sale_price

Le sale_price est le prix auquel le produit est disponible à l'achat sur le site, si un produit particulier est soldé, le sale_price sera rempli par le prix le plus bas. Le sale_price doit toujours être dans la même monnaie que sur le site. Ne remplissez sale_price qu’avec des prix numériques utilisant le point (.) comme séparateur décimal et pas de séparateur de milliers.

Exigences relatives aux caractères : le séparateur décimal doit être un point (.) sans séparateur de milliers.

Limite : 14

Type : chaîne

Exemple : 1199.99

3.1.11 gtin ou mpn

Le code d'article international (Global Trade Item Number, ou "GTIN" en anglais) est un identifiant de produit unique utilisé pour identifier un produit, un service ou un article sur le marché international.

Le GTIN comprend :

  • GTIN-12 (UPC-A) : il s'agit d'un numéro comportant 12 chiffres utilisé principalement en Amérique du Nord.
  • GTIN-8 (EAN/UCC-8) : il s'agit d'un numéro comportant 8 chiffres utilisé principalement en dehors de l'Amérique du Nord.
  • GTIN-13 (EAN/UCC-13) : il s'agit d'un numéro comportant 13 chiffres utilisé principalement en dehors de l'Amérique du Nord.
  • GTIN-14 (EAN/UCC-14 or ITF-14) : il s'agit d'un numéro comportant 14 chiffres qui permet d'identifier les articles commerciaux aux différents niveaux du conditionnement.

Exigences relatives aux caractères : la valeur doit être un numéro comportant 8, 12, 13 ou 14 chiffres (UPC, EAN, JAN ou ISBN).

MPN est un nombre qui associe le produit de manière unique à son fabricant.

Limite : 50

Type : chaîne

Exemple : 0001234560012

3.1.12 marque (brand)

La marque (brand) indique le nom de marque du produit. Certains produits ne sont pas associés à une marque en particulier. Dans ce cas, cette information n'a pas à être fournie.

Exigences relatives aux caractères : le nom doit commencer par une lettre ou un chiffre, et ne peut contenir que des caractères ASCII. Retirer toutes les balises HTML de ce champ, y compris les balises de styles.

Limite : 70

Type : chaîne

Exemple : Criteo

3.1.13 adulte (adult)

L'attribut adulte (adult) indique si le produit peut être présenté à tous les utilisateurs et tous les publics. Les produits pour adultes ne peuvent pas être affichés sur les bannières Criteo et peuvent conduire les réseaux de diffusion à mettre votre campagne sur liste noire. Vous pouvez également utiliser la valeur « non» dans ce champ, si vous souhaitez que ce produit ne soit pas recommandé et affiché dans les bannières.

Exigences relatives aux caractères : la valeur doit être oui ou non

Type : booléen

Exemple : non

3.2 - Champs facultatifs

3.2.1 Informations de base du produit

Nom : product_type

product_type est une catégorie (ou liste de catégories) à laquelle le produit appartient. Il n’y a pas de restrictions en ce qui concerne les catégories qui doivent être remplies ici, vous pouvez donc utiliser product_type pour établir une correspondance avec une catégorie de votre site. product_type distingue les majuscules des minuscules, donc si vous utilisez femme pour un produit et Femme pour un autre, Criteo interprètera qu’il s’agit de deux catégories différentes.

Exigences relatives aux caractères : le product_type doit commencer par une lettre ou un chiffre, et ne peut contenir que des caractères ASCII. Les catégories doivent être délimitées par > (&gt; pour les flux XML).

Limite : 500

Type : chaîne

Exemple : Femmes &gt; Chaussures &gt; Chaussures de travail

3.2.2 mobile_link

mobile_link est le lien vers la version optimisée pour dispositifs mobiles de votre page de renvoi de produit. Cette URL doit être différente de celle fournie dans le champ « lien ». En fournissant un lien mobile : vous améliorez l'expérience client et réduisez le temps de chargement de la page.

Exigences relatives aux caractères : le lien doit commencer par le protocole (http:// ou https://) suivi de l’adresse URL complète de la page des détails du produit. Tous les symboles doivent être encodés. Ex : $ doit être remplacé par %24.

Limite : 2000

Type : chaîne

Exemple : http://m.example.com/product/working-boots

3.2.3 état (condition)

La condition est utilisée pour qualifier le produit avec trois différentes valeurs possibles : « neuf », « reconditionné » et « d'occasion ».

Exigences relatives aux caractères : seules 3 valeurs sont acceptées :

  • « new » [new]
  • « refurbished » [refurbished]
  • « used » [used]

Type : chaîne

Exemple : new

---

Variantes du produit

3.2.6 item_group_id

item_group_id est un identifiant de produit unique au niveau parent. Il contient des caractères alphanumériques qui représentent un seul produit pouvant regrouper une série de produits enfants. Une fois que item_group_id est attribué à un produit et importé, item_group_id ne peut pas être utilisé pour un produit différent. item_groupe_id représentant une collection de produits, plusieurs produits peuvent avoir la même valeur pour item_group_id.

Exigences relatives aux caractères : le item_group_id doit commencer par une lettre ou un chiffre, et ne peut contenir que des caractères ASCII.

Limite : 250

Type : chaîne

Exemple  : abc123

3.2.7 couleur (color)

Détail : cette caractéristique indiquera la ou les couleurs dominantes du produit.

Limite : 100

Type : chaîne

Exemple : noir

3.2.8 genre (gender)

Requis pour tous les produits d'un groupe d'articles qui varient en genre.

Exigences relatives aux caractères : seules 3 valeurs sont acceptées :

  • « homme » [homme]
  • « femme » [femme]
  • « unisexe » [unisexe]

Type : chaîne

Exemple : homme

3.2.9 age_group

Cette caractéristique sera utilisée pour indiquer le groupe d'âge ciblé pour ce produit.

Exigences relatives aux caractères : seules 5 valeurs sont acceptées :

  • « nouveau-né » [nouveau-né]
  • « nourrisson » [nourrisson]
  • « tout-petit » [tout-petit]
  • « enfant » [enfant]
  • « adulte » [adulte]

Type : chaîne

Exemple : adulte

3.2.10 matière (material)

Cette caractéristique indique la matière ou le tissu dans laquelle/lequel est fabriqué un produit. Obligatoire pour tous les produits d'un groupe de produits qui se distinguent par matière.

Limite : 200

Type : chaîne

Exemple : cuir

3.2.11 pattern

Cette caractéristique indiquera le motif ou l'impression graphique du produit. Necessaire pour tous les produits d'un groupe qui se distinguent par motif.

Limite : 100

Type : chaîne

Exemple : rayé

3.2.12 size

Cette caractéristique indiquera la taille du produit. Obligatoire pour tous les produits d'un groupe d'articles qui varient en taille.

Limite : 100

Type : chaîne

Exemple : L

3.2.13 size_type

Vous pouvez spécifier la coupe du produit en ajoutant le type de taille.

Exigences relatives aux caractères : seules 5 valeurs sont acceptées :

  • « normale » [normale]
  • « petite » [petite]
  • « plus » [plus]
  • « grande taille » [grande taille]
  • « maternité » [maternité]

Limite : N/A

Type : chaîne

Exemple : normal

3.2.13 size_system

Détail : vous pouvez préciser le système de mesure de taille du pays

Exigences relatives aux caractères : seules 11 valeurs sont acceptées : US, UK, EU, DE, FR JP, CN (Chine), IT, BR, MEX, AU

Limite : N/A

Type : chaîne

Exemple : US

---

Informations relatives à l'expédition

3.2.14 shipping

Cette caractéristique sera utilisée pour préciser les détails d'expédition pour chaque pays pris en charge, en indiquant le prix et le service.

Type : chaîne

Exemple :

 <shipping>
<country>US</country>
<service>Standard</service>
<price>15.5  USD</price>
</shipping>

3.2.15 shipping_weight

shipping_weight désigne le poids du produit.

Exigences relatives aux caractères : seules les unités suivantes sont acceptées : lb, oz, g, kg

Type : chaîne

Exemple : 1 kg

3.2.16 shipping_height

shipping_height désigne la hauteur du produit.

3.2.17 shipping_width

shipping_width désigne la largeur du produit

3.2.18 shipping_length

Détail : shipping_height désigne la hauteur du produit.

3.2.19 shipping_label

Cette caractéristique peut être utilisée pour attribuer des étiquettes à des produits particuliers en utilisant des valeurs de votre choix, telles que périssable, volumineux ou promotion.

Limite : 100

Type : chaîne

Exemple : promotion

---

Emballage et paquet de produits

3.2.20 multipack

Cette caractéristique définit un pack de produits identiques.

Type : Integer

Exemple : 2

3.2.21 is_bundle

Cette caractéristique définit un groupe de produits différents.

Type : booléen

Exemple : FAUX

3.2.22 promotion_id

Détail : cette caractéristique indique l'identifiant de la promotion.

Limite : String

Type : 60

Exemple : 123654

---

Caractéristiques supplémentaires

3.2.23 custom_label_0

Ajoutez des informations supplémentaires sur le produit.

Exigences relatives aux caractères : seuls 5 niveaux de libellé personnalisé sont autorisés (de 0 à 4)

Limite : 100

Type : chaîne

3.2.24 sale_price_effective_date

Cette caractéristique est utilisée avec le « sale_price » pour préciser la plage de dates de validité du prix de vente.

Exigences relatives aux caractères : dates de début et de fin séparées par une barre oblique (/). Le début est indiqué au format (JJ-MM-AAAA), suivi de la lettre « H », l'heure à laquelle l'article est disponible, suivie d'une expression relative au fuseau horaire, telle que définie par la norme ISO 8601. La date de fin doit toujours être au même format.

Limite : 51

Exemple : 01-03-2016H13:00-0800/11-03-2016H15:30-0800

3.2.25 adwords_redirect

Adresse URL pour suivre séparément tous les clics de Google Shopping.

Limite : 200

Type : URL

Exemple : http://www.mywebsite.com/productpage.html

3.2.26 excluded_destination

La caractéristique « destination exclue » empêche un article d'apparaître dans certaines destinations, même s'il apparaît dans les données de produit.

3.2.27 expiration_date

La date à laquelle le produit ne sera plus recommandé.

Limite : 10

Type : format ISO 8601

Exemple : 24-07-2016

3.2.28 unit_pricing_measure

La caractéristique « mesure de base de tarification unitaire » définit la mesure et la dimension d'un article. Exemple : 25 floz ou 15 oz.

Exemple : 15 oz

3.2.29 unit_pricing_base_measure

La caractéristique « mesure de base de tarification unitaire » précise votre préférence en matière de dénominateur du prix unitaire. Ex : 50 cl .

Exemple : 50 oz

Exemple de structure du catalogue

Exemple de flux XML

XML

<rss xmlns:g="http://base.google.com/ns/1.0"version="2.0">

    <channel>

        <title>Your Website</title>

        <link>http://www.yoursite.com/us/</link>

        <description>Your Website</description>

        <item>

            <g:id>abc123-black-7.5</g:id>

            <g:title>Working Boots Size 7.5</g:title>

            <g:description>Excellent for daily use</g:description>

            <g:google_product_category>Women’s > Shoes > Working Boots</g:google_product_category>

            <g:link>http://www.example.com/product/working-boots</g:link>

            <g:image_link>http://www.example/com/product/image/working-boots.png</g:image_link>

            <g:additional_image_link>http://www.example.com/product/image/working-boots-side.png</g:additional_image_link>

            <g:additional_image_link>http://www.example.com/product/image/working-boots-side_2.png</g:additional_image_link>

            <g:availability>in stock</g:availability>

            <g:price>1299.99</g:price>

            <g:sale_price>1199.99</g:sale_price>

            <g:gtin>0001234560012</g:gtin>

            <g:brand>Criteo</g:brand>

            <g:adult>non</g:adult>

            <g:product_type>Women’s &gt; Shoes &gt; Working Boots</g:product_type>

            <g:mobile_link>http://m.example.com/product/working-boots</g:mobile_link>

            <g:condition>new</g:condition>

            <g:availability>in stock</g:availability>

            <g:availability_date>2016-06-25T13:00-0800</g:availability_date>

            <g:sale_price_effective_date>2016-03-01T13:00-0800/2016-03-11T15:30-0800</g:sale_price_effective_date>

            <g:item_group_id>abc123</g:item_group_id>

            <g:color>Black</g:color>

            <g:gender>male</g:gender>

            <g:age_group>adult</g:age_group>

            <g:material>leather</g:material>

            <g:pattern>Striped</g:pattern>

            <g:size>L</g:size>

            <g:size_type>regular</g:size_type>

            <g:size_system>US</g:size_system>

            <g:shipping>

                <g:country>US</g:country>

                <g:service>Standard</g:service>

                <g:price>5.5 USD</g:price>

            </g:shipping>

            <g:shipping_weight>1 kg</g:shipping_weight>

            <g:shipping_label>promotion</g:shipping_label>

            <g:multipack>2</g:multipack>

            <g:is_bundle>FALSE</g:is_bundle>

            <g:custom_label_0>custom data 0</g:custom_label_0>

            <g:custom_label_1>custom data 1</g:custom_label_1>

            <g:custom_label_2>custom data 2</g:custom_label_2>

            <g:custom_label_3>custom data 3</g:custom_label_3>

            <g:custom_label_4>custom data 4</g:custom_label_4>

            <g:sale_price_effective_date>2016-03-01T13:00-0800/2016-03-11T15:30-0800</g:sale_price_effective_date>

            <g:adwords_redirect>http://www.mywebsite.com/productpage.html</g:adwords_redirect>

            <g:excluded_destination>Shopping</g:excluded_destination>

            <g:expiration_date>2016-07-24</g:expiration_date>

            <g:unit_pricing_measure>15oz</g:unit_pricing_measure>

            <g:unit_pricing_base_measure>50oz</g:unit_pricing_base_measure>

        </item>

    </channel>

</rss>

Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 1 sur 1
Réalisé par Zendesk