Så här lägger du till ett anpassat webbflöde i en e-post

Du kommer att lära dig

Lär dig hur du lägger till och använder ett anpassat webbflöde i en e-post. Med ett anpassat webbflöde kan du dynamiskt fylla på ett flöde av data från en extern URL i ett e-postmeddelande till Klaviyo. Innan du skickar ett e-postmeddelande gör Klaviyo en HTTP-förfrågan till URL:en och hämtar data. Innehållet i webbflödet är sedan tillgängligt för användning i din e-post.

Kraften i webbflöden är att de låter dig använda en enda mall och dra in innehåll dynamiskt, där du bara behöver hålla flödet uppdaterat och Klaviyo kommer att se till att nytt innehåll från ditt flöde fylls i varje sändning.

Den här artikeln går igenom hur du lägger till och använder en anpassad webbfeed i kampanjer och flöde.

Innan du börjar

Det första steget för att lägga till dynamiskt externt innehåll till en e-post i Klaviyo är att skapa din webb Flödeskälla. Ditt foder måste: 

• finnas på en tillgänglig URL i antingen JSON- eller XML-format
• Vara 3,3 MB eller mindre
• Använd inte en omdirigerande URL 

Klaviyo kommer att göra en HTTP-begäran till din angivna URL och hämta ditt flöde data. Eftersom flöde e-post skickas kontinuerligt kommer Klaviyo att hålla innehållet i ditt flöde uppdaterat genom att regelbundet fråga din flödesadress för att hämta uppdaterat innehåll enligt något av följande scheman: 

• 15-minuters uppdatering
  Klaviyo kommer att försöka uppdatera ditt flöde var 15:e minut. För att uppnå detta måste ditt flöde laddas inom fem sekunder och återkomma med ett framgångsrikt svar.

• Uppdatering varje natt
  Om ditt flöde tar längre tid än fem sekunder att komma tillbaka, efter tre timmars försök, kommer vi att börja försöka uppdatera ditt flöde varje natt istället. För löpande nattliga uppdateringar måste ditt flöde laddas på mindre än 30 sekunder. 

Om vi inte kan ladda ditt flöde inom 30 sekunder tre nätter i rad kommer du inte att kunna använda detta flöde i din e-post. flöde e-post som förlitar sig på denna feed kommer att sluta skicka, och kampanj och flöde e-post kommer inte att skicka förrän feeden tas bort eller det utestående problemet med din feed är löst.

Om vi får ett felsvar när vi frågar efter ditt flöde kommer vi inte att kunna komma åt innehållet i ditt flöde. Vi kommer att följa samma mönster som ovan och försöka igen i upp till tre dagar. Under tiden kommer e-posten inte att skickas.

Om vi har problem med att komma åt ditt webbflöde kommer du att få meddelanden i appen och via e-post som informerar dig om detta. Ett enkelt felsökningssteg är att dubbelkolla foderkraven och se till att de stämmer överens med de parametrar som beskrivs ovan. 

Om du gör ändringar i ett flöde - t.ex. minskar storleken för att påskynda uppladdningstiden eller åtgärdar ett problem som orsakar ett felsvar - och vill att Klaviyo ska försöka göra en ny uppdatering, navigera till flödet på fliken Dataflöden och klicka på Uppdatera dataflödet. Vi kommer att testa och validera ditt flöde igen. Om ditt flöde är giltigt och ger ett svar i rätt tid fortsätter vi att försöka hålla ditt innehåll uppdaterat. Det här är ett bra felsökningssteg om du har problem med att komma åt ditt webbflöde, även om du inte har gjort några ändringar.

Django-filter

Vi support använder Django-filter för de variabler du lägger in. Nedan följer några vanliga filter, och du kan läsa mer i vår guide om att använda filter för att anpassa variabler och Ordlista över variabelfilter.

Begränsa inläggets sammanfattning till X antal ord

Om du vill inkludera en kort sammanfattning av ett blogginlägg under inläggets titel (och ditt flöde tillhandahåller denna sammanfattningstext) kan du använda filtret Truncate.

Om du vill begränsa sammanfattningen av en artikel till 250 tecken kan du t.ex. använda

{{ item.summary|truncatechars:250 }}

Lägg till ett anpassat webbflöde

Ställ in ditt flöde

