Come effettuare l'integrazione con Recurly
Cosa imparerai
Scopri come integrare Recurly con Klaviyo per personalizzare e targetizzare le e-mail in base ai dati di fatturazione e pagamento dei tuoi clienti. Klaviyo sincronizza i seguenti dati da Recurly:
- Quando viene emessa una fattura e gli articoli inclusi in ogni fattura
- Informazioni di pagamento quando un cliente non riesce a pagare, riceve un rimborso o paga correttamente
- Proprietà del profilo associate alle informazioni Recurly
Integra Recurly con Klaviyo
Ti serve l'autorizzazione per gestire le integrazioni in Klaviyo e l'accesso come sviluppatore o amministratore in Recurly per recuperare la tua chiave API privata.
- Per integrare Recurly con Klaviyo, avrai bisogno della tua chiave API Recurly, quindi inizia con l'accesso al tuo account Recurly.
- Vai su Integrazioni > Credenziali API.
- Copia la chiave API privata sotto Chiave API predefinita per utilizzarla in seguito.

Le chiavi API private, come la chiave predefinita utilizzata qui, vanno trattate come password; conservale in un luogo sicuro e non esporle mai al pubblico.
- Se la chiave API predefinita è già in uso con un'altra integrazione di terze parti, puoi generare una nuova chiave API privata per l'integrazione Klaviyo facendo clic su Aggiungi chiave API privata.

Recurly genererà solo 5 chiavi API private per l’integrazione con applicazioni di terze parti.
- Se hai creato una nuova chiave API, copiala per utilizzarla nel tuo account Klaviyo.
- Nel tuo account Klaviyo, seleziona la scheda Integrazioni.
- Fai clic su Esplora le app per aprire il marketplace delle app in una nuova scheda. Cerca Recurly, seleziona la scheda, quindi clicca su Installa.
- Inserisci il tuo sottodominio Recurly e la chiave API che hai copiato in precedenza, quindi fai clic su Connetti a Recurly. Ad esempio, inserisci "iltuosottodominio" per https://yoursubdomain.recurly.com.

- Se l’integrazione ha esito positivo, verrà visualizzato un messaggio di conferma e lo storico dei dati inizierà a sincronizzarsi. Puoi controllare l’avanzamento della sincronizzazione nella scheda Data dell’integrazione Recurly.
Monitora la sincronizzazione Recurly
Klaviyo importa fatture e pagamenti dei precedenti 1.825 giorni (circa 5 anni) quando colleghi Recurly. Le nuove fatture e i nuovi pagamenti si sincronizzano circa ogni 5 minuti. Le fatture e i pagamenti per gli account Recurly senza un indirizzo e-mail valido vengono saltati.
- In Klaviyo, fai clic sul menu a tendina Analisi e poi seleziona Metrica.
- Cerca Issued Invoice con l’icona di Recurly, fai clic sul nome della metrica, quindi seleziona la scheda Feed attività.

- Se la tua integrazione ha iniziato a sincronizzare i dati, inizierà a vedere gli eventi Fattura Emessa, con l'icona Recurly, aggiunti a questo feed di attività.
- Per confrontare i totali dei pagamenti, torna a Analytics > Metriche e apri Pagato con successo con l’icona Recurly.
- Nella scheda Grafico, scegli un Intervallo di date che includa il giorno che vuoi controllare. Imposta Visualizza per su Giornaliero e Misurazione su Totale.
- Confronta il totale di quel giorno con il numero di pagamenti riusciti in Recurly per la stessa data. Aspetta che la sincronizzazione storica finisca prima di controllare date precedenti.
- Se i totali non corrispondono, verifica che la sincronizzazione sia terminata, che i pagamenti abbiano indirizzi e-mail cliente validi e che i tuoi account Klaviyo e Recurly usino lo stesso fuso orario.
- Per verificare l’impostazione del tuo fuso orario in Klaviyo:
- Clicca sul nome del tuo account nell'angolo in basso a sinistra.
- Seleziona Impostazioni.
- Seleziona Account, quindi scorri verso il basso fino a Fuso orario.
Dati sincronizzati da Recurly a Klaviyo
Metriche
Recurly sincronizza le seguenti metrica in Klaviyo:
- Pagamento non riuscito
Registrato ogni volta che un pagamento effettuato tramite Recurly viene contrassegnato come non riuscito. - Issued Invoice
Registrata ogni volta che viene emessa una fattura a un cliente tramite Recurly. - Prodotto ordinato
Registrato per gli articoli su una fattura quando un cliente effettua un pagamento riuscito tramite Recurly. Un pagamento può generare più eventi Prodotto ordinato. - Pagamento rimborsato
Registrato quando rimborsi un pagamento tramite Recurly. - Pagato correttamente
Registrato ogni volta che un cliente paga correttamente una fattura tramite Recurly.

Proprietà del profilo
Le seguenti proprietà vengono sincronizzate da Recurly ai profili Klaviyo:
- Codice account Recurly
- Data di scadenza della carta Recurly
- Codici del piano Recurly
- Piani Recurly
Piani Recurly e Codici piano Recurly vengono popolati dagli abbonamenti attivi quando i dati di pagamento vengono sincronizzati. Data di scadenza della carta Recurly viene popolata quando i dettagli di fatturazione includono mese e anno di scadenza.
Risultato
Hai completato l'integrazione di Recurly con Klaviyo e hai verificato i dati sincronizzati. Ora puoi personalizzare e targetizzare le e-mail in base ai dati di fatturazione e pagamento dei tuoi clienti.
Risorse aggiuntive
- Primi passi con i flussi
Scopri come utilizzare i flussi, noti anche come automazioni o campagne di drip marketing, su Klaviyo, per comunicazioni personalizzate e automatizzate con i tuoi clienti e impara a impostare e pubblicare il tuo primo flusso.
- Primi passi con i segmenti
Scopri come creare e usare i segmenti in Klaviyo, uno strumento potente per capire il tuo pubblico e inviare messaggi mirati.
- Comprendere i tipi di informazioni scambiate tra Klaviyo e le app
Scopri quali tipi di dati vengono scambiati tra Klaviyo e le app esterne e dove trovare questi dati nel tuo account Klaviyo. Quando integri un'applicazione di terze parti con Klaviyo, le due piattaforme si scambiano informazioni. La maggior parte dello scambio di dati con Klaviyo è a senso unico; i dati vengono importati nel tuo account Klaviyo, così puoi sfruttare un'ampia gamma di dati dei tuoi clienti all'interno di Klaviyo.