Wanneer ‘developer-first’-zoeken een knelpunt wordt

Jullie ontwikkelaars kozen voor de zoek-API omdat die snel, flexibel en uitstekend gedocumenteerd was. De integratie verliep vlekkeloos. De zoekfunctie werkte. Iedereen was tevreden.
Dat was een jaar geleden. Vandaag wil je merchandisingteam een seizoenscollectie hoger in de zoekresultaten laten verschijnen. Het proces: Een ticket aanmaken, wachten tot een ontwikkelaar de configuratie aanpast, naar de staging-omgeving implementeren, controleren en vervolgens naar de productieomgeving implementeren. Wat vijf minuten zou moeten duren, duurt vijf dagen.
Dit is geen tekortkoming van de tool. Het is een logisch gevolg van de keuze voor een zoekinfrastructuur in plaats van een zoekproduct. En het gebeurt bij ecommercebedrijven van elke omvang.
De ‘API-witte-broodweek’
Zoektools die speciaal voor ontwikkelaars zijn gemaakt, zijn echt indrukwekkend. Reactietijden van minder dan een milliseconde. Elegante API’s. Uitgebreide documentatie. Flexibele datamodellen waarmee je engineeringteam precies kan bouwen wat ze willen.
Voor ontwikkelteams die zoekoplossingen aan het evalueren zijn, is dit heel aantrekkelijk. Je krijgt bouwstenen, geen meningen. Je krijgt infrastructuur, geen beperkingen. Het gaat om vrijheid, en de eerste paar maanden maakt die vrijheid zijn belofte waar.
Je ontwikkelaars bouwen een zoekinterface. Ze koppelen facetten en filters aan elkaar. Ze stellen rangschikkingsregels in. De zoekervaring werkt goed, want je ontwikkelaars zijn goed in wat ze doen.
De problemen beginnen pas later.
Als ‘gewoon een ticket indienen’ de standaardprocedure wordt
Zoeken is geen eenmalige implementatie. Het is een doorlopend proces. Producten veranderen. Seizoenen wisselen. Er worden campagnes gelanceerd. De voorraad schommelt. De zoekervaring moet zich voortdurend aanpassen, en wel dagelijks in plaats van per kwartaal.
In een ‘developer-first’-opzet is bij elke aanpassing de inbreng van de technici nodig. Zo ziet dat er in de praktijk uit:
Regels voor merchandising. Je categoriemanager wil een nieuwe merkpartner hoger in de zoekresultaten laten verschijnen. Dat lukt niet. De logica achter die boost zit in de code en wordt via je CI-pijplijn geïmplementeerd. Ze maken een ticket aan.
Seizoensaanpassingen. Black Friday komt eraan en je ecommercemanager wil producten met een hoge winstmarge voorrang geven in de zoekresultaten. De configuratie voor de rangschikking staat in een JSON-bestand in je repository. Ze maken een ticket aan.
Synoniemen en doorverwijzingen. Klanten zoeken naar ‘hardloopschoenen’, maar in je catalogus heten ze ‘sneakers’. Als je een synoniem toevoegt, moet de code worden aangepast. Ze maken een ticket aan.
A/B-testen. Je team wil testen of het weergeven van meer resultaten per pagina de conversie verbetert. De zoekconfiguratie heeft hiervoor geen gebruikersinterface. Ze maken een ticket aan.
Elk afzonderlijk probleem is klein. Maar het cumulatieve effect is dat het merchandisingteam de operationele controle heeft verloren over een van de belangrijkste delen van je site. Ze hebben ideeën en gegevens, maar kunnen daar niets mee doen zonder dat de ontwikkelaars erbij betrokken worden.
De ontwikkelaars besteden ondertussen hun sprintcapaciteit aan het aanpassen van de zoekinstellingen in plaats van aan het bouwen van nieuwe functies.
De verborgen kosten van het opzetten van je eigen productlaag
De zoekinfrastructuur biedt je een API. Een ecommerce-winkel heeft een product nodig, en de kloof tussen die twee dingen is groter dan het lijkt.
Dit is wat je meestal uiteindelijk bovenop een zoek-API bouwt:
Een merchandising-dashboard. Je team heeft een manier nodig om regels, boosts en pins in te stellen zonder te hoeven programmeren. Dus bouw je een interne tool. Die begint simpel, maar wordt gaandeweg steeds complexer.
Aanbevelingslogica. De zoek-API regelt het zoeken. Productaanbevelingen (op productpagina’s, in het winkelmandje, op categoriepagina’s) zijn een apart verhaal. Je kunt er zelf een bouwen of een oplossing van een andere leverancier eraan koppelen.
Merchandising van categoriepagina’s. Je categoriepagina’s hebben een slimme volgorde van producten nodig. De zoek-API kan hiervoor zorgen, maar de configuratie en de regels moet je weer zelf regelen.
E-mailpersonalisatie. Voor gepersonaliseerde productblokken in je e-mails heb je een aanbevelingsengine, productgegevens en gedragssignalen nodig. Je zoek-API kan dit niet. Weer een andere leverancier, weer een nieuwe integratie.
Analyses en rapportages. Om te begrijpen waar mensen naar zoeken, wat ze vinden en waar ze afhaken, moet je een zoekanalyse-laag opzetten of aanschaffen.
Dit zijn allemaal afzonderlijke projecten. Elk project vergt tijd van de technici, onderhoud en voortdurende ontwikkeling. En elk project werkt op zichzelf: Je zoekgegevens worden niet meegenomen in je aanbevelingen, de personalisatie van je e-mails leert niets van je zoekgedrag, en je categoriepagina’s werken volgens een andere logica dan je productpagina’s.
Je hebt voor een zoek-API gekozen om te voorkomen dat je aan een bepaald product vastzit. In plaats daarvan heb je zelf een product ontwikkeld, zonder speciaal team, zonder roadmap en zonder productoverschrijdende inzichten.
Wat hoort er niet bij een zoekinfrastructuur?
De echte kosten zitten niet in de zoek-API zelf. Het gaat om alles eromheen wat een ecommerce-winkel nodig heeft, maar wat een zoek-API niet biedt.
Retailmedia. Merken willen hun producten promoten binnen je zoek- en aanbevelingsresultaten. Dit is een inkomstenbron die een diepgaande integratie met je personalisatielaag vereist. Een zoek-API kent geen gesponsorde resultaten.
E-mailpersonalisatie. Automatisch verstuurde e-mails met gepersonaliseerde productaanbevelingen (prijsdalingen, aanvullen van voorraad, achtergelaten winkelwagentjes) vereisen gedragsgegevens, productinformatie en een e-mailintegratie. Je zoek-API weet wel waar mensen naar hebben gezocht, maar niet wat je ze moet mailen.
Audiencesegmentatie. Om bezoekers op basis van hun gedrag in groepen in te delen en verschillende segmenten een verschillende ervaring te bieden, heb je een uniforme gegevenslaag nodig. Je zoek-API registreert wel zoekgedrag, maar niet het surfgedrag, de interactie via e-mail of aankooppatronen.
Leren via verschillende contactpunten. Als zoekresultaten, aanbevelingen en categoriepagina’s allemaal op dezelfde voorkeuren van de klant zijn afgestemd, zorgt een product dat een klant op de ene plek bekijkt of koopt ervoor dat de andere pagina’s ook beter worden afgestemd. Een zoek-API weet per definitie alleen iets van zoeken.
De vraag over de teamstructuur
Dit is de belangrijkste vraag: Wil je een zoek-API waarvoor je een heel team nodig hebt, of een platform dat je bestaande team meer mogelijkheden biedt?
Een zoektool die in de eerste plaats op ontwikkelaars is gericht, gaat ervan uit dat je over ontwikkelaars beschikt die zich permanent met de zoekfunctie bezighouden, ook na de eerste implementatie. Configuratiewijzigingen, updates van de rangschikking, nieuwe functies, bugfixes en het onderhoud van de integratie: Het kost allemaal tijd van de ontwikkelaars.
Een personalisatieplatform dat speciaal voor merchandisers is ontwikkeld, gaat juist uit van het tegenovergestelde: Dat je ecommerce-team zelf de controle moet hebben over zoekfuncties, aanbevelingen en personalisatie, waarbij ontwikkelaars wel beschikbaar zijn voor uitgebreide aanpassingen, maar niet nodig zijn voor de dagelijkse gang van zaken.
Beide manieren werken. De vraag is welke het beste past bij je teamsamenstelling, je budget en je ambities.
Als je een speciaal team voor zoektechnologie hebt en helemaal vanaf nul een zoekervaring op maat wilt bouwen, biedt een ‘API-first’-tool je maximale controle.
Als je een merchandisingteam hebt dat snel wil werken, dan zorgt een platform met een dashboard voor zakelijke gebruikers en volledige API-toegang voor ontwikkelaars ervoor dat de bottleneck wordt weggenomen, zonder dat dit ten koste gaat van de technische flexibiliteit.
Waar je op moet letten bij een compleet platform
Als je aan het afwegen bent of je bij je zoekinfrastructuur blijft of overstapt naar een platform, dan zijn dit de belangrijke punten:
Gecentraliseerde intelligentie. Eén gegevenslaag die zoekfuncties, aanbevelingen, e-mail en retailmedia aanstuurt. Geen vier aparte tools met vier aparte gegevensmodellen.
Beheer van merchandisers. Bedrijfsregels, ‘boost’ en ‘bury’, synoniemen en omleidingen: Allemaal in te stellen via een dashboard, zonder dat er een ontwikkelaar aan te pas komt.
Toegang voor ontwikkelaars blijft behouden. Volledige toegang tot de API en SDK voor eigen implementaties. Overstappen naar een ander platform hoeft niet te betekenen dat je technische flexibiliteit verliest.
Geen trage opstart. Product Intelligence die je catalogus vanaf dag één begrijpt, zonder dat er maanden aan gedragsgegevens nodig zijn voordat de aanbevelingen relevant worden.
Kant-en-klare integraties. Shopify, Magento, WooCommerce, Shopware, Prestashop, Norce, BigCommerce: Ingebouwde koppelingen, geen maatwerkoplossingen.
Voorspelbare prijzen. Gebaseerd op de omvang van je catalogus en je bezoekersaantallen, niet op een afrekening per zoekopdracht die onvoorspelbare pieken kan veroorzaken.
Waar het op neerkomt
Zoek-API’s die vooral op ontwikkelaars zijn gericht, zijn geweldige tools. Ze lossen het zoekprobleem prima op. Maar personalisatie in de ecommerce gaat verder dan alleen zoeken, en de kloof tussen ‘zoekinfrastructuur’ en een ‘compleet personalisatieplatform’ wordt opgevuld met aangepaste code, externe leveranciers en verzoeken van merchandisers.
Als je zoek-API goed werkt en je team de technische capaciteit heeft om ‘m te onderhouden, is er geen reden om overhaast over te stappen. Maar als je merchandisers voor elke regelwijziging een ticket indienen, je aanbevelingslogica in aangepaste code zit en je e-mailpersonalisatie op een aparte stack draait, is het misschien tijd om je af te vragen of de flexibiliteit van een API de operationele kosten wel waard is.
Ben je benieuwd hoe de platforms zich naast elkaar verhouden? Bekijk dan onze eerlijke vergelijking tussen Hello Retail en API-first search.


