Primi passi con Stripe
Cosa imparerai
Scopri come integrare Stripe con Klaviyo per personalizzare e targetizzare le e-mail in base ai dati delle fatture e dei pagamenti dei tuoi clienti.
Configurerai l’integrazione Stripe in 2 passaggi. Per prima cosa, collegherai Stripe abilitando l’integrazione in Klaviyo. Poi configurerai i webhook in Stripe, che abiliteranno una sincronizzazione in tempo reale di dati Stripe specifici in Klaviyo.
Ecco una panoramica dei dati che sincronizziamo da Stripe:
- Quando viene emessa una fattura e gli articoli inclusi in ogni fattura
- Informazioni di pagamento quando un utente non riesce a pagare, riceve un rimborso o paga correttamente
Abilita l'integrazione Stripe in Klaviyo
- In Klaviyo, seleziona la scheda Integrazioni.
- Seleziona Scopri le app, cerca Stripe, quindi clicca sulla scheda.
- Dopodiché, clicca su Installa.
- Clicca su Connetti a Stripe. Così accederai al sito di Stripe: accedi se necessario.
- Seleziona l'account Stripe che desideri connettere a Klaviyo e fai clic su Connetti.
- Tornando in Klaviyo, puoi scegliere di verificare i webhook di Stripe inserendo il tuo signing secret (scelta consigliata). Puoi trovarlo in Stripe in Sviluppatori > Webhook e aggiungerà un ulteriore livello di sicurezza alla tua integrazione.
- Copia l'URL del webhook da questa pagina. Questo verrà incollato nel tuo account Stripe nella prossima sezione.
- Clicca su Completa la configurazione.
Configura i webhook Stripe
Ora configureremo i webhook di Stripe, che ti consentiranno di sincronizzare i dati di Stripe in tempo reale.
- Apri Stripe in una nuova scheda e vai alla scheda Developers.
- Seleziona Webhook e fai clic su Aggiungi endpoint.
- Compila i seguenti campi:
- URL dell'endpoint
Incolla l'URL che hai appena copiato da Klaviyo. - Versione
Seleziona l'ultima versione dell'API. - Eventi da inviare
Klaviyo richiede punti dati relativi ad addebiti e fatture. Nel menu a discesa Events to send, seleziona tutti gli eventi charge e invoice. Facoltativamente, puoi omettere tutti gli eventi charge.dispute. Crea endpoint per tutti i seguenti eventi:- addebito acquisito
- charge.expired
- charge.failed
- charge.pending
- charge.refunded
- charge.succeeded
- charge.updated
- invoice.created
- invoice.deleted
- invoice.finalized
- invoice.marked_uncollectible
- invoice.payment_action_required
- invoice.payment_failed
- invoice.payment_succeeded
- invoice.sent
- invoice.upcoming
- invoice.updated
- invoice.voided
- URL dell'endpoint
- Dopo aver selezionato tutti gli eventi charge e invoice, seleziona Add endpoint.
- Riceverai la conferma che i tuoi webhook sono abilitati.
- La tua integrazione Stripe ora è attiva.
Visualizza i dati sincronizzati da Stripe
Per controllare la tua integrazione attivata:
- Clicca sul menu a tendina Analisi in Klaviyo e seleziona Metrica.
- Trova la metrica Successfully Paid di Stripe e fai clic sull'icona Feed attività.
- Se la tua integrazione ha iniziato a sincronizzare i dati, qui vedrai comparire le fatture emesse tramite Stripe. Quando l'integrazione è completamente sincronizzata, l'integrazione Stripe mostrerà un bordo verde accanto ad essa nel tuo account Klaviyo. Klaviyo importa tutti i tuoi dati Stripe. Per verificarlo, puoi confrontare il numero di pagamenti andati a buon fine in un determinato giorno con quello presente nell'interfaccia Stripe e confermare che corrispondono.
- Ad esempio, fai clic sull'intestazione Grafico per la metrica Pagato correttamente. Questo grafico mostra per impostazione predefinita i dati degli ultimi 30 giorni. Passa con il mouse sul punto dati di ieri oppure guarda nella tabella dei dati sotto al grafico per vedere quanti pagamenti hai avuto ieri. Confronta quel numero con quanto salvato in Stripe e dovresti vedere che corrispondono esattamente.
- Se i dati non corrispondono, il problema è molto probabilmente che il fuso orario del tuo account Klaviyo non corrisponde al fuso orario del tuo account Stripe. Per controllare l’impostazione del fuso orario in Klaviyo:
- Fai clic sul nome del tuo account in basso a sinistra.
- Seleziona, quindi clicca su Impostazioni > Organizzazione.
- Scorri verso il basso fino a Fuso orario.
Le metriche di Stripe
Stripe sincronizza le seguenti metriche con Klaviyo:
- Pagamento non riuscito
- Fattura emessa
- Pagamento rimborsato
- Pagamento effettuato
Pagamento non riuscito
Questa metrica viene registrata ogni volta che un pagamento effettuato tramite Stripe viene contrassegnato come non riuscito. Usa questa metrica per targetizzare i clienti con pagamenti non riusciti e far sapere che hanno un saldo scaduto. Puoi filtrare e targetizzare gli eventi Failed Payment in base ai seguenti criteri:
- AttemptCount
Il numero di volte in cui questa fattura ha tentato di addebitare il pagamento all’utente. - Valuta
La valuta della fattura non è stata pagata, ad esempio USD, GBP. - Fattura
La fattura a cui è collegato questo pagamento non riuscito in Stripe. - Motivo
Il motivo per cui questo pagamento non è andato a buon fine in Stripe, ad esempio La tua carta è scaduta, La tua carta è stata rifiutata.
Fattura emessa
Questa metrica viene registrata ogni volta che viene emessa una fattura ai tuoi clienti tramite Stripe. Usa questa metrica per segmentare i clienti a cui è stata emessa una fattura, ma che non hanno pagato oppure per cui il pagamento non è andato a buon fine. Può anche essere usata per attivare segmenti per notificare ai clienti un pagamento in arrivo.
Pagamento rimborsato
Questa metrica registra un evento quando rimborsi un pagamento tramite Stripe. Puoi filtrare e targetizzare gli eventi di pagamento rimborsato in base ai seguenti criteri:
- Importo
Il valore del pagamento che è stato rimborsato.
Pagamento effettuato
Questa metrica viene registrata ogni volta che un cliente paga correttamente una fattura tramite Stripe. Questi eventi includono dati sul tuo cliente, sulla sua fattura e sui prodotti presenti nella fattura. Utilizza questa metrica per inviare fatture automatiche ai clienti dopo il pagamento oppure, nei flussi e-mail, per stabilire quando un cliente è stato attivo sul tuo sito web ma non ha effettuato pagamenti per i tuoi prodotti o servizi. Puoi quindi inviare a questi utenti e-mail che offrono sconti per effettuare un acquisto sul tuo sito web.
Puoi filtrare e targetizzare gli eventi Successfully Paid in base ai seguenti criteri:
- Valuta
La valuta della fattura pagata, ad esempio USD, GBP. - Fattura
La fattura a cui è collegato questo pagamento in Stripe.
Dati dei clienti
Klaviyo identifica in modo univoco ogni individuo tramite il suo indirizzo e-mail. Se Stripe sincronizza i dati dei clienti con un nuovo indirizzo e-mail, Klaviyo creerà un nuovo profilo costituito dall'indirizzo e-mail del cliente e dalle metriche Stripe associate. Le date di scadenza delle carte di credito vengono memorizzate come proprietà personalizzata nel profilo di un cliente.
Per creare un profilo in Klaviyo, deve verificarsi uno degli eventi Stripe elencati sopra.
Usa i dati di Stripe in Klaviyo
Qualsiasi metrica o metadati di Stripe possono essere usati per attivare un flusso in Klaviyo.
Fatture automatizzate
Puoi inviare automaticamente le ricevute delle fatture ai tuoi clienti dopo che effettuano un pagamento configurando un flusso delle fatture, attivato dalla metrica Successfully Paid di Stripe.
Questo flusso può compilare automaticamente un'e-mail che mostra dettagli di pagamento dinamici usando tag modello che fanno riferimento agli attributi di pagamento di Stripe.
Per ulteriori informazioni su come incorporare dati dinamici in un modello di e-mail, consulta il nostro articolo su tag modello e sintassi delle variabili.
Flusso dei pagamenti non riusciti di Stripe
Avvisa i clienti di un pagamento non riuscito con un flusso automatizzato, attivato dalla metrica Stripe Failed Payment.
Risoluzione dei problemi
Non vedo tutte le attività in Stripe sincronizzate con Klaviyo.
Il motivo più comune per cui un evento Stripe non si sincronizza con Klaviyo è che non c'è un indirizzo e-mail associato all'evento. Poiché Klaviyo utilizza un indirizzo e-mail per identificare in modo univoco una persona, non possiamo creare un profilo per chi non è associato a un indirizzo e-mail. Allo stesso modo, Klaviyo non può collegare un evento a un profilo se non è associato a un indirizzo e-mail.
Tieni presente che i campi nome e cognome non sono necessariamente coerenti o univoci, quindi non creiamo profili basandoci solo su queste informazioni. In questo modo potresti creare duplicati e un tracciamento impreciso.
Se, anche con gli indirizzi e-mail associati, non vedi ancora i dati Stripe sincronizzarsi con Klaviyo, contatta il nostro team di assistenza.
Risultato
Ora hai integrato Stripe con Klaviyo e hai imparato a usare i tuoi dati sincronizzati.
Risorse aggiuntive
- Getting started with flows
Learn how to use flows, also known as automations or drip campaigns, in Klaviyo for personalized and automated communications to your customers, and learn how to set your first flow live.
- Getting started with segments
Learn how to create and use segments in Klaviyo, which are a powerful tool for understanding your audience and sending targeted messages.
- Understanding the types of information exchanged between Klaviyo and apps
Learn about what types of data are exchanged between Klaviyo and external apps, and where that data is found in your Klaviyo account. When you integrate a third-party application with Klaviyo, the two platforms exchange information. Most data exchange with Klaviyo is one-way; data is pulled into your Klaviyo account so you can leverage a broad scope of your customers' data within Klaviyo.