Templateblokken en -secties weergeven of verbergen op basis van dynamische variabelen
Wat je leert
Lees hoe je een bepaald blok of gedeelte in een e-mail aan bepaalde ontvangers kunt tonen met behulp van de template-editor en de logica voor tonen/verbergen.
Je kunt dit gebruiken om verschillende content weer te geven aan bijvoorbeeld mensen in bepaalde loyaliteitsniveaus of die een bepaald product hebben gekocht. Met deze functie kun je de content van je e-mail targeten op basis van informatie over je abonnees, zodat elke ontvanger een zeer gepersonaliseerde marketingervaring heeft.
Voordat je van start gaat
Je kunt content weergeven/verbergen op basis van:
- Profielgegevens (d.w.z., profiel- of aangepaste eigenschappen)
- Eventvariabelen, maar alleen voor:
- Op gebeurtenissen getriggerde (ook wel op meetwaarde getriggerde) flow
- Aangepaste show-/hide-blokken met code
Voordat je je e-mail opstelt, moet je de gegevens die je nodig hebt in je account hebben. Met andere woorden: je moet 1 gebeurtenis of profiel hebben met de eigenschap die je wilt gebruiken.
Profielgegevens gebruiken
Als je voorwaarden wilt tonen/verbergen op basis van profielgegevens (bijv. locatie, taal, enz.), heb je minimaal 1 profiel met die gegevens nodig.
Profiel- en aangepaste eigenschappen kunnen op de volgende manieren worden toegevoegd:
- Aanmeldingsformulieren
- CSV-uploads
- E-commerce-integraties
- Integraties voor lijstgroei en loyaliteit, zoals Typeform of Yotpo
Meer informatie over profieleigenschappen in Klaviyo.
Gebeurteniseigenschappen gebruiken
Op dezelfde manier geldt voor gebeurteniseigenschappen dat er 1 gebeurtenis in je Klaviyo-account moet zijn. Vervolgens kun je blokken tonen/verbergen op basis van de triggergebeurtenis van die flow met behulp van aangepaste codeblokken. Je kunt geen gebeurtenisgegevens raadplegen met behulp van de logic builder.
Dus in een flow voor winkelwagen verlaten met de trigger Started Checkout kun je toon/verberg-voorwaarden opbouwen op basis van de waarde van een winkelwagen of de specifieke items die de klant heeft toegevoegd.
Stel je bericht op
De show/hide-logica-builder ondersteunt profielgegevens die zijn opgemaakt als tekst, cijfers en lijsten. Deze ondersteunt geen gebeurtenisgegevens, datums of booleans. Als je niet-ondersteunde gegevens wilt gebruiken in je show/hide-voorwaarde, gebruik dan aangepaste code om de voorwaarde te schrijven.
- Voeg een blok of sectie toe aan een e-mailtemplate.
- Selecteer het tabblad Weergave.
- Selecteer onder Logica weergeven/verbergen de optie Logica builder gebruiken.
- Selecteer een voorwaarde.
- Je kunt een eenvoudige voorwaarde maken met één criterium, of een complexere voorwaarde met meerdere criteria die met EN of OF zijn verbonden. Meer informatie over AND- versus OR-connectors.
- Gebruik de knop Voorwaarde toevoegen om desgewenst extra voorwaarden toe te voegen.
- Selecteer Save (opslaan).
Als je logica voor tonen/verbergen gebruikt op een sectie en een blok binnen die sectie, kunnen de instellingen met elkaar interageren en conflicten veroorzaken. Lees meer in ons artikel over weergaveopties.
EN vs. OF in weergeven-/verbergen-voorwaarden
Bij het evalueren van toon/verberg-logica worden voorwaarden die met AND zijn verbonden geëvalueerd vóór voorwaarden die met OR zijn verbonden. Houd rekening met de volgorde waarin je logica wordt geëvalueerd wanneer je deze opschrijft, om ervoor te zorgen dat deze wordt geïnterpreteerd zoals je bedoelt.
Neem als voorbeeld de volgende voorwaarde:
Bekijk aan de hand van deze criteria of het blok zichtbaar is voor enkele voorbeeldontvangers:
Ontvanger | Wordt het blok weergegeven? | Waarom? |
Jan loyalty_points = 145 Favoriete kleur = groen Favoriete fruit = banaan | Nee | Jane zou in aanmerking kunnen komen als haar favoriete kleur blauw was, of als haar favoriete fruit banaan was. |
Alex Favoriete kleur = blauw Favoriet fruit = appel | Nee | Alex zou in aanmerking kunnen komen met meer loyaliteitspunten of als zijn favoriete fruit kiwi was. |
Amanda Favoriete kleur = blauw Favoriet fruit = granaatappel | Ja | Amanda komt in aanmerking omdat ze > 99 loyaliteitspunten heeft en haar favoriete kleur blauw is. Haar favoriete fruit wordt niet meegenomen, omdat ze aan beide criteria voldoet aan de andere kant van de OR-operator. |
Stephanie Lievelingskleur = oranje Favoriete vrucht = kiwi | Ja | Stephanie komt in aanmerking omdat haar favoriete fruit kiwi is. De andere voorwaarden worden niet meegenomen omdat ze voldoet aan de criteria aan één kant van de OF-operator. |
Use cases voor blokken weergeven/verbergen
Banner voor loyaliteitsprogramma
Als je een loyaliteitsprogramma hebt, laat je actieve deelnemers zien hoeveel punten ze momenteel hebben. Bied contacten die zich nog niet hebben aangemeld voor het programma een incentive om mee te doen. Om dit in te stellen, heb je 2 banners nodig.
Toon actieve deelnemers aan het loyaliteitsprogramma een banner met deze toon/verberg-voorwaarde:
Loyalty points > is groter dan 0
Laat prospects een banner zien met deze voorwaarde:
loyalty_points > is niet ingesteld
Mogelijk moet je de criteria aanpassen op basis van de data die beschikbaar is in je eigen account.
Gepersonaliseerde afbeeldingen
Als je informatie verzamelt over hoe je abonnees je product gebruiken, laat ze dan beelden zien die op hen betrekking hebben.
Een merk dat rugzakken verkoopt, kan bijvoorbeeld vragen of abonnees ze gebruiken voor woon-werkverkeer, reizen of wandelen. Afhankelijk van hun antwoord kan dit merk beelden tonen van hun producten in die omgevingen.
Om dit in te stellen, heb je 3 afbeeldingsblokken nodig waarop je je product in 3 verschillende settings laat zien.
Toon forenzen een foto van een fietser die tijdens een woon-werkrit de rugzak draagt met deze voorwaarde:
Tasvoorkeur = woon-werkverkeer
Toon reizigers een foto van een van je rugzakken in een drukke luchthaven met deze voorwaarde:
Tasvoorkeur = Reizen
Toon alle anderen een foto van een van je rugzakken in een schilderachtig buitenlandschap met deze voorwaarde:
Voorkeur voor tas > komt niet overeen met > Reizen EN voorkeur voor tas > komt niet overeen met > Forenzen
Let erop dat de laatste afbeelding niet alleen op wandelaars is gericht; iedereen die geen forens of reiziger is, ziet hem. Het is belangrijk om rekening te houden met ontvangers bij wie deze eigenschap mogelijk niet is ingesteld, zodat je e-mail er voor iedereen geweldig uitziet.
Productspecifieke notities
Om een item te refereren vanuit de triggergebeurtenis van een flow, moet je aangepaste code gebruiken.
Communiceer productspecifieke informatie naar mensen die hun winkelwagen hebben verlaten, zodat ze belangrijke informatie krijgen die hun aankoopbeslissing kan beïnvloeden. Als je bijvoorbeeld bijna door een product heen bent, voeg je een tekstblok toe met een waarschuwing voor een lage voorraad die alleen wordt weergegeven voor mensen met dat item in hun winkelwagen met deze voorwaarde:
ITEM_NAME in event.Items
Locatiespecifieke berichten
Locatiespecifieke voorwaarden kunnen alleen tekst evalueren; ze kunnen geen afstand vanaf een postcode evalueren. Toon een aangepaste banner aan inwoners die in een bepaald gebied wonen, zoals mensen in dezelfde plaats als je pop-upshop met fysieke locatie, met deze voorwaarde:
Stad = Boston
Problemen oplossen met blokken weergeven/verbergen
Als je blok voor tonen/verbergen niet wordt weergegeven zoals verwacht, gebruik je de knop Converteren naar code om de builderlogica om te zetten naar code. Van daaruit kun je de code inspecteren en aanpassen zodat deze wordt weergegeven zoals verwacht.
Logica omzetten naar code is niet omkeerbaar.
Controleer bij probleemoplossing of het gegevenstype dat je in je conditiewaarde gebruikt hetzelfde is als het gegevenstype in de profielen waar je naar verwijst. Bijvoorbeeld: het getal 22 is anders dan de tekstwaarde "22". Als je conditie is ingesteld op Getal maar je waarden als tekst zijn opgeslagen op het profiel, kan de conditie niet correct worden geëvalueerd.
Tekst naar getallen converteren
Als je getaleigenschappen hebt, maar ze als tekst in een profiel zijn opgeslagen, kun je ze in het veld voor aangepaste code omzetten naar getallen met behulp van de filter |multiply. Om dit te gebruiken, voeg je de filter direct na de variabelenaam toe:
person.Birthday|multiply:"1" > 21
Booleans opgeslagen als tekst
Als je waar/onwaar-gegevens als tekst zijn opgeslagen (niet als een booleaanse waarde), of als je verwijst naar een eigenschap die zowel booleaanse waarden als tekst bevat, kun je deze structuren gebruiken om alle scenario's af te dekken. Neem alle spellingen en hoofdlettergebruik over die in je gegevens voorkomen.
Voorbeeldvoorwaarde | Toon het blok als... |
person|lookup:'VIP' == 1 or person|lookup:'VIP' == 'true' or person|lookup:'VIP' == 'True' | De VIP-eigenschap is ingesteld op de booleaanse waarde true of de strings true of True |
person|lookup:'VIP' == 0 or person|lookup:'VIP' == 'false' or person|lookup:'VIP' == 'False' | De VIP-eigenschap is ingesteld op de booleaanse waarde false of de strings false of False |
Niet-alfanumerieke tekens in eigenschappen
Als de eigenschappen of waarden waarnaar in je tonen/verbergen-blok wordt verwezen niet-alfanumerieke tekens bevatten (bijv. symbolen zoals =, ), wordt je voorwaarde niet ondersteund en zie je een foutmelding. Gebruik voor de beste resultaten alleen letters (hoofdletters of kleine letters, hoofdlettergevoelig), cijfers, underscores (_), of koppeltekens (-).
Aangepaste code om blokken weer te geven/te verbergen
Als je meer controle wilt, of als je een voorwaarde wilt opbouwen met eventgegevens, datums of booleans, gebruik dan aangepaste code voor je tonen/verbergen-blokken in plaats van de logic builder. Als je helemaal opnieuw wilt beginnen met code, selecteer je de knop Code gebruiken in de instellingen voor tonen/verbergen-logica.
Je kunt ook een bestaande voorwaarde voor tonen/verbergen omzetten om code te gebruiken met de knop Converteren naar code.
Logica omzetten naar code is niet omkeerbaar.
Als je ervoor kiest om code te gebruiken, zorg er dan voor dat je Django, programmeerlogica en Klaviyo's gegevenstypen goed begrijpt. Het supportteam van Klaviyo kan geen directe ondersteuning of probleemoplossing bieden voor aangepaste code.
Meer informatie over ondersteunde conditiestructuren.
Voorwaarden weergeven/verbergen op basis van eventgegevens
Als je e-mail wordt verzonden als onderdeel van een door een gebeurtenis getriggerde flow (bijv. een flow voor winkelwagen verlaten of orderbevestiging), kun je blokken weergeven/verbergen op basis van de details van de triggergebeurtenis van die flow. Dus in een flow voor winkelwagen verlaten met de trigger Checkout gestart kun je met aangepaste code voorwaarden voor tonen/verbergen instellen op basis van de waarde van een winkelwagen of de specifieke items die de klant heeft toegevoegd. Meer informatie over gebeurtenisvariabelen.
Begrijp hoe gegevens worden opgeslagen
Controleer voordat je je show/hide-voorwaarde configureert hoe je gegevens zijn opgeslagen. Er zijn 5 gegevenstypen in Klaviyo:
- Tekst
- Aantal
- Datum
- Booleaans
- Lijst
Hoe je gegevens worden opgeslagen, beïnvloedt welke weergeven/verbergen-voorwaarden voor jou werken. Ontdek hoe je gegevenstypen kunt identificeren in je eigen account.
Stel je bericht op
De eerste stap om aangepaste, gecodeerde tonen/verbergen-voorwaarden in een bericht toe te voegen, is het bouwen van de e-mailtemplate. In deze sectie lopen we een specifiek voorbeeld door, maar je kunt dezelfde stappen volgen om een blok zo in te stellen dat het wordt weergegeven op basis van je eigen criteria.
Als je bedrijf bijvoorbeeld leren tassen verkoopt, kun je klantvoorkeuren verzamelen over hoe ze hun tassen gebruiken met een aanmeldingsformulier, zoals hieronder wordt getoond.
Je kunt vervolgens een andere afbeelding weergeven op basis van de tasvoorkeur van je klant. Als de voorkeur van de klant bijvoorbeeld "Werk" is, verschijnt de tas in een afbeelding naast een laptop. Als de voorkeur van de klant "Buiten" is, verschijnt de tas in de buurt van een schilderachtig uitzichtpunt langs een wandelpad.
- Een campagne- of flowbericht maken.
- Voeg een afbeeldingsblok toe.
- Upload de werkgerelateerde afbeelding naar het blok.
- Klik in het aanpassingsmenu van het afbeeldingsblok op Weergave .
- Selecteer onder Logica voor tonen/verbergen de optie Code gebruiken.
- Voeg deze voorwaarde toe: person|lookup:'Bag Preference' == 'Work'.
- Klik op Wijzigingen opslaan.
- Klik op Gereed op het blok.
Dit blok wordt alleen getoond aan mensen die "Werk" als hun voorkeur hebben geselecteerd.
Voeg vervolgens de reisgerelateerde afbeelding toe aan een nieuw blok onder de werkgerelateerde afbeelding. Volg dezelfde stappen als eerder, maar gebruik deze keer de voorwaarde person|lookup:'Bag Preference' == 'Outdoors'.
Dit blok wordt alleen weergegeven aan mensen die “Outdoors” als voorkeur hebben geselecteerd.
Voeg tot slot een afbeelding toe die wordt weergegeven voor iedereen die "Work" of "Outdoors" niet heeft geselecteerd. Gebruik een meer generieke afbeelding en deze voorwaarde: person|lookup:'Bag Preference' != 'Work' en person|lookup:'Bag Preference' != 'Outdoors'.
Hier betekent != "is niet gelijk aan", dus deze voorwaarde zoekt naar mensen die iets anders dan "Work" of "Outdoors" hebben gekozen, of nooit een voorkeur hebben geselecteerd.
Zodra je elk van de blokken hebt geconfigureerd, kun je een voorbeeld van je bericht bekijken met 3 profielen. Deze profielen moeten abonnees zijn die aan één van elk van de afbeeldingscriteria voldoen:
- Klant die “Outdoor” heeft gekozen
- Klant die "Werk" heeft gekozen
- En klanten zonder voorkeur/andere voorkeur
Je kunt deze stappen gebruiken om blokken weer te geven of te verbergen op basis van profiel- of gebeurtenisgegevens in je account.
Maak een voorwaarde voor tonen/verbergen met profielgegevens
Als je een voorwaarde voor weergeven/verbergen met aangepaste code bouwt op basis van een profieleigenschap, vervang dan de voorbeeldvariabele uit de tabellen in de referentie voor voorwaardelijke logica (bijv. person|lookup:'Favorite Color') door je profieleigenschap.
Zo vind je de juiste variabele om te gebruiken:
- Klik op Personalisatie om het personalisatiemenu te openen.
- Kies een optie in het menu om deze toe te voegen aan het tekstblok.
- Kopieer de variabelenaam van binnen de tag. Om de variabelenaam te identificeren, verwijder je de accolades rond de variabele, evenals |default:'' aan het einde (indien aanwezig), samen met eventuele andere filters.
In de screenshot hieronder is de volledige tag bijvoorbeeld {{ person|lookup:"Accepts Marketing"|default:"" }}. De variabelenaam is person|lookup:"Accepts Marketing", dus selecteer dat gedeelte om te gebruiken in je show/hide-voorwaarde.
Maak een show/hide-voorwaarde met gebeurtenisgegevens
Je kunt eventgegevens gebruiken om een blok te tonen of te verbergen als je bericht deel uitmaakt van een door een event geactiveerde flow. Alleen gegevens binnen de triggergebeurtenis kunnen worden gebruikt in een tonen/verbergen-voorwaarde.
Zo identificeer je gebeurtenisvariabelen:
- Klik in de template-editor op Voorbeeld weergeven en testen.
- Klik onder Voorbeeldgegevensbron op Gebeurtenis.
- Selecteer in het dropdownmenu de gebeurtenis die het bericht dat je bouwt, zal activeren.
- Scroll door de Eventeigenschappen om de gegevens te vinden die je wilt opnemen.
- Klik op de eigenschapsnaam om de tag te kopiëren.
- Plak de tag in een tekstblok of teksteditor.
- Verwijder de accolades (d.w.z. {{ en }}) uit de tag, evenals eventuele filters.
- Gebruik de variabele die in je tonen/verbergen-voorwaarde blijft staan.
In de screenshot hieronder zie je de tag {{ event|lookup:'Item Count' }}. Je hebt alleen de tekst event|lookup:'Item Count' nodig voor je show/hide-voorwaarde. Let op: je gegevens kunnen een andere structuur gebruiken, zoals {{ event.extra.line_items.0.title }} of {{ event.ShippingAddress.address1 }}. Gebruik de variabele zoals deze in je eventgegevens wordt weergegeven.
Je voorwaarden voor tonen/verbergen aanpassen
Leer hoe je aangepaste voorwaarden voor tonen/verbergen maakt met behulp van de referentie voor voorwaardelijke logica. Deze bron bevat voorbeeldvoorwaarden, die je kunt aanpassen met je eigen profiel- en gebeurtenisdata.
Extra hulpbronnen
- Voorwaardelijke logica-referentie voor template
Kom meer te weten over alle beschikbare voorwaarden die je kunt gebruiken om een blok, sectie of een aangepaste code-inhoud alleen dynamisch weer te geven voor bepaalde ontvangers. Wil je weten hoe je deze voorwaarden in je template kunt gebruiken? Lees dan ons artikel over hoe je templateblokken kunt weergeven of verbergen op basis van dynamische variabelen.
- Gids voor personalisatie van berichten
Leer hoe je templatetags van Klaviyo, of tags, kunt gebruiken om de ervaring voor je klanten aan te passen.
- Inzicht in profielen in Klaviyo
Leer meer over profielen, waaronder hoe je ze kunt vinden en welke gegevens beschikbaar zijn op de profielpagina. Profielen worden gebruikt om alle informatie die je over je klanten en prospects hebt bij te houden.
- Apply programming logic concepts to build more personalized messages