Comment intégrer Recurly
Objectif de cet article
Apprenez à intégrer Recurly à Klaviyo afin de personnaliser et de cibler les e-mails en fonction des données de facturation et de paiement de vos clients. Klaviyo synchronise les données suivantes à partir de Recurly :
- Lorsqu’une facture est émise, et les articles inclus dans chaque facture
- Informations de paiement lorsque le paiement d’un client échoue, qu’il est remboursé ou qu’il paie avec succès
- Propriétés de profil associées aux informations Recurly
Intégrer Recurly à Klaviyo
Vous devez disposer de l’autorisation de gérer les intégrations dans Klaviyo et d’un accès développeur ou administrateur dans Recurly pour récupérer votre clé d’API privée.
- Pour intégrer Recurly à Klaviyo, vous aurez besoin de votre clé d’API Recurly ; commencez donc par vous connecter à votre compte Recurly.
- Accédez à intégrations > Identifiants de l’API.
- Copiez la clé d’API privée sous clé d’API par défaut pour l’utiliser plus tard.

Les clés d’API privées, telles que votre clé par défaut utilisée ici, doivent être traitées comme des mots de passe ; conservez-les en lieu sûr et ne les exposez jamais au public.
- Si votre clé d’API par défaut est déjà utilisée avec une autre intégration tierce, vous pouvez générer une nouvelle clé d’API privée pour l’intégration Klaviyo en cliquant sur Ajouter une clé d’API privée.

Recurly ne générera que 5 clés d’API privées pour s’intégrer à des applications tierces.
- Si vous avez créé une nouvelle clé d’API, copiez-la pour l’utiliser dans votre compte Klaviyo.
- Dans votre compte Klaviyo, sélectionnez l’onglet Intégrations.
- Cliquez sur Explorer les applications pour ouvrir le marketplace des applications dans un nouvel onglet. Recherchez Recurly, sélectionnez sa carte, puis cliquez sur Installer.
- Saisissez votre sous-domaine Recurly et la clé d’API que vous avez copiée précédemment, puis cliquez sur Se connecter à Recurly. Par exemple, saisissez « votresousdomaine » pour https://votresousdomaine.recurly.com.

- Si l’intégrations réussit, un message de réussite s’affichera, et vos données historiques commenceront à se synchroniser. Vous pouvez vérifier la progression de la synchronisation dans l’onglet Données de vos intégrations Recurly.
Surveiller la synchronisation Recurly
Klaviyo importe les factures et les paiements des 1 825 derniers jours (environ 5 ans) lorsque vous connectez Recurly. Les nouvelles factures et les nouveaux paiements se synchronisent environ toutes les 5 minutes. Les factures et les paiements des comptes Recurly sans adresse e-mail valide sont ignorés.
- Dans Klaviyo, cliquez sur le menu déroulant Analytics, puis sélectionnez indicateurs.
- Recherchez Issued Invoice avec l’icône Recurly, cliquez sur le nom de l’indicateur, puis sélectionnez l’onglet Fil d’activité.

- Si votre intégrations a commencé à synchroniser des données, vous commencerez à voir des événements Issued Invoice, avec l’icône Recurly, ajoutés à ce flux d’activité.
- Pour comparer les totaux de paiement, revenez à Analytics > Indicateurs, puis ouvrez Successfully Paid avec l’icône Recurly.
- Dans l’onglet Graphique, choisissez une Plage de dates qui inclut le jour que vous souhaitez vérifier. Définissez Afficher par sur Quotidien et Mesure sur Total.
- Comparez le total de cette journée avec le nombre de paiements réussis dans Recurly pour la même date. Attendez la fin de la synchronisation historique avant de vérifier des dates plus anciennes.
- Si les totaux diffèrent, vérifiez que la synchronisation est terminée, que les paiements disposent d’adresses e-mail client valides, et que vos comptes Klaviyo et Recurly utilisent le même fuseau horaire.
- Pour vérifier votre paramètre de fuseau horaire dans Klaviyo :
- Cliquez sur le nom de votre compte dans le coin inférieur gauche.
- Sélectionnez Paramètres.
- Sélectionnez Compte, puis faites défiler vers le bas jusqu’à Fuseau horaire.
Données synchronisées entre Recurly et Klaviyo
Indicateurs
Recurly synchronise les indicateurs suivants avec Klaviyo :
- Paiement échoué
Enregistré chaque fois qu’un paiement effectué via Recurly est marqué comme ayant échoué. - Facture émise
Enregistré à chaque fois qu’une facture est émise à un client via Recurly. - Produit commandé
Enregistré pour les articles figurant sur une facture lorsqu’un client effectue un paiement réussi via Recurly. Un paiement peut générer plusieurs événements Produit commandé. - Paiement remboursé
Enregistré lorsque vous remboursez un paiement via Recurly. - Payé avec succès
Enregistré chaque fois qu’un client paie avec succès une facture via Recurly.

Propriétés du profil
Les propriétés suivantes sont synchronisées de Recurly vers les profils Klaviyo :
- Code de compte Recurly
- Date d’expiration de la carte Recurly
- Codes de forfait Recurly
- Forfaits Recurly
Les Forfaits Recurly et les codes de forfait Recurly sont renseignés à partir des abonnements actifs lorsque les données de paiement sont synchronisées. La date d’expiration de la carte Recurly est renseignée lorsque les informations de facturation incluent un mois et une année d’expiration.
Résultat
Vous avez terminé l’intégration de Recurly avec Klaviyo et avez vérifié vos données synchronisées. À présent, vous pouvez personnaliser et cibler vos e-mails en fonction des données de facturation et de paiement de vos clients.
Ressources supplémentaires
- Démarrer avec les flux
Apprenez à utiliser les flux (également connus sous le nom d’automatisations ou de campagnes drip) pour personnaliser et automatiser votre communication auprès des clients, puis découvrez comment activer votre premier flux dans Klaviyo.
- Démarrer avec les segments
Apprenez à créer et à utiliser des segments dans Klaviyo, un puissant outil pour comprendre votre audience et envoyer des messages ciblés.
- Comprendre les types d’informations échangées entre Klaviyo et les applications
Découvrez quels types de données sont échangées entre Klaviyo et des applications externes, et où ces données se trouvent dans votre compte Klaviyo. Lorsque vous intégrez une application tierce à Klaviyo, les deux plateformes échangent des informations. La plupart des échanges de données avec Klaviyo sont unidirectionnels ; les données sont importées dans votre compte Klaviyo afin que vous puissiez exploiter un large éventail de données sur vos clients dans Klaviyo.