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 :
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>
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.
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 :
- Lien tel qu'il apparaît dans le flux XML :
-
<product>http://click.linksynergy.com/link?id=xxxxxxxxxxx&offerid=90431.10000046&murl=http%3A%2F%2Fwww.examplemerchant.com%2Fa%2Fproducts%2F678262</product>
- Lien avec & encodé et prêt à être utilisé :
-
http://click.linksynergy.com/link?id=xxxxxxxxxxx&offerid=90431.10000046&murl=http%3A%2F%2Fwww.examplemerchant.com%2Fa%2Fproducts%2F678262
- De plus, les balises pour les champs non utilisés ne sont pas incluses dans les fichiers XML.
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.
- 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.
- 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.
- 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 :
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 :
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
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 :
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
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 :
- Allez dans Liens dans l'en-tête de navigation et cliquez sur Flux de produits.
- Faites défiler vers le bas jusqu'à Format de flux préféré pour faire votre sélection :
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 :
|
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 :
|
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é. |
Commentaires
Vous devez vous connecter pour laisser un commentaire.