Flux de Contenu

Un flux de contenu est un fichier qui contient le catalogue de contenus de votre site multimédia (tous vos articles, avec leurs métadonnées). Il alimente les recommandations de contenu, le ciblage comportemental basé sur les propriétés des articles, et plus encore.

Vous ne pouvez avoir qu’un seul flux de contenu pour chaque site multimédia Dynamic Yield. Suivez les étapes suivantes pour créer, transférer et synchroniser un flux de contenu vers Dynamic Yield. 

Création d’un fichier de flux de contenu

Avant de pouvoir transférer et synchroniser un flux de contenu vers Dynamic Yield, vous devez vous assurer qu’il est conforme aux exigences de taille, de format et de contenu.

Les flux de contenu peuvent être au format CSV, JSON ou XML. Cependant, si le flux contient plus de 200 000 articles, il doit être au format CSV. Il peut être stocké dans n’importe quelle URL ou n’importe quel dossier local.

Structure du flux de contenu

Le flux de produit doit inclure les informations de base sur vos articles (identifiant, titre, URL, heure de publication, type de publication et ses catégories). Vous trouverez la liste des attributs obligatoires dans le tableau suivant, avec des instructions détaillées (format, limitations, etc.) :

Colonnes personnalisées

Vous pouvez également ajouter au flux d’autres colonnes qui décrivent vos articles. Celles-ci peuvent ensuite être utilisées pour le ciblage (par exemple, si vous ajoutez « sujet », vous pouvez l’utiliser pour cibler les utilisateurs qui aiment lire sur un sujet particulier, comme le basketball), le score d’affinité (par exemple, inclure l’affinité du sujet dans l’algorithme de recommandation selon l’affinité), ou définir différentes valeurs pour différentes locales (par exemple, afficher un nom traduit pour les clients qui visitent le site depuis la France).

Directives :

• Les valeurs des colonnes personnalisées doivent être des chaînes, jusqu’à 1 000 caractères, sans caractères spéciaux.
• Les noms des colonnes personnalisées ne peuvent pas commencer par ’_id’.
• Vous ne pouvez pas avoir un nom de colonne personnalisée incluant ’sku’. Si vous incluez une colonne avec ce mot, le flux est considéré comme invalide.
• Après avoir ajouté une colonne, vous ne pouvez pas la supprimer. Vous pouvez arrêter de l’utiliser ou renvoyer des valeurs vides, mais la colonne doit être incluse dans toute synchronisation future. 

Prise en charge multilingue

Pour les détails techniques, consultez Prise en charge multilingue dans notre Documentation pour les développeurs.

Pour prendre en charge plusieurs langues, vous pouvez spécifier différentes valeurs pour différentes langues pour n’importe quel champ. Utilisez le format “lng:<code de langue>:<nom de colonne>”: “<value>”. Par exemple, si vous souhaitez avoir une traduction pour un nom de produit, vous devez créer deux lignes pour le produit comme suit :

"lng:en_EN:name":"Blanc Pantalons"
"lng:de_DE:name":"blanc Pantalons"

Le code de langue doit correspondre au nom que vous utilisez dans le contexte de la page. Pour plus de détails, consultez l’article Contexte de la page. Le code de langue peut comprendre jusqu’à deux symboles (_) ou (-) entre les valeurs. Par exemple : "lng:en_EN_X".

Puisque ces colonnes sont facultatives, les valeurs vides ne déclenchent pas d’erreurs ou d’avertissements.

*Vous pouvez créer jusqu’à 300 colonnes lorsque vous travaillez dans plusieurs langues (y compris toutes les colonnes obligatoires, personnalisées et traduites).

Pour savoir comment cibler les campagnes en fonction de la locale de l’utilisateur (à l’aide de l’attribut "lng"), consultez l’article Prise en charge multilingue.

Synchronisation d’un flux de contenu

1. Si votre fichier de flux contient plus de 20 000 articles, contactez votre Customer Success Manager pour activer le transfert de votre flux.
2. Allez dans Assets (Ressources) › Data Feeds (Flux de données). Notez que vous ne pouvez créer qu’un seul flux de contenu pour chaque compte.
3. Si vous n’avez pas de flux de données, commencez ici et cliquez sur New Feed (Nouveau flux) :
   
   Puis sélectionnez Content Feed (Flux de contenu) :
   
   Si vous avez déjà d’autres flux, sur la page Data Feeds (Flux de données), cliquez sur Create New (Créer un nouveau), puis sélectionnez Content Feed (Flux de contenu) dans la liste déroulante.
4. Spécifiez un nom de flux et ajoutez des notes ou des étiquettes si vous le souhaitez.
5. Spécifiez la source du flux en transférant le fichier de flux ou en spécifiant une URL pointant vers un emplacement où le fichier 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://nomdutilisateur:motdepasse@url.

   Vous pouvez combiner plusieurs fichiers ou sources en un seul flux. Cliquez sur Add Another Source (Ajouter une autre source) pour spécifier plus d’un fichier. 

   

   Vous pouvez utiliser une fonction d’analyse syntaxique pour contrôler la façon dont deux fichiers sont fusionnés, comme le montre l’exemple suivant :

   function parse(feed1, feed2) {
     var combinedFeeds =  feed1.concat(feed2);
     return combinedFeeds;
   } 

6. Vous pouvez spécifier la fréquence à laquelle le fichier est synchronisé avec Dynamic Yield en développant les Advanced Settings (Paramètres avancés). Plus le flux est volumineux, moins vous êtes autorisé à le synchroniser.    
   
   Vous pouvez également utiliser une API pour mettre à jour le flux à la demande. Cette option vous permet d’ajouter, de supprimer ou de modifier des lignes ou des valeurs entières dans votre flux de données et de le synchroniser plus rapidement avec Dynamic Yield. Toutefois, cette méthode nécessite une configuration avancée et une assistance technique. Pour plus de détails, contactez votre Customer Success Manager.

7. Modifier le fichier de flux à l’aide d’une fonction d’analyse

   Si les colonnes et les valeurs de votre fichier de flux ne répondent pas aux exigences ci-dessus, 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 créée en JavaScript. Les fonctions d’analyse syntaxique sont uniquement prises en charge pour les flux de données allant jusqu’à 200 000 articles.

   Les fonctions d’analyse syntaxique sont nécessaires pour pouvoir convertir les flux XML en tableau dans un fichier JSON.
   
   Pour ajouter une fonction d’analyse, accédez à Advanced Settings (Paramètres avancés) › Parser Function (Fonction d’analyse) et entrez votre code.

   Exemple - Analyse d’un flux XML

   Les fonctions d’analyse syntaxique sont nécessaires pour pouvoir convertir les flux XML en tableau dans un fichier JSON.

   function parser(data){
    var products = data.items[0].item;
    return products.map(function(item){
    var newFeedRow = {};
    for(var column in item){
    newFeedRow[column] = item[column][0];
    }
    return newFeedRow;
    });
   }

   Exemple - Combiner deux flux 

   Vous pouvez utiliser une fonction d’analyse syntaxique pour combiner deux flux de produits en un seul flux.

   function parse(feed1, feed2) {
     var combinedFeeds =  feed1.concat(feed2);
     return combinedFeeds;
   }  

8. Vous pouvez afficher un aperçu d’un maximum de 100 entrées de votre flux, y compris les erreurs ou avertissements en cliquant sur Preview (Aperçu). Cliquez sur Save and Activate (Enregistrer et activer) pour continuer ou Cancel (Annuler) pour revenir en arrière. 
   
   
9. La durée du processus de synchronisation dépend du nombre d’articles dans votre flux. La synchronisation ne prend généralement que quelques minutes tant que vous avez moins de 250 000 articles dans le flux.  Au fur et à mesure que les flux s’agrandissent, cela prend généralement environ 30 minutes pour chaque tranche de 500 000 articles dans votre flux. Si le temps de synchronisation est un problème, pensez à contacter votre Customer Success Manager pour apprendre à utiliser une API afin de mettre à jour le flux à la demande plutôt qu’avec des synchronisations périodiques. 

Validation de l’état de synchronisation

Vous pouvez vérifier à tout moment que votre flux se synchronise correctement :  

1. Accédez à Assets (Ressources) › Data Feeds (Flux de données).
2. 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.
3. Dans la colonne Actions, cliquez sur l’icône View (Vue) . Vérifiez que toutes les colonnes requises et celles que vous avez ajoutées sont présentes et contiennent les bonnes données.