Ga naar hoofdinhoud

Productdata verrijken met Google Books en de AI Agent

Een mager, half leeg productoverzicht is een van de snelste manieren om een verkoop mis te lopen. De tool Enrich product data van StoreLinkr geeft elk product in je PIM met één klik een route naar een vollediger en beter geschreven vermelding — door bibliografische data op te halen voor boeken en, waar geconfigureerd, alles door te geven aan je AI Agent om er een geoptimaliseerde titel, beschrijving en set attributen van te maken.

Deze tutorial laat precies zien wat er gebeurt als je op die knop klikt, aan de hand van twee scenario's: een standaardproduct en een boek.

Hoe het werkt, in het kort​

  1. Open een willekeurig product in de PIM Editor en klik op Enrich product data (het ster-icoon, rechtsboven).
  2. StoreLinkr controleert de EAN van het product. Als deze eruitziet als een ISBN (een 13-cijferige code die begint met 978 of 979), wordt automatisch de Google Books API geraadpleegd voor die titel.
  3. Als je AI Agent is ingeschakeld, geeft StoreLinkr alles wat het heeft verzameld — je bestaande productdata, plus eventuele boekgegevens die net zijn gevonden — door aan je geconfigureerde AI-engine, met het verzoek om een geoptimaliseerde naam, korte en lange beschrijving en een volledige attributenlijst te schrijven.
  4. Je krijgt een preview van de verrijkte productdata te zien: een tabel naast elkaar met elk veld, de oude waarde naast de nieuwe, met wijzigingen gemarkeerd zodat je precies ziet wat er zou gebeuren.
  5. Er wordt niets opgeslagen totdat je op Accept and apply klikt. Klik in plaats daarvan op Close en het product blijft ongewijzigd.

Dezelfde knop en hetzelfde controlescherm behandelen beide scenario's hieronder — StoreLinkr bepaalt automatisch welke databronnen van toepassing zijn, op basis van de EAN van het product.

Voordat je begint

Voor verrijking is een product met een ingevulde EAN nodig — zonder EAN heeft StoreLinkr niets om op te zoeken en toont het "No EAN found to enrich." Gebruik het Data Quality-dashboard om producten te vinden waar deze ontbreekt.

Het controlescherm lezen​

In welk scenario je ook zit, de controletabel werkt op dezelfde manier:

KolomWat het toont
FieldNaam, korte beschrijving, lange beschrijving, EAN
Current ValueWat er op dit moment op het product staat
New ValueWat de verrijking heeft gevonden — groen gemarkeerd als dit afwijkt van de huidige waarde

Onder de hoofdtabel toont een geneste tabel Attributes elk technisch attribuut (facet) naast elkaar:

  • Groen — een nieuw attribuut, of een bestaand attribuut waarvan de waarde is veranderd.
  • Geel, "Will be removed" — een attribuut dat vandaag op het product staat, maar geen deel uitmaakte van de nieuwe data.
  • Ongewijzigde attributen worden ook getoond, grijs weergegeven, zodat je het volledige beeld ziet.

Als de verrijking nieuwe afbeeldingen heeft gevonden (bijvoorbeeld een boekomslag), verschijnen deze onderaan ter vergelijking met de huidige afbeelding van het product.

Je EAN zelf wordt nooit overschreven door verrijking — deze wordt alleen gebruikt als opzoeksleutel.

Scenario 1: Een standaardproduct verrijken​

Het grootste deel van je catalogus heeft geen ISBN, dus is er geen externe bibliografische database om verse feiten uit te halen. Voor deze producten is de AI Agent niet optioneel — het is de volledige waarde van de verrijkingsstap. Zonder AI Agent doet het klikken op Enrich product data bij een standaardproduct grotendeels niets anders dan teruggeven wat er al staat.

