E-postskript

Obs! Vi rekommenderar att du läser användarhandboken Snabb för att få en djupdykning i hur Snabblingsmallspråket fungerar.

Apache-hastighet är ett språk som bygger på Java och som är utformat för att malla och skripta HTML. Marketo tillåter att den används i e-postsammanhang med hjälp av skripttokens. Detta ger åtkomst till data som lagras i säljprojekt och anpassade objekt och gör det möjligt att skapa dynamiskt innehåll i e-postmeddelanden. Hastigheten ger ett högnivåkontrollflöde med if/else, for, and for each som tillåter villkorsstyrd och iterativ manipulering av innehåll. Här är ett enkelt exempel på hur du skriver ut en hälsningsfras:

//check if the lead is male
if(${lead.MarketoSocialGender} == "Male")
    if the lead is male, use the salutation 'Mr.'
    set($greeting = "Dear Mr. ${lead.LastName},")
//check is the lead is female
elseif(${lead.MarketoSocialGender} == "Female")
    if female, use the salutation 'Ms.'
    set($greeting = "Dear Ms. ${lead.LastName},")
else
    //otherwise, use the first name
    set($greeting = "Dear ${lead.FirstName},")
end
print the greeting and some content
${greeting}

    Lorem ipsum dolor sit amet...

Variabel

Variabler har alltid prefixet '$' och ställs in och uppdateras med #set:

#set($variable = "value")

Deras värden kan sedan hämtas via flera olika referenstyper med olika beteenden:

$variable ##outputs 'value'
$variablename ##outputs '$variablename'
${variable}name ##outputs 'valuename'

Det finns också en tyst referensnotation, där det finns en ! inkluderad efter $. När hastigheten påträffar en odefinierad referens lämnas strängen som representerar referensen på plats. Om en odefinierad referens påträffas med tyst referensnotation genereras inget värde:

##Defined Reference

#set($foo = "bar")
$foo ##outputs "bar"

##Undefined Reference

##normal
$baz ##outputs "$baz"

##quiet
$!baz ##outputs nothing

Mer information om hur du refererar till variabler finns i användarhandboken för Apache.

Snabbhetsverktyg

Apache-snabbprojekt gör funktioner tillgängliga med snabbverktyg. Dessa är helt enkelt wrappers för Java-objekt och visar deras metoder med globala variabler som är tillgängliga för alla skript.

Om du till exempel vill använda en metod från ComparisonDateTool måste du få åtkomst till den från variabeln $date i en skripttoken:

#set($birthday = $convert.parseDate("2015-08-07","yyyy-MM-dd"))
##use whenIs to determine how many days away it is
$date.whenIs($birthday).days ##outputs 1

Skapa en skripttoken

Snabbhetsskript inkluderas i e-postmeddelanden med hjälp av e-postskripttoken. Dessa kan skapas i marknadsföringsaktiviteter i antingen en marknadsföringsmapp eller ett program. För att en token ska kunna användas i ett e-postmeddelande måste e-postmeddelandet vara underordnat ett program som antingen äger token eller ärver den från en marknadsföringsmapp. Om du vill skapa en token går du till en mapp eller ett program och väljer fliken My Tokens. Dra alternativet E-postskript från den högra menyn till tokenlistan

Här kan du redigera namnet på token och öppna redigeraren med alternativet Click to Edit:

När du är i redigeraren kan du skapa ett skript med åtkomst till alla variabler i skripttillgängliga objekt. Om du vill hämta en fältreferens från ett objekt drar du den från det högra trädet till skriptet:

Inbäddning och testning av skript

När du har definierat skriptet i en Program My Token kan du referera till det i ett visst e-postmeddelande med hjälp av Marketo e-postredigerare.

Du kan testa skriptet med e-poståtgärden Send Sample Email i Marketo e-postdesigner. För att skriptet ska kunna behandlas korrekt måste du välja ett befintligt lead som personifieras i fältet Lead. Om du testar med $TriggerObject kan du välja det utlösande objektet via parametern Trigger. Detta använder data från det senast uppdaterade objektet av den typen som variabeln $TriggerObject.

Du kan också använda Email Preview för att testa skriptet. Om du vill göra det måste du välja View As: Lead Detail och välja en lead från en tillgänglig statisk lista. Detta medför även en fördel med att skriva ut eventuella undantag som kan ha inträffat under skriptkörningen:

Användbara tips

Den sammanlagda längden för alla e-postskripttoken i ett visst e-postmeddelande får inte överstiga 100 000 byte. Den här gränsen gäller den totala längden för själva tokensträngarna (inte den totala längden efter att tokens har utökats).

<!-- Correct -->
#set($url = "www.example.com/${object.id}")
<a href="http://${url}">Link Text</a>

<!-- Correct -->
<a href="http://www.example.com/${object.id}">Link Text</a>

<!-- Incorrect -->
<a href="${url}">Link Text</a>

<!-- Incorrect -->
<a href="{{my.link}}">Link Text</a>

<!-- Incorrect -->
<a href="http://{{my.link}}">Link Text</a>