Skip to main content

Pleasepoint API: Personaliza one-to-one y en tiempo real la interacción en el eCommerce (Parte 4).

Cómo utilizar la API de Pleasepoint para la recomendación de productos en tiempo real en tu eCommerce.

8 de noviembre del 2023 Pitu Sabadí

En este post te enseñaremos a utilizar la API de Pleasepoint para la recomendación one-to-one de productos en cualquier eCommerce, web o aplicación. De esta forma podrás utilizar las funciones de la APU en cualquier entorno y momento de interacción del usuario.

Estos son los contenidos del post:

  1. API: Mejora la experiencia de tus clientes.
  2. Recomendación one-to-one de productos.
  3. Recomendación de productos basada en otro producto (item-item).
  4. Recomendación basada en ranking de productos (ranking one-to-one).
  5. Recomendación basada en bestsellers.
  6. Registrando eventos de interacción.
  7. ¿Por qué debes personalizar one-to-one tu eCommerce con la API de Pleasepoint?

Este post es el cuarto de una serie de cuatro posts sobre cómo usar el SDK de Pleasepoint. En este artículo trataremos el uso del SDK en javascript. Te compartimos los enlaces a los otros tres posts:

Pleasepoint API: Hiper-personaliza en tiempo real la experiencia de usuario.

En este artículo, vamos a sumergirnos en el mundo de la API de Pleasepoint, una herramienta versátil que te permite recomendar productos y registrar eventos de interacción desde prácticamente cualquier aplicación y lenguaje de programación. ¿Por qué querrías utilizar la API? Bueno, hay momentos en los que necesitas un control total sobre cómo interactúas con un servicio, y es ahí donde entra en juego la API. La API de Pleasepoint te brinda esa flexibilidad para adaptar la personalización de la experiencia del cliente a tus necesidades específicas.

Recuerda que en tu acceso a Pleasepoint, en cada uno de los apartados encontrarás los ejemplo de llamada API que debes realizar:q



Pero, ¿qué puedes lograr con esta API? La respuesta es: mucho. Puedes acceder a los modelos de recomendación altamente efectivos y, al mismo tiempo, registrar todos los eventos de interacción de tus usuarios. Esto significa que puedes adaptar la experiencia de compra en función del comportamiento de tus clientes, lo que puede llevar a mayores tasas de conversión y una satisfacción general del cliente.

La API incluye el acceso a los modelos one-to-one, item-item, ranking one-to-one y bestsellers. Cada uno de estos modelos tiene su propio conjunto de ventajas y casos de uso específicos que pueden mejorar significativamente la experiencia de compra de tus clientes. Estamos aquí para guiarte en la exploración de cómo aprovechar al máximo estos modelos a través de la API de Pleasepoint.

1. Mostrar la recomendación one-to-one.

Te compartimos los enlaces sobre cómo utilizar la recomendación one-to-one:

  1. Uso de los parámetros por defecto del widget de recomendación one-to-one de productos.
  2. Uso de los parámetros específicos del widget de recomendación one-to-one de productos.

Esta es la url de la llamada API:

https://api.pleasepoint.com/api/onetoone/recommendation/getRecommendation

Estos son los parámetros de la llamada API:

{
    "account_id":"XXXXXXXXXX",
    "ssid":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "deploy_slug": "onetoone-v4_deploy",
    "model_type": "one-to-one",
    "user_reference_id": "4000140388",
    "num_items": 3 ,
    "rule_slug": "rule-home-01"
}

Recuerda que debes modificar los parámetros según tu cuenta de Pleasepoint, la configuración que desees del widget, la identificación del usuario y la sesión.

Esta es la respuesta de la llamada API:

{
    "status": "ok",
    "data": [
        {
            "reference_id": 1411872.41,
            "name": "Lunar 2023",
            "price": "€ 8.90",
            "url": "https://www.url.com/9788494871986/1411872.41.html",
            "image_url": "https://www.url.com/dw/image/25deae81/images/large/1411872.41.jpg",
            "recommendationId": "RID-be-408a-8af2-d4d362284793-CID-2005b6"
        },
        {
            "reference_id": 583753.4,
            "name": "La asertividad: expresión de una sana autoestima",
            "price": "€ 7.00",
            "url": "https://www.url.com/9788433011411/583753.40.html",
            "image_url": "https://www.url.com/dw/image/98c54e98/images/large/583753.40.jpg",
            "recommendationId": "RID-be-408a-8af2-d4d362284793-CID-2005b6"
        },
        {
            "reference_id": 1402625.38,
            "name": "Skeleton Keys",
            "price": "€ 7.95",
            "url": "https://www.url.com/9788424672911/1402625.38.html",
            "image_url": "https://www.url.com/dw/image/5b49d15e/images/large/1402625.38.jpg",
            "recommendationId": "RID-be-408a-8af2-d4d362284793-CID-2005b6"
        }
    ]
}