De situatie: stel je een product voor dat is geïmporteerd uit een leveranciersfeed, met een generieke naam, een beschrijving van één regel en slechts een paar technische specificaties — het soort vermelding dat het Data Quality-dashboard zou markeren als "short description".

  1. Configureer eerst de AI Agent. Ga naar Settings > AI en:

    • Zet AI Agent Enabled op ON.
    • Kies een engine (Gemini, OpenAI of Claude) en vul je API-key in.
    • Vul je Tone of Voice, Preferred Language, Target Audience en Keywords in — dit is de context die de AI gebruikt om in de stem van jouw merk te schrijven, in plaats van een generieke stem.

    Zie Hoe configureer ik AI-instellingen voor de volledige uitleg van deze pagina.

  2. Open het product in de PIM Editor en klik op Enrich product data.

  3. StoreLinkr stelt een prompt samen op basis van alles wat het weet over het product — huidige naam, beschrijvingen, merk en bestaande attributen — en stuurt die naar je geconfigureerde AI-engine, met het verzoek om een SEO-geoptimaliseerde naam, beschrijvingen en een volledige attributenlijst.

  4. Bekijk de preview. Voor een magere vermelding kun je verwachten:

    • Name herschreven naar iets beschrijvenders en beter vindbaar in zoekmachines.
    • Short en Long Description ingevuld met overtuigende, merkgetrouwe tekst — groen gemarkeerd omdat ze voorheen leeg of minimaal waren.
    • Nieuwe rijen in de tabel Attributes voor specificaties die de AI uit de context kon afleiden, naast je bestaande attributen die ongewijzigd zijn overgenomen.

  5. Klik op Accept and apply om de nieuwe data op het product op te slaan, of op Close om deze te negeren en het product precies te laten zoals het was.

Scenario 2: Een boek verrijken​

Boeken zijn het enige producttype dat StoreLinkr kan verrijken met harde bibliografische feiten voordat de AI er überhaupt aan te pas komt. Als de EAN van een product een geldige ISBN-13 is (begint met 978 of 979), wordt het automatisch opgezocht bij verrijking.

De situatie: een fysiek boek dat is geïmporteerd met alleen een titel en een EAN, bijvoorbeeld 9781234567897.

  1. Open het product en klik op Enrich product data — er is geen aparte "boekmodus" om aan te zetten; StoreLinkr herkent het ISBN-voorvoegsel zelf.

  2. Achter de schermen raadpleegt StoreLinkr de Google Books API met die ISBN. Google Books zelf verzamelt data die wereldwijd door uitgevers, bibliotheken en boekverkopers wordt aangeleverd, dus één opzoeking levert doorgaans op:

    • Titel en beschrijving
    • Auteur, uitgever, publicatiedatum en aantal pagina's (toegevoegd als nieuwe attributen)
    • Omslagafbeelding

  3. Als je AI Agent ook is geconfigureerd, stopt StoreLinkr daar niet — het voert deze net verzamelde boekgegevens, samen met je bestaande productgegevens, in je AI-engine in en vraagt deze om een SEO-geoptimaliseerde titel en beschrijving te schrijven in jouw geconfigureerde tone of voice en taal, terwijl de feitelijke attributen (auteur, uitgever, aantal pagina's) intact blijven.

    Als de AI Agent niet is geconfigureerd, krijg je nog steeds de ruwe Google Books-data samengevoegd op het product — alleen zonder de herschreven, SEO-geoptimaliseerde tekst.

  4. Bekijk de preview. Voor een boek kun je verwachten:

    • Name gematcht (en, als AI is ingeschakeld, gepolijst) met de titel die Google Books teruggaf.
    • Long Description gevuld met de synopsis van het boek — herschreven door de AI indien geconfigureerd.
    • Nieuwe attributenrijen voor Author, Publisher, Publish date en Page count.
    • Een omslagafbeelding in de rij Images, klaar om te vergelijken met de afbeelding (indien aanwezig) die het product nu heeft.

  5. Klik op Accept and apply om op te slaan, of op Close om weg te lopen zonder iets te wijzigen.

Goed om te weten​

  • Verrijking toont altijd eerst de preview — het product wordt nooit stilzwijgend overschreven. Bij het accepteren worden alle wijzigingen in de tabel in één keer toegepast; er is geen accepteren/afwijzen per veld, dus controleer de tabel goed voordat je bevestigt.
  • Dezelfde onderliggende actie is beschikbaar via de API (POST /api/portal/products/enrich-product/{uuid}) als je verrijking wilt laten meelopen in een grotere geautomatiseerde importworkflow — zie API Authentication om te beginnen.
  • Voer verrijking uit vanuit de gefilterde productlijsten van het Data Quality-dashboard om eerst de zwakste vermeldingen in je catalogus aan te pakken, in plaats van willekeurige producten te verrijken.