Comment ajouter un flux web personnalisé dans un e-mail ?

Vous apprendrez

Découvrez comment ajouter et utiliser un flux web personnalisé dans un e-mail. Un flux web personnalisé vous permet d'alimenter dynamiquement un flux de données à partir d'une URL externe dans un e-mail Klaviyo. Avant d'envoyer un e-mail, Klaviyo envoie une requête HTTP à l'URL et récupère les données. Le contenu du flux Web est alors disponible pour être utilisé dans votre courrier électronique.

L'avantage des flux web est qu'ils vous permettent d'utiliser un modèle unique et d'intégrer du contenu de manière dynamique. Il vous suffit de maintenir le flux à jour et Klaviyo veillera à ce que le contenu frais de votre flux soit intégré à chaque envoi.

Cet article traite de l'ajout et de l'utilisation d'un flux web personnalisé dans les campagnes et les flux.

Avant de commencer

La première étape pour ajouter un contenu externe dynamique à un e-mail dans Klaviyo est de créer votre source de flux web. Votre alimentation doit : 

• être hébergé à une adresse URL accessible au format JSON ou XML
• Être de 3,3 Mo ou moins
• Ne pas utiliser d'URL de redirection 

Klaviyo effectuera une requête HTTP vers l'URL spécifiée et récupérera les données de votre flux. En raison de l'envoi continu d'emails de flux, Klaviyo maintiendra le contenu de votre flux à jour en interrogeant périodiquement l'URL de votre flux pour en extraire le contenu actualisé selon l'un des calendriers suivants : 

• Rafraîchissement toutes les 15 minutes
  Klaviyo tentera de rafraîchir votre flux toutes les 15 minutes. Pour ce faire, votre flux doit se charger en moins de cinq secondes et renvoyer une réponse positive.

• Actualisation nocturne
  Si votre flux met plus de cinq secondes à revenir, après trois heures d'essai, nous commencerons à essayer de mettre à jour votre flux tous les soirs. Pour les actualisations nocturnes permanentes, votre flux doit se charger en moins de 30 secondes. 

Si nous ne pouvons pas charger votre flux dans les 30 secondes pendant trois nuits consécutives, vous ne pourrez pas utiliser ce flux dans vos e-mails. Les e-mails de flux reposant sur ce flux cesseront d'être envoyés, et les e-mails de campagne et de flux ne seront pas envoyés tant que le flux n'aura pas été supprimé ou que le problème en suspens concernant votre flux n'aura pas été résolu.

Lorsque nous interrogeons votre flux, si nous obtenons une réponse d'erreur, nous ne pouvons pas accéder au contenu de votre flux. Nous suivrons le même schéma que ci-dessus et ferons une nouvelle tentative pendant trois jours au maximum. Dans l'intervalle, les e-mails ne sont pas envoyés.

Si nous avons des difficultés à accéder à votre flux web, vous recevrez des notifications dans l'application et par e-mail pour vous en informer. Une étape de dépannage facile consiste à revérifier les exigences en matière d'alimentation et à s'assurer qu'elles correspondent aux paramètres décrits ci-dessus. 

Si vous apportez des modifications à un flux - par exemple, réduire la taille pour accélérer le temps de téléchargement ou corriger un problème provoquant une réponse d'erreur - et que vous souhaitez que Klaviyo tente une nouvelle actualisation, naviguez jusqu'au flux dans l'onglet Flux de données et cliquez sur Mettre à jour le flux de données. Nous testerons et revaliderons votre flux. Si votre flux est valide et renvoie une réponse dans les délais, nous recommencerons à essayer de maintenir votre contenu à jour. Il s'agit d'une bonne étape de dépannage à essayer si vous avez des difficultés à accéder à votre flux web, même si vous n'avez pas apporté de modifications.

Filtres Django

Nous soutenons l'utilisation de filtres Django pour les variables que vous insérez. Vous trouverez ci-dessous quelques filtres couramment utilisés. Pour en savoir plus, consultez notre guide sur l'utilisation des filtres pour personnaliser les variables et le glossaire des filtres de variables.

Limiter le résumé du message à X mots

Si vous souhaitez inclure un bref résumé d'un article de blog sous le titre de l'article (et que votre flux fournit ce texte de résumé), vous pouvez utiliser le filtre de troncature.

Pour limiter le résumé d'un article à 250 caractères, par exemple, vous pouvez utiliser :

{{ item.summary|truncatechars:250 }}

Ajouter un flux web personnalisé

Configurez votre flux

1. Cliquez sur le nom de votre entreprise dans le coin inférieur gauche de Klaviyo.
2. Cliquez sur Paramètres.
3. Cliquez sur Autre.
   
