Utilisez les flux pour que les entités soient importées dans Adobe Target Recommendations. Les entités peuvent être envoyées à l’aide de fichiers CSV, du format de flux de recherche de produit Google et des classifications de produits Adobe Analytics.
Présentation des flux concept_D1E9C7347C5D4583AA69B02E79607890
Les flux vous permettent de transférer Entités ou d’agrémenter vos données de mbox d’informations indisponibles sur la page ou dont l’envoi direct à partir de la page se révèle risqué, telles que les marges bénéficiaires, le coût des produits vendus, etc.
Les flux vous permettent de transmettre des informations détaillées sur l’élément dans Recommendations, telles que l’ID du produit, la catégorie, le nom, le message et d’autres attributs.
Vous pouvez sélectionner les colonnes de votre fichier de classifications de produits Target ou fichier de recherche de produits Google à envoyer au serveur Recommendations.
Ces éléments de données sur chaque élément peuvent ensuite être utilisés pour :
Afficher les valeurs dans les conceptions
Définition des règles d’inclusion de critères
Tri des éléments dans différentes collections
Appliquer les exclusions aux recommandations
Les descriptions d’élément peuvent être transmises à Target à l’aide de flux ou de mbox. Si des données sont collectées à la fois par un flux d’entité et une mbox, ce sont les plus récentes qui l’emportent. En règle générale, les données les plus récentes proviennent d’une mbox, dans la mesure où elles sont consultées plus souvent. Dans les rares cas où l’accès aux données de flux d’entité et de mbox survient au même moment, ce sont les données de cette dernière qui sont utilisées.
La liste Feeds ( Recommendations > Feeds) fournit des informations sur les flux que vous avez créés.
La page Feeds contient les colonnes suivantes :
Nom : nom du flux spécifié lors de la création. Pour modifier le nom d’un flux, vous devez modifier le flux lui-même. Lorsque vous enregistrez le flux avec le nouveau nom, il est actualisé.
Planification : affiche la planification de la mise à jour du flux : Daily, Weekly, Every 2 Weeks ou Never.
Éléments : affiche le nombre d’éléments dans le flux.
Dernière mise à jour : affiche la date et l’heure de la dernière mise à jour du flux et le nom de la personne qui l’a mis à jour. Si le flux Last Updated indique "non défini", il provient de Recommendations Classic et ne peut pas être modifié depuis Target Premium Recommendations.
Cliquez sur l’icône Informations pour afficher une carte qui affiche la date de dernier chargement et l’URL du flux.
Cliquez sur l’icône représentant des points de suspension pour accéder aux actions suivantes : Deactivate, Edit, Copy et Delete.
IMPORTANT
Les entités et attributs d’entité téléchargés expirent après 61 jours. Autrement dit :
Votre flux doit s’exécuter au moins une fois par mois pour s’assurer que le contenu de votre catalogue n’arrive pas à expiration.
La suppression d’un élément de votre fichier de flux ne le supprime pas de votre catalogue. Pour supprimer l’élément du catalogue, supprimez manuellement l’élément via l’interface utilisateur ou l’API Target. Vous pouvez également modifier les attributs d’élément (tels que l’inventaire) pour vous assurer que l’élément est exclu de la considération.
Types Source
Les entités peuvent être envoyées à l’aide de fichiers CSV, du format de flux de recherche de produit Google et des classifications de produits Adobe Analytics.
CSV section_65CC1148C7DD448FB213FDF499D35FCA
Vous pouvez créer un fichier .csv à l’aide du format de transfert CSV propriétaire Adobe. Le fichier contient des informations d’affichage sur les attributs personnalisés et réservés pour vos produits. Pour charger des attributs spécifiques à votre mise en œuvre, remplacez CustomN sur la ligne d’en-tête par le nom de l’attribut que vous souhaitez utiliser. Dans l’exemple ci-dessous, entity.Custom1 a été remplacé par : entity.availability. Vous pouvez ensuite charger le fichier par lot sur le serveur Recommendations.
L’utilisation du format .csv présente les avantages suivants sur le format Google Feed :
Le format .csv ne nécessite pas de mappages de champ.
Le format .csv prend en charge les attributs à plusieurs valeurs (voir l’exemple ci-dessous).
Le format .csv prend en charge jusqu’à 100 attributs personnalisés. Si vous avez besoin de plus de 100 attributs personnalisés, vous pouvez créer un deuxième fichier de flux comportant un ensemble différent d’attributs personnalisés spécifiés.
Utilisez la méthode de chargement en masse pour envoyer des informations d’affichage si votre page ne contient pas de mbox ou si vous souhaitez compléter vos informations d’affichage par des éléments qui ne sont pas disponibles sur votre site. Par exemple, vous pouvez envoyer au module les informations du stock qui ne sont pas publiées sur votre site.
Toutes les données chargées à l’aide du fichier .csv, du flux de produit Google ou du flux de classification de produit Analytics remplacent la valeur d’attribut d’entité existante dans la base de données. Si vous envoyez des informations de prix via des requêtes de mbox et que vous envoyez ensuite des valeurs de prix différentes dans le fichier, les valeurs du fichier remplacent les valeurs définies avec la requête de mbox. Une exception à cette règle est l’attribut d’entité categoryId où les valeurs de catégorie sont ajoutées au lieu d’être remplacées jusqu’à une limite de 250 caractères.
IMPORTANT
Dans votre fichier .csv, ne placez pas les valeurs entre guillemets doubles ( " ), sauf si cela est intentionnel. Si vous placez des valeurs entre guillemets doubles, vous devez les placer dans une séquence d’échappement en les plaçant entre un autre jeu de guillemets doubles. Si les guillemets doubles ne sont pas précédés d’un caractère d’échappement, le flux de recommandations ne se charge pas correctement.
Par exemple, la syntaxe suivante est incorrecte :
"Apples "Bananas" Grapes"",
La syntaxe suivante est correcte :
"Apples ""Bananas"" Grapes""",
NOTE
Vous ne pouvez pas remplacer une valeur existante par une valeur vierge. Transmettez une autre valeur à sa place pour la remplacer. Dans le cas d’un prix de vente, une solution courante consiste à transmettre un "NULL" réel ou un autre message. Vous pouvez alors écrire une règle de modèle afin d’exclure des éléments comportant cette valeur.
Le produit est disponible dans l’interface d’administration environ deux heures après le chargement de son entité.
Voici un exemple de code pour un fichier .csv :
## RECSRecommendations Upload File
## RECS''## RECS'' indicates a Recommendations pre-process header. Please do not remove these lines.
## RECS
## RECSUse this file to upload product display information to Recommendations. Each product has its own row. Each line must contain 19 values and if not all are filled a space should be left.
## RECSThe last 100 columns (entity.custom1 - entity.custom100) are custom. The name 'customN' can be replaced with a custom name such as 'onSale' or 'brand'.
## RECSIf the products already exist in Recommendations then changes uploaded here will override the data in Recommendations. Any new attributes entered here will be added to the product''s entry in Recommendations.
## RECSentity.id,entity.name,entity.categoryId,entity.message,entity.thumbnailUrl,entity.value,entity.pageUrl,entity.inventory,entity.margin,entity.last_updated_by,entity.multi_english,entity.availability,entity.tax_country,entity.tax_region,entity.tax_rate,entity.product_type,entity.item_group_id,entity.color,entity.size,entity.brand,entity.gtin
na3456,RipCurl Watch with Titanium Dial,Watches & Sport,Cutting edge titanium with round case,https://example.com/s7/na3456_Viewer,425,https://example.com/shop/en-us/na3456_RipCurl,24,0.25,csv,"[""New"",""Web"",""Sales"",""[1,2,34,5]""]",in stock,US,CA,9.25,Shop by Category > Watches,dz1,Titanium,44mm,RipCurl,"075380 01050 5"
na3457,RipCurl Watch with Black Dial,Watches & Sport,Cutting edge matte black with round case,https://example.com/s7/na3457_Viewer,275,https://example.com/shop/en-us/na3457_RipCurl,24,0.27,csv,"[""New"",""Web"",""Sales"",""[1,2,34,5]""]",in stock,US,CA,9.25,Shop by Category > Watches,dz1,Black,44mm,RipCurl,"075340 01060 7"
Google section_8EFA98B5BC064140B3F74534AA93AFFF
Le type de flux de recherche de produit Google utilise le format Google. Celui-ci diffère du format de chargement CSV propriétaire Adobe.
Si vous possédez un flux de produits Google existant, vous pouvez l’utiliser comme fichier d’importation.
NOTE
L’utilisation des données Google n’est pas obligatoire. Recommendations utilise le même format que Google. Vous pouvez utiliser cette méthode pour envoyer les données dont vous disposez et utiliser les fonctions de planification disponibles. Vous pouvez cependant conserver les noms d’attribut Google prédéfinis lors de la configuration du fichier.
La plupart des détaillants transfèrent des produits vers Google. Ainsi, lorsqu’un visiteur utilise la recherche de produits Google, ses produits s’affichent. Recommendations applique exactement la spécification pour les flux d’entité. Les flux d’entité peuvent être envoyés à Recommendations par .xml, .txt ou .tsv et peuvent utiliser les attributs définis par Google. Les résultats autorisent la recherche dans les pages de magasinage de Google.
NOTE
La méthode POST doit être autorisée sur le serveur qui héberge le contenu du flux Google.
Comme les utilisateurs de Recommendations configurent déjà des flux .xml ou .txt à envoyer à Google par URL ou FTP, les flux d’entité acceptent ces données de produit et les utilisent pour créer le catalogue de recommandations. Indiquez où ce flux existe et où le serveur de Recommandations récupère les données.
Si vous utilisez Google Product Search pour le chargement du flux d’entité, vous devez toujours disposer d’une mbox de page de produit sur la page si vous souhaitez y afficher des recommandations ou effectuer le suivi des consultations de produit pour la diffusion de l’algorithme en fonction des vues.
Les flux Google ne prennent pas en charge plusieurs valeurs pour un attribut personnalisé.
Le flux s’exécute au moment où vous l’enregistrez et l’activez. Il s’exécute au moment où vous enregistrez le flux, puis tous les jours une heure plus tard.
Voici un exemple de code pour un fichier .xml de flux Google Shopping :
Voici un exemple de code pour un fichier .tsv de flux Google Shopping :
id title description link price condition availability image_link tax shipping_weight shipping google_product_category product_type item_group_id color size gender age_group pattern brand gtin mpn
na3454 RipCurl Watch with Titanium Dial Cutting edge titanium with round case https://example.com/shop/en-us/na3454_RipCurl 425 new in stock https://example.com/s7/na3452_Viewer US:CA:9.25:y 1.5 oz US:::0.00 USD Watches & Sport Shop by Category > Watches dz1 Black 44mm male adult Solid RipCurl 075380 01050 5 DZ1437
na3455 RipCurl Watch with Black Dial Cutting edge matte black with round case https://example.com/shop/en-us/na3455_RipCurl 275 new in stock https://example.com/s7/na3452_Viewer US:CA:9.25:y 1.5 oz US:::0.00 USD Watches & Sport Shop by Category > Watches dz1 Black 44mm male adult Solid RipCurl 075340 01060 7 DZ1446
Analytics Classifications de produits section_79E430D2C75443BEBC9AA0916A337E0A
La classification de produit Analytics est la seule disponible pour les recommandations. Pour plus d’informations sur ce fichier de classification, voir À propos des classifications dans le guide Composants Analytics. Il est possible que toutes les informations dont vous avez besoin pour les recommandations ne soient pas disponibles dans votre mise en oeuvre actuelle. Vous pouvez donc suivre ce guide d’utilisation si vous souhaitez ajouter des informations à votre fichier de classifications.
IMPORTANT
Avant d’importer des données d’entité dans Recommendations en utilisant les classifications de produits Analytics, sachez qu’il ne s’agit pas de la méthode préconisée.
Tenez compte des restrictions suivantes :
Les mises à jour des attributs d’entité exigent un délai supplémentaire de 24 heures.
Target prend uniquement en charge Product Classifications. Le SKU du produit Analytics doit correspondre au même niveau que le Recommendations entity.id. Les classifications personnalisées Analytics peuvent être conçues à l’aide de Adobe Consulting Services. Contactez votre gestionnaire de compte pour toute question.
Création d’un flux steps
Créez un flux pour insérer des informations sur vos produits ou services dans les Recommendations.
Dans l’interface de Target, cliquez sur Recommendations > Feeds > Create Feed.
(Conditionnel) Si vous avez sélectionné CSV ou Google Product Feed, spécifiez l’emplacement d’accès au flux.
FTP : si vous sélectionnez FTP, fournissez les informations du serveur FTP, les informations d’identification de connexion, le nom du fichier et le répertoire FTP. Pour des téléchargements plus sécurisés, vous pouvez utiliser le protocole FTP avec SSL (FTPS).
Paramètres du serveur FTP pris en charge :
FTP et FTPS doivent être configurés pour utiliser le FTP passif.
Pour FTPS, configurez le serveur pour accepter les connexions FTPS explicites.
SFTP n’est pas pris en charge.
Vous pouvez spécifier manuellement un port sur lequel lancer la connexion (par exemple, ftp://ftp.yoursite.com:2121). Si vous n’indiquez pas de port, le port FTP ou FTPS par défaut est utilisé.
URL : si vous sélectionnez URL, spécifiez l’URL.
(Conditionnel) Si vous avez sélectionné Analytics Classifications, choisissez la suite de rapports dans la liste déroulante.
Cliquez sur la flèche Next pour afficher les options Schedule.
Choisissez une option de mise à jour :
Daily
Weekly
Every 2 Weeks
Never : ne planifiez pas de mise à jour. Sélectionnez cette option si vous voulez empêcher l’exécution de ce flux.
Indiquez l’heure d’exécution de votre flux.
Cette option se base sur le fuseau horaire utilisé par votre navigateur. Si vous voulez utiliser l’heure d’un fuseau horaire différent, vous devez calculer cette heure selon votre fuseau horaire.
Cliquez sur la flèche Next pour afficher les options Mapping, puis spécifiez la manière dont vous souhaitez mapper vos données aux définitions Target.
(Facultatif) Si vous souhaitez que les flux appartiennent à un environnement (un groupe d’hôtes), sélectionnez le groupe d’hôtes en question.
Par défaut, le flux appartient à tous les groupes d’hôtes. Cela garantit que les éléments du flux sont disponibles dans tous les environnements. Pour plus d’informations, voir Hôtes.
Cliquez sur Save.
Une fois que vous avez créé ou modifié un flux, celui-ci s’exécute immédiatement. Le flux est ensuite mis à jour en fonction des paramètres que vous avez définis. Il faut un certain temps pour que l'information soit disponible. Le flux doit tout d’abord être synchronisé, puis traité et indexé pour pouvoir être publié et rendu disponible. L’état actuel s’affiche sous État du flux dans la liste des flux. Vous pouvez fermer Target avant que le processus soit terminé et ce dernier se poursuit.
Lorsque l’indexation est en cours, les produits et les en-têtes du flux apparaissent avant que les valeurs individuelles aient été indexées. Vous pouvez ainsi rechercher et afficher des produits afin de créer des collections, des exclusions, des conceptions et des activités avant que l’indexation ne soit terminée.
Lorsque l’état indique « Succès », cela signifie que le fichier a été trouvé et analysé correctement. Les informations ne sont pas disponibles pour une utilisation dans les Recommendations tant que le fichier n’a pas été indexé, ce qui peut prendre du temps, selon la taille du fichier. Si le processus échoue, cela signifie que le fichier est introuvable. Par exemple, vous avez utilisé une URL incorrecte ou vos informations FTP étaient incorrectes ou une erreur d’analyse s’est produite.
États de flux et indicateurs concept_E475986720D1400999868B3DFD14A7A0
Information à propos des états possibles des flux et leurs indicateurs.
États du flux status
Un flux peut avoir les états suivants :
État
Description
Syncing
Les détails de configuration du flux sont enregistrés dans Target.
Sync Failed
Les détails de configuration du flux n’ont pas pu être enregistrés dans Target. Essayez à nouveau.
No Feed Run
Vous avez créé un flux, mais il n’a pas été planifié (la fréquence est définie sur Jamais).
Planifié à date et heure
Le flux n’a pas été exécuté, mais il doit s’exécuter à la date et à l’heure spécifiées.
Waiting for Download
Target se prépare à télécharger le fichier de flux.
Downloading Feed File
Target télécharge le fichier de flux.
Importing Items
Target importe des éléments du fichier de flux.
Flux importé avec succès à l’heure
Target a importé le fichier de flux dans son système de diffusion de contenu. Des modifications ont été apportées aux attributs d’élément dans le système de diffusion de contenu et seront bientôt répercutées dans les recommandations fournies. Si vous ne voyez pas les modifications attendues, réessayez et actualisez la page contenant les recommandations. Remarques :
Si des modifications apportées aux attributs d’un élément entraînent l’exclusion d’un élément des recommandations, l’exclusion est immédiatement répercutée. Si un élément est récemment ajouté ou si des modifications apportées aux attributs entraînent l’exclusion d’un élément plus des recommandations, elles ne sont pas répercutées avant la prochaine mise à jour de l’algorithme, qui se produit dans les 24 heures.
Lorsque cet état s’affiche, les mises à jour ne sont peut-être pas encore répercutées dans l’interface utilisateur de Catalog Search. Un état distinct est répertorié dans Catalog Search indiquant la dernière fois que le catalogue indexable a été mis à jour.
Failed to Index
L’opération d’index a échoué. Essayez à nouveau.
Server Not Found
Les destinations FTP ou URL sont incorrectes ou inaccessibles.
Pour mettre à jour un flux (par exemple, pour apporter des modifications à la configuration ou au fichier de flux), ouvrez le flux, apportez les modifications souhaitées, puis cliquez sur Save.
IMPORTANT
Le délai d’expiration des entités téléchargées est de 61 jours. Cela signifie que votre fichier de flux doit être téléchargé au moins tous les 60 jours pour éviter toute interruption de vos activités de recommandations. Si un élément n’est pas inclus dans un fichier de flux (ou une autre méthode de mise à jour d’entité) au moins une fois tous les 60 jours, Target en déduit que l’élément n’est plus pertinent et le supprime du catalogue.
Indicateurs de l’état du flux section_3C8A236C5CB84C769A9E9E36B8BFABA4
Les indicateurs d’état du flux suivants s’affichent dans la colonne Status :
Indicateur d’état
Description
Indicateur d’état vert
Une fois l’indexation du flux terminée, celui-ci est marqué d’un point vert pour indiquer que son état est Succès.
Indicateur d’état jaune
Lorsqu’un index de flux ou un flux est retardé de 25 % par rapport à la fréquence du flux, un point d’état jaune s’affiche. Par exemple, un point jaune s’affiche pour un flux défini pour s’exécuter tous les jours si l’index n’est pas terminé six heures après l’heure planifiée. Remarque : Une fois que l’état du flux est "En attente de la file d’attente d’index", les valeurs nouvellement mises à jour sont disponibles dans le traitement des diffusions et des critères.
Indicateur d’état blanc
Lorsqu’un flux n’est pas planifié, un point d’état blanc indique que le flux n’a pas encore été exécuté.
Indicateur d’état rouge
Si le flux ne parvient pas à transférer les données vers le serveur, un indicateur d’état rouge s’affiche.
Prenons les exemples suivants :
Exemple 1 :
Jour 1 : le flux quotidien se traite à 9h00 (heure du Pacifique).
2e jour : il est 15 h 30 et le flux n’a pas été exécuté depuis hier à 9 h 00.
L’état doit être jaune car l’index aurait dû s’exécuter il y a environ 6,5 heures. 6,5 heures +24 = 127 % de l’intervalle d’exécution du flux.
Exemple 2 :
1er janvier : le flux mensuel se traite à 9 heures (heure du Pacifique).
3 février : il est 10h00 et le flux ne s’est pas exécuté il y a un mois, un jour et une heure.
L’état doit être jaune car l’index aurait dû s’exécuter il y a environ un jour et une heure. Même si cela représente seulement (31+(1/25))/30 = 1,03 % du paramètre de fréquence, le délai d’un jour maximum a été dépassé.
Vidéos de formation
Les vidéos suivantes contiennent davantage d’informations sur les concepts abordés dans cet article.
