Så använder du anpassade objekt i mallar

Du kommer att lära dig

Lär dig hur du använder anpassade objekt i mallar så att du kan använda objektdata i flödes- och kampanjutskick.

Du måste skapa ett objekt innan du kan använda anpassade objektdata i mallar. För personaliseringsmenyn, objektfilter och mottagarpostlistor ska du använda ett objekt med en profilrelation. Dess poster måste vara länkade till mottagaren för att visas i deras meddelande.

Åtkomst till objektdata via personaliseringsmenyn

Du kan anpassa textblock i dra-och-släpp-redigeraren för mallar med hjälp av egenskaper från ett anpassat objekt, eller antalet poster för ett objekt.

Lär dig hur du använder Klaviyo mallredigerare.

Om du börjar med en HTML-mall kan du först skapa en drag-and-drop-kopia:

1. Navigera till Innehåll > Mallar och öppna sedan E-post: sparad. Öppna 3-punktsmenyn för din HTML-mall och välj Klona till dra och släpp.
2. Öppna Konverterade mallar för att kontrollera förloppet. När statusen är Klar att använda klickar du på den konverterade mallens namn för att öppna den.
3. Granska textens layout och personliga innehåll innan du använder den. Den ursprungliga HTML-mallen är oförändrad.

Så här kommer du igång med att lägga till objektdata i dina mallar:

1. Lägg till ett nytt textblock eller välj ett befintligt textblock.
2. Dubbelklicka i textblocket och placera sedan markören där du vill infoga din dynamiska egenskap.
3. Välj knappen Personalisering i textverktygsfältet.

4. I anpassningsmodulen väljer du Objekt i rullgardinsmenyn Alla typer .

5. I Objekt ser du alla objekt i ditt Konto som du kan använda för att hämta in data i mallen. Välj det objekt som innehåller den data du vill använda i mallen.
6. Välj en egenskap att visa eller Antal objekt för att visa ett antal. Välj sedan ett objektfilter. Du kan också skapa ett nytt objektfilter här.
7. Klicka på Infoga när du har valt ett befintligt filter. Om du skapar ett nytt filter infogas dess etikett när du är klar med att skapa det.
8. Använd de textstilar du behöver. För ett egenskapsvärde lägger du till standardtext genom att redigera dess etikett så att den innehåller |default:'value'. Ersätt value med den text du vill visa när egenskapen är tom.

För att ange versalreglerna för objektdata behöver du ställa in regeln manuellt i personaliseringstaggen. Till exempel använder de här etiketterna objektet som utlöste ett datumutlöst flöde:

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

Läs mer om att ändra värden med Django-filter.

Åtkomst till objektdata med personaliseringstagg

Du kan använda personaliseringstagg i e-postmeddelanden (inklusive e-postmeddelandets ämnesrad), sms-/mms-meddelanden, pushnotiser och Klaviyo Customer Hub för att visa objektdata.

Läs hur du använder personaliseringstagg i Klaviyo.

Referens för objektsanpassningstaggar

Du kan använda följande personaliseringstagg med objekt.

Använda objektet som utlöste ett flöde

De här exemplen använder följande:

• Objektet som heter Pet och som refereras med object -etiketten i mallen. 
• Objektsegenskap med namnet Name

Hämta ett objekt med ID

De här exemplen använder följande:

• Objektet heter Pet
• Objektsegenskap med namnet Name
• Händelse som utlöste flödet med en objektegenskap som heter pet_id. Det här fältet är samma som objekt-ID:t för objektet Pet.

Returnera ett enskilt objekt från ett objektfilter

De här exemplen använder följande:

• Ett ytterligare objektfilter med namnet oldestDog
• Objektsegenskap med namnet Name

Returnera ett heltal från ett objektfilter

De här exemplen använder följande:

• Ett ytterligare objektfilter som heter countOfDogs

Returnera flera objekt från ett objektfilter

För ett filter med namnet dogs som har konfigurerats med Multiple går du igenom de matchande posterna i en loop för att visa egenskapen Name för varje husdjur:

{% for pet in object_filter.dogs %}
{{ pet.Name }}
{% endfor %}

Hämta objektposter

Använd customobjects för att hämta upp till 5 poster som är länkade till mottagaren, sorterade från senast tillagda till äldsta. Loopa igenom de returnerade posterna för att visa deras egenskaper. I det här exemplet används följande:

• Objekt som heter Husdjurprofil
• Objektsegenskap med namnet name

Objektdata i ämnesrad