4. Cliquez sur Flux Web.
5. Cliquez sur Ajouter un flux Web.
   
6. Remplissez les champs du flux web comme suit :
   • Nom du flux
     Vous utiliserez ultérieurement cet identifiant dans votre modèle pour accéder au contenu du flux. Donnez à votre flux un nom court et descriptif. Nous vous recommandons de nommer les flux soit en majuscules (par exemple, "MyDataFeed"), soit en majuscules, les espaces étant remplacés par des traits de soulignement (par exemple, "MY_DATA_FEED"). Les espaces ne sont pas autorisés dans les noms de flux. 
   • URL du flux
     Le point de terminaison utilisé par Klaviyo pour récupérer le contenu du flux (c'est-à-dire l'URL du flux JSON ou XML configuré précédemment). Si votre flux contient des informations privées, nous vous recommandons vivement d'utiliser une URL HTTPS et d'inclure un paramètre de requête nonce pour sécuriser votre flux.
   • Méthode de requête
     Indiquez la méthode HTTP qui sera utilisée pour demander votre flux. Si vous n'êtes pas sûr de votre choix, sélectionnez GET. 
   • Type de contenu
     Le format du flux (JSON ou XML). Nous vous recommandons d'utiliser JSON si possible. Pour les flux XML, le flux sera converti en JSON.
7. Une fois que vous avez rempli tous les champs, cliquez sur Ajouter un flux web. Nous tenterons d'interroger l'URL du flux et de vérifier que votre flux fonctionne correctement. Si nous rencontrons une erreur, un message d'erreur s'affichera et vous ne pourrez pas enregistrer ce nouveau flux jusqu'à ce que le problème soit résolu.
   • Vous voulez essayer mais vous n'avez pas votre propre URL ? Utilisez la nôtre. Copiez l'URL suivante du Centre d'aide Klaviyo dans le champ Feed URL et essayez-la dans votre propre compte Klaviyo :

     https://help.klaviyo.com/api/v2/help_center/en-us/articles.json

8. Klaviyo valide votre flux et indique les erreurs potentielles. Une fois validé, vous verrez votre flux dans Klaviyo et il sera prêt à être utilisé dans les emails.
   

Prévisualisez votre flux

Il est utile de prévisualiser un flux web avant de l'ajouter à un courriel. Pour prévisualiser un flux :

1. Sur la page des flux Web, recherchez votre flux. 
2. Cliquez sur les trois points, puis sélectionnez Modifier. 
   
3. Dans la page de détail du flux, cliquez sur Aperçu. 

Lors de la prévisualisation de votre flux, vous verrez soit le contenu du flux, soit un message d'erreur si nous ne pouvons pas charger le flux. 

Si votre flux est un tableau JSON, nous analyserons et afficherons automatiquement chaque ligne individuellement. S'il s'agit d'autre chose, plus probablement d'un dictionnaire JSON, nous afficherons l'intégralité du dictionnaire.

Si vous développez activement votre flux, utilisez le bouton Actualiser pour obtenir la dernière version de votre flux. La page de prévisualisation d'un flux affiche l'intégralité du flux. Si votre flux est volumineux, l'affichage du contenu peut prendre plusieurs secondes. Gardez à l'esprit que si votre flux prend plus de 30 secondes à être interrogé, cela aura un impact sur les performances des e-mails qui dépendent de ce flux.

Maintenant que vous avez ajouté un flux web et prévisualisé son contenu, vous pouvez l'utiliser dans un courriel.

Utiliser un flux web dans un e-mail

Pour les campagnes, Klaviyo récupérera chaque flux une fois par envoi et stockera le contenu renvoyé. Même si vous envoyez des messages à des milliers de destinataires, Klaviyo n'enverra pas des milliers de requêtes à vos serveurs.

Remplir le contenu d'un flux dans un modèle

Dans notre exemple de flux web de la section précédente, nous avons un tableau d'articles où chaque entrée comprend un nom, une URL, un identifiant d'article, etc. Une fois qu'un flux est ajouté à un courriel, il est disponible via la variable "feeds" :

{{ feeds }}

Par exemple, pour le flux JSON ci-dessus, nous pouvons maintenant référencer ou produire le contenu du flux d'articles en incluant cette syntaxe dans notre modèle :

{{ feeds.Klaviyo_Help_Center }}

Examinons un exemple dans lequel nous itérons sur toutes les entrées du tableau, en affichant certaines variables. Nous utiliserons le flux Klaviyo Blog comme exemple ici, et nous itérerons sur Images.

