API JavaScript
La seguente guida la guiderà nell'impostazione e nell'utilizzo dell'API JavaScript. Se sta pianificando un'integrazione completa con l'e-commerce, consulti questa guida.
Nota
Per utilizzare gli snippet di Klaviyo forniti di seguito, dovrà aggiornare il segnaposto API_KEY con la sua chiave API pubblica, che può trovare qui.
Aggiunta dello snippet di Klaviyo
Per iniziare a tracciare le persone, aggiunga il seguente snippet a destra nel modello principale del suo sito web, in modo che venga aggiunto automaticamente a tutte le pagine del suo sito. Se ha uno sviluppatore che aggiungerà questo script al suo sito web, può inviargli un link a questa guida.
È necessario apportare una modifica allo snippet. Se è un'azienda di e-commerce, rimuova le quattro righe con la chiamata "identify". Se si tratta di un sito web o di un'applicazione web a cui le persone accedono, sostituisca il segnaposto e-mail {{ email }} con la variabile del modello appropriata che contiene l'indirizzo e-mail dell'utente connesso.
Suggeriamo di inserire il codice Klaviyo nella parte inferiore del modello del suo sito. Se utilizza Google Analytics o altri servizi di terze parti, può inserire il codice Klaviyo direttamente sopra o sotto di esso.
Forse si starà chiedendo: "In che modo l'utilizzo di Klaviyo influisce sulle prestazioni del mio sito?" La risposta è che Klaviyo non influisce affatto sulle prestazioni del suo sito web. Il nostro codice viene caricato solo dopo che il resto del suo sito web ha terminato il caricamento. Inoltre, Klaviyo indica ai browser di memorizzare nella cache il nostro JavaScript, in modo che i suoi visitatori spesso non debbano nemmeno scaricare il nostro JavaScript ogni volta che cambiano pagina.
Controlli il suo copione
Una volta aggiunto il JavaScript al suo sito web, può verificare che sia impostato correttamente inserendo l'URL del suo sito web a destra.
Una volta che lo script è sul suo sito web, Klaviyo inizierà a tracciare le visite e le sessioni sul suo sito web in tempo reale.
Nozioni di base dell'API
Per effettuare chiamate all'API di Klaviyo e memorizzare le informazioni sulle persone, utilizzerà l'oggetto _learnq che viene aggiunto automaticamente dallo script di Klaviyo.
Per effettuare una chiamata API, Klaviyo utilizza una sintassi speciale che consente alle chiamate API di funzionare anche quando il nostro script non è ancora stato caricato sulla pagina. Creerà un array in cui il primo valore è il nome del metodo che desidera chiamare e tutti i valori successivi sono argomenti da passare a quel metodo.
Identificare le persone
Il metodo Identifica le consente di identificare e impostare le proprietà di un individuo. Questo metodo accetta un dizionario o un hash di proprietà. Quando identifica una persona, deve includere il suo indirizzo e-mail, con la chiave $email, o un identificatore unico come il suo ID utente, con la chiave $id.
Una volta incluso almeno uno di questi identificatori, è libero di aggiungere le proprietà personalizzate che desidera. Le proprietà personalizzate sono utili per tracciare i fatti relativi alle persone. In Klaviyo, può poi creare segmenti di persone in base a queste proprietà. Per esempio, potrebbe voler tracciare il tipo di piano di un individuo o la data di iscrizione. Klaviyo capirà anche i diversi tipi di dati utilizzati, quindi si senta libero di usare numeri, booleani e date.
Klaviyo ha alcune proprietà speciali che vengono utilizzate per visualizzare le informazioni sulle persone. Questi sono: $nome_nome, $cognome, $numero_di_telefono, $titolo e $organizzazione.
Oltre alle proprietà che lei traccia, Klaviyo determinerà automaticamente da quale sito web ogni persona è stata indirizzata per la prima volta per il monitoraggio dell'attribuzione e la posizione di una persona in base al luogo in cui accede al suo sito web.
Codice di esempio:
Tracciare gli eventi e le azioni
Il metodo track le consente di registrare gli eventi e le azioni che le persone compiono sul suo sito web. Questo metodo accetta una stringa che è il nome che lei dà a quell'evento. Questo metodo accetta anche un dizionario o un hash opzionale di proprietà associate a quell'evento.
Ad esempio, può tracciare quando qualcuno acquista un articolo e includere informazioni sul prezzo di acquisto e su quali articoli ha comprato. Se ha un'applicazione in cui le persone hanno dei profili, può tracciare quando qualcuno compila il suo profilo. Se sta pianificando un'integrazione completa con l'e-commerce, consulti questa guida.
Il monitoraggio degli eventi e le analisi di Klaviyo sono molto flessibili, quindi può personalizzarli per tenere traccia di ciò che è importante per la sua attività. Il nostro metodo di tracciamento comprende anche diversi tipi di dati, quindi può utilizzare numeri, booleani e date e noi creeremo grafici e diagrammi intelligenti basati sui dati che ci invia.
Codice di esempio: