Hoe filters gebruiken om variabelen aan te passen

Wat je leert

Leer hoe filters werken en hoe je ze kunt gebruiken om variabelen aan te passen. Met filters kun je het formaat en de inhoud van variabelen (d.w.z. templatetag) in je berichten aanpassen. Voor een lijst van filters die beschikbaar zijn om te gebruiken in de template editor, zie Klaviyo's variabele filters verklarende woordenlijst. 

Voordat je van start gaat

Voordat je aan de slag gaat, moet je weten hoe personalisatie werkt in Klaviyo. Om filters te kunnen gebruiken, moet je de juiste basisvariabelen kunnen identificeren en toevoegen aan je template. 

Hoe filters werken

Filters worden toegepast op templatetag om de uitvoer die wordt weergegeven aan te passen. Enkele mogelijke gebruikssituaties zijn:

• Consequent hoofdlettergebruik toepassen op een stuk tekst (je kunt bijvoorbeeld de bovenste filter gebruiken om een willekeurige variabele te nemen en er allemaal hoofdletters van te maken).
• Toon de prijs van een artikel nadat een promotie is toegepast met behulp van het vermenigvuldigingsfilter. 
• Stel het aantal decimalen in dat moet worden weergegeven voor een getalvariabele met behulp van het floatformat filter.

Raadpleeg onze verklarende woordenlijst voor variabele filters voor een lijst van ondersteunde filters. 

Een filter toepassen op een variabele

Om een filter toe te passen op een variabele:

1. Identificeer je sjabloontag (bijv, {{ item.price }}).
2. Voeg een pijpsymbool ( | ) toe na de naam van de variabele. 
3. Voeg een filternaam toe, zoals floatformat, om het aantal decimalen op te geven dat moet worden weergegeven.
4. Als het filter argumenten nodig heeft (d.w.z. extra parameters of invoer), voeg dan een dubbele punt toe, gevolgd door het (de) argument(en). 

Voeg geen extra spaties toe. Hier is een voorbeeld van een variabele waarop een filter is toegepast:

{{ item.price|floatformat:2 }}

In dit voorbeeld is item.price de variabelenaam, floatformat is de filter en 2 is het argument dat de filter nodig heeft. 

Als het argument een stuk tekst is, moet het omgeven worden door rechte enkele aanhalingstekens (dus ', niet '). Aanhalingstekens zijn niet nodig als het argument een getal is. Raadpleeg de verklarende woordenlijst voor variabele filters van Klaviyo voor voorbeelden. 

Tips voor het gebruik van filters

Als je filters kopieert en in je template plakt, zorg er dan voor dat je ze als platte tekst plakt om te voorkomen dat je opmaak in het filter zelf plakt. Gebruik de sneltoets Plakken als platte tekst (Ctrl+Shift+V of Cmd+Shift+V). 

Het is belangrijk om ervoor te zorgen dat de gegevens waarnaar wordt verwezen in je variabelen geschikt zijn voor het filter dat wordt gebruikt. Sommige filters kunnen alleen worden toegepast op soorten tekstgegevens, terwijl andere alleen werken op lijsten of getallen. Als het filter niet werkt zoals verwacht, bekijk dan de gebeurtenis- of profielgegevens die je gebruikt om er zeker van te zijn dat ze van het juiste type zijn. 

Meerdere filters toepassen

Indien nodig kun je meerdere filters toepassen op een enkele variabele. Om dit te doen, verbind je elk filter met een pijpsymbool ( | ) en bedenk je dat de filters over het algemeen in volgorde worden toegepast (van eerst naar laatst). Hier zijn enkele voorbeelden van variabelen waarop meerdere filters zijn toegepast: 

{{ first_name|title|default:'there' }}

Het eerste filter past titelcasing toe op de voornaam van de ontvangers en het tweede filter geeft een standaardwoord dat moet worden gebruikt als er geen voornaam is opgegeven. 

{{ item.price|multiply:.8|floatformat:2 }}

Het eerste filter vermenigvuldigt de basisprijs met .8 (om de prijs te tonen als er een coupon met 20% korting is toegepast), en het tweede filter geeft aan dat er twee cijfers achter de komma moeten verschijnen. 

Extra hulpbronnen

• Woordenlijst variabele filters
• Datumvariabelen in sjabloonreferentie
• Referentie personalisatie bericht