Inicializar sesión
Inicialice una sesión de la Product Recommendation API para obtener un device ID y un session ID antes de llamar a cualquier otro endpoint de recomendaciones.
init. El proceso de inicialización acepta el identificador del usuario actual y solicita los ajustes del proyecto y las preferencias del usuario.
Cuándo inicializar
Según su plataforma, los requisitos sobre cuándo ejecutarinit son distintos:
- cURL: inicialice cada vez que se renderice la página.
- Web: inicialice cada vez que se abra la página (incluidas las single-page applications).
- iOS o Android: inicialice cada vez que se inicie la aplicación.
init sin un device ID para generar uno. Para una lógica de recomendaciones en backend con Kameleoon Web Experimentation, llame a esta API y almacene los IDs en la cookie KameleoonProducts_session_code para sid y en KameleoonProducts_device_id para did.
Parámetros de consulta
sid es obligatorio, no lo añada durante la primera inicialización, ya que el sistema lo genera y lo devuelve en la respuesta (como seance).Una vez generado, use el sid generado por el sistema para las solicitudes dentro de la sesión actual.Respuesta
Parámetros de consulta
Store Key. Find this in Recommendations > Settings > Store settings in the Kameleoon app. Contact your Customer Success Manager for the key if necessary.
A device ID. If a device ID already exists, specify it here. If you don't specify a did, the API generates a new one. Use this generated ID as the device ID for all future requests.
A session ID is a temporary identifier assigned to the user for the current session. Do not include sid on the first init request; Kameleoon generates and returns it (as seance) in the response. If a sid is specified and does not exist in the system, an error occurs.
Respuesta
Session initialized. Verified against a live response on 2026-09-24; fields below reflect what the API actually returns, which is more than the did/seance pair described in the endpoint's prose.
The device ID. Store this for use on subsequent requests.
The generated session ID (sid). Use it for requests within the current session.
The shop's default currency symbol.
Whether the email collector feature is enabled for this shop.
Whether an email address is already associated with this session.
Whether product recommendations are enabled for this shop.
Whether recommendation blocks lazy-load on this shop.
Whether Kameleoon automatically injects CSS for recommendation blocks.
The CMS/platform identifier configured for this shop, if any.
Custom JavaScript snippets configured for this shop in the Kameleoon app, injected alongside recommendation blocks.
The shop's Search service configuration.