ReferralCandy est une plateforme de marketing de recommandation conçue pour les marques de commerce électronique. Elle vous permet de lancer "programmes de parrainage" où les clients gagnent des récompenses pour attirer de nouveaux acheteurs.
En connectant ReferralCandy avec Omnisend, vous pouvez transformer l'activité du programme de parrainage en événements de contact – afin de pouvoir déclencher des e-mails ou des SMS automatisés et créer des segments en fonction de ce qui se passe dans votre programme de parrainage.
Dans cet article, vous apprendrez comment connecter ReferralCandy à Omnisend, activer les trois automatisations disponibles et utiliser les données qu'ils envoient.
Avant de commencer
Vous avez besoin d'un compte Omnisend actif.
Vous avez besoin d'un compte ReferralCandy actif avec une campagne de parrainage en cours.
Vos identifiants API ReferralCandy (ID d'accès API et secret API) sont nécessaires pour authentifier la connexion.Vous pouvez les trouver dans votre tableau de bord ReferralCandy sous Compte → API Tokens.
Avantages
Automatisez les communications de votre programme de parrainage : Déclencheur d'emails ou de SMS dès qu'un défenseur s'inscrit, qu'un achat de parrainage est confirmé ou qu'une récompense est gagnée.
Livrer des récompenses instantanément : La charge utile de l'événement Récompense Gagnée inclut le code de coupon, la description et la date d'expiration – afin que vous puissiez envoyer la récompense directement depuis un Workflow d'Automatisation.
Créer des segments ciblés : Identifiez les défenseurs qui ont gagné des récompenses, les contacts qui ont référé au moins un ami, ou les défenseurs qui n'ont pas encore généré d'achats.
Comment ça marche
L'intégration interroge ReferralCandy toutes les 12 heures (à partir du moment où vous activez chaque automatisation) et envoie de nouvelles activités à Omnisend en tant que événements personnalisés.Chaque événement est associé au contact pertinent (l'avocat) dans Omnisend.
Les événements suivants sont synchronisés avec Omnisend depuis ReferralCandy :
Nom de l'événement dans Omnisend | S'active lorsque |
| L'achat d'un ami référé est attribué à un défenseur |
| Un nouvel avocat rejoint le programme de référence |
| Un avocat gagne une récompense |
Les événements apparaissent dans Omnisend dans un délai de 12 heures après l'activité sur ReferralCandy.Seule l'activité qui se produit après avoir activé une automatisation est prise en compte ; l'historique des références passées n'est pas rempli.
Processus de configuration
Étape 1. Obtenez vos identifiants API ReferralCandy
Connectez-vous à votre compte ReferralCandy.
Allez à Compte Jetons API.
Copiez à la fois votre ID d'accès API et votre secret API.
Étape 2. Connectez ReferralCandy à Omnisend
Connectez-vous à votre compte Omnisend et allez dans Applications.
Recherchez ReferralCandy et ouvrez l'application.
Entrez votre ID d'accès API et secret API dans les champs correspondants et cliquez sur Connecter.
Omnisend validera vos identifiants auprès de ReferralCandy.Une fois confirmé, vous verrez un badge Connecté à côté du nom de l'application.
Étape 3. Activez les automatisations
Après vous être connecté, vous verrez une section Automatisations avec trois interrupteurs.Activez ceux que vous souhaitez utiliser :
ReferralCandy - Référence terminée →Omnisend
ReferralCandy - Avocat Inscrit →Omnisend
ReferralCandy - Récompense Gagnée →Omnisend
Chaque automatisation est indépendante – activez uniquement celles qui sont pertinentes pour votre configuration.Une fois activée, l'automatisation commence à interroger ReferralCandy toutes les 12 heures.
C'est tout ! ReferralCandy enverra désormais automatiquement de nouveaux événements de parrainage à Omnisend.
Quelles données sont transmises
Chaque automatisation envoie un custom event à Omnisend avec un ensemble de propriétés.Voici ce que chaque événement comprend :
ReferralCandy - Avocat Inscrit
Se déclenche lorsqu'un nouvel avocat rejoint votre programme de parrainage.L'événement est associé au contact de l'avocat dans Omnisend.
Propriété | Description |
| ID ReferralCandy de l'Avocat |
| Adresse email de l'avocat |
| Prénom de l'avocat |
| Nom de famille de l'avocat |
| Que l'avocat ait effectué un achat ( |
| Array des achats de l'avocat |
| Le drapeau de désinscription de ReferralCandy pour ce contact ( |
Exemple de charge utile :
{ "id": 430711176, "first_name": "first", "last_name": "last", "email": "[email protected]", "purchase_made": false, "purchases": [], "unsubscribed": false }
ReferralCandy - Référence terminée
Se déclenche lorsqu'un achat d'un ami référé est attribué à un défenseur.L'événement est associé au contact de l'avocat – vous pouvez donc leur envoyer un message lorsque le contact qu'ils ont référé effectue un achat.
Propriété | Description |
| Adresse email de l'avocat |
| Adresse email de l'ami référé |
| Lorsque la référence a eu lieu (timestamp Unix) |
| ID de campagne de parrainage |
| Que la période d'examen de ReferralCandy pour ce parrainage soit terminée ( |
| L'ID de commande de la boutique pour l'achat référencé |
Exemple de charge utile :
{ "campaignId": 125143, "external_reference_id": "1480", "referral_email": "[email protected]", "referral_timestamp": 1781607304, "referring_email": "[email protected]", "review_period_over": true }
ReferralCandy - Récompense Gagnée
Se déclenche lorsqu'un défenseur gagne une récompense, après la période de révision de ReferralCandy.L'événement est associé au contact de l'avocat.
Propriété | Description |
| Adresse email de l'avocat |
| Nom du défenseur |
| Type de récompense (par exemple, |
| Description de la récompense lisible par l'homme (par exemple, "une remise de 50 €") |
| Le code de coupon de la récompense |
| Date d'expiration du coupon (timestamp Unix) |
| Si le coupon a été utilisé ( |
| Statut de la récompense (par exemple, |
| Quand la récompense a été gagnée (timestamp Unix) |
| ID de la récompense |
| Lien vers la remise Shopify sous-jacente |
Exemple de charge utile :
{ "advocate_email": "[email protected]", "advocate_name": "Advocate Name", "coupon_code": "THANKS-XXXXXX", "coupon_code_data": { "shopify_graphql_discount_code_id": "gid://shopify/DiscountCodeNode/0000000000" }, "coupon_code_expiry_timestamp": 1786792518, "coupon_used": false, "created_at": 1781608518, "description": "a €50 discount", "id": 7427724, "status": "delivered", "type": "coupon" }Remarque : Chaque événement utilise un nom de champ différent pour l'adresse email de l'avocat. Lors de la création de segments ou de flux de travail qui s'étendent sur plusieurs événements, utilisez le champ correct pour chaque événement.
Événement | Champ email de l'avocat |
Défenseur Inscrit |
|
Référence Complétée |
|
Récompense Gagnée |
|
L'email de l'ami référé (referral_email) n'est disponible que dans l'événement Référence Complétée.
Construire des flux de travail d'automatisation
Une fois l'intégration active, utilisez les événements personnalisés comme déclencheurs dans les workflows d'automatisation Omnisend :
Avocat Inscrit 4E6 Envoyer un email de bienvenue expliquant comment fonctionne le programme de référence et partageant le lien de référence de l'avocat.
Référence terminée Informez l'avocat que le contact qu'ils ont référé vient de faire un achat, renforçant ainsi le comportement.
Récompense Gagnée 4E6 Email à l'avocat avec leur récompense. Le payload de l'événement inclut le code coupon (
coupon_code), la description (description), et la date d'expiration (coupon_code_expiry_timestamp).
Vous pouvez également utiliser les événements pour segmentation de contact – par exemple, "les défenseurs qui ont gagné au moins une récompense" ou "les défenseurs n'ayant pas encore de parrainages complétés" pour une campagne de réengagement.
Choses à Savoir
Les événements ne sont pas instantanés. L'intégration interroge ReferralCandy toutes les 12 heures. Attendez-vous à ce que les événements apparaissent dans Omnisend dans un délai allant jusqu'à 12 heures après l'activité dans ReferralCandy.
Aucun remplissage historique. L'activation d'une automatisation ne rejoue pas l'activité de référence passée. Seuls les événements qui se produisent après l'activation sont envoyés à Omnisend.
Aucun événement en double. Chaque parrainage, récompense et inscription d'avocat est envoyé à Omnisend une seule fois. L'intégration suit ce qui a déjà été synchronisé.
Aucun consentement marketing. Les contacts créés via cette intégration sont définis surnon-abonnés par défaut. Ils ne recevront pas d'e-mails marketing ni de SMS tant qu'ils ne s'inscrivent pas via un Formulaire d'inscription Omnisend.
Timing de la récompense. L'événement Récompense Gagnée ne se déclenche qu'après la période de révision de ReferralCandy pour la référence liée. Cela signifie que Récompense Gagnée arrivera toujours après Référence Complétée pour la même référence.
Lecture seule. L'intégration lit les données de ReferralCandy. Elle n'écrit rien en retour à ReferralCandy.
Dépannage
Un événement n'apparaît pas dans Omnisend
Vérifiez dans cette commande :
ReferralCandy l'a-t-il enregistré ? Allez àAchats & Références dans votre compte ReferralCandy et confirmez que la référence est attribuée ou que la récompense existe. Si ce n'est pas le cas, le problème vient de ReferralCandy.
Un sondage a-t-il déjà été effectué ? Les événements apparaissent après le prochain sondage de 12 heures. Attendez l'intervalle complet avant de supposer un problème.
L'automatisation est-elle activée ? Confirmez que l'automatisation pertinente est activée dans Omnisend.
Les identifiants sont-ils toujours valides ? Si votre ID d'accès API ou votre secret API a été renouvelé dans ReferralCandy, mettez à jour la connexion dans Omnisend avec les nouveaux identifiants.
La récompense n'est pas arrivée, mais la référence l'est
C'est prévu. Récompense Gagnée ne se déclenche qu'après la période de révision de ReferralCandy pour cette référence.Le Délai entre la Référence Complétée et la Récompense Gagnée est normal.
FAQ
Quel statut d'abonnement obtiennent les nouveaux contacts ?
Les contacts créés via cette intégration sont définis par défaut sur non-abonnés.Ils ne recevront pas d'e-mails marketing ni de SMS tant qu'ils ne s'inscrivent pas via un Formulaire d'inscription Omnisend.
Puis-je exécuter seulement certaines des trois automatisations ?
Oui. Chaque automatisation est indépendante.Activez uniquement celles dont vous avez besoin et laissez les autres désactivées.
Puis-je utiliser l'Email de l'ami référé dans une automatisation ?
L'email de l'ami référé (referral_email) est inclus dans le payload de l'événement Référence Complétée.Cependant, cet événement est associé au contact de l'avocat – pas celui de l'ami.Pour envoyer un message directement à l'ami, vous devrez créer un contact pour eux séparément.
L'intégration synchronise-t-elle les données de parrainage historiques ?
Non. La seule activité qui se produit après que vous avez activé une automatisation est envoyée à Omnisend.Les références et récompenses passées ne sont pas remplies.
Une recommandation a eu lieu dans ma boutique, mais aucun événement n'est arrivé dans Omnisend. Que devrais-je vérifier ?
Tout d'abord, vérifiez si ReferralCandy a attribué la référence à un défenseur.Si la détection de fraude de ReferralCandy a bloqué l'attribution (par exemple, une auto-référence), aucun événement ne sera envoyé à Omnisend – ce résultat est entièrement décidé au sein de ReferralCandy.
Puis-je utiliser ces événements dans des campagnes Email ?
Ces événements sont conçus comme des déclencheurs pour les flux de travail d'automatisation.Pour envoyer une campagne unique, créez un segment basé sur l'événement personnalisé (par exemple, les contacts qui ont l'événement ReferralCandy - Reward Earned) et envoyez une campagne à ce segment.
Bloqué ou incertain sur ce qu'il faut faire ensuite ? Contactez notre équipe de support à tout moment via le chat dans l'application ou à[email protected]. Pour des questions spécifiques à ReferralCandy, contactezsupport ReferralCandy