Productaanbevelingen in JSON-formaat

Productaanbevelingen die worden geleverd als ruwe JSON in plaats van als weergegeven widget, zodat je ze zelf kunt opmaken. Gebruik het voor een zelf ontworpen widget, een single-page-app, een native app, of elke plek waar jij de presentatielaag beheert en alleen de keuzes wilt.

In het panel: Nieuwe campagne › App / API › JSON-API — Productaanbevelingen.

De stappen

Zes stappen: Catalogus, Interacties, Aanbeveling, Data in de respons, Code en Prestaties.

1. Catalogus

Je catalogus moet klaarstaan en actueel zijn — er kan niets worden aanbevolen wat Personyze niet kent. Elk item heeft minstens een interne ID, een titel en een URL nodig, plus een afbeelding als je lay-out die toont.

2. Interacties

De engine leert van wat mensen met items doen: bekeken, aan de winkelwagen toegevoegd, gekocht, gelezen, geliket. Op een gewone website kan Personyze veel hiervan vaak automatisch herkennen. Gebruik je JSON, dan geef je de resultaten meestal zelf weer — en dat betekent dat je ook de interacties zelf moet doorgeven, anders leert de engine nooit van wat je eigen lay-out toont.

Dit is de meest voorkomende reden dat een aanbeveling via JSON zwakke of algemene resultaten geeft: de uitvoer wordt weergegeven, maar er wordt niets teruggemeld.

3. Aanbeveling

Kies wat er moet worden aanbevolen, en in welke context — een homepage, een categoriepagina, een productpagina, een winkelwagen- of bedankpagina vragen elk om een ander algoritme.

Welk algoritme je ook kiest, je kunt het verfijnen met dezelfde set aanpassingen:

• Tijdvenster — vandaag, recent, de afgelopen 2 / 4 dagen, de afgelopen week, of altijd. Kortere vensters volgen trends; langere zijn stabieler.
• Categoriebereik — uit alle categorieën, alleen uit de laatst bekeken categorie, of uit de categorie van het huidige product.
• Interessebereik — uit de afgeleide interesses van de bezoeker, of uit de interesses die horen bij het laatste product dat die bekeek.
• Volgorde en actualiteit — nieuwste eerst, oudste eerst, goedkoopste, of recent aan de catalogus toegevoegd.
• Samen voorkomen — samen gekocht, of samen bekeken binnen de huidige categorie.

Filters maken de pool nog kleiner: alleen op voorraad, een prijsklasse, een bepaald merk of een bepaalde categorie, of elk eigen catalogusveld.

Voor een uitgebreidere behandeling van de algoritmes zelf, zie Typen aanbevelingsalgoritmes.

4. Data in de respons

Personyze genereert een JSON-array met objecten, waarbij elk object de velden bevat die je hier kiest. Je kiest de vorm van je eigen API-antwoord, dus kies precies wat je renderer nodig heeft en niets meer.

Een typische selectie voor een productwidget:

[
  {
    "internal_id": "nw-p001",
    "title": "Alpine Shell",
    "price": 249,
    "image_1": "https://example.test/img/alpine-shell.jpg",
    "url": "https://example.test/shop/alpine-shell"
  },
  ...
]

Elk eigen catalogusveld kan worden opgenomen, dus toont je lay-out een badge, een beoordeling of een voorraadmelding, wijs dat veld dan hier toe in plaats van het apart op te zoeken.

5. Code

De wizard geeft je het snippet om in te sluiten. Er zijn twee manieren om het resultaat te gebruiken:

• Op een pagina — het snippet wijst de JSON toe aan een JavaScript-variabele die je zelf een naam geeft, en je eigen script geeft die weer. Dit is de gebruikelijke keuze voor een eigen widget of een SPA.
• Aan de serverkant of vanuit een app — roep /rest/tracker-v1 aan en lees de passende actie uit het antwoord. De JSON komt binnen in het veld data van de actie. Dit is de route die native apps en platforms buiten het web gebruiken; die is van begin tot eind beschreven, met een uitgewerkt voorbeeld, in Een eigen aanbevelingsapp bouwen.

6. Prestaties

Resultaten zodra het live is. Let op: dit weerspiegelt alleen wat Personyze kan zien — geef je de JSON zelf weer en meld je geen interacties, dan geven de prestatiecijfers minder weer dan wat de aanbeveling echt deed.

Let op: er is geen QA-stap

Anders dan campagnes op de site hebben JSON-API-campagnes geen QA-stap — er is geen weergegeven content die het panel kan tonen. Controleer door de JSON zelf op te vragen en te bekijken: controleer of je het verwachte aantal items krijgt, of de velden die je hebt gekozen aanwezig zijn, en of de waarden gevuld zijn in plaats van leeg.

Gerelateerd

• JSON-API — Contentaanbevelingen
• Een eigen aanbevelingsapp bouwen — de volledige API-route, met een uitgewerkt voorbeeld.
• Het object products en productinteracties in de REST API.