Coordinar los SDKs entre plataformas

• El JavaScript SDK o engine.js para entornos web.
• El SDK móvil para aplicaciones Android o iOS.
• SDKs del lado del servidor para integraciones de backend y lógica de decisión.

​

Descripción general de la arquitectura

• Sitio web: utiliza el JavaScript SDK o engine.js para ejecutar experimentos y campañas de personalización del lado del cliente.
• Aplicación móvil: utiliza un SDK móvil para mostrar las variaciones y hacer seguimiento de las conversiones.
• Servidor backend: utiliza un SDK del lado del servidor para tomar decisiones de variación centralizadas o sincronizar los datos del visitante.

​

Flujo de datos y de visitor code

• El visitor code identifica a los usuarios de forma consistente en todos los entornos.
• El SDK del lado del servidor coordina las decisiones de variación cuando es necesario.
• Cada SDK envía los datos de analítica y tracking directamente a la plataforma Kameleoon.

​

Visitor code y gestión cross-device

​

Generar y compartir los visitor codes

1. El engine, el web SDK, el SDK del lado del servidor o la aplicación móvil genera el visitor code.
2. El backend recupera el visitor code existente cuando el usuario inicia sesión en una nueva plataforma.
3. El sistema pasa el visitor code a los SDKs móvil, del lado del servidor y web. Esto garantiza que todas las plataformas evalúen al mismo usuario de forma consistente.

​

Sincronizar los visitor codes

• Almacene el visitor code de forma segura en el backend o la base de datos de usuarios y vincúlelo al ID de usuario.
• Siga estos pasos cuando un usuario inicie sesión en otra plataforma:
  • Aplicación móvil: solicite el visitor code al backend.
  • SDK del lado del servidor: utilice el mismo visitor code para todas las llamadas de variación y tracking.
  • Web SDK: establezca el visitor code utilizando la API de JavaScript:

kameleoon.API.Visitor.setVisitorCode(visitorCode);

​

Buenas prácticas

• Asocie el identificador de usuario existente (como userId) a un único visitor code de Kameleoon en todas las plataformas.
• Mantenga el backend como la fuente de verdad de los visitor codes.
• Evite que los SDKs sobrescriban los visitor codes existentes para usuarios conocidos.

​

Gestión de experimentos entre entornos

​

Escenario de ejemplo

• La aplicación móvil muestra la variación.
• El servidor backend determina la variación asignada.

​

Opciones de implementación

1. La aplicación móvil envía el visitor code al backend.
2. El SDK del lado del servidor llama a getVariation() (o su equivalente) para recuperar la variación asignada.
3. El backend devuelve el ID o nombre de la variación a la aplicación móvil.
4. La aplicación móvil muestra la variación y registra la exposición.
5. Tanto los SDKs móvil como del servidor utilizan el mismo visitor code para los eventos de tracking.

• Centraliza la lógica de variación y garantiza decisiones consistentes.
• Soporta experimentos que afectan tanto a la lógica del backend como a los elementos de UI.

1. El SDK móvil recupera la asignación de variación utilizando el visitor code.
2. La aplicación móvil aplica la variación localmente y registra la exposición directamente.
3. (Opcional) Si el backend también participa en el tracking o la validación, el SDK del lado del servidor reutiliza el mismo visitor code para garantizar la coherencia de los informes.

• Proporciona una decisión síncrona y de latencia cero.
• Reduce la latencia al evitar un round trip al servidor.
• Optimiza los experimentos centrados en la UI que no dependen de la lógica del backend.

​

Elegir la configuración adecuada

​

Ejemplos de código: pasar el visitor code entre capas

const visitorCode = kameleoon.API.Visitor.code;
fetch("/api/syncVisitor", {
  method: "POST",
  body: JSON.stringify({ visitorCode }),
});

let kameleoonClient = try KameleoonClientFactory.create(
    siteCode: siteCode, 
    visitorCode: visitorCodeFromBackend
)
let variation = try kameleoonClient.getVariation(featureKey: featureKey)

client = KameleoonClientFactory.create(SITE_CODE, config)
variation = client.get_variation(visitor_code, feature_key)

• Asigne un único visitor code por usuario en todas las plataformas.
• Gestione y distribuya los visitor codes desde el backend.
• Seleccione la capa de lógica de variación según el tipo de experimento (servidor para la lógica centralizada, lado del cliente para la UI impulsada por la aplicación).
• Mantenga datos coherentes y cross-device haciendo seguimiento de toda la actividad del usuario con el mismo visitor code.