Använd samma syntax för anpassade objekt i ämnesrader som i meddelandetexten. De här exemplen visar syntaxen för varje datakälla:

• {{ object_filter.oldestDog.Name }} visar egenskapen Name från enobjektsfiltret oldestDog.
• {{ object.Name }} visar egenskapen Name från objektet som utlöste ett datumutlöst flöde.
• {% customobject event.pet_id object_type_title="Pet" as pet %}{{ pet.Name }}{% endcustomobject %} letar upp en Pet-post efter ID. Använd den i ett flöde som utlöses av en händelse som innehåller pet_id.

Använd till exempel {{ object.Name }} i ett datumutlöst flöde baserat på Pet-objektet för att visa en kunds husdjurs namn i ämnesraden.

Utkastvy:

E-postförhandsgranskning:

Objektdata i visa/dölj-logik

Du kan också konfigurera om du vill visa eller dölja ett block i en mall baserat på objektdata. Använd en egenskap eller ett antal från ett objektfilter, eller objektet som utlöste ett datumutlöst flöde. Du kan använda objektdata i ett enskilt villkor för visa/dölj eller i villkoret för varje variation av visa/dölj-logiken. För data som hämtas med ID ska du använda den avancerade villkorslogik som beskrivs nedan.

I ett datumutlöst flöde som till exempel baseras på ett Pet -objekt använder du object.Breed == 'Labrador' för att bara visa ett block när den utlösande husdjurets Breed är Labrador. Använd det exakta rasvärdet från din data.

1. Markera blocket och öppna fliken Visa. Under Visa/dölj-logik väljer du Visa endast för en specifik målgrupp eller Anpassa för flera målgrupper för att skapa logikvariationer. Välj sedan Använd kod.
2. Ange ett villkor, till exempel object_filter.countOfDogs > 0, utan {{ }} eller {% %} runt det. Objektfilter kan användas i kampanjer och flöden. Använd object endast i ett datumutlöst flöde baserat på objektdata.
3. Klicka på Spara för att tillämpa villkoret.

Anpassade objektavsnitt har stöd för logik för visa/dölj för endast en målgrupp. Logikvariationer är inte tillgängliga för dem. Läs mer om logikvariationer för visa/dölj.

För mer flexibilitet (t.ex. att göra viss information villkorad utifrån information som returneras av {% customobject %} eller {% customobjects %}) kan du överväga att använda avancerad villkorslogik med {% if ... %}-logik direkt i ett textblock.

Objektfilter

Vad är ett objektfilter?

Objektfilter väljer poster som är länkade till varje mottagare utifrån kriterier som du anger. Du kan visa en egenskap från 1 matchande post, egenskaper från upp till 10 matchande poster eller antalet matchande poster.

Skapa ett objektfilter

För att börja skapa ett objektfilter:

1. Lägg till ett nytt textblock eller redigera texten i ett befintligt textblock i din mall.
2. Välj knappen Personalisering .

3. I personaliseringsmodalen väljer du Objekt i rullgardinsmenyn Alla typer .
4. Välj objektet som innehåller de data du vill ställa in ett filter för.
5. Välj den egenskap du vill visa. Om du vill skapa ett antalfilter i stället väljer du Antal objekt.
6. Klicka på Skapa om det inte finns några filter ännu. Om filter finns i listan lämnar du dem omarkerade och klickar på Skapa objektfilter.

I modalrutan Skapa objektfilter anger du följande information:

• Namn
  Ange ett unikt namn som endast innehåller bokstäver och siffror, till exempel oldestDog. Använd inte mellanslag eller specialtecken.
• Ange filtervillkor
  Definiera reglerna som ett objekt måste uppfylla för att inkluderas i textblocket.
• Hur många objekt ska visas?
  För ett egenskapsvärde väljer du Enstaka för 1 post eller Flera för upp till 10 poster. Räknefilter visar inte den här inställningen.
• Välj egenskap och Sorteringsordning
  För ett filter för egenskap-värde väljer du egenskapen som används för att välja eller sortera poster och väljer sedan sorteringsordning. Till exempel kan du sortera efter en födelsedagsegenskap med Äldst för att välja det äldsta husdjuret först. Dessa fält visas inte för räknefilter.

Klicka på Skapa objektfilter för att spara ditt filter och infoga dess etikett i textblocket.

När du har skapat ditt objektfilter kan du använda det i visa/dölj-logik och personaliseringstaggar för att visa specifika objektposter baserat på de kriterier du har angett.

Ytterligare resurser