# 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](/es/docs/audiences/unsubscribes/). |
| `{{cf.<key>}}` | El valor de un [campo personalizado](/es/docs/contacts/custom-fields/), 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**.

```html
<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](/es/docs/campaigns/test-and-schedule/).

## Etiquetas de combinación y Temple

Las campañas usan sus propias etiquetas de combinación. Las plantillas enviadas con la [API de email](/es/docs/email-api/) y los emails enviados por [automatizaciones](/es/docs/automations/) usan [Temple](/es/docs/templates/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>}}`.

## Ver también

  - [Campos personalizados](/es/docs/contacts/custom-fields/): Define los campos que usas en las etiquetas de combinación.
  - [Temple](/es/docs/templates/temple/): Variables, valores alternativos y condicionales para los envíos por API.

---
Fuente: https://emailit.com/es/docs/campaigns/merge-tags/