Aprende a utilizar la recomendación one-to-one de productos y sus casos de uso durante la navegación en el eCommerce.

2. Mostrar la recomendación de productos basada en otro producto (item-item).

Te compartimos los enlaces sobre cómo utilizar la recomendación de productos item-item:

  1. Uso de los parámetros por defecto del widget de recomendación item-item de productos.
  2. Uso de los parámetros específicos del widget de recomendación item-item de productos.

Esta es la url de la llamada API:

https://api.pleasepoint.com/api/onetoone/recommendation/getRecommendation

Estos son los parámetros de la llamada API:

{
    "account_id":"XXXXXXXXXX",
    "ssid":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "deploy_slug": "itemitem-v4_deploy",
    "model_type": "item-item",
    "product_reference_id": "0904219.66",
    "user_reference_id": "4000140388",
    "num_items": 3 ,
    "rule_slug": "pdp-item-recommendations"
}

Recuerda que debes modificar los parámetros según tu cuenta de Pleasepoint, la configuración que desees del widget, la identificación del producto, del usuario y de la sesión de usuario.

Esta es la respuesta de la llamada API:

{
    "status": "ok",
    "data": [
        {
            "reference_id": 1357816.84,
            "name": "Los Compas perdidos en el espacio",
            "price": "€ 19.90",
            "url": "https://www.url.com/9788427048348/1357816.84.html",
            "image_url": "https://www.url.com/dw/image/2b7c8379/images/large/1357816.84.jpg",
            "recommendationId": "RID-f5-45d4-99e8-3c7b1ad35de4-CID-49a0f9"
        },
        {
            "reference_id": 1299455.03,
            "name": "El corazón del pirata",
            "price": "€ 18.90",
            "url": "https://www.url.com/9788414023488/1299455.03.html",
            "image_url": "https://www.url.com/dw/image/35cfc573/images/large/1299455.03.jpg",
            "recommendationId": "RID-f5-45d4-99e8-3c7b1ad35de4-CID-49a0f9"
        },
        {
            "reference_id": 1336752.48,
            "name": "Las Ratitas 2. Súper Alma en acción",
            "price": "€ 14.95",
            "url": "https://www.url.com/9788408227977/1336752.48.html",
            "image_url": "https://www.url.com/dw/image/1a6d0de/images/large/1336752.48.jpg",
            "recommendationId": "RID-f5-45d4-99e8-3c7b1ad35de4-CID-49a0f9"
        }
    ]
}

Aprende a utilizar la recomendación de productos basada en el modelo item-item y sus casos de uso durante la navegación en el eCommerce.

3. Mostrar el ranking one-to-one.

Te compartimos los enlaces sobre cómo utilizar la recomendación basada en el ranking one-to-one de productos:

  1. Uso de los parámetros por defecto del widget de recomendación basada en ranking one-to-one de productos.
  2. Uso de los parámetros específicos del widget de recomendación basada en ranking one-to-one de productos.

Esta es la url de la llamada API:

https://api.pleasepoint.com/api/onetoone/recommendation/getRecommendation

Estos son los parámetros de la llamada API:

{
    "account_id":"XXXXXXXXXX",
    "ssid":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "deploy_slug": "ranking-v4_deploy",
    "model_type": "ranking",
    "user_reference_id": "6000131413",
    "ranking_product_ids": "811832.01, 325867.43, 1420406.04, 1209029.16, 787689.20, 1434900.18, 1048194.41, 1349627.15",
    "rule_slug": "plp-ranking-recommendations"
    "num_items": 8
}

Recuerda que debes modificar los parámetros según tu cuenta de Pleasepoint, la configuración que desees del widget, la identificación de los productos, del usuario y de la sesión de usuario.

Esta es la respuesta de la llamada API:

{
    "status": "ok",
    "data": [
        {
            "reference_id": 787689.2,
            "name": "IQ Puzzler",
            "price": "€ 12.99",
            "url": "https://www.url.com/54652655262/787689.20.html",
            "image_url": "https://www.url.com/30a9a2a5/images/large/787689.20.jpg",
            "recommendationId": "RID-2a-4eac-9f74-9016e08e41fd-CID-2b8bc0"
        },
        {
            "reference_id": 811832.01,
            "name": "1000 pegatinas de monstruos y vampiros",
            "price": "€ 4.95",
            "url": "https://www.url.com/654651651651/811832.01.html",
            "image_url": "https://www.url.com/dw/image/80485db6/images/large/811832.01.jpg",
            "recommendationId": "RID-2a-4eac-9f74-9016e08e41fd-CID-2b8bc0"
        },
        {
            "reference_id": 1048194.41,
            "name": "Afilar el lapicero: guía de redacción pa",
            "price": "€ 10.90",
            "url": "https://www.url.com/9788433977236/1048194.41.html",
            "image_url": "https://www.url.com/dw/image/2faad56e/images/large/1048194.41.jpg",
            "recommendationId": "RID-2a-4eac-9f74-9016e08e41fd-CID-2b8bc0"
        },
        {
            "reference_id": 1349627.15,
            "name": "La mochila austriaca",
            "price": "€ 10.00",
            "url": "https://www.url.com/9788498889789/1349627.15.html",
            "image_url": "https://www.url.com/dw/image/6ed797db/images/large/1349627.15.jpg",
            "recommendationId": "RID-2a-4eac-9f74-9016e08e41fd-CID-2b8bc0"
        },
        {
            "reference_id": 1209029.16,
            "name": "Crea tus juguetes",
            "price": "€ 1.95",
            "url": "https://www.url.com/9843517328438954/1209029.16.html",
            "image_url": "https://www.url.com/dw/image/543aa66/images/large/1209029.16.jpg",
            "recommendationId": "RID-2a-4eac-9f74-9016e08e41fd-CID-2b8bc0"
        },
        {
            "reference_id": 1434900.18,
            "name": "El libro de manualidades con tijeras +3",
            "price": "€ 9.95",
            "url": "https://www.url.com/1278246998573/1434900.18.html",
            "image_url": "https://www.url.com/dw/image/313785ec/images/large/1434900.18.jpg",
            "recommendationId": "RID-2a-4eac-9f74-9016e08e41fd-CID-2b8bc0"
        },
        {
            "reference_id": 1420406.04,
            "name": "100% Marvel lobezno. parche",
            "price": "€ 14.00",
            "url": "https://www.url.com/8847326694120/1420406.04.html",
            "image_url": "hhttps://www.url.com/dw/image/4d18313/images/large/1420406.04.jpg",
            "recommendationId": "RID-2a-4eac-9f74-9016e08e41fd-CID-2b8bc0"
        }
    ]
}

Aprende a utilizar la recomendación basada en el ranking de productos y sus casos de uso durante la navegación en el eCommerce.

4. Mostrar la recomendación de bestsellers.

Te compartimos los enlaces sobre cómo utilizar la recomendación basada en productos bestsellers:

  1. Uso de los parámetros por defecto del widget de recomendación basada en productos bestsellers.
  2. Uso de los parámetros específicos del widget de recomendación basada en productos bestsellers.

Esta es la url de la llamada API:

https://api.pleasepoint.com/api/onetoone/recommendation/getRecommendation

Estos son los parámetros de la llamada API:

{
    "account_id":"XXXXXXXXXX",
    "ssid":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "deploy_slug": "bestsellers-v4_deploy",
    "model_type": "best-sellers",
    "num_items": 3 ,
    "rule_slug": "home-bestsellers"
}

Recuerda que debes modificar los parámetros según tu cuenta de Pleasepoint, la configuración que desees del widget, la identificación del producto, del usuario y de la sesión de usuario.

Esta es la respuesta de la llamada API:

{
    "status": "ok",
    "data": [
        {
            "reference_id": 1333866.5,
            "name": "La Fundación",
            "price": "€ 10.95",
            "url": "https://www.url.com/9788467060003/1333866.50.html",
            "image_url": "https://www.url.com/dw/image/7a08d0c1/images/large/1333866.50.jpg",
            "recommendationId": "RID-8d-44e8-b8d0-448c73d82d3d-CID-3307e8"
        },
        {
            "reference_id": 1352985.2,
            "name": "El juego del alma",
            "price": "€ 18.90",
            "url": "https://www.url.com/9788491293545/1352985.20.html",
            "image_url": "https://www.url.com/dw/image/99db3c69/images/large/1352985.20.jpg",
            "recommendationId": "RID-ce-46bc-a7d1-30abaf20c6d7-CID-3307e8"
        },
        {
            "reference_id": 1290830.8,
            "name": "Nada",
            "price": "€ 10.95",
            "url": "https://www.url.com/9788423355693/1290830.80.html",
            "image_url": "https://www.url.com//dw/image/fd03d8dc/images/large/1290830.80.jpg",
            "recommendationId": "RID-8d-44e8-b8d0-448c73d82d3d-CID-3307e8"
        }
    ]
}

Aprende a utilizar la recomendación basada en productos bestsellers y sus casos de uso durante la navegación en el eCommerce.

5. Registrar eventos de interacción.

Este es el enlace para ver la descripción de los parámetros para el registro de eventos de interacción.

A continuación veremos cómo registrar los eventos de interacción utilizando la API.

Esta es la url de la llamada API:

https://api.pleasepoint.com/api/onetoone/recommendation/registerEvent

Estos son los parámetros de la llamada API:

{
    "account_id":"XXXXXXXXXX",
    "ssid":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "api_id": "08a79f6e-72c8-4211-8f6f-949543fc41af",
    "products": ["0904219.66"],
    "user_reference_id": "6000045528",
    "session_id": "IDS123456789",
    "event_type": "impression"
}

Recuerda que debes modificar los parámetros según tu cuenta de Pleasepoint, la configuración que desees del widget, la identificación del producto, del usuario y de la sesión de usuario.

Esta es la respuesta de la llamada API:

{
    "status": "ok",
    "data": true
}

Aprende a registrar en tiempo real los eventos de interacción durante la navegación en el eCommerce con la API de Pleasepoint.

¿Por qué debes personalizar one-to-one tu eCommerce con el SDK JS?

Descubre cómo la personalización one-to-one mejorará la tasa de conversión de tu eCommerce utilizando el SDK de Pleasepoint.

El SDK en JS de Pleasepoint es muy práctico cuando tienes la lógica en el lado del cliente. Para utilizar el SDK en JS debes tener acceso a la siguiente información:

  • Id de usuario o email e id de la sesión.
  • Ids de los productos que visualiza o interacciona el usuario.

El registro de eventos de Añadir al carrito es uno de los usos clásicos de este SDK.

Descarga nuestro eBook Introducción al marketing one-to-one y aprende a ejecutar una estrategia híper-personalizada basada en el ciclo de vida y las preferencias de cada uno de tus clientes. Nunca antes había sido tan fácil empezar a híper-pesonalizar e incrementar el rendimiento de tus acciones de marketing.

También te puede interesar...

Cinco casos de uso de IA aplicados en el eCommerce.

Exploramos 5 casos de uso de IA para enseñarte cómo la personalización one-to-one transforma la interacción.

11 de julio del 2024 Leer más
El modelo de datos de Pleasepoint.

Descripción del modelo de datos utilizado en la plataforma de Pleasepoint. Este artículo está pensado principalmente para la carga inicial de datos.

13 de junio del 2024 Leer más
Navegando hacia un crecimiento impulsado por la IA

Estamos construyendo un sólido ecosistema de Agencias y Consultoras especializadas en marketing, eCommerce y datos.

20 de marzo del 2024 Leer más

¡No te pierdas los próximos eventos de Pleasepoint!

Únete a nuestros eventos y descubre los mejores casos de uso de Inteligencia Artificial. Aprende de expertos, participa en demos en vivo y accede a casos de éxito que impulsarán tu negocio.

Partners de software (ISV) de Amazon Web Services.

Somos partners ISV (Independent Software Vendor) de Amazon Web Services (AWS) y hemos sido seleccionados para el programa de aceleración ISV-Accelerate.

Pleasepoint en AWS Marketplace

"Con Pleasepoint hemos pasado del modelo tradicional de gestión de campañas a un modelo de cliente más dinámico, segmentado y enriquecido, personalizando las campañas de CRM y mejorando la conversión de nuestros clientes del canal de comercio electrónico."

Josep Jarque
Digital Project Manager & IT Architect

"La implementación de la personalización one-to-one nos ha permitido generar contenido mucho más interesante para los usuarios, además de fomentar la fidelización, mejorar la experiencia de compra y generar ventas adicionales a través de recomendaciones personalizadas."

Jose Antonio Linde
COO de Condisline

Nuestros clientes nos avalan.