1. Klicka på ditt företagsnamn i det nedre vänstra hörnet på Klaviyo.
2. Klicka på Inställningar.
3. Klicka på Annat.
   
4. Klicka på Webbfeeds.
5. Klicka på Lägg till webbflöde.
   
6. Fyll i fälten för webbmatningen enligt följande:
   • Flödets namn
     Du kommer senare att använda den här identifieraren i din mall för att komma åt innehållet i flödet. Ge ditt flöde ett kort beskrivande namn. Vi rekommenderar att feeds namnges antingen med kamelbokstäver (t.ex. "MyDataFeed") eller med versaler och mellanslag ersätts med understreck (t.ex. "MY_DATA_FEED"). Mellanslag är inte tillåtna i feednamn. 
   • URL för flöde
     Den slutpunkt som Klaviyo använder för att hämta innehållet i flödet (dvs. URL:en för det JSON- eller XML-flöde som konfigurerats tidigare). Om ditt flöde innehåller privat information rekommenderar vi starkt att du använder en HTTPS-URL och inkluderar en nonce-frågeparameter för att säkra ditt flöde.
   • Metod för begäran
     Ange den HTTP-metod som ska användas för att begära ditt flöde. Om du är osäker på vad du ska välja, välj GET. 
   • Typ av innehåll
     Flödets format (antingen JSON eller XML). Vi rekommenderar att du använder JSON om det är möjligt. För XML-flöden kommer flödet att konverteras till JSON.
7. När du har fyllt i alla fält klickar du på Lägg till webbflöde. Vi kommer att försöka fråga efter feed-URL:en och bekräfta att ditt feed fungerar korrekt. Om vi stöter på ett fel kommer du att se ett felmeddelande och du kommer inte att kunna spara det nya flödet förrän problemet har åtgärdats.
   • Vill du prova detta men har ingen egen URL för webbflöde? Använd vår. Kopiera följande URL för Klaviyo hjälpcenter till rutan Feed URL och testa det på din egen Klaviyo Konto:

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

8. Klaviyo validerar ditt flöde och visar eventuella fel. När du har validerat kommer du att se ditt flöde på Klaviyo och det är klart att användas i e-post.
   

Förhandsgranska ditt flöde

Det är bra att förhandsgranska ett webbflöde innan du lägger till det i en e-post. Förhandsgranska ett flöde:

1. Leta reda på ditt flöde på sidan Webbflöden. 
2. Klicka på de tre prickarna och välj sedan Redigera. 
   
3. Klicka på Förhandsgranska på detaljsidan för flödet. 

När du förhandsgranskar ditt flöde kommer du antingen att se flödets innehåll eller ett felmeddelande om vi inte kan ladda flödet. 

Om ditt flöde är en JSON-array kommer vi automatiskt att analysera och visa varje rad individuellt. Om det är något annat, troligen en JSON-ordbok, visar vi hela ordboken.

Om du aktivt utvecklar ditt flöde kan du använda knappen aktualisera för att hämta den senaste versionen av ditt flöde. På förhandsgranskningssidan för ett flöde visas hela flödet. Om ditt flöde är stort kan det ta flera sekunder att visa innehållet. Tänk på att om din feed tar mer än 30 sekunder att fråga, kommer detta att påverka resultatet för alla e-postmeddelanden som förlitar sig på denna feed.

Nu när du har lagt till ett webbflöde och förhandsgranskat dess innehåll kan du använda det i ett e-postmeddelande.

Använd ett webbflöde i ett e-postmeddelande

För kampanjer kommer Klaviyo att hämta varje flöde en gång per sändning och butik det returnerade innehållet. Även om du skickar till tusentals mottagare kommer Klaviyo inte att göra tusentals förfrågningar till dina servrar.

Fylla i feed-innehåll i en mall

I vårt exempel på webbflöde från föregående avsnitt har vi en matris med artiklar där varje post innehåller ett namn, URL, artikel-ID med mera. När ett flöde har lagts till i ett e-postmeddelande är det tillgängligt via flödesvariabeln:

{{ feeds }}

För JSON-flödet ovan kan vi till exempel nu referera till eller mata ut innehållet i artikelflödet genom att inkludera denna syntax i vår mall:

{{ feeds.Klaviyo_Help_Center }}

Låt oss gå igenom ett exempel där vi itererar över alla poster i matrisen och visar vissa variabler. Vi använder Klaviyo Blog-flödet som ett exempel här och itererar över Images.

