Hoe je de functies voor het herhalen van inhoud kunt gebruiken

Wat je leert

Leer hoe je de blokherhaalfuncties kunt gebruiken voor een sectie of een blok in een Klaviyo e-mailtemplate. Met deze functie kun je de inhoud van een blok of sectie herhalen voor elk item in een array (lijst) van gegevens van een ontvangersgebeurtenis of profielgegevens, of van een gegevensfeed.

Voordat je van start gaat

Als je niet bekend bent met het gebruik van gebeurtenis-, profiel- of catalogusgegevens in e-mail, reken dan als eerste stap af met onze referentie voor het personaliseren van berichten. 

Het zal ook nuttig zijn om gegevenstypen in Klaviyo te begrijpen, met name lijst (i.e., arrays). Een array zaak meerdere stukken gegevens die op dezelfde manier zijn opgebouwd. De gekochte artikelen van een klant worden bijvoorbeeld als een array in een Geplaatste Bestelling-gebeurtenis weergegeven. De items array bevat 1 item per besteld item en elk item bevat de details voor 1 item (bijv. itemnaam, URL van afbeelding, hoeveelheid, maat, kleur, etc.). 

Inhoud herhalen functies use cases

Om de content repeat functies te gebruiken, heb je een array of lijst met gegevens nodig. In de tabel hieronder staan een aantal voorbeelden van gegevensreeksen die in je Klaviyo account kunnen voorkomen, samen met voorbeeldgebruiksgevallen. 

Je kunt de content repeat functies gebruiken met elke array, of het nu gaat om een zaak in het profiel of de eventgegevens van een abonnee, of in een van je webfeeds. De bovenstaande voorbeelden zijn slechts een klein voorbeeld van hoe deze functies kunnen worden gebruikt.

Hoe je de functies voor het herhalen van inhoud kunt gebruiken

Om de functies voor het herhalen van inhoud in te schakelen, navigeer je naar de sectie of het blok dat je wilt herhalen en klik je vervolgens op Weergaveopties. Klik in de sectie Inhoud herhalen op Inhoud herhalen maken. 

Je ziet twee velden verschijnen: Herhaal voor en Item alias. Volg de onderstaande stappen om deze velden in te vullen en je herhalende inhoud in te stellen: 

1. Identificeer je "herhalen voor"
2. Kies je "item alias" 
3. Bouw je herhalende inhoud
4. Een voorbeeld van je e-mail bekijken

Identificeer je "herhalen voor" 

Voeg de naam van de matrix toe aan het veld Herhaal voor.

Om de naam van je array te vinden, bekijk je de gegevens van je gegevensbron (d.w.z. profielgegevens, gebeurtenisgegevens of een gegevensfeed). In dit voorbeeld doorlopen we het vinden van de array van gebeurtenisgegevens: 

1. Klik in je e-mailtemplate op Voorbeeld en test.
2. Klik op Gebeurtenis.
3. Selecteer de gebeurtenis die deze flow e-mail activeert (bijv. Afrekenen gestart).
4. Blader door de voorbeeldgegevens voor je evenement tot je een matrix vindt die de informatie bevat die je nodig hebt. Je kunt de pijlpictogrammen aan de linkerkant van de gegevens gebruiken om secties die je niet nodig hebt samen te vouwen en het navigeren te vergemakkelijken.
   

   In dit voorbeeld zijn er twee arrays die iteminformatie bevatten: 

   • Items
     Een array op het hoogste niveau en bevat een eenvoudige lijst met de naam van elk item, maar geen andere informatie.
   • Regel_items
     Genest in de extra array en bevat meer details, waaronder de titel, prijs, SKU en URL van de afbeelding van elk item.
     

   In dit geval zou je de meer gedetailleerde array, line_items, willen gebruiken, omdat deze de gedetailleerde informatie bevat die nodig is om weer te geven in het herhalende blok. Om de juiste variabele te vinden om in te stellen in het veld Herhalen voor, zoek je twee variabelen in de eerste sectie van de matrix en kopieer je ze. In dit voorbeeld kopiëren we de variabelen voor variant_prijs en titel. Hier zijn de twee tags die we hebben gekopieerd: 

   {{ event.extra.line_items.0.variant_price }}

   {{ event.extra.line_items.0.title }}

