Directives de mise en œuvre des flux de données du Product Catalog

Mise à jour décembre 2023.

Introduction

Ce document est votre guide pour la mise en œuvre des flux de données du Product Catalog de Rakuten Advertising. Il vous fournit des informations sur la façon d'automatiser le processus d'obtention des informations produit de vos partenaires annonceurs qui font partie de Rakuten Advertising et qui ont souscrit au programme Product Catalog.

Il existe deux niveaux de mise en œuvre pour les flux de données du Product Catalog. Tout d'abord, vous devrez être approuvé et configuré pour la mise en œuvre technique des flux de données produit, puis vous devrez être approuvé par chacun de vos partenaires annonceurs participants pour utiliser leur flux de données du Product Catalog sur votre site Web ou blog. Voir Premiers Pas pour plus d'informations.

Exigences Techniques pour Utiliser le Product Catalog

Pour automatiser le processus d'obtention des informations produit, vous devez être capable de :

  • Télécharger des fichiers depuis un compte SFTP.
  • Traiter des fichiers XML ou texte délimités par des pipes contenant les informations produit.

Sections de Fichier

Les fichiers produit comportent trois sections : en-tête, données produit et bande-annonce ; cliquez sur le + pour plus d'informations sur chaque section :

Section En-tête

L'en-tête contient l'ID et le nom de l'annonceur ainsi qu'un horodatage indiquant quand le fichier a été déposé dans votre compte SFTP. Cet enregistrement se termine par un retour chariot. Il inclut les éléments suivants :

  • MID : La valeur numérique attribuée pour identifier chaque annonceur.
  • Nom : Le nom de l'annonceur. Celui-ci est défini par l'annonceur et peut changer.
  • Horodatage : L'heure à laquelle le fichier a été déposé dans votre compte SFTP en UTC. Le format est mm/jj/aaaa hh:mm:ss.

Exemples :

  • Fichier .txt : HDR|1237|NORDSTROM.com|09/03/2022 00:02:32
  • Fichier .xml : <header><merchantId>1237</merchantId><merchantName>NORDSTROM.COM
    </merchantName><createdOn>09/03/2022 00:02:32</createdOn></header>
Section Données Produit
Cette section contient des enregistrements de données produit individuels. Chaque ligne contient des données pour un produit. L'enregistrement de données produit comporte deux parties : la section principale et la section attributs. La section attributs est facultative. La section principale comporte 28 champs. La section attributs inclut jusqu'à 10 valeurs pour tous les produits sauf les cartes de crédit, qui peuvent avoir jusqu'à 22 valeurs.

 Note

Si un annonceur n'inclut pas la section attributs, son fichier Product Catalog inclura tout de même des espaces réservés pour tous les champs.

Informations Principales
La section principale fournit des informations de base sur chaque produit, y compris le numéro d'article, le Nom du Produit, la Catégorie Principale, l'URL du Produit et le Prix de Vente. Les détails de tous les champs qui font partie de cette section sont expliqués dans l'Annexe A.
Informations sur les Attributs
La section attributs comprend les 10 derniers champs (22 pour les cartes de crédit) et fournit des informations détaillées sur chaque produit en fonction de certaines définitions de classe de produit. Les champs de cette section sont facultatifs. Le nombre de valeurs de champ et le contenu de chaque champ dans la section attributs dépendront de l'ID de Classe pour le produit spécifique.
L'ID de Classe identifie la catégorie de classe d'un produit et les attributs associés à cette classe permettent à l'annonceur d'inclure des informations supplémentaires sur un produit.
Par exemple, l'ID de Classe 40 identifie la catégorie de produit Matériel Informatique. Pour cet ID de Classe, les champs sont Plateforme, RAM, Disque Dur, Processeur, Taille de l'Écran, Modem et Lecteur.
Rakuten Advertising dispose actuellement de 16 ID de Classe prédéfinis disponibles. Chaque ID de Classe a un ensemble prédéterminé de champs d'attributs. L'Annexe B fournit des détails sur les champs pour chaque ID de Classe.

 Note

Les ID de Classe n'auront pas le même nombre de champs d'attributs et tous les champs ne sont pas tenus d'avoir des données. L'Annexe D vous fournit des exemples d'enregistrements.

Section Bande-annonce

