Hoe je een aangepaste webfeed toevoegt in een e-mail

Wat je leert

Leer hoe je een aangepaste webfeed toevoegt en gebruikt binnen een e-mail. Met een aangepaste webfeed kun je dynamisch een feed met gegevens van een externe URL vullen binnen een Klaviyo E-mail. Voordat een e-mail wordt verzonden, doet Klaviyo een HTTP-verzoek naar de URL en haalt de gegevens op. De inhoud van de webfeed is dan beschikbaar voor gebruik in je e-mail.

De kracht van webfeeds is dat ze je in staat stellen om één enkele template te gebruiken en dynamisch inhoud op te halen, waarbij je alleen de feed up-to-date hoeft te houden en Klaviyo ervoor zorgt dat verse inhoud uit je feed in elke verzending wordt gevuld.

Dit artikel gaat over het toevoegen en gebruiken van een aangepaste webfeed in campagnes en flow.

Voordat je van start gaat

De eerste stap om dynamische externe inhoud toe te voegen aan een e-mail in Klaviyo is het maken van je webfeedbron. Je voer moet: 

• Gehost zijn op een toegankelijke URL in JSON- of XML-formaat
• 3,3 MB of kleiner zijn
• Geen omleidende URL gebruiken 

Klaviyo doet een HTTP-verzoek naar je opgegeven URL en haalt je feedgegevens op. Omdat flow e-mail continu verzendt, zal Klaviyo de inhoud van je feed up-to-date houden door periodiek je feed URL op te vragen om vernieuwde inhoud binnen te halen op een van de volgende tijdstippen: 

• 15-minuten vernieuwen
  Klaviyo probeert je feed elke 15 minuten te vernieuwen. Om dit te bereiken moet je feed binnen vijf seconden worden geladen en terugkeren met een succesvol antwoord.

• Nachtelijk vernieuwen
  Als het na drie uur proberen langer dan vijf seconden duurt voordat je feed terugkomt, gaan we proberen om je feed 's nachts te vernieuwen op update. Voor doorlopende nachtelijke vernieuwingen moet je feed laden in minder dan 30 seconden. 

Als we je feed drie nachten achter elkaar niet binnen 30 seconden kunnen laden, kun je deze feed niet gebruiken in je e-mail. Flow e-mail die afhankelijk is van deze feed zal stoppen met verzenden en campagne en flow e-mail zullen niet worden verzonden totdat de feed is verwijderd of het probleem met je feed is opgelost.

Als we je feed opvragen en een foutmelding krijgen, hebben we geen toegang tot de inhoud van je feed. We volgen hetzelfde patroon als hierboven en proberen het maximaal drie dagen opnieuw. In de tussentijd wordt er geen e-mail verzonden.

Als we problemen hebben met de toegang tot je webfeed, ontvang je meldingen in de app en per e-mail om je dat te laten weten. Een gemakkelijke stap om problemen op te lossen is om de voedingsvereisten dubbel te controleren en ervoor te zorgen dat ze voldoen aan de hierboven beschreven parameters. 

Als je wijzigingen aanbrengt in een feed - bijvoorbeeld de grootte verkleinen om het uploaden te versnellen of een probleem oplossen dat een foutmelding veroorzaakt - en je wilt dat Klaviyo een nieuwe vernieuwingspoging doet, navigeer dan naar de feed op het tabblad Gegevens Feeds en klik op Gegevens Feed bijwerken. We zullen je feed testen en opnieuw valideren. Als je feed geldig is en tijdig een antwoord terugstuurt, gaan we verder met het up-to-date houden van je inhoud. Dit is een goede stap voor probleemoplossing om te proberen als je problemen hebt met de toegang tot je webfeed, zelfs als je geen wijzigingen hebt aangebracht.

Django filters

We support het gebruik van Django filters voor de variabelen die je invoegt. Hieronder staan een paar veelgebruikte filters, en je kunt meer te weten komen in onze gids over Filters gebruiken om variabelen aan te passen en de Verklarende woordenlijst van variabelenfilters.

Beperk de samenvatting van je bericht tot X aantal woorden

Als je een korte samenvatting van een blogbericht wilt opnemen onder de titel van het bericht (en je feed deze samenvattende tekst levert), kun je het Filter Afkappen gebruiken.

Om bijvoorbeeld de samenvatting van een artikel te beperken tot 250 tekens, kun je het volgende gebruiken:

{{ item.summary|truncatechars:250 }}

Een aangepaste webfeed toevoegen

Je feed instellen

1. Klik op je bedrijfsnaam in de linkerbenedenhoek van Klaviyo.
2. Klik op Instellingen.
3. Klik op Overig.
   
