Un flux de produits est un fichier qui contient votre catalogue de produits (tous vos produits, ainsi que leurs métadonnées). Il permet une personnalisation basée sur les affinités, des recommandations de produits, des messages de preuve sociale et plus encore.
Voici le framework pour créer et synchroniser votre flux de produits avec Dynamic Yield. La planification est essentielle du point de vue de votre activité, car les colonnes de flux déterminent les informations que vous pouvez utiliser pour personnaliser vos campagnes. Travaillez en collaboration avec votre équipe de développement pour créer le fichier de flux et déterminer comment et à quelle fréquence il doit être synchronisé.
Vous pouvez créer et synchroniser des flux de produits à l’aide de fichiers de données ou via une API.
Synchroniser votre flux de produits à l’aide d’un fichier de données
- Créez le fichier avec toutes les métadonnées de produit requises (par exemple, le prix ou le SKU).
- Synchronisez le fichier avec Experience OS au moyen de l’une des méthodes énumérées.
- Analysez le fichier source (facultatif). Utilisez du code JavaScript pour manipuler le fichier source afin de l’adapter au format requis par Experience OS (comme le fait de changer des noms d’attributs).
- Prévisualisez et enregistrez.
- Validez l’état de synchronisation.
Consultez nos meilleures pratiques de conception des flux de produits pour en tirer le meilleur parti
Étape 1 : créer le fichier
Pour les détails techniques, consultez notre Documentation pour les développeurs.
Avant de pouvoir transférer et synchroniser un flux de produits sur Experience OS, assurez-vous que votre fichier de flux est conforme aux exigences de taille, de format et de contenu.
| Taille du flux | Type de fichier |
| Jusqu’à 20 000 objets | CSV, JSON, XML |
| 20 000-200 000 | CSV, JSON |
| Plus de 200 000 | CSV |
Remarque : si votre flux comprend plus de 20 000 articles, contactez votre Technical Account Manager pour obtenir une aide avec la synchronisation (étapes 2 à 4). La taille totale du flux est plafonnée à 5 millions d’articles.
Le fichier peut être stocké dans une URL quelconque ou un dossier local, ou encore dans un bucket Amazon S3 que nous fournissons. Vous pouvez également transférer les flux vers Amazon S3 via SFTP. Si vous utilisez un fichier CSV, les articles doivent être séparés par des virgules. Reportez-vous à l’Étape 2 pour obtenir plus d’informations sur ces méthodes.
Structure du flux de produits
Le flux de produit doit inclure les informations de base sur votre produit (SKU, identifiant de groupe, prix, image, URL, en stock ou non, et ses catégories).
| Colonne (sensible à la casse) |
Description |
| sku | Identifiant unique du produit. Remarque : les SKU ne peuvent pas contenir d’espaces ou la chaîne // |
|
product_type Facultatif, mais fortement recommandé |
Le type d’élément : Offre, Produit ou Article Institutions financières uniquement. |
| group_id |
Identifie un groupe de produits dont certains attributs diffèrent. Remarque : si vous modifiez la structure d’identifiants du groupe ou la structure de catégorie entre les synchronisations, le flux pourrait se réinitialiser, entraînant la perte de toute les données de recommandation précédentes |
| name | Nom du produit |
| url | URL de la page de détails du produit (doit être valide, commençant par HTTP/HTTPS) |
| price | Prix du produit (doit être un nombre) |
| in_stock | Précise si le produit est en stock (indiqué par « true » [vrai] ou « false » [faux]) |
| image_url | L’URL de l’image du produit (doit être valide, commençant par HTTP/HTTPS) |
| categories | Les catégories associées au produit, en allant du plus général au plus spécifique |
|
keywords Facultatif, mais fortement recommandé |
Toute information supplémentaire décrivant le produit, séparée par des barres verticales. Ils sont utilisés pour nos algorithmes d’apprentissage automatique et d’affinité. Étant donné que cette colonne est facultative, les valeurs vides ne déclencheront pas d’erreurs ou d’avertissements. |
Si une valeur d’un produit ne figure pas dans une colonne obligatoire, celui-ci est ignoré. Si plus de 10 % des produits ont un champ vide dans l’une des colonnes, toute la synchronisation échouera.
Colonnes personnalisées
Vous pouvez également ajouter d’autres colonnes qui décrivent votre produit. Celles-ci peuvent être plus tard utilisées pour le ciblage (par exemple, ajouter « couleur » et cibler les utilisateurs qui ont acheté des articles bleus), les scores d’affinité (par exemple, inclure l’affinité de couleur dans l’algorithme de recommandation selon l’affinité), ou pour définir des règles de merchandising dans vos widgets de recommandation (par exemple, ne jamais recommander de produits d’une marque spécifique). Consultez notre Documentation pour les développeurs pour en savoir plus.
Prise en charge multilingue
Pour prendre en charge plusieurs langues, vous pouvez ajouter une colonne pour chaque version traduite d’une propriété que vous souhaitez inclure. En savoir plus sur la prise en charge multilingue dans votre section.
Étape 2 : créer ou synchroniser le fichier avec Experience OS
Accédez à Assets (Ressources) › Data Feeds (Flux de données) et créez un nouveau flux de produits.
Après avoir nommé le flux, vous pouvez sélectionner l’une des options de synchronisation suivantes :
- Sync a URL or upload a file (Synchroniser une URL ou transférer un fichier) : transférez un fichier de flux (jusqu’à 25 Mo) ou indiquez l’adresse URL où un fichier de flux est stocké. Si vous utilisez l’authentification HTTP, ajoutez le nom d’utilisateur et le mot de passe à l’URL du flux comme suit :http://user:password@url.
- Sync securely via Amazon S3 (Synchronisation sécurisée via Amazon S3)
- Sync securely via SFTP (Synchronisation sécurisée via SFTP)
Consultez notre Documentation pour les développeurs pour obtenir plus d’informations.
Fréquence de synchronisation
Par défaut, le flux se synchronise avec le fichier source toutes les 24 heures. Vous pouvez modifier ceci dans les Paramètres avancés si votre catalogue de produits est actualisé plus fréquemment. Si vous synchronisez le fichier via S3 ou SFTP, Experience OS vérifie le bucket à la recherche d’un nouveau fichier six fois par jour. Si vous venez de transférer votre fichier vers le bucket, vous pouvez cliquer sur Sync Now (Synchroniser maintenant) pour forcer la synchronisation initiale.
Étape 3 : analyser le fichier source (facultatif)
Si les colonnes et les valeurs de votre fichier de flux ne répondent pas aux exigences décrites à l’Étape 1, si vous souhaitez fusionner des fichiers, ou si une autre manipulation est nécessaire pour dupliquer, déplacer ou renommer les valeurs et les champs, vous pouvez modifier le flux à l’aide d’une fonction d’analyse syntaxique créée en JavaScript. Par exemple, les fichiers XML qui ne sont pas « plats » peuvent être « aplatis » à l’aide d’une fonction d’analyse syntaxique.
Remarque : cette option est disponible pour les flux de moins de 200 000 articles et qui sont inférieurs à 180 Mo.
Pour les détails techniques, consultez notre Documentation pour les développeurs.
Étape 4 : prévisualiser et enregistrer
Si votre source de flux est un fichier transféré ou une URL, vous pouvez afficher un aperçu d’un maximum de 100 entrées de votre flux, y compris les erreurs ou les avertissements en cliquant sur Preview (Aperçu). Cliquez sur Save and Activate (Enregistrer et activer) pour continuer ou sur Cancel (Annuler) pour revenir en arrière.
La durée de synchronisation dépend du nombre d’éléments de votre flux. Pour les flux dotés de 250 000 articles, cela prend généralement quelques minutes, et 30 minutes pour chaque tranche de 500 000 articles supplémentaires dans votre flux. Si vous avez besoin d’une synchronisation plus rapide, envisagez une mise à jour de votre flux par une API pour mettre à jour des modifications incrémentielles au lieu d’une mise à jour standard du flux complet.
Remarque : pour les flux contenant plus de 2 millions de produits, les produits sans événements associés sont filtrés hors de l’aperçu des flux de données. Les produits actifs sont ceux qui possèdent une ou plusieurs activités (vue du produit/ajout au panier/achat) au cours des six derniers mois. Ainsi, lorsque vous affichez le flux de produits dans l’aperçu, le nombre de produits au bas de la page est le nombre mis à jour avec ce filtre.
Étape 5 : valider l’état de synchronisation
Vous pouvez vérifier à tout moment que votre flux se synchronise correctement :
- Accédez à Assets (Ressources) › Data Feeds (Flux de données).
- Dans la colonne Last Sync Attempt (Dernière tentative de synchronisation), vous devriez voir une icône Date Feed Synced (Date de synchronisation du flux)
et une date récente. Si l’icône indique une erreur ou un avertissement, téléchargez le journal pour plus de détails.
- Dans la colonne Actions, cliquez sur l’icône View (Afficher)
. Vérifiez que toutes les colonnes requises et celles que vous avez ajoutées sont présentes et contiennent les bonnes données.
Facultatif : téléchargez les fichiers localement via le Terminal
Consultez notre Documentation pour les développeurs pour en savoir plus.
Synchroniser votre flux de produits via une API
Si vous avez un flux volumineux, vous pouvez utiliser une API pour mettre à jour uniquement les modifications dans votre flux (supprimer ou ajouter un article, modifier les propriétés d’un article, etc.), pour des mises à jour plus rapides.
Cette méthode nécessite un savoir-faire de développeur. Les détails se trouvent sur notre site Développeurs.
La synchronisation de votre catalogue de produits via une API avec Dynamic Yield comprend les étapes suivantes :
- Créer le flux de produits dans Experience OS. Voir la section suivante.
- Générer une clé API à inclure dans chaque appel d’API. Voir les détails pour les développeurs.
- Implémenter les appels d’API pour envoyer des données à Dynamic Yield. Voir les détails pour les développeurs.
Créer le flux de produits
- Accédez à Assets (Ressources) › Data Feeds (Flux de données) et créez un nouveau flux de produits.
- Pour la Feed Source (Source du flux), sélectionnez Sync via API (Synchroniser via une API).
- Ajoutez toutes les propriétés facultatives qui seront incluses dans chaque article du flux de produits en cliquant sur New Property (Nouvelle propriété). Celles-ci peuvent ensuite être utilisées pour le ciblage (par exemple, si vous ajoutez « couleur », vous pouvez l’utiliser pour cibler les utilisateurs qui ont acheté des articles bleus), le score d’affinité (par exemple, inclure l’affinité de couleur dans l’algorithme de recommandation par affinité), ou pour définir des règles de merchandising dans vos widgets de recommandation (par exemple, ne jamais recommander de produits d’une marque spécifique).
- Les valeurs de propriété personnalisées doivent être des chaînes, jusqu’à 1 000 caractères, sans aucun caractère spécial.
- Le nom des propriétés personnalisées ne doit pas commencer par « _id ».
- Après avoir ajouté une propriété personnalisée, vous ne pouvez pas la supprimer. Vous pouvez arrêter de l’utiliser ou renvoyer des valeurs vides, mais la propriété doit figurer dans chacun des futurs articles.
- Pour prendre en charge plusieurs langues, vous pouvez ajouter une propriété pour chaque version traduite d’une propriété que vous souhaitez inclure. En savoir plus sur la prise en charge multilingue dans votre section.
- Cliquez sur Save and Activate (Enregistrer et activer) pour terminer le processus.