Le dernier enregistrement du fichier Product Catalog est la bande-annonce qui commence par les caractères TRL, suivis d'un délimiteur de pipe. La bande-annonce vous fournit le nombre d'enregistrements de produits contenus dans le fichier Product Catalog.

Exemples :

  • Fichier .txt : TRL|45826
  • Fichier .xml : <trailer><numberOfProducts>33</numberOfProducts></trailer>

Formats de Fichier

Les fichiers Product Catalog sont disponibles en deux formats : texte délimité par des pipes et XML :

1. Fichier texte délimité par des pipes : 2. Fichier XML :
Ce fichier utilise le délimiteur de pipe (|) pour diviser les champs. Chaque enregistrement est terminé par un retour à la ligne/nouvelle ligne. Le fichier sera rempli avec tous les champs que les annonceurs sont tenus de fournir ainsi qu'avec d'autres informations qui peuvent avoir été fournies par l'annonceur. S'il n'y a pas de données pour un champ, sa position est préservée dans le fichier par son délimiteur. Les valeurs de champ contenant le délimiteur de pipe seront entourées de guillemets doubles.

Noms de fichiers

Les noms de fichiers du Product Catalog ont trois parties, chacune séparée par un trait de soulignement : ID de l'annonceur, ID du canal du publisher et type de fichier.

  1. L'ID de l'annonceur ou MID est un identifiant unique que le réseau d’affiliation de Rakuten Advertising utilise pour identifier l'annonceur. Il est toujours numérique.
  2. L'ID du canal du publisher ou SID est un identifiant unique que le réseau d’affiliation de Rakuten Advertising utilise pour identifier le canal du publisher. Il est toujours numérique.
  3. Le type de fichier “mp” définit que le fichier est un fichier de Product Catalog.

Les extensions de nom de fichier spécifient quel type de fichier de Product Catalog il s'agit. Le fichier délimité par des pipes a une extension .txt et le fichier au format XML a une extension .xml. Les fichiers sont tous compressés, donc il y a .gz après l'extension de type de fichier.

Exemple : 2385_112_mp.txt.gz, où :

  • 2385 est l'ID du programme de l'annonceur.
  • 112 est l'ID du canal du publisher.
  • mp indique qu'il s'agit d'un fichier de Product Catalog.
  • .txt indique qu'il s'agit d'un fichier de Product Catalog délimité par des pipes.

Types de fichiers

La fonctionnalité de Product Catalog de Rakuten Advertising permet aux annonceurs de télécharger leurs informations produit chez nous. Nous traitons les informations téléchargées et créons une URL de suivi de publisher correspondante pour chaque produit et rendons les informations produit disponibles pour les publishers via SFTP. Vous avez plusieurs choix de types de fichiers que vous pouvez télécharger pour chaque annonceur ; cliquez sur le + pour en savoir plus sur chaque type de fichier :

Fichier complet
Un fichier complet qui contient tous les produits d'un annonceur, pas seulement les produits qui ont changé depuis le dernier téléchargement.
Fichier delta
Un fichier delta qui inclut uniquement les nouveaux enregistrements de produits, modifiés et supprimés d'un annonceur.
Fichier de catégorie
Des fichiers qui contiennent uniquement des produits d'une catégorie de produit particulière basée sur les catégories définies par les annonceurs. Les fichiers de catégorie sont également disponibles en tant que fichiers complets et delta.
Fichiers globaux et supplémentaires
Les annonceurs peuvent inclure des flux de téléchargement dans différentes langues et devises ou créer des flux qui leur permettent de séparer des sous-ensembles de produits de leur flux principal.

Fichiers delta

Les fichiers delta vous permettent de télécharger des fichiers plus petits qui contiennent uniquement les mises à jour de produits, y compris les nouveaux enregistrements de produits, modifiés et supprimés. Cela peut être utile pour mettre à jour les flux pour les annonceurs ayant des catalogues de produits particulièrement volumineux. Le type de modification apportée est reflété dans un champ supplémentaire appelé Modification. Dans les fichiers délimités par des pipes, c'est le dernier champ pour chaque enregistrement de produit. Dans les fichiers XML, cela est indiqué par la balise <modification>. Voir le champ Modification dans l'Annexe A pour les valeurs prises en charge.

