Premium

Flux

Dernière mise à jour : 2023-09-29

Utilisation de 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 Adobe Analytics classifications de produits.

Présentation des flux

Les flux vous permettent de transmettre Entités ou augmentez vos données de mbox avec des informations indisponibles sur la page ou dont l’envoi direct à partir de la page est 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 les éléments dans Recommendations, comme 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 Google Shopping à envoyer au serveur de 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 utilisation 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 variable Flux list ( Recommendations > Flux) fournit des informations sur les flux que vous avez créés.

Page Flux

La variable Flux La page 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é.
  • Type : les types comprennent CSV, Flux de produits Google et Classifications Analytics.
  • État : état actuel du flux.
  • Planification: affiche le planning de mise à jour du flux : Qualité, Hebdomadaire, Every 2 Weeks, ou Jamais.
  • É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 Dernière mise à jour 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 : Désactiver, Edit, Copier, et Supprimer.

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-le manuellement via l’option Target Interface utilisateur ou API. 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 de source

Les entités peuvent être envoyées à l’aide de fichiers CSV, du format de flux de recherche de produit Google et Adobe Analytics classifications de produits.

CSV

Vous pouvez créer un fichier .csv à l’aide de la variable Adobe format de chargement CSV propriétaire. 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 produits Google ou Analytics Le flux de classification de produit remplace 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""",
REMARQUE

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

Le type de flux de recherche de produit Google utilise le format Google. Différent de la fonction Adobe format de chargement CSV propriétaire.

Si vous possédez un flux de produits Google existant, vous pouvez l’utiliser comme fichier d’importation.

REMARQUE

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 via .xml, .txt ou .tsv, et peut utiliser la variable Attributs définis par Google. Les résultats autorisent la recherche dans les pages de magasinage de Google.

REMARQUE

La méthode POST doit être autorisée sur le serveur qui héberge le contenu du flux Google.

Parce que Recommendations les utilisateurs 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 :

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<feed xmlns="https://www.w3.org/2005/Atom" xmlns:ns2="https://base.google.com/ns/1.0" xmlns:ns3="https://base.google.com/cns/1.0">
    <title>Product Feed</title>
    <link href="https://example.com"/>
    <updated>2017-12-13T08:45:04.918-08:00</updated>
    <author>
        <name>Product Feed Author</name>
    </author>
    <id>https://example.com</id>
    <entry>
        <title>RipCurl Watch with Titanium Dial</title>
        <description>Cutting edge Titanium with Round case</description>
        <ns2:id>na3452</ns2:id>
        <ns2:link>https://example.com/shop/en-us/na3452_RipCurl</ns2:link>
        <ns2:availability>in stock</ns2:availability>
        <ns2:condition>NEW</ns2:condition>
        <ns2:google_product_category>Watches &amp; Sport</ns2:google_product_category>
        <ns2:gtin>075380 01050 5</ns2:gtin>
        <ns2:image_link>https://example.com/s7/na3452_Viewer</ns2:image_link>
        <ns2:mobile_link>https://m.example.com/s7/na3452_Viewer</ns2:mobile_link>
        <ns2:mpn>71050</ns2:mpn>
        <ns2:price>425</ns2:price>
        <ns2:product_review_average>5.0</ns2:product_review_average>
        <ns2:product_review_count>30</ns2:product_review_count>
        <ns2:product_type>Shop by Category > Watches </ns2:product_type>
        <ns2:brand>RipCurl</ns2:brand>
        <ns2:sale_price>375</ns2:sale_price>
        <ns2:tax>
          <ns2:country>US</ns2:country>
          <ns2:region>CA</ns2:region>
          <ns2:rate>9.25</ns2:rate>
          <ns2:tax_ship>y</ns2:tax_ship>
        </ns2:tax>
        <ns2:is_bundle>N</ns2:is_bundle>
    </entry>
    <entry>
        <title>RipCurl Watch with Black Dial</title>
        <description>Cutting edge matte black with Round case</description>
        <ns2:id>na3453</ns2:id>
        <ns2:link>https://example.com/shop/en-us/na3453_RipCurl</ns2:link>
        <ns2:availability>in stock</ns2:availability>
        <ns2:condition>NEW</ns2:condition>
        <ns2:google_product_category>Watches &amp; Sport</ns2:google_product_category>
        <ns2:gtin>075380 013450 5</ns2:gtin>
        <ns2:image_link>https://example.com/s7/na3453_Viewer</ns2:image_link>
        <ns2:mobile_link>https://m.example.com/s7/na3453_Viewer</ns2:mobile_link>
        <ns2:mpn>71050</ns2:mpn>
        <ns2:price>275</ns2:price>
        <ns2:product_review_average>4.8</ns2:product_review_average>
        <ns2:product_review_count>23</ns2:product_review_count>
        <ns2:product_type>Shop by Category > Watches </ns2:product_type>
        <ns2:brand>RipCurl</ns2:brand>
        <ns2:sale_price>249</ns2:sale_price>
        <ns2:tax>
          <ns2:country>US</ns2:country>
          <ns2:region>CA</ns2:region>
          <ns2:rate>9.25</ns2:rate>
          <ns2:tax_ship>y</ns2:tax_ship>
        </ns2:tax>
        <ns2:is_bundle>N</ns2:is_bundle>
    </entry>
</feed>

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 des produits

La variable Analytics La classification de produit est la seule disponible pour les recommandations. Pour plus d’informations sur ce fichier de classification, voir À propos des classifications dans le Composants Analytics guide. 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 using Analytics classifications de produits, 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 Classifications des produits uniquement. La variable Analytics le SKU du produit doit correspondre au même niveau que le Recommendations entity.id. Personnalisé Analytics Les classifications peuvent être conçues à l’aide de Services de conseil en Adobe. Contactez votre gestionnaire de compte pour toute question.

Création d’un flux

Créez un flux pour insérer des informations sur vos produits ou services dans les Recommendations.

  1. Depuis l’interface Target, cliquez sur Recommandations > Flux > Créer un flux.

    Boîte de dialogue Créer un flux

  2. Entrez un nom explicite pour votre flux.

  3. Sélectionnez un Type de source.

    • CSV
    • Flux de produits Google
    • Classifications Analytics

    Pour plus d’informations sur la variable CSV et Flux de produit Google types de flux, voir Présentation des flux. Vous pouvez également téléchargement d’un guide de modèle CSV pour vous aider à formater correctement le flux.

  4. (Conditionnel) Si vous avez sélectionné CSV ou Flux de produits Google, indiquez l’emplacement d’accès du 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.

  5. (Conditionnel) Si vous avez sélectionné Classifications Analytics, choisissez la suite de rapports dans la liste déroulante.

  6. Cliquez sur la flèche Suivant pour afficher les options de Planification.

    Résultat d’étape

  7. Choisissez une option de mise à jour :

    • Quotidien
    • Hebdomadaire
    • Toutes les 2 semaines
    • Jamais: ne planifiez pas de mise à jour. Sélectionnez cette option si vous voulez empêcher l’exécution de ce flux.
  8. 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.

  9. Cliquez sur la flèche Suivant pour afficher les options de Mapping, puis indiquez la manière dont vous souhaitez mapper vos données aux définitions Target.

    Résultat d’étape

  10. (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.

  11. Cliquez sur Enregistrer.

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

Information à propos des états possibles des flux et leurs indicateurs.

États du flux

Un flux peut avoir les états suivants :

État Description
Synchronisation Les informations de configuration du flux sont enregistrées dans Target.
Échec de la synchronisation Les détails de configuration du flux n’ont pas pu être enregistrés dans Target. Réessayer.
Aucune exécution de flux 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.
En attente de téléchargement Target se prépare à télécharger le fichier de flux.
Téléchargement du fichier de flux Target télécharge le fichier de flux.
Importation d’éléments Target importe des éléments à partir 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’ajout d’un élément. ne plus exclue des recommandations, elle n’est pas prise en compte 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 pas encore répercutées dans la variable Recherche catalogue Interface utilisateur. Un état distinct est répertorié dans Recherche catalogue indiquant la dernière fois que le catalogue indexable a été mis à jour.
Échec de l’indexation L’opération d’index a échoué. Réessayer.
Serveur introuvable 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 du flux), ouvrez le flux, apportez les modifications souhaitées, puis cliquez sur Enregistrer.

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 des entités) au moins une fois tous les 60 jours, Target déduit que l’élément n’est plus pertinent et le supprime du catalogue.

Indicateurs de l’état du flux

Les indicateurs de l’état du flux suivants s’affichent dans la colonne État :

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’indexation », 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 :

  • 1er jour : traitement du flux quotidien à 9 h 00 (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 : traitement du flux mensuel à 9 h 00 (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.

Présentation des flux dans Recommendations (3:01) Badge de présentation

Cette vidéo traite des sujets suivants :

  • Comprendre l’objectif des flux
  • Comprendre la valeur des flux

Créer un flux (6:44) Badge de tutoriel

Cette vidéo traite des sujets suivants :

  • Configurer un flux
  • Déterminer le type de flux à utiliser

Sur cette page