4. Klik op Webfeeds.
5. Klik op Webfeed toevoegen.
   
6. Vul de velden voor de webfeed als volgt in:
   • Feed naam
     Je zult deze identificatie later gebruiken in je template om toegang te krijgen tot de inhoud van de feed. Geef je feed een korte beschrijvende naam. We raden aan om feeds een naam te geven in camel case (bijv. "MyDataFeed") of met hoofdletters en spaties vervangen door underscores (bijv. "MY_DATA_FEED"). Spaties zijn niet toegestaan in feednamen. 
   • Feed URL
     Het eindpunt dat Klaviyo gebruikt om de inhoud van de feed op te halen (d.w.z. de URL van de JSON of XML feed die eerder is geconfigureerd). Als je feed privégegevens bevat, raden we je sterk aan om een HTTPS URL te gebruiken en een nonce queryparameter op te nemen om je feed te beveiligen.
   • Aanvraagmethode
     Geef de HTTP-methode op die wordt gebruikt om je feed op te vragen. Als je niet zeker weet welke je moet kiezen, selecteer dan GET. 
   • Type inhoud
     Het formaat van de feed (JSON of XML). We raden aan om JSON te gebruiken als dat mogelijk is. Voor XML feeds wordt de feed geconverteerd naar JSON.
7. Zodra je alle velden hebt ingevuld, klik je op Webfeed toevoegen. We zullen proberen de feed URL op te vragen en te valideren of je feed goed werkt. Als er een fout optreedt, krijg je een foutmelding te zien en kun je deze nieuwe feed niet opslaan totdat het probleem is opgelost.
   • Wil je dit uitproberen maar heb je geen eigen URL voor webfeeds? Gebruik de onze. Kopieer de volgende URL voor het Klaviyo Helpcentrum in het vak Feed URL en probeer het uit in je eigen Klaviyo account:

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

8. Klaviyo valideert je feed en laat mogelijke fouten zien. Zodra je feed is gevalideerd, zie je hem in Klaviyo en is hij klaar om te worden gebruikt in e-mail.
   

Een voorbeeld van je feed

Het is handig om een voorbeeld van een webfeed te bekijken voordat je deze toevoegt aan een e-mail. Een feed bekijken:

1. Zoek je feed op de pagina Webfeeds. 
2. Klik op de drie puntjes en selecteer Bewerken. 
   
3. Klik op de feed detailpagina op Voorbeeld. 

Als je een voorbeeld van je feed bekijkt, zie je de inhoud of een foutmelding als we de feed niet kunnen laden. 

Als je feed een JSON-array is, zullen we automatisch elke rij afzonderlijk ontleden en weergeven. Als het iets anders is, waarschijnlijk een JSON woordenboek, dan laten we het hele woordenboek zien.

Als je je feed actief aan het ontwikkelen bent, gebruik dan de vernieuwen knop om de nieuwste versie van je feed op te halen. De voorbeeldpagina voor een feed toont de hele feed. Als je feed groot is, kan het enkele seconden duren voordat de inhoud wordt weergegeven. Houd er rekening mee dat als het meer dan 30 seconden duurt om je feed op te vragen, dit invloed heeft op de prestaties van alle e-mails die op deze feed vertrouwen.

Nu je een webfeed hebt toegevoegd en de inhoud ervan hebt bekeken, kun je deze in een e-mail gebruiken.

Gebruik een webfeed in een e-mail

Voor campagnes zal Klaviyo elke feed één keer per verzending ophalen en de geretourneerde inhoud bekijken. Zelfs als je naar duizenden ontvangers verstuurt, zal Klaviyo geen duizenden verzoeken naar je servers sturen.

Vul feed-inhoud in een template

In onze voorbeeld webfeed uit de vorige sectie hebben we een matrix van artikelen waar elk item een naam, URL, artikel-ID en meer bevat. Nadat een feed is toegevoegd aan een e-mail, is deze beschikbaar via de variabele feeds:

{{ feeds }}

Bijvoorbeeld, voor de JSON feed hierboven kunnen we nu verwijzen naar de inhoud van de artikelenfeed of deze uitvoeren door deze syntaxis op te nemen in onze template:

{{ feeds.Klaviyo_Help_Center }}

Laten we een voorbeeld bekijken waarin we itereren over alle items in de matrix en bepaalde variabelen weergeven. We gebruiken hier de Klaviyo Blog feed als voorbeeld en itereren over Afbeeldingen.