Le fichier contient toutes les modifications qui ont été apportées lors du traitement du dernier flux de l'annonceur. Les annonceurs peuvent traiter les flux plusieurs fois par jour, il est donc recommandé de vérifier souvent le serveur pour les mises à jour, en se référant à l'horodatage sur le fichier pour déterminer si des modifications ont été apportées depuis la dernière fois que vous avez récupéré le fichier. De plus, il est recommandé de récupérer un fichier complet régulièrement pour vous assurer que vous avez le Product Catalog complet.

Le nom du fichier delta est le même que celui utilisé pour télécharger le fichier complet du Product Catalog, sauf qu'il a le mot delta ajouté à la fin.

Exemples :

  • Fichier .txt : 2385_112_mp_delta.txt.gz
  • Fichier .xml : 2385_112_mp_delta.xml.gz

L'en-tête du fichier Delta est le même que celui du fichier complet et inclut MID, le nom de l'annonceur et l'horodatage dans le format indiqué dans Sections du fichier de Product Catalog.

Fichiers de catégorie

Le Product Catalog par catégorie est une fonctionnalité qui vous permet de télécharger des fichiers pour des catégories de produits spécifiques d'annonceurs au lieu de télécharger le fichier de produit complet. Cela signifie que si vous avez seulement besoin de produits dans la catégorie de produits électroniques, vous pouvez télécharger le flux pour cette catégorie uniquement.

Pour chaque annonceur qui vous a approuvé pour accéder à leur flux de Product Catalog, vous verrez un dossier. Le nom du dossier sera le MID de l'annonceur. Le dossier contiendra deux types de fichiers : Fichier de liste de catégories de produits et Fichier de Product Catalog spécifique à une catégorie ; cliquez sur le + pour plus d'informations sur chaque fichier :

Fichier de liste de catégories de produits

Il s'agit d'un fichier texte délimité par des barres verticales qui répertorie l'ID et le nom de la catégorie de produit tel que spécifié par l'annonceur. Les IDs de catégorie sont uniques à chaque annonceur et peuvent changer. Le fichier est nommé MID_category_list.txt, où MID est l'ID de l'annonceur. Chaque catégorie de produit est listée sur une ligne.

Exemple :
2385_category_list.txt
Contenu d'exemple :
10|Jardinage|525 lignes
11|Jouets|625 lignes
12|Outlet|1024 lignes
15|Électronique|23 lignes
Fichier de Product Catalog spécifique à une catégorie

Il s'agit d'un fichier de Product Catalog pour une catégorie de produit spécifique d'un annonceur. Ce fichier est nommé MID_SID_XX_cmp.txt.gz pour le format texte et MID_SID_XX_cmp.xml.gz pour le format XML. XX est l'ID numérique pour la catégorie de produit spécifique.

Exemple :

  • 2385_112_15_cmp.txt.gz
  • 2385_112_15_cmp.xml.gz

Basé sur la liste de catégories de produits ci-dessus, ces fichiers concernent la catégorie de produit électronique. Le contenu du fichier est formaté de manière identique aux fichiers complets de Product Catalog.

Nous vous suggérons de télécharger d'abord le fichier de catégorie de produit et de l'utiliser pour déterminer les catégories que vous souhaitez télécharger. Une fois que vous avez déterminé l'ID des catégories que vous souhaitez télécharger, vous devriez pouvoir créer un script qui téléchargera les fichiers pour ces catégories en remplaçant automatiquement le XX par l'ID de la catégorie de produit.

 Erreurs de catégorie

Les produits sont catégorisés par les annonceurs et il est possible qu'ils aient placé des produits dans les mauvaises catégories. Dans ces cas, contactez les annonceurs pour leur demander de mettre à jour leurs catégories.

Fichiers globaux et supplémentaires

Rakuten Advertising permet aux annonceurs de soumettre plusieurs fichiers par compte. Si un annonceur choisit de rendre disponible plus d'un fichier de Product Catalog, vous trouverez ces fichiers imbriqués sous un dossier « GLOBAL » ou un dossier « ADDITIONAL » dans le répertoire racine de votre compte SFTP. Les fichiers « Global » contiennent des produits dans une langue et/ou une devise différente du fichier de flux principal. Les fichiers « Additional » ont la même langue et devise que le fichier de flux principal. Cliquez sur le + pour des informations sur le téléchargement des fichiers globaux ou supplémentaires :

