E-mailscripting

NOTA: Het wordt hoogst geadviseerd dat u de Gids van de Gebruiker van de Snelheidvoor een diep-duik in het gedrag van de Taal van het Malplaatje van de Snelheid leest.

de Snelheid van Apacheis een taal die op Java wordt voortgebouwd die voor het templating en het scripting van de inhoud van HTML wordt ontworpen. 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 stille verwijzingsnotatie, waarbij er een ! Opgenomen is 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

Voor meer informatie over hoe te om variabelen van verwijzingen te voorzien, zie de Gids van de Gebruiker Apache.

Snelheidsgereedschappen

Het Project van de Snelheid Apache maakt functionaliteit door het gebruik van Hulpmiddelen van de Snelheidbeschikbaar. 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 van ComparisonDateTool wilt gebruiken, opent u de gebeurtenis $date via 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 tab My Tokens . Sleep vanuit het rechtermenu de optie 'E-mailscript' naar de tokenlijst

Vanaf hier kunt u de naam van het token bewerken en de editor openen via de optie Click to Edit :

uit

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 e-mailactie Send Sample Email in de Marketo-e-mailontwerper. Het script kan alleen correct worden verwerkt als u een bestaande lead selecteert om zich voor te doen in het veld Lead . Als u met $TriggerObject test, kunt u het activerende voorwerp via Trigger param selecteren. Hierbij worden de gegevens van het laatst bijgewerkte object van dat type gebruikt als de variabele $TriggerObject .

U kunt het script ook testen met Email Preview . Hiervoor moet u View As: Lead Detail selecteren en een lead in een beschikbare statische lijst selecteren. 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>