Come personalizzare i contenuti sul sito con l'API di appartenenza al gruppo di Klaviyo

Imparerai

Scopra come utilizzare il metodo getGroupMembership dell'oggetto JavaScript di klaviyo, che può essere utilizzato per implementare la personalizzazione in loco sul suo sito web. Questo richiede il caricamento dell'oggetto klaviyo e il passaggio di un array di liste o segmenti da controllare, che restituirà un output che potrà sfruttare per la personalizzazione sul posto.

Prima di iniziare

Quando aggiunge il tracciamento onsite di Klaviyo al suo sito, viene tracciata solo l'attività di navigazione di "browser conosciuti" (cioè browser che hanno visitato, si sono impegnati e sono stati identificati o "cookied"). Il tracciamento in loco di Klaviyo non traccia i browser anonimi. Ci sono 3 modi principali in cui Klaviyo identifica un visitatore del sito per il tracciamento in loco:

• Se qualcuno ha cliccato attraverso un'e-mail di Klaviyo sul suo sito web.
• Se qualcuno si è iscritto attraverso un modulo Klaviyo.
• Se qualcuno ha effettuato l'accesso al suo sito e lei ha installato il tracciamento.

Installi Klaviyo.js e carichi l'oggetto Klaviyo

Dovrà innanzitutto installare Klaviyo.js, se non l'ha già fatto. Klaviyo.js, noto anche come JavaScript "attivo sul sito" di Klaviyo, supporta automaticamente l'oggetto klaviyo. Se ha attivato un'integrazione con il suo account Klaviyo o ha installato manualmente Klaviyo.js, potrà avviare l'oggetto klaviyo per ascoltare le chiamate pertinenti.

Per utilizzare l'oggetto klaviyo immediatamente al caricamento della pagina, consigliamo di installare manualmente lo snippet qui sotto sul suo sito (oltre all'installazione di Klaviyo.js come indicato sopra). L'oggetto klaviyo deve essere caricato solo una volta per pagina.

Per caricare l'oggetto klaviyo:

Per utilizzare il metodo getGroupMembership dell'oggetto JavaScript klaviyo per la personalizzazione sul posto:

1. All'interno del suo codice, selezioni l'elenco o gli ID dei segmenti per i quali desidera verificare l'appartenenza. Il limite è di 50 elenchi o segmenti.
2. Identificare gli utenti sul suo sito tramite un modulo Klaviyo o altri mezzi.
3. Effettui una chiamata nel seguente formato, con un array degli ID dell'elenco o del segmento per cui desidera verificare l'appartenenza:

klaviyo.getGroupMembership(['listID1', 'listID2', 'listID3'])

L'output fornito sarà un array di ID di elenco/segmento a cui appartiene l'utente identificato, dato che tali ID erano presenti nell'array di input. Se viene restituito un array vuoto, significa che ha inserito troppi ID, oppure che l'utente non appartiene a nessuno degli elenchi o segmenti che ha fornito.

Può utilizzare i dati dei segmenti e delle liste di appartenenza restituiti per personalizzare il suo sito con prodotti, contenuti e altro ancora, basati sui segmenti dei clienti di Klaviyo.

Esempio di codice

Ecco un esempio che mostra come chiamare l'API getGroupMembership con più ID di segmento.

const customerSegments = await klaviyo.getGroupMembership([
  VIPSegmentID,
  UnEngagedSegmentID,
  DogLoversSegmentID,
]);

Impatto sulle prestazioni del sito

L'API di appartenenza al gruppo ha un impatto minimo sulle prestazioni del suo sito. Il file Javascript (cioè web_personalization.js) che Klaviyo carica sul suo sito è solo di circa 1,2 KB e la richiesta di bundle per questo file non blocca il thread principale, quindi non influisce sull'usabilità delle pagine.

I dati che vengono caricati per personalizzare un sito in base al profilo del cliente vengono memorizzati nella cache del browser dopo la prima richiesta, per cui le richieste aggiuntive non richiedono chiamate API al backend.

Risultato

Ora può utilizzare l'oggetto JavaScript klaviyo con gli strumenti di personalizzazione web e per personalizzare i contenuti sul sito web in base al segmento o all'appartenenza a una lista.

Risorse aggiuntive

Introduzione all'oggetto Klaviyo

Il modello di dati di Klaviyo

Glossario dei termini API comuni