Vous pouvez transmettre vos données de produit à la Plateforme Marketing Emarsys au format Flux de Produit Google (GPF), que nous convertissons automatiquement dans notre format CSV natif. Si vous possédez déjà un fichier de produit GPF, il y a de bonnes chances que vous puissiez l'utiliser tel quel. Assurez-vous juste que votre GPF contienne tous les champs de données produit exigés par Emarsys.
Table des matières
Pré-requis
- Un fichier GPF crypté en UTF-8.
Si votre fichier GFP pèse plus de 400 Mo, veuillez contacter le Support Emarsys avant de configurer les mises à jour programmées dans l'UI Web.
Nous vous conseillons fortement de n'utiliser aucun caractère espace (par exemple saut de ligne, espace, caractère de tabulation) au format XML de fichier produit GPF, à moins que vous n'en ayez explicitement esoin. Fichiers GPF - quand appliqué au format XML - fonctionne de manière optimale sans aucun caractère espace supplémentaire. Les spécifications de fichier XML sont disponibles ici.
Vous devez valider votre GPF dans le Google Merchant Center avant d'essayer de le téléverser vers Emarsys. En effet, nous n'offrons la validation des données produit complète que pour le format CSV Emarsys.
Veuillez apporter une attention particulière aux noms de colonne. Emarsys ne supporte pas les colonnes multiples désignées par le même nom (par ex. additional_image_link) mais Google n'affichera pas cela comme une erreur.
Les champs Google Product Feed au format CSV Emarsys
Le tableau ci-dessous montre comment nous convertissons les champs GPF en champs de données produit Emarsys :
GPF | Emarsys CSV | Obligatoires dans Emarsys | Commentaires |
|---|---|---|---|
id et item_group_id | item | Oui | Emarsys supprime les variantes de produits (c'est-à-dire les produits similaires qui ne diffèrent que par des caractéristiques telles que la taille, la couleur et le matériau) et crée un article de niveau apparenté à partir de chaque groupe de produit. Nous utilisons le champ GPF item_group_id pour identifier les groupes de produit. En savoir plus. |
| Le produit de niveau apparenté dans le CSV Emarsys héritera des caractéristiques du premier article du groupe de produit GPF. Voir l'exemple ci-dessous. | |||
titre | titre | Oui | |
lien | lien | Oui | |
image_link | zoom image et image | Non | L'URL originelle est collée dans le champ zoom_image. |
| Elle est aussi utilisée pour le champ image, mais se traduit par une URL qui crée une vignette à la volée pour les recommandations email. En savoir plus. | |||
google_product_category ou product_type | categorie | Non | Pour en savoir plus sur comment nous convertissons les catégories, cliquez ici. |
disponibilité | disponible | Non | GPF supporte 3 valeurs (in stock, out of stock, preorder), tandis qu'Emarsys en supporte seulement 2. in stock et preorder sont tous deux convertis en true. |
description | description | Non | |
sale_price | prix | Non | Si les deux champs de prix GPF sont peuplés, voici comment il se convertit. |
Si seul sale_price est peuplé, nous utilisons cette valeur à la fois pour price et msrp dans le CSV Emarsys. | |||
prix | msrp | Non | Si les deux champs de prix GPF sont peuplés, voici comment il se convertit. |
Si seul price est peuplé, nous utilisons cette valeur à la fois pour price et msrp dans le CSV Emarsys. | |||
marque | marque | Non | |
custom_label_[n] | c_label_[n] | Non | En savoir plus sur quels champs GPF personnalisés nous supportons. |
Pays et langues supportés
Nous nous efforçons d'offrir le support à tous les pays et dans toutes les langues cibles supportés par Google. Si Google supporte votre pays et votre langue et que vous ne les trouvez pas dans le menu déroulant lorsque vous téléversez votre GPF dans l'UI Web de la Plateforme Marketing Emarsys, veuillez contacter le Support Emarsys.
Si nous ne supportons pas votre pays et votre langue, vous pouvez toujours sélectionner les États-Unis comme localité par défaut.
Utiliser des flux multiples
Nous supportons l'usage de flux GPF multiples pour les clients qui ciblent divers pays (ou utilisent diverses langues), mais nous ne supportons pas l'usage de flux multiples pour le même pays et la même langue.
Les GPF multiples sont fusionnés dans un seul fichier de données produit CSV, basé sur les règles définies dans nos lignes directrices de localisation.
Seuls les produits compris dans votre localité par défaut sont ajoutés au fichier de données CSV Emarsys pendant la conversion. Si vous offrez des produits dans d'autres localités alors que vous ne les vendez pas dans votre localité par défaut, assurez-vous de les inclure dans votre fichier GPF par défaut ainsi que de configurer leur disponibilité sur en rupture de stock. Conservez les mêmes item_group_id et SKU dans les champs de données produit par défaut et locaux pour les mêmes produits.
Si vous avez un doute sur comment faire cela, veuillez contacter le Support Emarsys.
item_group_id dans les fichiers de données produit n'est pas encore complètement supporté pour l'instant. N'utilisez pas item_group_id si vous utilisez aussi des fichiers de données produit locaux, car certaines produits locaux peuvent être supprimés du catalogue final (même s'ils sont en stock dans cette localité). Ne regroupez pas vos variantes sous le même item_group_id, mais gardez-les comme id-s distincts de sorte à refléter correctement la disponibilité.
Catégories de produit
GPF supporte deux caractéristiques pour spécifier la catégorie à laquelle un produit spécifique appartient.
- google_product_category - Les catégories de produit de vos articles selon la taxonomie de produit Google. Le champ a une limite importante : il ne peut inclure qu'un chemin de catégorie par produit. Il peut être peuplé soit par une valeur numérique (l'identifiant de catégorie standardisé) ou par le chemin complet de la catégorie (par exemple
root > cat1 > subcat2). - product_type - Les catégories de produit que vous définissez pour vos produits. Dans ce champ, vous pouvez inclure de multiples hiérarchies de catégorie. Ce champ a une limite importante : Google ne supporte pas l'usage de virgules ( , ) à l'intérieur des valeurs individuelles soumises dans ce champ car elles sont réservées à la séparation de valeurs multiples.
Lorsque le GPF originel est traité et converti dans notre format CSV natif, nous regardons d'abord le contenu du champ product_type. S'il est peuplé, voici ce que nous utiliserons dans le fichier de données produit. C'est seulement si product_type n'est pas peuplé que nous utiliserons le champ google_product_category.
Si vous utilisez des identifiants de catégorie numériques dans le champ google_product_category, ceux-ci seront convertis dans le chemin de catégorie intelligible correspondant. Par exemple, 4745 deviendra Electronics > Computers > Tablet Computers dans notre format CSV natif. Lorsque vous implémentez nos scripts de collecte de données Web Extend, faites toujours passer le chemin de catégorie intelligible dans la commande category pour rapporter les vues de page de catégorie sur votre site Web.
Groupes d'article
La Plateforme Marketing Emarsys fonctionne actuellement uniquement avec des produits de niveau apparenté et n'utilise pas les informations sur les variantes de niveau SKU du même produit. Mais Google vous oblige à lister les variantes de produit qui ne se distinguent les uns des autres que par des caractéristiques comme la taille, la couleur, le matériau etc. comme produits séparés dans votre GPF.
Assurez-vous d'utiliser la caractéristique item_group_id pour grouper les différentes variantes des mêmes produits apparentés dans votre GPF, puisqu'Emarsys a besoin que ce champ identifie les groupes de produit. Lorsque nous convertissons votre GPF au format CSV Emarsys, nous ne conservons que les groupes de produit et laissons de côté les variantes individuelles.
Ce tableau vous montre comment nous convertissons vos groupes de produit GPF :
| GPF | Emarsys CSV |
|---|---|
| id,title,item_group_id 100_40, chaussure en cuir homme taille 40, 100 100_41, chaussure en cuir homme taille 41, 100 100_42, chaussure en cuir homme taille 42, 100 | article, titre 100, chaussure en cuir homme taille 40 |
Voici les erreurs les plus fréquentes à éviter :
| GFP | Emarsys CSV | Commentaire |
|---|---|---|
| Id,title,item_group_id 100_42, chaussure en cuir homme taille 42, 100_43, chaussure en cuir homme taille 43, | article, titre 100_42, chaussure en cuir homme taille 42 100_43, chaussure en cuir homme taille 43 | item_group_id est manquant, toutes les variantes du produit seront listées comme un article séparé dans la base de données produit Emarsys. |
| Id,title,item_group_id Chaussure en cuir homme taille 42, 100 | [erreur] | L'article est supprimé parce que id est manquant. |
| Id,title,item_group_id 100_42, chaussure en cuir homme taille 42, 100_42 | [erreur] | L'article est supprimé parce que id et item_group_id sont identiques. |
Si vous utilisez item_group_id dans votre GPF, vous devez garder cela en tête quand vous implémentez notre API JavaScript Web Extend. Dans ce cas, assurez-vous de faire passer la valeur de ce champ comme caractéristique item dans les commandes view, cart et purchase, sinon Emarsys ne pourra pas identifier ces produits.
Champs GPF personnalisés
GPF supporte deux types de champ personnalisé :
- caractéristiques personnalisées, qui commencent par un "c: (par exemple
c:promo_offer:boolean). - labels personnalisés, qui sont numérotés de 0 à 4 (par exemple
custom_label_1).
Actuellement, seuls les labels personnalisés sont convertis dans le CSV Emarsys. Les caractéristiques personnalisées sont ignorées.