Català Castellano English

Idioma ca es en

Parlem-ne

Pleasepoint API: Personalitza one-to-one i en temps real la interacció a l'eCommerce (Part 4).

Pitu Sabadí Publicat el Documentació tècnica

Exemple de crida a l’API de recomanació: la URL, el tipus de petició i el cos amb els seus paràmetres, sobre fons blau.


En aquest post t'ensenyarem a utilitzar l'API de Pleasepoint per a la recomanació one-to-one de productes en qualsevol eCommerce, web o aplicació. D'aquesta manera podràs utilitzar les funcions de l'API en qualsevol entorn i moment d'interacció de l'usuari.

Aquests són els continguts del post:

  1. API: Millora l'experiència dels teus clients.
  2. Recomanació one-to-one de productes.
  3. Recomanació de productes basada en un altre producte (item-item).
  4. Recomanació basada en ranking de productes (ranking one-to-one).
  5. Recomanació basada en bestsellers.
  6. Registre d'esdeveniments d'interacció.
  7. Per què has de personalitzar one-to-one el teu eCommerce amb l'API de Pleasepoint?

Aquest post és el quart d'una sèrie de quatre posts sobre com fer servir el SDK de Pleasepoint. En aquest article tractarem l'ús del SDK en javascript. Et compartim els enllaços als altres tres posts:

Pleasepoint API: Híper-personalitza en temps real l'experiència d'usuari.

En aquest article ens endinsarem en el món de l'API de Pleasepoint, una eina versàtil que et permet recomanar productes i registrar esdeveniments d'interacció des de pràcticament qualsevol aplicació i llenguatge de programació. Per què voldries utilitzar l'API? Doncs bé, hi ha moments en què necessites un control total sobre com interactues amb un servei, i és aquí on entra en joc l'API. L'API de Pleasepoint et dona aquesta flexibilitat per adaptar la personalització de l'experiència del client a les teves necessitats específiques.

Recorda que al teu accés a Pleasepoint, a cadascun dels apartats hi trobaràs els exemples de crida API que has de fer:

Però què pots aconseguir amb aquesta API? La resposta és: molt. Pots accedir als models de recomanació altament efectius i, alhora, registrar tots els esdeveniments d'interacció dels teus usuaris. Això vol dir que pots adaptar l'experiència de compra en funció del comportament dels teus clients, cosa que pot portar a taxes de conversió més altes i a una satisfacció general del client.

L'API inclou l'accés als models one-to-one, item-item, ranking one-to-one i bestsellers. Cadascun d'aquests models té el seu propi conjunt d'avantatges i casos d'ús específics que poden millorar significativament l'experiència de compra dels teus clients. Som aquí per guiar-te en l'exploració de com treure el màxim partit d'aquests models a través de l'API de Pleasepoint.

1. Mostrar la recomanació one-to-one.

Et compartim els enllaços sobre com utilitzar la recomanació one-to-one:

  1. Ús dels paràmetres per defecte del widget de recomanació one-to-one de productes.
  2. Ús dels paràmetres específics del widget de recomanació one-to-one de productes.

Aquesta és la url de la crida API:

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

Aquests són els paràmetres de la crida 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"
}

Recorda que has de modificar els paràmetres segons el teu compte de Pleasepoint, la configuració que vulguis del widget, la identificació de l'usuari i la sessió.

Aquesta és la resposta de la crida 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"
        }
    ]
}

Aprèn a utilitzar la recomanació one-to-one de productes i els seus casos d'ús durant la navegació a l'eCommerce.

2. Mostrar la recomanació de productes basada en un altre producte (item-item).

Et compartim els enllaços sobre com utilitzar la recomanació de productes item-item:

  1. Ús dels paràmetres per defecte del widget de recomanació item-item de productes.
  2. Ús dels paràmetres específics del widget de recomanació item-item de productes.

Aquesta és la url de la crida API:

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

Aquests són els paràmetres de la crida 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"
}