1. Faites glisser un nouveau bloc de texte dans votre courriel et placez-le à l'endroit où vous souhaitez que le flux Web soit affiché.
2. Activez la fonctionnalité de répétition du bloc/contenu : cliquez sur l'onglet Options d'affichage du bloc de texte, puis sur Créer des règles de répétition.
3. Pour le champ Repeat For, insérez feeds.YOUR_FEED_NAME, suivi du nom de la (des) variable(s) qui contient (contiennent) le tableau que vous voulez parcourir.
   • Dans notre exemple, comme nous itérons également sur la valeur "articles", nous répétons pour : feeds.Klaviyo_Help_Center.articles.
4. Vos données peuvent être imbriquées dans une série de variables. Par exemple, votre flux peut être structuré comme suit : 

   rss : {
   ..... 
    channel : { 
   ..... 
    item : { 
   .....}}}

   Dans ce cas, vous utiliserez feeds.YOUR_FEED_NAME.rss.channel.item comme Repeat for.

5. Si vous souhaitez que ce bloc n'itère que sur un certain nombre d'entrées, utilisez le filtre "slice". Pour utiliser ce filtre, ajustez la valeur Répéter pour en ajoutant le filtre à la fin :  feeds.Klaviyo_Help_Center.articles|slice:':3'
   Dans cet exemple, |slice:':3' n'affichera que les trois premières entrées. 
6. Dans le champ Alias de l'élément, insérez : élément
7. Une fois que vous avez configuré la fonction Répétition du bloc/contenu, vous pouvez insérer des variables à l'aide de l'alias "item".
8. Pour identifier et ajouter des variables, ouvrez l'aperçu de votre flux web et reportez-vous à la façon dont vos données sont structurées. Toute donnée imbriquée dans le tableau utilisé dans le champ Répéter pour peut être utilisée comme variable.
   Dans cet exemple, toutes les données figurant dans le tableau des articles sont disponibles pour être utilisées dans un courrier électronique :
   
9. Pour les données de premier niveau, il suffit d'ajouter item devant le nom de la variable figurant dans vos données. Par exemple, utilisez {{ item.title }} pour afficher le titre d'un article, ou {{ item.url }} pour afficher l'URL d'un article. 
10. Pour accéder aux données imbriquées dans les variables de premier niveau, utilisez la notation par points (par exemple, {{ item.images.thumbnail_url }}). Pour en savoir plus sur les notations et les variables de modèle, consultez notre guide sur les balises de modèle et la syntaxe des variables. 
11. Lorsque vous prévoyez votre modèle, vous remarquerez que la fonction de répétition du bloc/contenu permet à ce simple bloc de texte d'itérer automatiquement sur toutes les entrées de votre flux. Seules les variables spécifiées dans le bloc de texte seront affichées pour chaque entrée.
12. Si vous insérez une image, veuillez noter que vous devrez modifier le champ Code source du bloc de texte et contenir l'image dans un <img src> tag.
    

Vous avez ajouté un flux web personnalisé à votre courrier électronique et pouvez désormais alimenter dynamiquement un flux de données à partir de votre URL externe. 

Testez ou validez votre flux

Si vous recevez un e-mail ou une notification in-app indiquant que nous avons des difficultés à accéder à votre flux web :

1. Naviguez jusqu'à votre flux et cliquez sur le bouton Mettre à jour le flux.
2. Une fois la validation terminée, deux types de messages d'erreur peuvent apparaître :
   • Réponse invalide
     Si nous recevons une réponse d'erreur lorsque nous tentons d'interroger le contenu de votre flux, nous vous indiquerons le code d'état de l'erreur. Vous devrez résoudre le problème à l'origine de cette réponse d'erreur avant que le flux puisse être utilisé avec succès dans un courrier électronique.
   • Problème de performance
     Si nous n'obtenons pas de réponse de votre flux dans les 30 secondes, cela entraînera des retards d'envoi. Bien que vous ayez pu sauvegarder votre flux dans le passé, pour réduire le risque de retard d'envoi, vous devrez résoudre le problème de performance de votre flux avant de le valider à nouveau et de le sauvegarder avec succès.

Dans les deux cas, si vous utilisez un flux problématique dans un envoi, cela entraînera des retards d'envoi ou votre courriel pourra être annulé. Pour les flux, il est également probable que les e-mails ne soient pas envoyés.

Nous vous recommandons de supprimer un flux problématique de tous les e-mails pendant que vous réglez les problèmes en suspens afin d'éviter toute perturbation de l'envoi.

Ressources complémentaires

• Dépannage de votre flux web Instagram dans les e-mails
• Comment utiliser les flux de produits et les recommandations