5. Negeer de accolades en kijk naar de variabelen erin. Merk op dat het begin van beide variabelen hetzelfde is: event.extra.line_items.0. 

   Gebruik alles tot (maar exclusief) de punt en het getal aan het einde van dit deel van de variabele als je Herhaal voor. In dit voorbeeld is de juiste instelling voor het veld Herhalen voor event.extra.regel_items.

Kies je alias

Je item alias kan elke tekst zijn die je wilt gebruiken (zonder speciale tekens of spaties). Je zult deze alias binnen je herhalende blok gebruiken om variabelen aan te geven die moeten worden opgehaald uit de array die je hierboven hebt geselecteerd. Kies een eenvoudige maar beschrijvende alias, zodat je hem gemakkelijk kunt onthouden. 

Als je blok bijvoorbeeld wordt herhaald over een lijst van items in een winkelwagen verlaten, is item een goede alias om te gebruiken. Als je blok zich herhaalt over een lijst met blogberichten, dan zou je post als alias kunnen gebruiken.

Je kunt elke alias gebruiken die je maar wilt; zorg er alleen voor dat je die alias consequent gebruikt in variabelen van je array (zoals beschreven in de volgende stappen). 

Zodra je de velden Herhalen voor en Item alias hebt ingevuld, klik je op Wijzigingen opslaan en kun je beginnen met het maken van je inhoud. 

Bouw je herhalende blok/sectie

Zodra je de instellingen voor Herhalen voor en Item alias hebt ingesteld, voeg je templatetag toe aan het inhoudsblok om overheen te itereren. Je kunt elk type variabele aan dit blok toevoegen, inclusief profiel en gebeurtenisgegevens, maar elke tag die uit je array wordt gehaald (bijvoorbeeld de lijst van items die iemand heeft besteld) moet iets worden aangepast. 

De volledige titel en variatieprijsvariabelen die in het bovenstaande voorbeeld werden gebruikt, waren: 

{{ event.extra.line_items.0.variant_price }}

{{ event.extra.line_items.0.title }}

Als je de bovenstaande variabelen aan het blok toevoegt, wordt het blok één keer herhaald per item in je array, maar elke herhaling toont de titel en prijs van het eerste item in de array. 

Om de titel en prijs voor elk item weer te geven, vervang je de tekst uit de Herhaal voor instelling(event.extra.line_items), plus de daaropvolgende punt en cijfer (.0) met je Item alias(item). De resulterende variabelen voor dit voorbeeld zijn: 

{{ item.variant_price }}

{{ item.title }}

Herhaal het proces met alle andere variabelen die je wilt opnemen in de array. 

Een voorbeeld van je e-mail bekijken en problemen oplossen

Als je eenmaal je herhalende blok hebt opgebouwd, bekijk dan een voorbeeld van je e-mail. Als de e-mail verwijst naar gebeurtenisgegevens, selecteer dan dezelfde gebeurtenis die je hebt gebruikt om het blok op te bouwen (d.w.z. de gebeurtenis die deze flow zal triggeren). Als je blok verwijst naar profielgegevens, kies dan een profiel met de juiste variabelen. 

Als het herhalende blok in je voorbeeldmail leeg lijkt of niet alle inhoud bevat die je verwachtte, ga dan terug naar de bovenstaande stappen. Zorg ervoor dat je Repeat for, Item alias en alle aangepaste variabelen correct zijn geconfigureerd volgens de bovenstaande stappen. Bekijk vervolgens de voorbeeldgegevens die je gebruikt: controleer of je de juiste gebeurtenis hebt geselecteerd en of de voorbeeldgebeurtenis die je hebt gekozen de gegevens bevat die je nodig hebt. 

Extra hulpbronnen

• Referentie personalisatie bericht
• Handleiding voor de e-mail-editortemplate