Recorda que has de modificar els paràmetres segons el teu compte de Pleasepoint, la configuració que vulguis del widget, la identificació del producte, de l'usuari i de la sessió d'usuari.

Aquesta és la resposta de la crida 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"
        }
    ]
}

Aprèn a utilitzar la recomanació de productes basada en el model item-item i els seus casos d'ús durant la navegació a l'eCommerce.

3. Mostrar el ranking one-to-one.

Et compartim els enllaços sobre com utilitzar la recomanació basada en el ranking one-to-one de productes:

  1. Ús dels paràmetres per defecte del widget de recomanació basada en ranking one-to-one de productes.
  2. Ús dels paràmetres específics del widget de recomanació basada en ranking one-to-one de productes.

Aquesta és la url de la crida API:

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

Aquests són els paràmetres de la crida 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
}

Recorda que has de modificar els paràmetres segons el teu compte de Pleasepoint, la configuració que vulguis del widget, la identificació dels productes, de l'usuari i de la sessió d'usuari.

Aquesta és la resposta de la crida 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"
        }
    ]
}

Aprèn a utilitzar la recomanació basada en el ranking de productes i els seus casos d'ús durant la navegació a l'eCommerce.

4. Mostrar la recomanació de bestsellers.

Et compartim els enllaços sobre com utilitzar la recomanació basada en productes bestsellers:

  1. Ús dels paràmetres per defecte del widget de recomanació basada en productes bestsellers.
  2. Ús dels paràmetres específics del widget de recomanació basada en productes bestsellers.

Aquesta és la url de la crida API:

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

Aquests són els paràmetres de la crida API:

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

Recorda que has de modificar els paràmetres segons el teu compte de Pleasepoint, la configuració que vulguis del widget, la identificació del producte, de l'usuari i de la sessió d'usuari.

Aquesta és la resposta de la crida 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"
        }
    ]
}

Aprèn a utilitzar la recomanació basada en productes bestsellers i els seus casos d'ús durant la navegació a l'eCommerce.

5. Registrar esdeveniments d'interacció.

Aquest és l'enllaç per veure la descripció dels paràmetres per al registre d'esdeveniments d'interacció.

Tot seguit veurem com registrar els esdeveniments d'interacció utilitzant l'API.

Aquesta és la url de la crida API:

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

Aquests són els paràmetres de la crida 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"
}

Recorda que has de modificar els paràmetres segons el teu compte de Pleasepoint, la configuració que vulguis del widget, la identificació del producte, de l'usuari i de la sessió d'usuari.

Aquesta és la resposta de la crida API:

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

Aprèn a registrar en temps real els esdeveniments d'interacció durant la navegació a l'eCommerce amb l'API de Pleasepoint.

Per què has de personalitzar one-to-one el teu eCommerce amb el SDK JS?

Descobreix com la personalització one-to-one millorarà la taxa de conversió del teu eCommerce utilitzant el SDK de Pleasepoint.

El SDK en JS de Pleasepoint és molt pràctic quan tens la lògica al costat del client. Per utilitzar el SDK en JS has de tenir accés a la informació següent:

  • Id d'usuari o email electrònic i id de la sessió.
  • Ids dels productes que l'usuari visualitza o amb què interacciona.

El registre d'esdeveniments d'Afegir a la cistella és un dels usos clàssics d'aquest SDK.

Descarrega el nostre eBook Introducció al marketing one-to-one i aprèn a executar una estratègia híper-personalitzada basada en el cicle de vida i les preferències de cadascun dels teus clients. Mai no havia estat tan fàcil començar a híper-personalitzar i incrementar el rendiment de les teves accions de marketing.

Parlem del teu cas?

Explica'ns com treballa el teu equip avui. Et diem si hi ha alguna cosa que valgui la pena implantar, i si no n'hi ha, també.

Parlem-ne

Sense compromís Parles amb qui farà la feina Si no encaixa, t'ho diem