Reglas de transformación: adaptar los datos a lo que pide el anunciante

Para qué sirve

El lead llega con los datos como los manda el afiliado: el teléfono con +34, el género como M o W, las respuestas como las escribió el usuario. Si el sistema del anunciante los quiere de otra forma, las reglas los adaptan sin tocar la plantilla. La plantilla dice dónde va cada dato; las reglas, cómo llega.

Quién puede usarlo

Necesitas 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; el cambio surte efecto en tu siguiente inicio de sesión. Las reglas de una campaña nueva las pone un administrador al crearla, o cualquiera con ese permiso después, en la ficha.

Paso a paso

1. Abre la ficha de la campaña y la pestaña Integración. La campaña tiene que estar en Host & Post (API).
2. Baja hasta Reglas de Transformación de Datos, debajo de Mapeo del Body / Payload.

   

3. Pulsa Añadir regla ①. La regla nueva sale al final de la lista, con {phone} y Eliminar texto / prefijo de partida y el cursor en la variable.
4. En Variable, escribe el dato que quieres cambiar: {phone}, {gender} o {custom_data.clave} para un dato extra. Al escribir salen sugerencias, incluidos los datos extra que ya usa la plantilla.
5. En Acción, elige qué hacer. Si la acción necesita un valor, aparece la casilla Valor; si no, sale un guion.
6. Ordénalas con las flechas de cada regla ② y quita la que sobre con la papelera ③.
7. Pulsa Guardar Cambios.

Mientras editas una regla, si su acción tiene ayuda, sale debajo ①:

Las nueve acciones

El Mapeo, en detalle

• Busca primero el valor exacto. Si no lo encuentra, compara sin mayúsculas, sin tildes y sin espacios de más: Sí=true también casa con si.
• *=valor vale para cualquier otro valor que no esté vacío, por ejemplo Piso=piso,*=otro. *= sin nada detrás lo deja vacío.
• Sin coincidencia ni comodín, el valor se queda como estaba.
• Compara el valor entero: no cambia un trozo de texto dentro de otro.

Número y verdadero/falso

• En la plantilla, la variable va entre comillas, pegada a ellas: "tel": "{phone}". Con un espacio dentro de las comillas no se convierte. Sin comillas, la plantilla deja de ser JSON: Entregar los leads por API (Host & Post).
• Un número sale sin comillas sólo si lo es para el JSON: sin ceros delante, sin + y con punto decimal. 08001, +34600000001 o 85,50 salen como texto. Por eso, para el teléfono, quita antes el prefijo.
• Verdadero/falso actúa sobre el texto true o false, sin importar mayúsculas. Si el afiliado manda Sí o No, añade también un Mapeo Sí=true,No=false.
• Son para plantillas JSON. Con un formulario o una dirección (POST (x-www-form-urlencoded), GET (Query String)) no hay tipos.

Lo que conviene saber

• El orden importa en las reglas que cambian el valor (quitar texto, Mapeo, mayúsculas, minúsculas y Si está vacío, usar otra variable): cada una trabaja con el valor que dejaron las de arriba. En Si está vacío, usar otra variable, si la otra variable tiene su propia regla más arriba, se toma ya cambiada; si la tiene más abajo, sin cambiar.
• Las otras cuatro se deciden al final, con todas las reglas aplicadas, estén donde estén: número, verdadero/falso, Omitir el campo si está vacío y Enviar el campo sólo si otra variable vale…. La condición compara sin mayúsculas, tildes ni espacios de más; si la otra variable no llega, el campo tampoco se envía.
• Sólo quitan la clave cuyo valor es exactamente esa variable. "nombre": "{name} {lastname}" se envía igual aunque el apellido esté vacío.
• Un dato extra que la plantilla usa y no llega cuenta como vacío: Omitir el campo si está vacío lo quita y Si está vacío, usar otra variable lo rellena. Una regla sobre una variable que la plantilla no usa no cambia lo que se envía, y la pantalla no avisa.
• Elige bien el texto que quitas. Eliminar texto / prefijo con 34 sobre +34600343434 deja +600: quita todas las apariciones. Con +34 no pasa, porque el + sólo va delante.
• El género por API es M, W o U. El ejemplo de la casilla, M=1,F=2, deja la W sin traducir: escribe M=1,W=2. Qué valor de partida tiene cada variable: Variables de la plantilla de entrega.
• Los espacios de los bordes se quitan al guardar, en la variable y en el valor.
• Guarda antes de hacer otra cosa en la pestaña. Mover o añadir reglas no cuenta como cambio sin guardar: si después pulsas Guardar autenticación, el nuevo orden se pierde sin preguntar. Y Enviar lead de prueba usa siempre las reglas guardadas.
• Cambiar la campaña a Envío por Email y guardar borra las reglas, y volver a Host & Post (API) no las recupera: Ficha de campaña: las cuatro pestañas.
• También se aplican cuando la campaña sirve de conector a un comprador de Lead Gen.

Lo que no hace

• No cambia las cabeceras HTTP ni el Mapeo de Respuestas (Validación S2S): sólo el cuerpo que se envía.
• No une variables, ni recorta longitud, ni cambia fechas: eso se escribe en la plantilla o no se puede.
• No enseña cómo queda el cuerpo. Para verlo, el Log del Directorio de Leads de un lead ya entregado (Directorio de Leads: buscar, filtrar e inspeccionar la entrega) o, con cuidado, el lead de prueba (Enviar un lead de prueba desde la ficha de la campaña).

Errores frecuentes

Relacionado

• Entregar los leads por API (Host & Post)
• Variables de la plantilla de entrega
• Ficha de campaña: las cuatro pestañas
• Enviar un lead de prueba desde la ficha de la campaña
• Directorio de Leads: buscar, filtrar e inspeccionar la entrega