Script e-mail

Per una spiegazione dettagliata del comportamento di Velocity Template Language, leggere la Guida utente di Velocity.

Apache Velocity è un linguaggio basato su Java per la creazione di modelli e lo scripting di contenuti HTML. Utilizza Velocity nei token di script e-mail di Marketo per accedere ai dati memorizzati in opportunità e oggetti personalizzati e creare contenuti e-mail dinamici.

Velocity fornisce il flusso di controllo if/else, for e foreach per il contenuto condizionale e iterativo.

Variabili

Prefisso variabili con $. Crea o aggiorna con #set:

#set($variable = "value")

Recupera i valori delle variabili con tipi di riferimento che forniscono comportamenti diversi:

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

La notazione di riferimento non interattiva include ! dopo $. Per impostazione predefinita, Velocity lascia la stringa di riferimento in posizione quando un riferimento non è definito. Un riferimento silenzioso non emette alcun valore quando non è definito:

##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 fornisce strumenti Velocity. Questi wrapper espongono i metodi dell’oggetto Java tramite variabili globali disponibili per tutti gli script.

Per utilizzare ad esempio un metodo di ComparisonDateTool, accedere alla 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

Aggiungi script Velocity alle e-mail con token di script e-mail. Crea un token in Attività di marketing all’interno di una cartella di marketing o di un programma.

Per utilizzare un token, l’e-mail deve essere un elemento secondario del programma a cui appartiene il token o ereditarlo da una cartella di marketing. Passare a una cartella o a un programma e selezionare la scheda My Tokens. Trascina l’opzione Script e-mail dal menu a destra nell’elenco dei token.

Modifica il nome del token, quindi seleziona Click to Edit per aprire l’editor:

Nell’editor, crea uno script che acceda alle variabili in oggetti accessibili da script. Per aggiungere un riferimento a un campo oggetto, trascinarlo dalla struttura destra allo script:

Incorporamento e test degli script

Dopo aver definito lo script in un programma My Token, fai riferimento a esso da un’e-mail nell’editor e-mail di Marketo.

Verificare lo script con l’azione Send Sample Email nella finestra di progettazione e-mail di Marketo. Selezionare un lead esistente nel campo Lead in modo che lo script venga elaborato correttamente.

Durante il test di $TriggerObject, selezionare l’oggetto di attivazione con il parametro Trigger. Marketo utilizza come variabile $TriggerObject l’oggetto aggiornato più di recente di quel tipo.

È inoltre possibile eseguire il test con Email Preview. Selezionare View As: Lead Detail, quindi selezionare un lead da un elenco statico. L’anteprima mostra anche le eccezioni all’esecuzione dello script:

Best practice

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>