Come effettuare l'integrazione con Segment

Cosa imparerai

Scopri come integrare Segment con Klaviyo per poter attivare e filtrare i flussi e definire i segmenti utilizzando gli eventi sincronizzati con Klaviyo dal tuo progetto Segment. Usa la destinazione Klaviyo (Actions) per inviare track eventi e identify aggiornamenti dei profili da Segment a Klaviyo.

Questa guida spiega come inviare i dati di Segment a Klaviyo e, facoltativamente, come inviare a Segment l'attività di Klaviyo Email. Per la configurazione della destinazione, usa la guida completa di Segment per l'integrazione con Klaviyo.

Prima di iniziare

Connetti Segment e Klaviyo

Aggiungi Klaviyo (Azioni) come destinazione in Segment

Segui la guida alla configurazione di Klaviyo (Actions) di Segment per aggiungere la destinazione e collegare la sorgente Segment di cui vuoi inviare i dati a Klaviyo.

Configura la destinazione e le relative mappature delle azioni utilizzando la guida di Segment e i dettagli di Klaviyo riportati di seguito.

• Una chiave API privata di Klaviyo con accesso completo ad Account, Campagne, Eventi, Liste, Profili, Segmenti e Iscrizioni. Scopri come creare una chiave API privata e come gestire le tue chiavi API in Klaviyo.
• Se vuoi aggiungere profili a una lista, usa l’ID della lista nella mappatura dell’azione pertinente. Scopri come trovare l’ID del tuo elenco in Klaviyo.

Tratta le chiavi API private come password: conservale in un luogo sicuro e non rivelarle mai al pubblico.

Usa Upsert Profile per le chiamate identify che creano o aggiornano le informazioni del profilo e Track Event per le chiamate track che registrano l'attività del cliente. Segui la guida di Segment per configurare e abilitare le mappature di cui hai bisogno.

Abilita la destinazione in Segment per iniziare a inviare dati che corrispondono alle mappature abilitate.

Invia l'attività delle e-mail Klaviyo a Segment (facoltativo)

La sincronizzazione di ritorno invia a Segment gli eventi di consegna dell’e-mail, apertura, clic sui link, bounce, segnalazione spam e annullamento dell’iscrizione.

Ottieni una write key per la source di Segment che dovrebbe ricevere la tua attività e-mail di Klaviyo Email. Puoi configurare una sorgente Klaviyo oppure trovare la chiave di scrittura per una sorgente stream di eventi esistente.

Copia la tua chiave di scrittura. La tua chiave di scrittura è un'altra Chiave API privata. Trattala come una password: conservala in un luogo sicuro e non esporla mai al pubblico.

Abilita l'integrazione in Klaviyo

1. In Klaviyo, seleziona la scheda Integrazioni.
2. Seleziona Esplora le app, cerca Segment e poi clicca sulla scheda. Dopodiché, clicca su Installa.
3. Incolla nella casella la chiave di scrittura che hai copiato in precedenza e scegli l'area del tuo segmento, quindi clicca su Connetti a segmento.
   • Scegli Stati Uniti se l’URL di Segment è: https://app.segment.com/.
   • Scegli Unione europea se l’URL del tuo segmento è: https://eu1.app.segment.com/.
     

4. Nella pagina successiva, puoi limitare l’attività e-mail inviata di nuovo a Segment selezionando la casella accanto a Non sincronizzare i profili che non sono aggiornati dalla destinazione Klaviyo.

• Questa impostazione controlla la sincronizzazione dei resi. Non unisce né rimuove i profili in Klaviyo. Se lo lasci deselezionato, i profili senza identificatori Segment archiviati inviano l'attività e-mail utilizzando il loro indirizzo e-mail come ID anonimo in Segment.
• Seleziona la casella di controllo per inviare l'attività e-mail solo per i profili con un ID utente del segmento o un ID anonimo salvato. L'idoneità dipende da questi identificatori, non da dove è stato creato per la prima volta il profilo.

5. Una volta terminato, fai clic su Completa la configurazione.

Dopo aver inviato un’e-mail da Klaviyo, controlla l’origine di ricezione in Segment per l’attività e-mail. Consulta la guida della fonte Klaviyo di Segment per gli eventi previsti.

Metriche del segmento

Ti consigliamo di sincronizzare con Klaviyo gli eventi più importanti, come:

• Quando un cliente si iscrive
• Quando un cliente inizia la procedura di pagamento o manifesta interesse per il pagamento
• Cosa acquista un cliente (comprese le immagini degli articoli e le descrizioni degli articoli)

Fornisci gli identificatori del profilo richiesti dalla mappatura Klaviyo (Azioni), ad esempio un indirizzo e-mail o un ID esterno. Per informazioni dettagliate sugli identificatori e sulla formattazione degli eventi, vedi la guida all'integrazione Klaviyo di Segment.

Per le aziende web transazionali e le piattaforme e-commerce, ti consigliamo di seguire la nostra guida all’integrazione di un carrello e-commerce o di una piattaforma personalizzati per informazioni dettagliate sugli eventi da inviare a Klaviyo tramite Segment.

Monitoraggio della sincronizzazione di Klaviyo

Dopo aver abilitato la destinazione Klaviyo (Actions) e le relative mappature in Segment, le chiamate identify e track inizieranno a inviare dati a Klaviyo entro 5-10 minuti. Per verificare la sincronizzazione degli eventi, invia un evento track di test, quindi vai su Analytics > metrica in Klaviyo per trovare la metrica corrispondente.

Per Traccia evento, la mappatura Nome metrica determina il nome della metrica in Klaviyo. Klaviyo tratta le metriche Segment come metriche API di terze parti, quindi ogni metrica avrà un’icona a forma di ingranaggio accanto al suo nome in Klaviyo. Per visualizzare i dati in arrivo, apri la metrica e seleziona feed attività.

Per verificare una chiamata identify inviata tramite Upsert Profile, controlla il profilo Klaviyo corrispondente per le informazioni aggiornate. Gli aggiornamenti del profilo non creano una metrica né un evento nel feed attività della metrica.

Risultato

Ora hai integrato Segment con Klaviyo e puoi iniziare a utilizzare i dati di Segment per attivare e filtrare i flussi, e definire i segmenti utilizzando gli eventi sincronizzati con Klaviyo dal tuo progetto Segment.

Risorse aggiuntive