Script e-mail

NOTA: si consiglia di leggere la Guida utente Velocity per approfondire il comportamento di Velocity Template Language.

Apache Velocity è un linguaggio basato su Java e progettato per la creazione di modelli e script di contenuti HTML. Marketo consente di utilizzarlo nel contesto delle e-mail utilizzando token di script. Questo consente di accedere ai dati memorizzati in Opportunità e Oggetti personalizzati e di creare contenuto dinamico nelle e-mail. Velocity offre un flusso di controllo standard di alto livello con if/else, for e for each per consentire la manipolazione condizionale e iterativa dei contenuti. Di seguito è riportato un semplice esempio per stampare un saluto con la formula di apertura corretta:

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

Variabili

Le variabili hanno sempre il prefisso '$' e vengono impostate e aggiornate utilizzando il #set:

#set($variable = "value")

I loro valori possono quindi essere recuperati tramite diversi tipi di riferimento con comportamenti diversi:

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

Esiste anche una notazione di riferimento silenziosa, dove è presente un ! Incluso dopo il $. Normalmente, quando Velocity incontra un riferimento non definito, la stringa che rappresenta il riferimento viene lasciata in posizione. Con la notazione di riferimento silenzioso, se viene rilevato un riferimento non definito, non viene emesso alcun valore:

##Defined Reference

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

##Undefined Reference

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

##quiet
$!baz ##outputs nothing

Per ulteriori informazioni su come fare riferimento alle variabili, consulta la Guida utente di Apache.

Strumenti Velocity

Il progetto Apache Velocity rende disponibili le funzionalità tramite l'utilizzo di strumenti Velocity. Si tratta semplicemente di wrapper per oggetti Java ed espongono i loro metodi tramite variabili globali che sono rese disponibili a tutti gli script.

Ad esempio, per utilizzare un metodo di ComparisonDateTool, accedere se dalla variabile $date in un token di script:

#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

Creazione di un token di script

Lo script Velocity viene incluso nelle e-mail utilizzando i token di script e-mail. Possono essere create nelle attività di marketing in una cartella di marketing o in un programma. Affinché un token possa essere utilizzato all’interno di un’e-mail, l’e-mail deve essere figlia di un programma che possiede il token o lo eredita da una cartella di marketing. Per creare un token, passare a una cartella o a un programma e selezionare la scheda My Tokens. Dal menu di destra, trascina l’opzione "Script e-mail" nell’elenco dei token

Da qui, puoi modificare il nome del token e aprire l'editor tramite l'opzione Click to Edit:

Una volta nell’editor, puoi creare uno script con accesso a tutte le variabili in oggetti accessibili da script. Per ottenere un riferimento di campo da un oggetto, trascinarlo dalla struttura di destra nello script:

Incorporamento e test degli script

Una volta definito lo script all’interno di un token del programma, puoi farvi riferimento all’interno di una determinata e-mail utilizzando l’editor e-mail di Marketo.

Puoi testare lo script utilizzando l'azione e-mail Send Sample Email in E-mail Designer di Marketo. Affinché lo script possa essere elaborato correttamente, è necessario selezionare un lead esistente da rappresentare nel campo Lead. Se si esegue il test con $TriggerObject, è possibile selezionare l'oggetto di attivazione tramite il parametro Trigger. Vengono utilizzati i dati dell'oggetto aggiornato più di recente di quel tipo come variabile $TriggerObject.

È inoltre possibile utilizzare Email Preview per testare lo script. A tale scopo, è necessario selezionare View As: Lead Detail e selezionare un lead da un elenco statico disponibile. Ciò offre il vantaggio aggiuntivo di restituire eventuali eccezioni che possono essersi verificate durante l’esecuzione dello script:

Suggerimenti utili

La lunghezza combinata di tutti i token di script e-mail in una determinata e-mail non può superare i 100.000 byte. Questo limite si riferisce alla lunghezza totale delle stringhe di token stesse (non alla lunghezza totale dopo l’espansione dei token).

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