SDK server

L’SDK server è il modo in cui un backend partecipa a un test server-side. Scarica la configurazione dei test del sito e la mantiene aggiornata in background, così chiedere quale variante riceve un visitatore è una chiamata di funzione locale anziché una richiesta a Pertento. Il vostro server mostra la variante giusta fin dalla prima volta, e se Pertento non è raggiungibile ripiega sulla vostra esperienza predefinita invece di dare un errore.

È disponibile per TypeScript e JavaScript come pacchetto npm open source senza dipendenze. Gira su Node, Bun e Deno, e su worker al bordo come Cloudflare Workers, Vercel Edge e Deno Deploy, usando soltanto fetch e Web Crypto. I backend scritti in altri linguaggi ottengono le stesse decisioni e conversioni tramite un’API HTTP autenticata.

La decisione arriva alla pagina come un piccolo blocco di dati nel head, che l’SDK scrive per voi. Lo script Pertento lo legge, iscrive il visitatore esattamente nelle varianti scelte dal vostro server e lo conta, così il browser e il backend concordano su chi sia il visitatore. Pertento non imposta cookie: il vostro server conserva l’identificativo del visitatore, oppure decide in base al vostro identificativo cliente.

L’accesso avviene tramite chiavi server, create per ogni sito da un proprietario o da un amministratore e mostrate una sola volta. Un sito può averne più d’una contemporaneamente, così una chiave può essere ruotata senza interruzioni, e la creazione o la revoca di una chiave invia una notifica all’account. Quando il sito riferisce le conversioni dal server, l’SDK riferisce anche gli acquisti e le altre conversioni, attribuiti solo ai test che la persona ha effettivamente visto.