Affiliate Cloud Referencia

Variables de la plantilla de entrega

La lista de variables que se pueden usar en la plantilla de una campaña y en qué formato sale cada una, por API y por correo.

Actualizado el 26 de octubre de 2026

En esta página

Para qué sirve
Quién puede usarlo
Dónde se ven en la pantalla
Las variables
Lo que conviene saber
Errores frecuentes

En resumen

Las variables se escriben entre llaves en la plantilla de la campaña, {phone}, y al enviar cada lead se cambian por sus datos.
No todas salen igual por API y por correo: la fecha y el género cambian de formato, y algunas sólo existen en uno de los dos.
Una variable que no existe se envía escrita tal cual, sin ningún error.
El teléfono sale con el prefijo de su país en los diez países que la plataforma reconoce, y la provincia, si el afiliado no la manda, se deduce del código postal en España.

Para qué sirve

Para saber qué escribir en Mapeo del Body / Payload (entrega por API) o en Cuerpo del Mensaje (entrega por correo), y cómo le llega cada dato del lead al anunciante. Cómo se configura cada entrega: Entregar los leads por API (Host & Post) y Entregar los leads por correo electrónico.

Quién puede usarlo

Lo mismo que para cambiar la ficha de la campaña: Permitido en Gestionar (Editar / Operar), en la fila Campañas de Affiliate Cloud del panel de permisos. Si no lo tienes, pídeselo a un administrador de tu cuenta.

Dónde se ven en la pantalla

Por API: en la ficha de la campaña, pestaña Integración, debajo de Mapeo del Body / Payload. El formulario de alta no tiene esa lista.
$Caja «Mapeo del Body / Payload» con una plantilla JSON y, debajo, la lista de variables que se pueden usar por API y las ayudas sobre {province}, {user_agent} y el JSON válido con cada variable entre comillas.$
Por correo: los botones del Diccionario de Variables, bajo el título Cuerpo del Mensaje y encima de la caja del mensaje. En el alta faltan Provincia y Navegador; se pueden escribir a mano.

Las variables

Cada una sale de un campo que manda el afiliado por la API de leads: API de leads: enviar un lead (referencia).

Variable	Qué es	Por API	Por correo
`{name}`	El nombre (`name_lead`)	Tal cual; vacío si no llega	Igual
`{lastname}`	Los apellidos (`lastname_lead`)	Tal cual; vacío si no llega	Igual
`{email}`	El correo (`email_lead`); siempre llega	Tal cual	Igual
`{phone}`	El teléfono (`phone_lead`)	Con el prefijo de su país (ver abajo); vacío si no llega	Igual
`{address}`	La dirección (`address_lead`)	Tal cual; vacío si no llega	Igual
`{zip}`	El código postal (`zip_lead`)	Tal cual; vacío si no llega	Igual
`{city}`	La ciudad (`city_lead`)	Tal cual; vacío si no llega	Igual
`{province}`	La provincia (`state_lead`)	La que mande el afiliado; si no, la del código postal (ver abajo)	Igual
`{country}`	El país (`country_lead`), dos letras; siempre llega	Tal como llega, sin pasar a mayúsculas	Igual
`{birthdate}`	La fecha de nacimiento (`birthdate_lead`)	`dd/mm/aaaa`; sin fecha, `01/01/1900`	`AAAA-MM-DD`; sin fecha, `1900-01-01`
`{gender}`	El género (`gender_lead`)	`M` hombre, `W` mujer, `U` sin dato	`M`, `F` o `U`
`{ip}`	La IP del usuario (`ip_lead`); siempre llega	Tal cual	Igual
`{user_agent}`	El navegador del usuario al dar el consentimiento (`user_agent_lead`)	Tal cual; vacío si no llega	Igual
`{subid}`	El subid del afiliado (`subid_lead`)	Tal cual; vacío si no llega	Igual
`{click_id}`	El mismo dato que `{subid}`	Igual que `{subid}`	No existe: llega escrita tal cual
`{id_lead}`	El número del lead en la plataforma	El número	No existe: llega escrita tal cual
`{custom_data.clave}`	El dato `clave` de los datos extra (`custom_data`)	Su valor; vacío si no llega	Su valor; si no llega, escrita tal cual
`{custom_data}`	Todos los datos extra	No existe: llega escrita tal cual	Cada dato como «Clave: valor» (la clave con los guiones bajos como espacios y la primera letra en mayúscula), pero todos en una sola línea, separados por un `<br>` que llega escrito