Fichiers globaux : conventions de nommage des répertoires et des fichiers
Vous devez suivre la structure de répertoire spécifiée et les conventions de nommage des fichiers pour parcourir et télécharger les flux globaux souhaités. Le répertoire GLOBAL contient des sous-répertoires pour chaque combinaison pays-langue-devise prise en charge. Dans chacun d'eux, vous trouverez des répertoires pour chaque MID ainsi que les fichiers de flux globaux en versions complètes et delta. Les sous-répertoires MID incluent des fichiers spécifiques à une catégorie en formats complets et delta pour cette combinaison spécifique pays-langue-devise, et un fichier texte de liste de catégories qui fournit la liste des catégories principales et des IDs de catégorie que vous pouvez utiliser pour déterminer quelles catégories sont dans chaque fichier. Voir Fichiers de catégorie ci-dessus pour plus d'informations sur les fichiers de catégorie.
root

GLOBAL (dossier)

FR-FR_EUR (dossier – langue-locale_devise)

12345 (dossier – le numéro ici est l'ID de l'annonceur, ou MID)

12345_678_mp_FR-FR_EUR.txt.gz

12345_678_mp_delta_FR-FR_EUR.txt.gz

FR-CA_CAD (dossier – langue-locale_devise)

12345 (dossier)

12345_678_mp_FR-CA_CAD.txt.gz

12345_678_mp_delta_FR-CA_CAD.txt.gz
Fichiers supplémentaires : conventions de nommage
Vous devez suivre la convention de nommage spécifiée pour parcourir et télécharger les flux supplémentaires souhaités. Le répertoire ADDITIONAL contient des sous-répertoires pour chaque MID fournissant un flux supplémentaire. Dans chacun d'eux, vous trouverez des répertoires pour chaque flux supplémentaire fourni. Dans ces sous-répertoires, vous trouverez les fichiers de flux supplémentaires en formats complets et delta pour ce flux supplémentaire spécifique. Les fichiers spécifiques à une catégorie ne sont pas disponibles pour les flux supplémentaires.
root

ADDITIONAL (dossier)

12345 (dossier – le numéro ici est l'ID de l'annonceur, ou MID)

