Referens för personanpassning av meddelanden
Lär dig hur du använder Klaviyo-malltaggar, eller etiketter, för att anpassa dina kunders upplevelse.
Malltaggar kan användas i e-postmeddelanden (inklusive i e-postmeddelandets ämnesrad), sms/mms-meddelanden, pushnotiser och Klaviyo Customer Hub. Denna artikel beskriver vissa tillgängliga taggar, deras strukturer och former och hur du kan anpassa dem. Om du vill veta mer om personanpassning kan du läsa vår artikel om hur du lägger till personanpassning i dina meddelanden.
Malltagg kan också kallas personanpassningsetiketter eller variabel syntax.
Om malltaggar
När du matar in taggar i ett textfält ser de ut som meningen till vänster i tabellen nedan. När meddelandet visas ersätts taggarna av information från mottagarens profil eller händelsedetaljer och ser ut som meningen till höger.
Hej | Hej George Washington! Din favoritfärg är grön |
Personanpassning av profiler börjar i allmänhet med person, med undantag för några få specialetiketter som first_name och last_name. Händelsevariabler, som kan användas i mättalsutlösta flöden, börjar med event. Organisationstaggar (som företagsnamn och adress) börjar med organization.
Alla malltaggar är skiftlägeskänsliga och måste exakt matcha egenskapsnamnen de refererar till. Se till att dina taggar är rättstavade och använd samma skiftläge som på dina profiler.
Personanpassning av profiler
Personanpassning av profiler ger dig möjlighet att visa speciella Klaviyo-egenskaper i dina meddelanden. Listan nedan beskriver all profilpersonanpassning (alltså inbyggda Klaviyo-egenskaper). Utvalda profilmalltaggar är tillgängliga i menyn Personanpassning i e-postredigeraren, eller från förhandsgranskningsmodalen för sms- och pushnotismeddelanden.
Om du vill lägga till anpassade egenskaper i dina meddelanden kan du hoppa vidare till avsnittet om personanpassning.
Etikett | Profilegenskap |
| E-post |
| Förnamn |
| Efternamn |
| Mottagarens organisation |
| Adress 1 |
| Unikt ID ($id/externt ID) |
| Latitud |
| Longitud |
| Klaviyo ID |
| Fullständigt namn |
| Titel |
| Telefonnummer |
| Adress 2 |
| Ort |
| Stat/region |
| Land |
| Postnummer |
| Källa |
| Samtycke |
| $consent_form_id |
| $consent_form_version |
| $consent_method |
| Mottagarens tidszon |
| $consent_timestamp |
| $phone_number_region |
| Nyligen visade objekt |
| Förväntat datum för nästa beställning |
Anpassade objekttaggar
Med anpassade objektetiketter kan du använda objektdata i flödes- och kampanjutskick.
Granska etikettsreferenser för specifika exempel på hur man använder etiketter för att få ett objekt-ID eller returnera ett antal.
Du måste först skapa ett objekt innan du kan använda anpassade objektdata i mallar. Taggen {{ object }} är endast tillgänglig när ett objekt har utlöst ett flöde.
Etikett | Utfall |
| Returnera det objekt som utlöste ett flöde |
| |
| Returnera ett enskilt objekt från ett objektfilter |
| |
| Returnera ett antal från ett objektfilter |
| Hämta ett objekt med ID |
| Hämta alla poster för ett objekt från en profil |
Organisationstaggar
Med organisationsetiketter kan du inkludera information om ditt företag eller din organisation i dina meddelanden. Du kan hantera den här informationen genom att klicka på ditt organisationsnamn i det nedre vänstra hörnet och sedan välja Inställningar > Organisation > Kontaktuppgifter. Alla organisationsetiketter börjar med organization. Se tabellen nedan för listan över organisationsetiketter.
Organisationsetiketter | Beskrivning |
| Din organisations namn |
| Din organisations webbplats |
| Din organisations fullständiga adress, inklusive ort, delstat/region och postnummer |
| Din organisations gatuadress |
| Den andra delen av din organisations adress (till exempel lägenhetsnummer eller kontorsnummer) |
| Din organisations ort |
| Din organisations delstat, provins eller region |
| Din organisations postnummer |
Länk- och förhandsvisningsetiketter
Länk- och förhandsgranskningsetiketter gör det möjligt för mottagare att hantera sina prenumerationsinställningar och visa ditt meddelande i sina webbläsare. Här ingår:
- Avsluta prenumeration
- Hantera preferenser
- Webbvy
- Förhandsgranska text
Dessa taggar stöds endast för e-postmallar. Om du klickar på en av dessa länkar från ett förhandsgransknings-e-postmeddelande kommer du att skickas till en platshållarsida istället för en aktiv samtyckessida eller förhandsgranskning.
Avsluta prenumeration
Klaviyo kräver en avregistreringslänk i alla e-postmeddelanden. Använd en enkel avregistreringsetikett för en länk med texten ”Avsluta prenumeration”, eller lägg till egen text inom citattecken.
Etikett | Utdata |
| Avsluta prenumeration |
Om du inte längre vill få e-post, | Klicka här om du inte längre vill få e-post. |
Alternativt kan du använda {% unsubscribe_link %}-etiketter för att generera en URL till avregistreringen. I stället för att generera ett ord eller fras med en länk skapar denna etikett bara en URL till avregistreringen. Använd denna etikett om du vill ge din avregistreringslänk en annan färg än länkfärgen i mallstilen, eller om du vill använda en länkad knapp eller bild istället för en textlänk.
Etikett | Utdata |
| Detta är en tjusig avregistreringslänk. |
När en mottagare klickar på avregistreringslänken kommer hen till en anpassningsbar bekräftelsesida.
Hantera preferenser
Preferenssidor gör det möjligt för mottagare att uppdatera sina preferenser, så att du kan segmentera och rikta dina meddelanden mer effektivt. För att inkludera en länk till denna sida för varje mottagare ska du använda hantera alternativ-etiketten.
Du kan skapa listspecifika och allmänna sidor för hantering av inställningar. Listspecifika sidor skickas när du skickar ett meddelande till bara en lista. Den allmänna sidan för alternativhantering används när du skickar till ett segment, en kombination av listor och i flöden som inte är listutlösta. Läs mer om alternativhanteringssidor.
Använd en enkel hantera alternativ-etikett för en länk med texten ”Hantera alternativ”, eller lägg till din egen text inom citationstecken.
Etikett | Utdata |
| Hantera preferenser |
Vill du uppdatera dina alternativ? | Vill du uppdatera dina alternativ? Klicka här. |
Alternativt kan du använda {% manage_preferences_link %}-etiketten för att generera en URL för att hantera alternativ. I stället för att generera ett ord eller fras med en länk skapar denna etikett bara en URL till mottagarens alternativsida. Använd denna etikett om du vill ge din länk en annan färg än länkfärgen i mallstilen, eller om du vill använda en länkad knapp eller bild i stället för en textlänk.
Etikett | Utdata |
| Detta är en tjusig hantera alternativ-länk. |
Webbvy
För att ge mottagare möjlighet att se ett e-postmeddelande i sina webbläsare kan du använda webbvisningsetiketten.
Etikett | Utdata |
| Visa i din webbläsare |
Kan du inte se detta e-postmeddelande? | Kan du inte se detta e-postmeddelande? Öppna i din webbläsare. |
| Detta är en tjusig webbvisningslänk. |
Förhandsgranska text
I vissa fall kanske du vill visa din förhandsgranskningstext inuti mallens brödtext. Du kan rikta till en förhandsgranskningstext som du har ställt in på e-postmeddelandets förhandsgransknings-/inställningsskärm genom att använda etiketten {% render_variable preview_text %}.
Om du uppdaterar förhandsgranskningstexten på e-postmeddelandets förhandsgranskningsskärm visar denna etikett din uppdaterade förhandsgranskningstext.
Personanpassning och händelseetiketter
Anpassade etiketter avser anpassade profilegenskaper (alltså data som du samlar in om dina kontakter som inte är speciella Klaviyo-egenskaper och -händelser), som någons födelsedag eller kontaktpreferenser. Händelseetiketter avser en specifik händelses data (till exempel en skapad beställning-händelse) och kan endast användas i flöden som löses ut av denna händelse.
För att lägga till en anpassad etikett ska du klicka på Personanpassning i ett e-postmeddelande och leta upp etiketten. Om du vill lägga till en händelseetikett förhandsgranskar du ditt meddelande och kopierar händelsevariabeletiketten från dina förhandsgranskningsdata. Alternativt kan du använda de format som beskrivs nedan för att manuellt lägga till anpassade etiketter i din mall.
Taggformat | Beskrivning | Exempel |
| En enkel profilmalltagg |
|
| A profilmalltagg, om egenskapsnamnet innehåller mellanslag eller specialtecken |
|
| En enkel händelsevariabeletikett |
|
| En händelsevariabeletikett, om variabelnamnet innehåller mellanslag eller specialtecken |
|
| En händelsevariabeletikett, om händelsevariabeln är inbäddad i händelsedata |
|
| En händelsevariabeletikett, om händelsevariabeln är inbäddad i en annan variabel med ett namn som innehåller mellanslag eller specialtecken |
|
Använd punkt (.) för etiketter utan mellanslag eller specialtecken. Om egenskapsnamnen innehåller mellanslag eller specialtecken (till exempel $) ska du använda lookup-beteckning.
Observera att om ett egenskapsnamn använder lookup-beteckning för inbäddade egenskaper måste alla senare egenskaper också använda lookup-beteckning. Detta innebär att event|lookup:'Collection Names'|lookup:'0' är korrekt, men event|lookup:'Collection Names'.0 inte är det.
Anpassa taggar med filter
För att anpassa hur din etikett visas ska du använda mallfilter. Filter kan användas för att tillämpa skiftläge, ställa in antalet decimaler för tal och mycket annat. Två av de vanligaste filtren är standard och titel.
Standardfiltreringen anger ett standardvärde som ska visas om en meddelandemottagare inte har denna egenskap inställd. I exemplet nedan är ”friend” och ”tasty treats” inställda som standardvärden om en mottagares namn eller favoritmat inte är angivna i deras Klaviyo-profil.
Text med malltaggar | Utdata |
Hej | Hej kompis! Sugen på godsaker? |
Med titelfiltreringen kan du lägga till skiftläge för en textetikett för att se till att texten visas på ett enhetligt sätt när meddelandet skickas. Till exempel kanske prenumeranter använder bara stora eller små bokstäver när de fyller i ditt registreringsformulär. Utan ett filter kommer deras förnamn att få det skiftläge som de ursprungligen använde när de fyllde i ditt formulär. Titel-filtret korrigerar skiftläget så att namn visas korrekt.
Text med malltaggar | Utdata |
Hej | Hej Elise! Har du sett vår senaste lansering? |
Det finns dussintals andra filter tillgängliga för dina meddelanden. Läs mer om hur du använder filter för att anpassa etiketter.
Datumetiketter
Datumetiketter fungerar som ett snabbt sätt att infoga datuminformation i ett e-postmeddelande. Datumet är i ditt kontos tidszon och återspeglar den dag eller tidpunkt då ett meddelande skickades.
{{ today }}-etiketten är en av de vanligaste datumetiketterna och fyller i en tidsstämpel när meddelandet skickas. För att använda today-etiketten ska du klistra in följande kodrad i din mall:
{% today "%Y-%m-%d" as today %} {{ today }}
Observera att om du använder {{ today }}-etiketten utan föregående kod kommer ingenting att renderas – hela kodraden behövs.
Om du vill lära dig hur du använder eller anpassar datumetiketter ska du läsa vår artikel om datumetiketter i mallar.
Valutaetiketter
Händelsedata som Skapad Beställning, Tillagt i Kundvagnen med flera har ofta ett finansiellt värde kopplat till sig (till exempel en produkts pris eller värdet på en kunds kundvagn). Använd {% currency_format ... %}-etiketten för att tillämpa ditt lands valutaformatering på detta värde.
Tänk till exempel på $value-fältet i Startad kassaprocess-mättalet nedan:
Om du bara använder variabeln {{ event|lookup:"$value" }} kommer denna egenskap att återges med bara en decimal och utan valutasymbol i e-postmeddelandet:
Med valutaformatsetiketten {% currency_format event|lookup:"$value" %} återges emellertid talet med en valutasymbol och rätt antal decimaler:
Om du vill använda valutaformatsetiketten ersätter du platshållartexten i {% currency_format PLACEHOLDER %} med din variabel.
Om din variabel till exempel är {{ event.item.price }} skulle den fullständiga valutaformatsetiketten bli {% currency_format event.item.price %}. Om din etikett innehåller filter (till exempel ett standardvärde om egenskapen är tom) ska de också inkluderas i etiketten: {% currency_format event.item.price|default:”0” %}.
Så väljer du ett land
Det finns två ställen där du kan ställa in valutaformatet för dina meddelanden:
- För hela ditt konto
Navigera till Inställningar > Organisation > Organisationsspråk och regionalt format och välj ett organisationsspråk. - För ett specifikt meddelande
Välj ett annat valutaformat för ett enskilt meddelande i fliken Stilar i avsnittet Valuta i meddelandets mall.
Felsökning av currency_format-etiketten
Denna etikett stöds endast för variabler som är tal (till exempel 10, 24,56). Egenskaper med valutasymbolen inkluderad (till exempel $40, $76,30) är strängar, och currency_format-etiketten kan inte ändra dem.
Villkorssatser
Med villkorsetiketter kan du inkludera innehåll i dina meddelanden för mottagare som uppfyller vissa kriterier, och inte inkludera det för andra. De ger dig kraftfulla kontroller om du vill anpassa dina meddelanden efter varje mottagare.
If-satser
Med if-satser kan du styra innehållet som någon får baserat på profil- eller händelsedata.
I exemplet nedan visas den första textraden för en person som har mer än 150 lojalitetspoäng. Om hen har mindre än 150 men mer än 0 visas den andra raden. Och om hen inte har några lojalitetspoäng kommer hen att se det tredje meddelandet.
{% if person|lookup:'Loyalty Points' > 150 %}
Hej VIP! Du har alltid fått fri frakt och kostnadsfria returer
{% elif person|lookup:'Loyalty Points' > 0 %}
Du har {{ person|lookup:'Loyalty Points' }} poäng, och du behöver bara 150 för att bli VIP!
{% else %}
Har du hört talas om vårt VIP-program? Gå med idag på vår webbplats för att börja tjäna belöningar.
{% endif %}
I en if-sats krävs ett inledande {% if ... %}-villkor liksom en avslutande {% endif %}-etikett. Alla andra element (till exempel {% elif %}- och {% else %}-etiketter) är valfria. Du kan använda ett obegränsat antal {% elif %}-etiketter följt av högst en {% else %}-etikett. Varje e-postmottagare kommer endast att se det första meddelandet hen kvalificerar sig för.
For-satser
Med ”for”-block kan du iterera över varje objekt i en variabel som lagrar en lista och rendera dem individuellt. Nedan följer en exempelsats:
| Extrastor strandhandduk × 1 Strandstolar × 4 SPF-solskydd × 2 Kylväska × 1 |
Varje For-sats måste innehålla följande:
- En
{% for ... %}-öppningsetikett, innehållande ett radalias (item i exemplet ovan) och en radsamling (event.shopping_cart_items i exemplet ovan) - En
{% endfor %}-stängningsetikett
Mellan de två obligatoriska etiketterna kan du inkludera vilken text du vill. Om du vill inkludera variabler som är inbäddade i radsamlingen ersätter du början av variabelnamnet (radsamlingen plus numret efter radsamlingen) med ditt radalias. Till exempel skulle variabeln {{ event.shopping_cart_items.0.name }} bli {{ item.name }}.
Villkorssatser och inline-textredigeraren
När du lägger till vissa villkorssatser i ett textblock kan de försvinna från inline-textredigeraren. Koden finns fortfarande kvar, den är bara dold. Om du vill visa och redigera villkorssatser ska du öppna textblocket i fältet Källkod.
Följande etiketter är endast synliga i ett textblocks Källkods-fält:
- {% for ... %}
- {% endfor %}
- {% if ... %}
- {% elif ... %}
- {% else %}
- {% endif %}
- {% with ... %}
- {% endwith %}
Ytterligare resurser
- Så skapar och skickar du en e-postkampanj
Lär dig mer om grunderna i e-postkampanjer, inklusive vad de är och hur du skickar dem i Klaviyo.
- Så använder du förhandsgranskningspanelen för att personanpassa meddelanden
Läs om hur du använder förhandsgranskningspanelen för att se vilka anpassningar data som finns tillgängliga för dina meddelanden och hur du kommer åt malltagg. Använd förhandsgranskningsmodalen som din sanningskälla för personaliseringsalternativ.
- Så bygger du dynamiska block i flödesmejl
Lär dig hur du använder dynamiska tabellblock för att lägga till produkt- och annan händelseinformation till ditt mättal-triggade flöde. I den här artikeln får du lära dig hur du skapar ett dynamiskt block med hjälp av exemplet med en påminnelse om övergiven kundvagn som visar de produkter som lämnats kvar.
- Felsöka felmeddelanden i e-postmallar
Om du stöter på fel eller varningar i en e-postmallar kan du behöva åtgärda dem innan du skickar ditt meddelande. Sök i den här resursen efter det felmeddelande eller den varning som du stöter på för att hitta tips om hur du löser problemet.
- Så skapar du innehållsblock för Klaviyo Customer Hub
Lär dig hur du skapar innehållsblock för din Klaviyo Customer Hub. Innehållsblock är mycket anpassningsbara och personliga block som har tillgång till Klaviyo profildata vilket gör att du kan visa integrationer (t.ex. lojalitetspoäng), personliga erbjudanden och mycket mer.