Saltar al contenido principal
La integración Amplitude Event Streaming envía automáticamente eventos a su cuenta de Amplitude cada vez que los visitantes son expuestos a un experimento de Kameleoon. Esta integración permite una analítica enriquecida en Amplitude, proporcionando información sobre la exposición a los experimentos para ayudarle a comprender mejor el comportamiento y la interacción del usuario.
Esta integración utiliza el dispatcher de eventos de Kameleoon para enviar eventos del lado del servidor a su cuenta de Amplitude en lotes mediante el endpoint /import de la HTTP API de Amplitude.

Ventajas clave

  • Información precisa sobre el comportamiento: La integración envía eventos específicos a herramientas de terceros para los visitantes expuestos a experimentos web y feature flags en proyectos basados en SDK, como aplicaciones. Este seguimiento detallado permite una visión más clara de cómo las diferentes variaciones afectan a las acciones del usuario. Por ejemplo, puede observar qué variación genera más clics, conversiones u otros resultados deseados, ayudándole a determinar el enfoque más eficaz.
  • Toma de decisiones en tiempo real: La integración proporciona datos en tiempo real, lo que permite tomar decisiones sobre la marcha. Con información actualizada sobre los experimentos en curso, puede ajustar rápidamente las estrategias si una variación no está funcionando como se esperaba.
  • Configuración sencilla: Habilite las integraciones de terceros directamente desde la aplicación de Kameleoon sin necesidad de código personalizado o cambios en el SDK.

Consideraciones

  • Tiempo de entrega de eventos: Los servidores de Kameleoon envían los eventos con un retraso mínimo de 30 minutos.

Requisitos previos

Para configurar esta integración, necesita la siguiente información:
  • Amplitude API key: La clave de API exclusiva de uno de sus proyectos de Amplitude (como se documenta aquí).
  • Server residency: Especifique si su cuenta de Amplitude está configurada para la región de alojamiento estándar o de alojamiento UE.
  • Amplitude plan: Seleccione el tipo de plan de cliente que ha contratado con Amplitude.
El SDK de Kameleoon también debe estar instalado en su proyecto del lado del servidor.

Configuración

Esta integración se puede activar para Web Experimentation y Feature Experimentation.

Para experimentos web

Habilite la integración desde la página de integraciones.
Añada la integración mientras finaliza su experimento web.

Para experimentos de feature

Configure la integración en el entorno del feature flag en la sección de integraciones. Habilítela para los entornos en los que quiera que esté activa.
Una vez activada la integración y su experimento esté publicado, Kameleoon enviará automáticamente eventos de experimento a Amplitude cada vez que un visitante sea expuesto. Cada evento incluye detalles clave, como:
  • El código de visitante de Kameleoon (enviado tanto como propiedad personalizada como valor por defecto del campo device_id)
  • Marca de tiempo de exposición
  • ID de experimento de Kameleoon
  • ID de variación de Kameleoon

Ejemplo de payload de evento

Kameleoon envía eventos a Amplitude en el siguiente formato:
{
    "event_type": "$identify",
    "user_properties":
    {
        "$set":
        {
            "KAM_EXPERIMENT_12345": "KAM_VARIATION_15685",
            "KAM_VISITOR_CODE": "rjfloel55ug9fg"
        }
    },
    "device_id": "rjfloel55ug9fg" // also Kameleoon visitor code
    "time": 1730194985000
}
Por defecto, user_id contendrá el código de visitante de Kameleoon del visitante. Si ha configurado la reconciliación del historial entre dispositivos de Kameleoon, se utilizará en su lugar el identificador colocado en el dato personalizado de reconciliación entre dispositivos en lugar del código de visitante.

Personalización del payload para user_id, device_id y session_id

Por defecto, Kameleoon envía payloads donde los usuarios se identifican por el campo device_id, que contiene el código de visitante de Kameleoon. Sin embargo, puede personalizar el contenido de estos payloads creando y rellenando datos personalizados en Kameleoon. Puede definir cualquiera o todos los siguientes datos personalizados:
  • Identificación entre dispositivos (user_id):
    • Si crea un dato personalizado y habilita la opción de usar para la identificación entre dispositivos, su valor —cuando esté presente durante una visita— se enviará en el campo user_id de Amplitude. Este dato personalizado es ideal para identificadores de “usuario autenticado” asociados a sus usuarios.
  • Identificador de dispositivo (device_id):
    • Si crea un dato personalizado llamado amplitude_device_id, su valor —cuando esté presente— sustituirá al código de visitante de Kameleoon en el campo device_id del payload. Este dato personalizado se recomienda para identificadores “anónimos” vinculados a los dispositivos del usuario. Independientemente de si se establece este dato personalizado, el código de visitante original de Kameleoon sigue incluido en sus payloads bajo la propiedad personalizada KAMELEOON_VISITOR_CODE.
  • Identificador de sesión (session_id):
    • Si crea un dato personalizado llamado amplitude_session_id, su valor —cuando esté presente— se enviará en el campo session_id de Amplitude. Recomendamos establecer este valor para que coincida con el ID de sesión de Amplitude.

Ejemplo de payload de evento

{
    "event_type": "$identify",
    "user_properties":
    {
        "$set":
        {
            "KAM_EXPERIMENT_12345": "KAM_VARIATION_15685",
            "KAM_VISITOR_CODE": "rjfloel55ug9fg"
        }
    },
    "device_id": "dfkslj47h9"
    "user_id": "xf54dd2thdd5",
    "session_id": 1396381378123
    "time": 1730194985000
}
Tenga en cuenta que cualquier dato personalizado específico de su negocio, que normalmente se incluye en sus eventos de Amplitude, no estará presente en los eventos enviados por Kameleoon desde el servidor. Si necesita enriquecer el payload con datos no rastreados de forma nativa por Kameleoon, y tiene una cuenta de Kameleoon, puede enviar una solicitud de funcionalidad.