Skip to main content
Una vez que haya activado Databricks para un proyecto específico, puede utilizarlo para crear objetivos en Kameleoon. Estos objetivos están diseñados para utilizar datos de conversiones directamente desde su base de datos de Databricks. Para crear un objetivo utilizando Databricks, siga el flujo de Data warehouse tracking descrito en Crear un objetivo y elija Databricks en el menú desplegable Datawarehouse integration. El paso 1 le pide estos campos específicos de Databricks:
  • Frecuencia: Seleccione con qué frecuencia debe ejecutarse la tarea.
  • Catálogo: Introduzca el nombre del catálogo de Databricks que contiene los esquemas de los que desea que Kameleoon lea.
  • Esquema: Introduzca el esquema que contiene sus datos de conversión.
  • Consulta: Introduzca una consulta SQL con dos columnas: la primera columna debe contener el ID de usuario (o kameleoonVisitorCode) y la segunda debe contener el valor correspondiente que quiere añadir como información adicional (enriquecimiento) para ese usuario.
Una vez que el paso 1 esté completo, configure el paso 2, Configuración avanzada, si es necesario, y luego guarde su objetivo.
Período de retención del warehouse de datos: Para que un evento se consulte, Kameleoon requiere que permanezca accesible mediante su consulta de entrada al menos durante 72 horas después de que se produjera el evento.

Formato de la consulta

La consulta debe seguir un formato específico:
Donde visitor_id es la columna que representa el ID único de sus visitantes y conversion_timestamp es una columna que representa el momento exacto en que se produjo la conversión. En Databricks, la columna conversion_timestamp debe ser una columna de tipo Timestamp. Si quiere asociar un ingreso a cada conversión, la consulta debe seguir un formato alternativo:
Donde revenue es una columna que contiene los ingresos de cada conversión. Para consultas más complejas, puede ajustarse a este formato formulando una subconsulta así:

Cómo Kameleoon consulta los datos de conversión

Kameleoon consulta los datos de conversión de Databricks de su objetivo cada hora, añadiendo a su consulta una cláusula WITH que filtra por marcas de tiempo. En lugar de recargar todo el historial de eventos en cada ejecución, Kameleoon consulta de forma incremental: cada tarea de consulta registra el último punto de consulta correcto y, en la siguiente ejecución, solo consulta la ventana temporal de los registros nuevos desde ese punto. Consultar solo esa ventana mantiene cada consulta rápida, ya que Kameleoon nunca vuelve a escanear datos que ya ha importado. Aunque las conversiones se recopilan cada hora, solo se fusionan en los resultados de su experimento una vez al día. Como la consulta siempre avanza hacia delante, Kameleoon puede pasar por alto un registro que llega a Databricks con una marca de tiempo anterior a la última ventana de consulta correcta. Los registros tardíos suelen llegar porque su pipeline de datos tarda en escribir el evento de conversión, de modo que el registro llega a Databricks solo después de que Kameleoon ya haya consultado más allá de la ventana temporal a la que pertenece. Para evitar registros perdidos, configure el plazo de ingesta que aparece a continuación para que coincida con el retraso de llegada habitual de su pipeline.

Plazo de ingesta

Por defecto, Kameleoon permite hasta 1 hora entre el momento en que se produce un evento de conversión de su objetivo y el momento en que está disponible en su warehouse de Databricks, y su ventana de consulta tiene en cuenta ese retraso automáticamente. Si su pipeline tarda más de 1 hora en escribir eventos en Databricks, por ejemplo debido a procesos ETL por lotes o nocturnos, esos registros de llegada tardía quedan fuera de la ventana de consulta y se pierden. Póngase en contacto con su Customer Success Manager para ampliar el retraso de modo que coincida con el retraso de llegada real de su pipeline.

Ejecutar su consulta antes de la ingesta

Antes de guardar su tarea de ingesta, puede probar su consulta directamente en Kameleoon. Las pruebas le permiten:
  • Verificar la conexión en tiempo real.
  • Confirmar que sus credenciales y derechos de acceso son correctos, lo que ayuda a detectar problemas de inmediato, sin tener que esperar a la primera importación de datos.
  • Validar la estructura y accesibilidad de sus datos.
Puede ejecutar una consulta sencilla para asegurarse de que Kameleoon puede acceder a las bases de datos y tablas correctas. También puede descargar una pequeña muestra del dataset para confirmar que el esquema, los permisos y el contenido coinciden con sus expectativas.

Utilizar su objetivo de Databricks

Ahora que ha creado un objetivo, puede incorporarlo a sus campañas de Kameleoon. Al configurar un experimento o personalización, puede seleccionar el objetivo, lo que le permitirá realizar el seguimiento y analizar conversiones específicas en su base de datos de Databricks. Estas conversiones se fusionan con los resultados de su experimento una vez al día, por lo que todas las conversiones consultadas en un día determinado estarán disponibles a la mañana siguiente. Para aprender a configurar un objetivo en un experimento, consulte Configurar un objetivo en una campaña.