---
title: "Come effettuare l'integrazione con Recurly"
description: "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:"
canonical_url: "https://help.klaviyo.com/hc/it-it/articles/115005082207"
markdown_url: "https://help.klaviyo.com/hc/it-it/articles/115005082207.md"
locale: "it-it"
category: "Integrazioni"
section: "Recurly"
updated: "2025-07-30"
---

# 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.

1. Per integrare Recurly con Klaviyo, avrai bisogno della tua chiave API Recurly, quindi inizia con l'accesso al tuo account Recurly.

2. Vai su **Integrazioni > Credenziali API.**

3. Copia la chiave API privata sotto **Chiave API predefinita** per utilizzarla in seguito.




![Default API Key section in Recurly with private API key blurred out](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/c0841d1ca32e6651a9e87a9b34e94971c12eea94-1668x454.jpg?auto=format)

**📝 Note:** 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.

1. 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**. 




![Private API Keys in Recurly showing Default API Key blurred out and Add Private API Key with gray background at the bottom](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/5c3158171eced03aff03deebcdba6f20ffe9f8db-1698x920.jpg?auto=format)

**📝 Note:** Recurly genererà solo 5 chiavi API private per l’integrazione con applicazioni di terze parti.

1. Se hai creato una nuova chiave API, copiala per utilizzarla nel tuo account Klaviyo.

2. Nel tuo account Klaviyo, seleziona la scheda **Integrazioni**.

3. 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**.

4. 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.



![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/a13b8ed2767023b34bc30ce1cc4948e17ef83f6a-1542x1060.png?auto=format)

5. 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.

1. In Klaviyo, fai clic sul menu a tendina **Analisi** e poi seleziona **Metrica**.

2. Cerca **Issued Invoice** con l’icona di Recurly, fai clic sul nome della metrica, quindi seleziona la scheda **Feed attività**.



![Page showing list of Issued Invoice via Recurly metrics in Klaviyo with timestamps](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/7db87fcbd683ad92b858dbbc9b11257420d25e58-1000x581.jpg?auto=format)

3. 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à.

4. Per confrontare i totali dei pagamenti, torna a **Analytics > Metriche** e apri **Pagato con successo** con l’icona Recurly.

5. Nella scheda **Grafico**, scegli un **Intervallo di date** che includa il giorno che vuoi controllare. Imposta **Visualizza per** su **Giornaliero** e **Misurazione** su **Totale**.

6. 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.

7. 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.

8. 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.




![Metrics tab in Klaviyo filtered by Recurly with metrics such as Failed Payment and Issues Invoice](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/9c7829de22c9b6561e3a49f20262e87f4fd9ea8b-1676x590.jpg?auto=format)

### 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](https://help.klaviyo.com/hc/it-it/articles/115002774932.md)
  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](https://help.klaviyo.com/hc/it-it/articles/115005237908.md)
  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](https://help.klaviyo.com/hc/it-it/articles/360030696012.md)
  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. 