1. Sleep een nieuw tekstblok naar je e-mail en plaats het waar je wilt dat de webfeed wordt ingevuld.
2. Zet de Herhaal blok/Content Herhaal functies aan: klik op het tabblad Weergaveopties van het tekstblok en klik dan op Herhaal regels maken.
3. Voeg voor het veld Repeat For feeds.YOUR_FEED_NAME in, gevolgd door de naam van de variabele(n) die de array bevat waar je doorheen wilt itereren.
   • Omdat we in ons voorbeeld ook itereren over de "articles" waarde, herhalen we voor: feeds.Klaviyo_Help_Center.articles.
4. Je gegevens kunnen genest zijn in een reeks variabelen. Je feed zou bijvoorbeeld als volgt gestructureerd kunnen zijn: 

   rss: {
   ..... 
    kanaal: { 
   ..... 
    item: { 
   .....}}}

   In dit geval zou je feeds.YOUR_FEED_NAME.rss.kanaal.item gebruiken als je Herhaling voor.

5. Als je wilt dat dit blok alleen over een bepaald aantal regels itereert, gebruik dan het filter "slice". Om dit filter te gebruiken, pas je de waarde Repeat For aan door het filter aan het einde toe te voegen:  feeds.Klaviyo_Help_Center.articles|slice:':3'
   In dit voorbeeld zorgt |slice:':3' ervoor dat alleen de eerste drie artikelen worden weergegeven. 
6. Voeg voor het veld Item Alias in: item
7. Zodra je de Herhaal blok/Content Herhaal functies hebt geconfigureerd, kun je variabelen invoegen met het "item" alias.
8. Om variabelen te identificeren en toe te voegen, open je de voorbeeldweergave van je webfeed en kijk je naar de manier waarop je gegevens zijn gestructureerd. Alle gegevens die genest zijn in de matrix die gebruikt wordt in het veld Herhalen voor kunnen gebruikt worden als variabele.
   In dit voorbeeld zijn alle gegevens in de artikelenreeks beschikbaar voor gebruik in een e-mail:
   
9. Voor gegevens op het eerste niveau voeg je gewoon item toe voor de naam van de variabele in je gegevens. Gebruik bijvoorbeeld {{ item.title }} om de titel van een artikel weer te geven, of {{ item.url }} om de URL van een artikel weer te geven. 
10. Gebruik de puntnotatie (bijv, {{ item.images.thumbnail_url }}). Als je meer wilt weten over puntnotaties en templatetag, ga dan naar onze gids voor templatetag en variabele syntaxis. 
11. Als je een voorbeeld van je template bekijkt, zul je zien dat dit eenvoudige tekstblok met de functie Herhaal blok/Content Herhaal automatisch alle items in je feed kan doorlopen. Alleen de variabelen die je opgeeft in het tekstblok worden getoond voor elke invoer.
12. Als je een afbeelding invoegt, moet je het veld Broncode van het tekstblok bewerken en de afbeelding opnemen in een <img src> tag.
    

Je hebt een aangepaste webfeed aan je e-mail toegevoegd en kunt nu dynamisch een feed met gegevens van je externe URL vullen. 

Test of valideer je feed

Als je een e-mail of in-app melding ontvangt dat we problemen hebben met de toegang tot je webfeed:

1. Navigeer naar je feed en klik op de knop Feed bijwerken.
2. Zodra de validatie is voltooid, zijn er twee soorten foutmeldingen die je kunt zien:
   • Ongeldige reactie
     Als we een foutmelding krijgen wanneer we de inhoud van je feed proberen op te vragen, vertellen we je de statuscode van de foutmelding. Je moet het probleem aanpakken dat deze foutmelding veroorzaakt voordat de feed met succes in een e-mail kan worden gebruikt.
   • Prestatieprobleem
     Als we niet binnen 30 seconden een reactie krijgen van je feed, leidt dit tot vertragingen bij het verzenden. Hoewel je je feed in het verleden misschien hebt kunnen opslaan, moet je, om het risico op vertragingen bij het verzenden te beperken, het prestatieprobleem met je feed aanpakken voordat je deze opnieuw valideert en met succes opslaat.

In beide gevallen, als je een problematische feed gebruikt binnen een verzending, zal dit leiden tot vertragingen bij het verzenden of kan je e-mail helemaal worden geannuleerd. Voor stromen is het ook waarschijnlijk dat e-mail niet wordt verzonden.

We raden je aan om een problematische feed uit alle e-mail te verwijderen terwijl je nog openstaande problemen aanpakt om verstoring van de verzending te voorkomen.

Extra hulpbronnen

• Problemen oplossen met je Instagram webfeed in e-mail
• Hoe gebruik je productfeed en aanbevelingen