E-mailscripting

OPMERKING: het wordt ten zeerste aanbevolen om de Gebruikershandleiding voor snelheid voor een diepe duik in het gedrag van de Taal van het Malplaatje van de Snelheid.

Apache Snelheid is een taal die is gebaseerd op Java en die is ontworpen voor sjablonen en scripts voor HTML-inhoud. Marketo staat het toe om in de context van E-mail te worden gebruikt door scripting tokens te gebruiken. Hierdoor hebt u toegang tot gegevens die zijn opgeslagen in Opportunity en Custom Objects, en kunt u dynamische inhoud maken in e-mails. Snelheid biedt standaard besturingsstroming op hoog niveau met if/else, for en for each om voorwaardelijke en iteratieve manipulatie van inhoud toe te staan. Hier is een eenvoudig voorbeeld om een groet met de correcte aanhef te drukken:

//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...

Variabelen

Variabelen worden altijd vooraf ingesteld op '$' en worden ingesteld en bijgewerkt met #set:

#set($variable = "value")

Hun waarden kunnen dan via verscheidene verschillende verwijzingstypes met verschillend gedrag worden teruggewonnen:

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

Er is ook een rustige verwijzingsnotatie, waarbij er een ! Opgenomen na de $. Wanneer de snelheid een ongedefinieerde verwijzing tegenkomt, wordt de tekenreeks die de verwijzing vertegenwoordigt, normaal gesproken op zijn plaats gelaten. Met een rustige verwijzingsnotatie wordt, als een niet gedefiniëerde verwijzing wordt ontmoet, dan geen waarde uitgestraft:

##Defined Reference

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

##Undefined Reference

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

##quiet
$!baz ##outputs nothing

Zie voor meer informatie over het verwijzen naar variabelen de Gebruikershandleiding voor Apache.

Snelheidsgereedschappen

Met het Apache Velocity-project wordt functionaliteit beschikbaar gesteld via het gebruik van Snelheidsgereedschappen. Dit zijn eenvoudig wrappers voor voorwerpen Java en hun methodes door globale variabelen blootstellen die aan alle manuscripten ter beschikking worden gesteld.

Als u bijvoorbeeld een methode wilt gebruiken vanuit ComparisonDateTool, toegang tot $date variabele in een scripttoken:

#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

Een scripttoken maken

Het snelheidsscript wordt opgenomen in e-mailberichten met behulp van e-mailscripttokens. Deze kunnen in de Activiteiten van de Marketing in of een Omslag van de Marketing of een Programma worden gecreeerd. Als u een token in een e-mailbericht wilt gebruiken, moet de e-mail een onderliggend item zijn van een programma dat de token bezit of overneemt van een marketingmap. Als u een token wilt maken, navigeert u naar een map of programma en selecteert u de knop My Tokens tab. Sleep vanuit het rechtermenu de optie 'E-mailscript' naar de tokenlijst

Van hier, kunt u de naam van het teken uitgeven, en de redacteur openen via Click to Edit optie:

Wanneer u zich in de editor bevindt, kunt u een script maken met toegang tot alle variabelen in objecten die toegankelijk zijn voor scripts. Als u een veldverwijzing van een object wilt ophalen, sleept u deze van de rechterstructuur naar het script:

Scriptinsluiting en testen

Als u uw script hebt gedefinieerd in een Program My Token, kunt u ernaar verwijzen in een bepaalde e-mail via de e-maileditor van Marketo.

U kunt uw script testen met de Send Sample Email Handeling via e-mail in de Marketo-ontwerper. Als u het script op de juiste wijze wilt laten verwerken, moet u een bestaande lead selecteren om na te bootsen in het dialoogvenster Lead veld. Als u wilt testen met $TriggerObject, kunt u het activeringsobject selecteren via het dialoogvenster Trigger param. Hierbij worden de gegevens van het laatst bijgewerkte object van dat type gebruikt als de $TriggerObject variabele.

U kunt ook de opdracht Email Preview om het script te testen. Hiervoor moet u View As: Lead Detail en selecteer een lead in een beschikbare statische lijst. Dit heeft het extra voordeel om het even welke uitzonderingen uit te voeren die tijdens manuscriptuitvoering kunnen zijn voorgekomen:

Nuttige tips

De gecombineerde lengte van alle e-mailscripttokens in een bepaalde e-mail mag niet groter zijn dan 100.000 bytes. Deze limiet heeft betrekking op de totale lengte van de tokentekenreeksen zelf (niet de totale lengte nadat tokens zijn uitgebreid).

<!-- 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>