1. Dra in en ny text block i din e-post och placera den där du vill att webbflödet ska visas.
2. Aktivera upprepningsblocket/Content Repeat funktioner: klicka i texten blockpå fliken Display Options och klicka sedan på Create Repeat Rules.
3. I fältet Repeat For skriver du in feeds.YOUR_FEED_NAME, följt av namnet på den eller de variabler som innehåller den matris som du vill iterera igenom.
   • I vårt exempel, eftersom vi itererar över "artiklar" värde också, kommer vi att upprepa för: feeds.Klaviyo_Help_Center.articles.
4. Dina data kan vara inbäddade i en serie variabler. Ditt flöde kan till exempel vara uppbyggt så här: 

   rss: {
   ..... 
    kanal: { 
   ..... 
    item: { 
   .....}}}

   I det här fallet skulle du använda feeds.YOUR_FEED_NAME.rss.kanal.item som din Repeat for.

5. Om du bara vill att block ska iterera över ett visst antal poster använder du filtret "slice". Om du vill använda det här filtret justerar du värdet Upprepa för genom att lägga till filtret i slutet:  feeds.Klaviyo_Help_Center.articles|slice:':3'
   I det här exemplet kommer |slice: ':3' att leda till att endast de tre första posterna visas. 
6. I fältet Item Alias skriver du in: item
7. När du har konfigurerat Repeat block/Content Repeat funktioner kan du infoga variabler med hjälp av aliaset "item".
8. För att identifiera och lägga till variabler öppnar du förhandsgranskningen av ditt webbflöde och hänvisar till hur dina data är strukturerade. Alla data som är inbäddade i den matris som används i fältet Repeat for kan användas som en variabel.
   I det här exemplet är alla data som visas i artikelmatrisen tillgängliga för användning i en e-post:
   
9. För data på första nivån lägger du helt enkelt till item före variabelnamnet som visas i dina data. Du kan till exempel använda {{ item.title }} för att visa en artikels titel, eller {{ item.url }} för att visa en artikels URL. 
10. För att komma åt data som är inbäddade i variablerna på första nivån använder du punktnotation (t.ex, {{ item.images.thumbnail_url }}). Om du vill veta mer om punktnotationer och malltagg kan du läsa vår guide till malltagg och variabelsyntax. 
11. När du förhandsgranskar ditt köpcentrum kommer du att märka att Repeat block/Content Repe at funktioner gör det möjligt för denna enkla text block att automatiskt iterera över alla poster i ditt flöde. Endast de variabler som du anger i texten block visas för varje post.
12. Om du infogar en bild, observera att du måste redigera källkodsfältet i texten block och innehålla bilden i en <img src> etikett.
    

Du har lagt till ett anpassat webbflöde i din e-post och kan nu dynamiskt fylla på ett flöde med data från din externa URL. 

Testa eller validera ditt flöde

Om du får ett e-postmeddelande eller ett meddelande i appen om att vi har problem med att komma åt ditt webbflöde:

1. Navigera till ditt flöde och klicka på knappen Uppdatera flödet.
2. När valideringen har slutförts kan du se två typer av felmeddelanden:
   • Ogiltigt svar
     Om vi får ett felsvar när vi försöker fråga efter ditt flödesinnehåll, kommer vi att berätta statuskoden för felet. Du måste ta itu med problemet som orsakar detta felsvar innan flödet kan användas framgångsrikt i någon e-post.
   • Problem med prestanda
     Om vi inte får svar från din feed inom 30 sekunder kommer det att leda till fördröjningar i sändningen. Du kanske har kunnat spara ditt flöde historiskt, men för att minska risken för sändningsförseningar måste du åtgärda prestandaproblemet med ditt flöde innan du validerar det på nytt och sparar det.

I båda fallen gäller att om du använder ett problematiskt flöde i ett utskick kommer det att leda till förseningar i utskicket eller att ditt utskick helt och hållet avbryts. För flöde är det också troligt att e-post inte skickas.

Vi rekommenderar att du tar bort ett problematiskt flöde från all e-post medan du åtgärdar eventuella kvarstående problem för att förhindra sändningsstörningar.

Ytterligare resurser

• Felsök ditt Instagram-flöde i e-post
• Så här använder du produktfeed och rekommendationer