Personalización

Fóir decide qué versión de tu contenido recibe una petición antes de responder. Un sitio web, una app nativa y un agente hacen la misma pregunta y reciben el mismo contenido, sin que quede nada por resolver en el cliente.

Pruébalo con un registro real

Este panel lee un registro real de la API de Fóir: el hero de la página de inicio de una marca de running en producción. Cambia el visitante y la misma consulta devuelve contenido distinto.

El sitio solo indica qué tipo de producto hay en el carrito. Fóir averigua en el servidor dónde está el visitante, qué ha comprado y cuánto ha gastado, así que nadie puede mudarse a París ni convertirse en VIP editando una petición. En esta página los defines tú mismo, para ver cada caso.

Enviado por tu sitio

¿Qué hay en su carrito?

Calculado por Fóir en el servidor

¿Dónde está el visitante?
¿Ha comprado zapatillas de running antes?
¿Cuánto ha gastado?

Lo que devolvió

La lectura que envía tu sitio

personalisationDemo(
  naturalKey: "home-hero"
) {
  heading
  body
  ctaLabel
  _variant
}

Añadido por Fóir en el servidor

location
51.51,-0.13
segment.runner
false
segment.vip
false

El servidor toma la decisión

Una lectura le dice a Fóir lo que sabe de la petición: el dispositivo, el locale y cualquier dimensión propia, como el tipo de producto en el carrito o el mercado en el que compra el visitante. Fóir añade el resto por su cuenta: desde dónde llegó la petición, si el usuario tiene la sesión iniciada y a qué segmentos pertenece.

Elige la variante cuyas reglas coinciden y devuelve el registro con los valores de esa variante ya aplicados. Tu código lee los mismos campos sea cual sea la versión que llegue.

Lo que un visitante no puede declarar

La ubicación, el estado de inicio de sesión, la pertenencia a segmentos y los datos de perfil nunca se toman de quien llama. Fóir sitúa la petición por sí mismo y deduce el resto a partir del token del usuario, diga lo que diga la petición.

La regla de un segmento puede leer un campo de perfil que el cliente no tiene permiso para ver, así que un valor que mantienes privado puede decidir igualmente qué se le muestra a un cliente.

Un público se define una sola vez

A quién va dirigida una variante es una entrada del catálogo de variantes: un conjunto de reglas con nombre y una prioridad. Las reglas pueden combinar dimensiones y segmentos con AND y OR.

Cualquier número de registros puede apuntar a una misma entrada. Edita la entrada y se redirigen todas las variantes que la usan.

Una página, un campo o un párrafo

Una variante puede reemplazar un registro completo, con sus propios borradores e historial de versiones. También puede sobrescribir un solo campo, o una entrada dentro de un campo de prosa o de una lista, y dejar el resto igual.

Los editores escriben cada versión en el mismo editor y previsualizan el borrador como el público al que va dirigido.

Ejemplo: el maratón de París

Una marca de running quiere que su página de inicio destaque el maratón, pero solo para quienes están en París y ya le han comprado zapatillas de running.

Ninguno de los dos datos viene del sitio. Fóir sitúa cada petición, así que una regla puede pedir visitantes a menos de 30 km de París. Un segmento lee el perfil del cliente con sesión iniciada: las categorías que ha comprado incluyen zapatillas de running.

Una entrada del catálogo combina ambas condiciones, y una variante de la página de inicio con el titular y la imagen del maratón apunta a ella. En el front end no cambia nada.

Lo que devuelve esa lectura

La lectura es la misma que ya hace la página de cada visitante, enviada con el token del cliente. Un cliente en París que ha comprado zapatillas de running recibe la página del maratón, y _variant en la respuesta nombra la variante que se sirvió.

Un visitante en Lyon, o cualquiera sin sesión iniciada, recibe la página por defecto. El segmento se evalúa en cada petición, así que no hay ninguna lista de corredores que mantener sincronizada.

Ejemplo: VIP por gasto total

Un público VIP es un segmento: una regla sobre el perfil del cliente según la cual su gasto total supera un umbral que tú eliges.

Apunta una entrada del catálogo a él y cualquier registro puede llevar una versión VIP, ya sea un banner, una lista de precios o una página de destino completa. El cliente la ve en la primera lectura después de superar el umbral.

Vista previa, caché y traza

El editor resuelve un borrador para el locale y el público que elijas, de modo que lo que apruebas es lo que se publica. Una respuesta que contiene una variante resuelta se marca como privada, para que una caché compartida no la almacene.

Un interruptor de depuración en una lectura informa de qué variantes se consideraron y por qué se sirvió una, a una clave que tenga el alcance de depuración.

Lee el detalle

Variantes, Públicos y segmentos y Resueltas en la lectura explican cada una una parte en profundidad, y la guía de segmentación tiene la sintaxis de las reglas.