2017Summer (dossier – nom du fichier supplémentaire, tel que spécifié par l'annonceur)

12345_678_mp_2017Summer.txt.gz

12345_678_mp_delta_2017Summer.txt.gz

Back2School (dossier – nom du fichier supplémentaire, tel que spécifié par l'annonceur)

12345_678_mp_Back2School.txt.gz

12345_678_mp_delta_Back2school.txt.gz

Téléchargement des fichiers de Product Catalog

Vous pouvez télécharger le fichier de Product Catalog depuis votre compte en utilisant n'importe quel logiciel client SFTP. Voir Premiers pas pour demander l'activation.

Exemple : get 2385_112_mp.txt.gz

 Conseil de réussite

Si vous téléchargez fréquemment des fichiers de Product Catalog, ou si vous travaillez avec un annonceur ayant un Product Catalog particulièrement volumineux, vous pouvez télécharger un fichier Delta qui inclut uniquement les nouveaux enregistrements de produits et les enregistrements modifiés de l'annonceur depuis leur dernier téléchargement. Ce fichier se télécharge plus rapidement que le fichier complet de Product Catalog. Voir Fichiers Delta pour plus d'informations.

Les fichiers de produits sont générés dynamiquement au moment de la récupération. Cela garantit que tous les publishers reçoivent les informations produit les plus récentes lorsqu'ils récupèrent les fichiers de Product Catalog des annonceurs. La rapidité des informations produit dépend de la fréquence à laquelle les annonceurs mettent à jour les informations dans leur base de données de Product Catalog.

 Note

Nos serveurs traitent les mises à jour de produits de l'annonceur peu de temps après le téléchargement. Le temps de traitement du fichier dépend de la taille du fichier. Les informations mises à jour sont disponibles pour les publishers immédiatement après la fin du traitement.

Premiers pas

Tous les publishers du Product Catalog doivent d'abord s'inscrire pour devenir membre de Rakuten Affiliate. Si votre entreprise ne l'a pas encore fait, inscrivez-vous en vous rendant sur https://rakutenadvertising.com/ et en cliquant sur Devenir un publisher. Une fois inscrit, vous recevrez un e-mail avec l'approbation de l'inscription et les informations de votre nouveau compte publisher, ainsi que votre ID du site.

Vous devrez ensuite suivre l'étape 1 pour obtenir l'accès FTP et l'étape 2 pour obtenir l'approbation des annonceurs pour utiliser leurs flux de Product Catalog, comme indiqué ci-dessous.

Étape 1 : Processus de configuration technique

Configuration SFTP

Le flux de Product Catalog est disponible pour vous via SFTP. Le nom d'hôte du serveur SFTP de Rakuten Affiliate est aftp.linksynergy.com.

Pour commencer, contactez l'assistance clientèle avec votre nom d'utilisateur Rakuten Affiliate et votre ID du site (SID). Lorsque vous soumettez votre demande pour le Product Catalog, ces étapes sont effectuées :

  • Nous établissons un compte SFTP unique sur nos serveurs à partir duquel vous pouvez télécharger des fichiers.
  • Un nom d'utilisateur et un mot de passe sont attribués au compte SFTP.

Dans un délai d'un jour ouvrable, un représentant de l'assistance clientèle répondra à votre demande avec votre nom d'utilisateur, votre mot de passe et l'URL de votre compte SFTP.

Accès SFTP

Vous pouvez accéder à votre compte SFTP en utilisant n'importe quel client SFTP. Vous pouvez également automatiser le processus de téléchargement du fichier ou le faire manuellement. Vous devez définir le mode de transfert sur binaire avant de commencer à télécharger des fichiers, car les fichiers sont stockés dans un format compressé. Utiliser le mode ASCII corrompra les données du fichier et le rendra inutilisable. Si vous utilisez un script pour automatiser le processus de téléchargement des fichiers, assurez-vous de ne pas ouvrir plus de cinq connexions au serveur SFTP en même temps.

Veuillez noter :

  • Utilisez toujours des connexions passives lorsque vous êtes connecté à aftp.linksynergy.com avec FTP simple.
  • Définissez toujours le mode sur binaire avant de télécharger des fichiers avec FTP simple.
  • Pas plus de cinq connexions simultanées ne sont autorisées par compte SFTP de publisher.
  • Les tailles de fichiers indiquées sont des estimations. Les tailles de fichiers réelles varieront. Par conséquent, il est conseillé de NE PAS utiliser la taille du fichier comme vérification pour garantir des téléchargements réussis. Les téléchargements doivent être considérés comme réussis si le fichier s'extrait correctement et se termine par un enregistrement de bande-annonce indiquant le nombre de produits dans le fichier.
  • Si vous utilisez un script pour récupérer les fichiers, Wget est préféré à cURL. Si vous utilisez cURL, vous devez utiliser l'option --ignore-content-length.
  • Bien que le FTP simple soit actuellement pris en charge, il est fortement recommandé d'utiliser SFTP à la place. Le support pour le FTP simple sera supprimé à l'avenir.

Contenu du compte SFTP

Dans le répertoire racine de votre compte SFTP, vous verrez des fichiers et un dossier pour chaque annonceur qui vous a approuvé pour accéder à leur flux de Product Catalog. Vous pouvez également voir des dossiers intitulés « GLOBAL » et « ADDITIONAL » si l'un de vos partenaires annonceurs a plus d'un flux de produits.

Les fichiers dans le répertoire racine sont vos fichiers de Product Catalog et les dossiers numérotés contiennent des fichiers qui vous fournissent des données de produits pour des catégories de produits individuelles. Le nom du dossier correspond au MID de l'annonceur et les fichiers sont disponibles en deux formats : texte délimité par des barres verticales et XML.

Vous pouvez sélectionner le format que vous préférez dans votre tableau de bord des publishers en suivant ces étapes :

  1. Allez dans Liens dans l'en-tête de navigation et cliquez sur Flux de produits.
  2. Faites défiler vers le bas jusqu'à Format de flux préféré pour faire votre sélection :
    Interface des paramètres de flux de produits avec l'option d'inscription automatique mise en évidence.

    Cliquez sur l'image pour une version plus grande.

Si vous ne sélectionnez pas de format, votre compte SFTP contiendra deux fichiers et un dossier pour chaque annonceur qui vous a approuvé pour accéder à leur flux de Product Catalog.

Étape 2 : Processus d'approbation du Product Catalog des annonceurs

Une fois que vous avez terminé la configuration technique du Product Catalog, vous devrez demander l'accès aux annonceurs participants avec lesquels vous êtes déjà partenaire.

Pour voir une liste de vos partenaires annonceurs qui offrent le Product Catalog dans votre tableau de bord des publishers, allez dans Liens dans l'en-tête de navigation et cliquez sur Flux de produits. Faites défiler vers le bas pour voir la liste et recherchez des annonceurs par nom. De là, vous pouvez demander l'accès, vous retirer de l'accès et voir le statut de votre demande :

Liste des noms d'annonceurs et des statuts de flux de produits.

Cliquez sur l'image pour une version plus grande.

Vous pouvez automatiquement demander l'approbation du Product Catalog lorsque vous postulez à un nouveau programme d'annonceur participant avec notre option d'inscription automatique. Vous pouvez activer ou désactiver l'inscription automatique dans la section Paramètres de flux de la page Flux de produits :

Interface des paramètres de flux de produits avec les options affichées.

Cliquez sur l'image pour une version plus grande.

Questions fréquentes

Mon script ne télécharge les fichiers que lorsque la date du fichier change. Cela fonctionnera-t-il avec le Product Catalog ?
Oui, vous devriez pouvoir utiliser le tampon de date du fichier dans le répertoire, qui indique l'heure de création en UTC, pour voir ce qui a été modifié et récupérer uniquement les éléments les plus récents.
Pourquoi ai-je plusieurs fichiers annonceur dans mon compte ?
Vous avez le choix entre un fichier texte délimité par des pipes et un fichier au format XML. Vous pouvez sélectionner votre format préféré dans votre tableau de bord des publishers, comme indiqué dans Contenu du compte SFTP ci-dessus. Si vous ne sélectionnez pas de format, votre compte SFTP contiendra des versions .txt et .xml de chaque type de fichier.
Quels sont les dossiers que je vois dans mon compte SFTP ?
Les dossiers de votre compte SFTP sont pour chaque annonceur dont vous êtes éligible à obtenir les fichiers Product Catalog. Les dossiers contiennent les fichiers Product Catalog spécifiques à chaque catégorie pour les annonceurs.
Dois-je être approuvé par chaque annonceur pour utiliser leur flux de données de produit Product Catalog ?
Oui, il y a deux niveaux d'approbation pour le Product Catalog. D'abord, vous recevez une approbation technique, puis vous avez besoin de l'approbation de l'annonceur. Vous devez demander l'approbation du Product Catalog lorsque vous postulez à un nouveau programme d'annonceur, ou la demander séparément auprès des partenaires annonceurs existants, comme détaillé dans Étape 2 ci-dessus.
Que dois-je faire si les données du Product Catalog d'un annonceur sont obsolètes ?
Il est préférable d'en informer directement l'annonceur. Vous pouvez trouver les coordonnées d'un annonceur dans votre tableau de bord des publishers : allez dans Annonceurs dans l'en-tête de navigation, cliquez sur Mes Annonceurs, puis cliquez sur l'annonceur concerné pour accéder à leur page de détails.
Si vous n'êtes pas sûr que ce qui vous préoccupe soit un problème de données obsolètes, contactez l'assistance clientèle.

Annexe A : Définitions des champs de fichier Product Catalog

Consultez l'Annexe A pour les définitions des champs.

Annexe B : Définitions des classes de fichiers d'attributs

Consultez l'Annexe B pour les définitions des classes de fichiers d'attributs.

Annexe C : Normes de formatage XML

Consultez l'Annexe C pour les normes de formatage XML.

Annexe D : Exemples d'enregistrements

Consultez l'Annexe D pour des exemples d'enregistrements d'un fichier délimité par des pipes et d'un fichier XML.

 

 

Ce site Web utilise l'IA pour les traductions, qui peuvent contenir des inexactitudes ou des erreurs. Nous ne sommes pas responsables des problèmes découlant de la confiance accordée au contenu traduit ; consultez la version originale en anglais pour des informations faisant autorité.

Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 0 sur 1

Commentaires

0 commentaire

Vous devez vous connecter pour laisser un commentaire.