{id_lead} es único en la plataforma: sirve como referencia del lead en el sistema del anunciante.

Lo que conviene saber

El teléfono

Se quitan los espacios y todo lo que no sea una cifra o +.
Si empieza por + y tiene 9 caracteres o más, se deja así.
Sin +, y si el país es ES, MX, CO, CL, PE, AR, US, BR, PT o NL, se quitan el 00 y los ceros del principio y se pone el prefijo de ese país: 600 000 001 de ES sale +34600000001. Si el número ya traía el 34 delante sin el +, el prefijo se añade igualmente.
Sin + y con otro país, sale tal como lo mandó el afiliado, espacios incluidos.

La provincia

Si el afiliado manda state_lead, sale eso, aunque no sea una provincia.
Si no, se deduce del código postal sólo en España y con 5 cifras exactas: 8001 no da ninguna provincia. Los nombres son los de uso común, como «Gipuzkoa» o «A Coruña».

Los datos extra

La clave distingue mayúsculas: {custom_data.vivienda} no recoge Vivienda.
Un número sale como número (3.50 llega como 3.5). Un true llega como 1 y un false, vacío. Un null, una lista o un objeto no tienen valor.
Por eso Enviar como verdadero / falso (sin comillas) no convierte un true o false que llegue así: sólo actúa sobre el texto true o false, por ejemplo tras un Mapeo (Buscar y Reemplazar). Y los Requisitos del lead leen ese mismo dato como el texto «true» o «false»: un false que los cumple llega vacío al anunciante y, con Omitir el campo si está vacío, desaparece.

Datos de relleno y reglas

Sin fecha de nacimiento se envía la de relleno. Si el anunciante no la quiere, en la entrega por API pon dos reglas sobre {birthdate}: un Mapeo (Buscar y Reemplazar) con 01/01/1900= y después Omitir el campo si está vacío.
{gender} usa W para mujer por API. Si el anunciante espera otra letra, un Mapeo (Buscar y Reemplazar) como W=F.
{name}: si el afiliado no manda el campo name_lead, sale vacía, pero Omitir el campo si está vacío y Si está vacío, usar otra variable no actúan sobre ella. Si lo manda vacío, sí.

Las reglas sólo existen en la entrega por API: Reglas de transformación: adaptar los datos a lo que pide el anunciante.

Cómo se insertan

Se sustituyen de una pasada: un dato que contenga el texto de otra variable no se vuelve a sustituir.
Por API, cada valor se escapa según la forma de la plantilla; por eso cada variable va entre comillas en un JSON: Entregar los leads por API (Host & Post).
Por correo, los datos se escriben como texto: una etiqueta HTML del afiliado sale escrita, no se aplica.
Una variable que no existe, como {inventada}, se envía escrita tal cual. No da error ni al guardar ni al enviar.
{user_agent} sólo tiene valor si el afiliado manda user_agent_lead, y su guía de la API no lo nombra salvo que la campaña lo pida en Requisitos del lead: Requisitos del lead de una campaña: qué se exige y qué se rechaza. Si el anunciante lo necesita, pídeselo al afiliado.

Errores frecuentes

Lo que ves	Qué significa	Qué hacer
Al anunciante le llega una variable escrita tal cual	No existe en ese tipo de entrega, está mal escrita o, en el correo, el afiliado no mandó ese dato extra.	Compárala con la tabla.
Le llega `01/01/1900` o `1900-01-01`	El lead no traía fecha de nacimiento.	Por API, quítala con dos reglas (ver arriba).
Le llega `W` en el género	Así sale la mujer por API.	Tradúcela con un Mapeo (Buscar y Reemplazar).
Le llega un teléfono con el 34 repetido	El afiliado lo mandó con el 34 delante y sin `+`.	Pide al afiliado que lo mande con `+34` o sin prefijo.
Le llega vacío un dato que el afiliado manda como `false`	Los valores verdadero/falso llegan como `1` y vacío.	Pide al afiliado que lo mande como texto.