Hoe gebruik je aangepaste objecten in een sjabloon
Je moet toegang hebben tot aangepaste objecten om deze functionaliteit te kunnen gebruiken.
Wat je leert
Leer hoe je aangepaste objecten kunt gebruiken in sjablonen, zodat je objectgegevens kunt gebruiken in flow en campagneverzendingen.
Je moet eerst een object maken voordat je aangepaste objectgegevens kunt gebruiken in een sjabloon.
Objectgegevens openen via het personalisatiemenuObjectgegevens openen via het personalisatiemenu
Je kunt tekstblok in template editor personaliseren met behulp van eigenschappen van een aangepast object, of het aantal records voor een object.
Leer hoe je Klaviyo's template editor gebruikt.
Om te beginnen met het toevoegen van objectgegevens aan je sjabloon:
- Voeg een nieuw tekstblok toe of bewerk de tekst in een bestaand tekstblok in je template.
- Selecteer de knop Personalisatie rechtsboven.
- Selecteer in het personalisatievenster Objecten in de vervolgkeuzelijst Alle typen .
- Binnen Objecten zie je alle objecten op je account die je kunt gebruiken om gegevens naar template te halen. Selecteer het object dat de gegevens bevat die je wilt gebruiken in de template.
- Selecteer de specifieke objecteigenschap of objectfilter om op te nemen in de template. Je kunt hier ook een nieuw objectfilter maken.
- Stel de standaardtekst en eventuele stijlen voor je tekst in.
Om de hoofdletterregels voor objectgegevens op te geven, moet je de regel handmatig instellen in de sjabloontag. Bijvoorbeeld:
-
{{ object.full_name|title|default:'value' }}
John Doe -
{{ object.full_name|upper|default:'value' }}
JOHN DOE -
{{ object.full_name|lower|default:'value' }}
onbekende Jan
Leer meer over het wijzigen van waarden met Django filters.
Objectgegevens openen met templatetagObjectgegevens openen met templatetag
Je kunt templatetag gebruiken in e-mail (inclusief de onderwerpregel van de e-mail), sms/mms-berichten, pushmelding en Klaviyo Customer Hub om objectgegevens weer te geven.
Leer hoe je templatetag gebruikt in Klaviyo.
Objectsjabloontag verwijzingObjectsjabloontag verwijzing
Je kunt de volgende templatetag gebruiken met objecten.
Met het object dat een flow
{{ object }} is alleen beschikbaar als een object een flow heeft geactiveerd. De {{ object }} templatetag is alleen beschikbaar in een door datum getriggerde stroom op basis van een object. Dit is vergelijkbaar met de {{ event }} templatetag voor event triggered flow.
Deze voorbeelden gebruiken het volgende:
- Object met de naam Huisdier waarnaar wordt verwezen met het object tag in de template.
- Objecteigenschap Naam
| Structuur | Voorbeeld |
| {{ object.object_property }} | {{ object.Name }} |
| {{ object | lookup:'object_property' }} | {{ object | lookup:'Name' }} |
Een object ophalen op ID
Deze voorbeelden gebruiken het volgende:
- Object genaamd Huisdier
- Objecteigenschap Naam
- Gebeurtenis die de flow activeerde met een objecteigenschap genaamd pet_id. Dit veld is hetzelfde als het object ID voor het Huisdierobject.
| Structuur | Voorbeeld |
|
{% customobject event.object_id object_type_title="Title" as alias %} {{ alias.object_property }} {% endcustomobject %} |
{% customobject event.pet_id object_type_title="Pet" as pet %} {{ pet.Name }} {% endcustomobject %} |
|
{% customobject event.object_id object_type_title="Title" as alias %} {{ alias | lookup:'object_property' }} {% endcustomobject %} |
{% customobject event.pet_id object_type_title="Pet" as pet %} {{ pet | lookup:'Name' }} {% endcustomobject %} |
Geeft een enkel object weer uit een objectfilter
Deze voorbeelden gebruiken het volgende:
- Een extra objectfilter met de naam oudste_hond
- Objecteigenschap Naam
| Structuur | Voorbeeld |
|
{{ object_filter.object_filter_name.object_property}} | {{ object_filter.oldest_dog.Name }} |
| {{ object_filter.object_filter_name | lookup: 'object_property' }} | {{ object_filter.oldest_dog | lookup: 'Name' }} |
Geef een geheel getal terug van een objectfilter
Deze voorbeelden gebruiken het volgende:
- Een extra objectfilter genaamd count_of_dogs
| Structuur | Voorbeeld |
| {{ object_filter.object_filter_name }} | {{ object_filter.count_of_dogs }} |
Objectrecords ophalen
Om de meest recente objectrecords voor een object op te halen, moet u door alle objectrecords lussen. Dit voorbeeld gebruikt het volgende:
- Object genaamd Huisdieren
| Structuur | Voorbeeld |
| {% customobjects object_type_title="Title" as alias %}
{% for object_instance in alias %} {{ object_instance.record }} {% endfor %} {% endcustomobjects %} |
{% customobjects object_type_title="Pet Profile" as pets %} |
Objectgegevens in onderwerpregel
Je kunt je onderwerpregel personaliseren met een van de aangepaste objecttags:
- {% object_filter %}
- {% object %}
- {% customobject %}
Je kunt bijvoorbeeld de tag {% object %} gebruiken in de onderwerpregel van je bericht om de naam van het huisdier van een klant direct weer te geven.
Ontwerpweergave:
Email voorvertoning:
Objectgegevens in tonen/verbergen-logica
Je kunt ook instellen of een blok in een template moet worden weergegeven of verborgen op basis van objectgegevens. Het dynamisch tonen of verbergen van een blok op basis van objectgegevens gebruikt dezelfde tag als de templatebouwer. Je kunt naar objecten verwijzen op basis van ID, eigenschappen van objectfilters of aggregaten van objectfilters.
Je moet objectfilters maken voordat je ernaar kunt verwijzen in de tonen/verbergen logica.
Als je bijvoorbeeld een Huisdierobject hebt met een eigenschap genaamd Ras, kun je ervoor kiezen om een blok alleen te tonen aan huisdiereigenaren met een bepaald hondenras met behulp van de voorwaarde object.Ras .
Om de tonen/verbergen logica in te stellen, klik je op het blok waarvoor je de regels wilt instellen en selecteer je Gebruik code op het tabblad Weergave.
Voer de voorwaarde direct in de code editor in. Je kunt objectfilters en het object templatetag gebruiken als het een bericht is voor een datumgetriggerde flow gebaseerd op objectgegevens.
Voor meer flexibiliteit (bijvoorbeeld om bepaalde informatie afhankelijk te maken van informatie die wordt geretourneerd door {% customobject %} of {% customobjects %}) kun je overwegen om geavanceerde voorwaardelijke logica te gebruiken met {% if … %} logica direct in een tekstblok.
ObjectfiltersObjectfilters
Wat is een objectfilter?Wat is een objectfilter?
Objectfilters schakelen je in om de geretourneerde objectrecords te beperken op basis van specifieke criteria die je instelt, zodat je records van een bepaald type kunt weergeven.
Maak een nieuw objectfilterMaak een nieuw objectfilter
Om te beginnen met het maken van een objectfilter:
- Voeg een nieuw tekstblok toe of bewerk de tekst in een bestaand tekstblok in je template.
- Selecteer de knop Personalisatie .
- Selecteer in het personalisatiemodel Objecten in de vervolgkeuzelijst Alle typen .
- Selecteer het object dat de gegevens bevat waarvoor je een filter wilt instellen.
- Selecteer de objecteigenschap waarvoor je een filter wilt instellen.
- Selecteer Nieuw filter maken.
Stel in het modal Objectfilter maken de volgende informatie in:
-
Naam
Maak een naam voor je objectfilter. -
Filter voorwaarden
Definieer de regels waaraan een object moet voldoen om opgenomen te worden in het tekstblok. -
Gedrag als 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 deze gebruiken in de show/hide logica en templatetag om specifieke objectrecords weer te geven op basis van de criteria die je hebt ingesteld.
Extra hulpbronnenExtra hulpbronnen
Referentie personalisatie bericht
Hoe je het voorbeeldvenster gebruikt voor het personaliseren van berichten