Saltar al contenido principal
Esta guía explica cómo recuperar colecciones de productos usando la Product Recommendation API sin incrustar el elemento HTML de Kameleoon. Utilice el siguiente endpoint:

¿Por qué usar la API?

Use la API para aplicaciones móviles.
Según sus necesidades, este enfoque ofrece múltiples ventajas:
  • Control total: Personalice la visualización de la variación para que coincida con sus estándares de diseño y UX.
  • Mejor rendimiento: Utilice llamadas a la API optimizadas para reducir los retrasos de carga de la página en comparación con las soluciones basadas en script.
  • Depuración más sencilla: Registre, supervise y depure las integraciones dentro de su base de código del cliente utilizando herramientas estándar.
  • Sin dependencia de scripts de terceros: Utilice llamadas directas para evitar scripts externos, reducir conflictos potenciales y alinearse con las políticas de seguridad.
  • Compatible con SPAs: Integre directamente en aplicaciones de una sola página para evitar problemas de tiempo y encajar con el enrutamiento del lado del cliente.
  • Resistencia frente a bloqueadores de anuncios: Entregue los experimentos de forma consistente sin scripts de terceros ni marcadores HTML específicos. Para más detalles sobre cómo afectan los bloqueadores de anuncios a Kameleoon, consulte las FAQ.

Objetivo

Recupere una colección de productos del motor de recomendaciones y muéstrela en su frontend. Por ejemplo, la siguiente imagen muestra una colección renderizada en una página de inicio:
Product Collections

Requisitos

  • Una cuenta de Kameleoon válida con un Store ID (shop_id).
    • Obtenga su shop_id en Recommendations > Settings > Store settings en la aplicación Kameleoon. Contacte con su Customer Success Manager para obtener la clave si es necesario.
Store Key
  • Un collection_id de la sección Product Collections del dashboard. Esta sección lista sus colecciones configuradas y sus IDs.
Collection ID
  • Un Device ID (did) y un Session ID (sid). (Obligatorios solo cuando se utilicen filtros o algoritmos que dependan de datos históricos de dispositivo/usuario).
    • Para Kameleoon Web Experimentation, obténgalos de las siguientes cookies:
      • KameleoonProducts_device_idDevice ID (did)
      • KameleoonProducts_session_codeSession ID (sid)
    • En caso contrario, genere estos valores manualmente.

Pasos

1. Recuperar las cookies (solo Kameleoon Web Experimentation)

Genere estos valores manualmente para implementaciones de backend o entornos sin Kameleoon Web Experimentation. Consulte el endpoint Init para más detalles.

2. Solicitud de consulta

Endpoint:
Sustituya {collection-id} por el valor de Requisitos.
Para personalizar la colección para usuarios en varias plataformas, utilice el external_id configurado como Kameleoon Custom Data en lugar del did.
Ejemplo:

3. Respuesta

La aplicación móvil puede ignorar html.
La API no devuelve CSS; debe aplicar estilos al resultado manualmente.
Ejemplo: