Aangepaste objecten gebruiken in templates

Wat je leert

Ontdek hoe je aangepaste objecten in templates gebruikt, zodat je objectgegevens kunt gebruiken bij flow- en campagneverzendingen.

Je moet eerst een object maken voordat je aangepaste objectgegevens in template kunt gebruiken.

Objectgegevens openen via het menu Personalisatie

Je kunt tekstblokken in de template-editor personaliseren met eigenschappen van een aangepast object of met het aantal records voor een object.

Ontdek hoe je de template-editor van Klaviyo gebruikt.

Zo ga je aan de slag met het toevoegen van objectgegevens aan je templates:

1. Voeg een nieuw tekstblok toe of selecteer een bestaand tekstblok.
2. Dubbelklik op het tekstblok en plaats vervolgens je cursor op de plek waar je je dynamische eigenschap wilt invoegen.
3. Selecteer de knop Personalisatie rechtsboven.

4. Selecteer in de personalisatiemodal Objecten in de vervolgkeuzelijst Alle typen .

5. In Objecten zie je alle objecten in je account die je kunt gebruiken om gegevens in de template te laden. Selecteer het object dat de gegevens bevat die je in de template wilt gebruiken.
6. Selecteer de specifieke objecteigenschap of objectfilter die je in de template wilt opnemen. Je kunt hier ook een nieuw objectfilter maken.
7. Stel de standaardtekst en eventuele stijlen voor je tekst in.

Als je de regels voor hoofdlettergebruik voor objectgegevens wilt specificeren, moet je de regel handmatig instellen in de personalisatietag. Bijvoorbeeld:

• {{ object.full_name|title|default:'value' }}
  John Doe
• {{ object.full_name|upper|default:'value' }}
  JOHN DOE
• {{ object.full_name|lower|default:'value' }}
  john doe

Meer informatie over waarden wijzigen met Django-filters.

Objectgegevens openen met personalisatietags

Je kunt personalisatietags gebruiken in e-mails (inclusief de onderwerpregel van de e-mail), sms/mms-berichten, pushmeldingen en Klaviyo Customer Hub om objectgegevens weer te geven.

Meer informatie over hoe je personalisatietags in Klaviyo gebruikt.

Referentie voor objectpersonalisatietags

Je kunt de volgende personalisatietags met objecten gebruiken.

Het object gebruiken dat een flow heeft getriggerd

Deze voorbeelden gebruiken het volgende:

• Object met de naam Pet dat wordt gerefereerd met de object tag in de template. 
• Objecteigenschap met de naam Naam

Een object op ID ophalen

Deze voorbeelden gebruiken het volgende:

• Object met de naam Pet
• Objecteigenschap met de naam Naam
• Event dat de flow heeft getriggerd met een objecteigenschap met de naam pet_id. Dit veld is hetzelfde als de object-ID voor het object Pet.

Geeft een enkel object weer uit een objectfilter

Deze voorbeelden gebruiken het volgende:

• Een extra objectfilter met de naam oldest_dog
• Objecteigenschap met de naam Naam

Geeft een geheel getal weer uit een objectfilter

Deze voorbeelden gebruiken het volgende:

• Een extra objectfilter met de naam count_of_dogs

Objectrecords ophalen

Om de meest recente objectrecords voor een object op te halen, moet je door alle objectrecords loopen. In dit voorbeeld wordt het volgende gebruikt:

• Object genaamd Huisdieren

Objectgegevens in onderwerpregels

Je kunt je onderwerpregels personaliseren met een van de aangepaste objecttags:

• {% object_filter %}
• {% object %}
• {% customobject %}

Je kunt bijvoorbeeld de tag {% object %} in de onderwerpregel van je bericht gebruiken om de naam van de huisdier van een klant direct weer te geven.

Conceptweergave:

E-mailvoorbeeld:

Objectgegevens in logica voor weergeven/verbergen

Je kunt ook instellen of je een blok in een template wilt weergeven of verbergen op basis van objectgegevens. Een blok dynamisch weergeven of verbergen op basis van objectgegevens gebruikt dezelfde tags als de templatebouwer. Je kunt naar objecten verwijzen op ID, eigenschappen uit objectfilters of aggregaties uit objectfilters.

Als je bijvoorbeeld een Pet -object hebt met een eigenschap met de naam Breed, kun je ervoor kiezen om een blok alleen te tonen aan huisdiereigenaren met een bepaald hondenras met behulp van de voorwaarde object.Breed .

Om logica voor tonen/verbergen in te stellen, klik je op het blok waarvoor je de regels wilt instellen en selecteer je Code gebruiken op het tabblad Weergave.

Voer de voorwaarde rechtstreeks in de code-editor in. Je kunt objectfilters en de object-templatetag gebruiken als het om een bericht gaat voor een flow die door een datum wordt geactiveerd op basis van objectgegevens.

Voor meer flexibiliteit (bijv. om bepaalde informatie voorwaardelijk te maken op basis van informatie die wordt geretourneerd door {% customobject %} of {% customobjects %}), kun je overwegen om geavanceerde voorwaardelijke logica te gebruiken met {% if ... %}-logica rechtstreeks in een tekstblok.

Objectfilters

Wat is een objectfilter?

Met objectfilters kun je de geretourneerde objectrecords beperken op basis van specifieke criteria die je instelt, zodat je records van een bepaald type kunt weergeven.

Een nieuw objectfilter maken

Om aan de slag te gaan met het maken van een objectfilter:

1. Voeg een nieuw tekstblok toe of bewerk de tekst in een bestaand tekstblok in je template.
2. Selecteer de knop Personalisatie .

3. Selecteer binnen het personalisatiemodel Objecten in de dropdown Alle typen .
4. Selecteer het object dat de gegevens bevat waarvoor je een filter wilt instellen.
5. Selecteer de objecteigenschap waarvoor je een filter wilt instellen.
6. Selecteer Nieuwe filter maken.

Stel in het modaal venster Objectfilter maken de volgende informatie in:

• Naam
  Maak een naam voor je objectfilter.
• Filtervoorwaarden
  Definieer de regels waaraan een object moet voldoen om te worden opgenomen in het tekstblok.
• Gedrag wanneer meerdere records aan de voorwaarden voldoen
  Definieer het gedrag voor gevallen waarin meerdere records aan de voorwaarden voldoen.

Zodra je objectfilter is gemaakt, kun je het gebruiken in logica voor tonen/verbergen en personalisatietags om specifieke objectrecords weer te geven op basis van de criteria die je hebt ingesteld.

Extra hulpbronnen