- 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.
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: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:
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áusulaWITH 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.
