Referencia
Etiquetas de combinación
Personaliza los asuntos y el contenido de las campañas con etiquetas de combinación para nombres, email, campos personalizados y el enlace de baja, y descubre en qué se diferencian de Temple.
Las etiquetas de combinación insertan los datos de cada destinatario en una campaña: su nombre en el asunto, un campo personalizado en el cuerpo y su enlace de baja personal. Esta página lista todas las etiquetas, las reglas de sintaxis y cómo previsualizar el resultado.
Etiquetas disponibles
| Etiqueta | Se sustituye por |
|---|---|
{{first_name}} |
El nombre del contacto. |
{{last_name}} |
Los apellidos del contacto. |
{{email}} |
La dirección de email del contacto. |
{{unsubscribe_url}} |
El enlace de baja personal del destinatario. Consulta Bajas. |
{{cf.<key>}} |
El valor de un campo personalizado, según su clave. Por ejemplo, {{cf.company}} para un campo con la clave company. |
Las etiquetas de combinación funcionan en el Subject de la campaña, en el contenido HTML y en la versión de texto plano. No se sustituyen en From name, From email ni Reply to.
<p>Hi {{first_name}},</p>
<p>Your {{cf.plan}} plan now includes scheduled sending.</p>
<p><a href="{{unsubscribe_url}}">Unsubscribe</a> from Acme emails sent to {{email}}.</p>Insertar etiquetas en los editores
- Editor de texto enriquecido: escribe
@y elige una variable, o un campo personalizado por su nombre. - Editor Dragit: usa el menú de campos de combinación, que muestra First name, Last name, Email y tus campos personalizados. El enlace de baja está entre los enlaces especiales.
- Editor HTML y campo Subject: escribe la etiqueta.
Reglas de sintaxis
- Sin espacios dentro de las llaves. Escribe
{{first_name}}. Una etiqueta con espacios, como{{ first_name }}, no se sustituye y aparece en el email tal como se escribió. Esto importa sobre todo en el enlace de baja: la comprobación del paso Send acepta{{ unsubscribe_url }}, pero solo{{unsubscribe_url}}se convierte en un enlace que funciona. - Los nombres de las etiquetas no distinguen entre mayúsculas y minúsculas, así que
{{First_Name}}también funciona. Las claves de los campos personalizados deben coincidir exactamente con la clave guardada, y las claves siempre están en minúsculas, así que escribe{{cf.company}}, no{{cf.Company}}. - Los campos personalizados necesitan el prefijo
cf..{{company}}no es una etiqueta de combinación y aparece tal como se escribió. - Cualquier otra cosa entre llaves dobles se queda tal cual. Emailit solo sustituye las etiquetas de la tabla anterior.
Valores que faltan
Cuando un contacto no tiene valor para una etiqueta, la etiqueta se sustituye por nada. En las campañas no hay sintaxis de valor alternativo: {{first_name|"there"}} no se admite y aparece tal como se escribió.
| Contenido | Contacto con nombre | Contacto sin nombre |
|---|---|---|
Hi {{first_name}}, |
Hi Ada, | Hi , |
Hi there, |
Hi there, | Hi there, |
Así que escribe textos que se lean bien sin el valor, o asegúrate de que todos lo tengan. En la página Contacts, filtra por First name con is empty para encontrar los contactos sin nombre.
Cómo se muestran los valores
| Tipo de campo | Se muestra como |
|---|---|
| Texto, número | El valor guardado, por ejemplo Acme o 42. |
| Fecha | YYYY-MM-DD, por ejemplo 1990-04-12. |
| Booleano | true o false. |
| Selección | La opción seleccionada. |
| Selección múltiple | Las opciones separadas por comas, sin espacios, por ejemplo news,offers. |
Los valores se insertan exactamente como están guardados, sin escapar el HTML. Si las personas pueden introducir sus propios nombres, por ejemplo en un formulario de suscripción público, comprueba esos valores antes de usarlos en HTML.
Previsualizar las etiquetas de combinación
- Preview as contact, en el paso Preview and test, renderiza el asunto y el contenido con los datos de un contacto real. Úsalo para comprobar nombres, campos personalizados y valores vacíos.
- Los envíos de prueba rellenan
{{email}}con la dirección de prueba y dejan vacíos los nombres y los campos personalizados. El enlace de baja de una prueba no da de baja a nadie.
Consulta Probar y programar.
Etiquetas de combinación y Temple
Las campañas usan sus propias etiquetas de combinación. Las plantillas enviadas con la API de email y los emails enviados por automatizaciones usan Temple, el lenguaje de plantillas de Emailit, que se parece pero funciona de otra manera:
| Etiquetas de combinación de campañas | Temple | |
|---|---|---|
| Se usa en | Campañas | Envíos por API y SMTP con plantilla, emails de automatizaciones |
| Datos | El contacto destinatario | Las variables que pasas, o los datos del contacto y del evento de la ejecución de la automatización |
| Conjunto fijo de etiquetas | Sí, las cinco etiquetas anteriores | No, cualquier variable que pases |
| Valores anidados | Solo cf.<key> |
Cualquier ruta, como {{user.name}} |
| Valores alternativos | No | Sí |
| Condicionales | No | Sí, {{#if ...}} |
| Enlace de baja | {{unsubscribe_url}} |
No se proporciona |
En Temple, el valor alternativo va después de una barra vertical, por ejemplo {{first_name|"there"}}. Si guardas una campaña como plantilla y la envías con la API, Temple rellena sus etiquetas a partir de las variables que pasas. Pasa first_name para {{first_name}}, un objeto cf para {{cf.company}} y tu propia unsubscribe_url si el contenido enlaza a una. En las automatizaciones, los campos personalizados del contacto están disponibles como {{custom_fields.<key>}}, no como {{cf.<key>}}.