Scripts de correo electrónico

Lea la Guía del usuario de Velocity para obtener una explicación detallada del comportamiento del idioma de plantilla de Velocity.

Apache Velocity es un lenguaje basado en Java para crear plantillas y scripts de contenido de HTML. Utilice Velocity en los tokens de scripts de correo electrónico de Marketo para acceder a los datos almacenados en oportunidades y objetos personalizados y crear contenido de correo electrónico dinámico.

Velocity proporciona los flujos de control if/else, for y foreach para el contenido condicional e iterativo.

Variables

Prefijo de variables con $. Créelos o actualícelos con #set:

#set($variable = "value")

Recupere valores de variables con tipos de referencia que proporcionen comportamientos diferentes:

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

La notación de referencia silenciosa incluye ! después de $. De forma predeterminada, Velocity deja la cadena de referencia en su lugar cuando una referencia no está definida. Una referencia silenciosa no emite ningún valor cuando no está definida:

##Defined Reference

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

##Undefined Reference

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

##quiet
$!baz ##outputs nothing

Para obtener más información sobre cómo hacer referencia a variables, consulte la Guía del usuario de Apache.

Herramientas de Velocity

El proyecto Apache Velocity proporciona Herramientas de Velocity. Estos contenedores exponen los métodos de objeto Java a través de variables globales disponibles para todos los scripts.

Por ejemplo, para usar un método de ComparisonDateTool, acceda a él desde la variable $date en un token de 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

Creación de un token de script

Añadir scripts de Velocity a los correos electrónicos con tokens de script de correo electrónico. Cree un token en Actividades de marketing dentro de una carpeta o programa de marketing.

Para utilizar un token, el correo electrónico debe ser un elemento secundario del programa que posee el token o heredarlo de una carpeta de marketing. Vaya a una carpeta o programa y seleccione la ficha Mis tokens. Arrastre la opción Script de correo electrónico desde el menú derecho a la lista de tokens.

Edite el nombre del token y, a continuación, seleccione Haga clic para editar para abrir el editor:

En el editor, cree una secuencia de comandos que acceda a variables en objetos accesibles por secuencias de comandos. Para añadir una referencia de campo de objeto, arrástrela desde el árbol derecho al script:

Incrustación y prueba de scripts

Después de definir la secuencia de comandos en el programa My Token, haga referencia a él desde un correo electrónico en el editor de correo electrónico de Marketo.

Pruebe el script con la acción Enviar correo electrónico de muestra en el diseñador de correo electrónico de Marketo. Seleccione un posible cliente existente en el campo Posible cliente para que el script se procese correctamente.

Al probar $TriggerObject, seleccione el objeto desencadenante con el parámetro Déclencheur. Marketo usa el objeto actualizado más recientemente de ese tipo como la variable $TriggerObject.

También puede probar con Vista previa del correo electrónico. Seleccione Ver como: Detalle del posible cliente y, a continuación, seleccione un posible cliente de una lista estática. La vista previa también muestra excepciones de la ejecución de scripts:

Mejores prácticas

La longitud combinada de todos los tokens de script de correo electrónico de un correo electrónico determinado no puede superar los 100 000 bytes. Este límite pertenece a la longitud total de las propias cadenas de token (no a la longitud total después de que se hayan expandido los tokens).

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