ReferralCandy è una piattaforma di marketing referral costruita per i marchi di ecommerce. Ti consente di gestire "programma "refer-a-friend" in cui i clienti guadagnano premi per portare nuovi acquirenti.
Collegando ReferralCandy con Omnisend, puoi trasformare l'attività del programma di referral in eventi di contatto – in modo da poter attivare email o SMS automatici e costruire segmenti basati su ciò che accade all'interno del tuo programma di referral.
In questo articolo, imparerai come collegare ReferralCandy a Omnisend, abilitare le tre automazioni disponibili e utilizzare i dati che inviano.
Prima di iniziare
Hai bisogno di un account Omnisend attivo.
Hai bisogno di un account ReferralCandy attivo con una campagna di referral in corso.
Le tue credenziali API di ReferralCandy (ID accesso API e segreto API) sono necessarie per autenticare la connessione.Puoi trovarli nel tuo pannello di controllo ReferralCandy sotto Account Token API.
Vantaggi
Automatizza le comunicazioni del tuo programma di referral: Invia email o SMS nel momento in cui un sostenitore si iscrive, un acquisto di referral è confermato o una ricompensa è guadagnata.
Consegna ricompense istantaneamente: Il payload dell'evento Ricompensa Guadagnata include il codice coupon, la descrizione e la data di scadenza – quindi puoi inviare la ricompensa direttamente da un Flusso automatizzato.
Costruisci segmenti mirati: Identifica gli sostenitori che hanno guadagnato premi, i contatti che hanno riferito almeno un amico, o gli sostenitori che non hanno ancora generato acquisti.
Come funziona
L'integrazione interroga ReferralCandy ogni 12 ore (dal momento in cui attivi ogni flusso automatizzato) e invia nuove attività a Omnisend come eventi personalizzati.Ogni evento è collegato al contatto rilevante (l'avvocato) in Omnisend.
I seguenti eventi sono sincronizzati con Omnisend da ReferralCandy:
Nome evento in Omnisend | Scatta quando |
| L'acquisto di un amico segnalato è attribuito a un sostenitore |
| Un nuovo sostenitore si unisce al programma di referral |
| Un avvocato guadagna una ricompensa |
Gli eventi appaiono in Omnisend entro un massimo di 12 ore dall'attività che si verifica in ReferralCandy.Solo l'attività che avviene dopo aver attivato un flusso automatizzato è elaborata; la cronologia dei referral passati non viene ripristinata.
Processo di Configurazione
Passaggio 1. Ottieni le tue credenziali API di ReferralCandy
Accedi al tuo account ReferralCandy.
Vai a Account Token API.
Copia sia il tuo ID accesso API che il tuo segreto API.
Passo 2. Collega ReferralCandy a Omnisend
Accedi al tuo account Omnisend e vai su Apps.
Cerca ReferralCandy e apri l'app.
Inserisci il tuo ID accesso API e il segreto API nei campi corrispondenti e fai clic su Connetti.
Omnisend convaliderà le tue credenziali contro ReferralCandy.Una volta confermato, vedrai un badge Connesso accanto al nome dell'app.
Passaggio 3. Abilita le automazioni
Dopo aver effettuato la connessione, vedrai una sezione Automazioni con tre interruttori.Accendi quelli che vuoi utilizzare:
ReferralCandy - Riferimento Completato →Omnisend
ReferralCandy - Avvocato Iscritto →Omnisend
ReferralCandy - Premio Guadagnato →Omnisend
Ogni flusso automatizzato è indipendente – attiva solo quelli rilevanti per la tua configurazione.Una volta attivato, il flusso automatizzato inizia a controllare ReferralCandy ogni 12 ore.
Questo è tutto! ReferralCandy ora invierà automaticamente nuovi eventi di referral a Omnisend.
Quali dati vengono inviati
Ogni flusso automatizzato invia un evento personalizzato a Omnisend con un insieme di proprietà.Ecco cosa include ogni evento:
ReferralCandy - Sostenitore Iscritto
Si attiva quando un nuovo sostenitore si unisce al tuo programma di referral.L'evento è collegato al contatto dell'avvocato in Omnisend.
Proprietà | Descrizione |
| ID ReferralCandy dell'Avvocato |
| Indirizzo email dell'avvocato |
| Nome di battesimo dell'avvocato |
| Cognome dell'avvocato |
| Se l'avvocato ha effettuato un acquisto ( |
| Array degli acquisti dell'avvocato |
| Il flag di disiscrizione di ReferralCandy per questo contatto ( |
Esempio di payload:
{ "id": 430711176, "first_name": "first", "last_name": "last", "email": "[email protected]", "purchase_made": false, "purchases": [], "unsubscribed": false }
ReferralCandy - Referral Completato
Si attiva quando l'acquisto di un amico referito è attribuito a un sostenitore.L'evento è collegato al contatto dell'avvocato – così puoi inviare loro un messaggio quando un contatto che hanno riferito effettua un acquisto.
Proprietà | Descrizione |
| Indirizzo email dell'avvocato |
| L'indirizzo email dell'amico segnalato |
| Quando si è verificato il referral (timestamp Unix) |
| ID della campagna di referral |
| Se il periodo di revisione di ReferralCandy per questo referral è terminato ( |
| L'ID dell'ordine del negozio per l'acquisto riferito |
Esempio di payload:
{ "campaignId": 125143, "external_reference_id": "1480", "referral_email": "[email protected]", "referral_timestamp": 1781607304, "referring_email": "[email protected]", "review_period_over": true }
ReferralCandy - Ricompensa Guadagnata
Si attiva quando un sostenitore guadagna una ricompensa, dopo che il periodo di revisione di ReferralCandy è terminato.L'evento è collegato al contatto dell'avvocato.
Proprietà | Descrizione |
| Indirizzo email dell'avvocato |
| Nome del sostenitore |
| Tipo di ricompensa (es. |
| Descrizione della ricompensa leggibile dall'uomo (es. "uno sconto di €50") |
| Il codice coupon della ricompensa |
| Data di scadenza del coupon (timestamp Unix) |
| Se il coupon è stato riscattato ( |
| Stato della ricompensa (es. |
| Quando è stata guadagnata la ricompensa (timestamp Unix) |
| ID della ricompensa |
| Collegamento allo sconto Shopify sottostante |
Esempio di payload:
{ "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" }Nota: Ogni evento utilizza un nome di campo diverso per l'indirizzo email dell'avvocato. Quando si creano segmenti o flussi di lavoro che coprono più eventi, utilizzare il campo corretto per ogni evento.
Evento | Campo email dell'avvocato |
Sostenitore Iscritto |
|
Riferimento Completato |
|
Ricompensa Guadagnata |
|
L'email dell'amico segnalato (referral_email) è disponibile solo nell'evento Referral Completed.
Crea flussi automatizzati
Una volta che l'integrazione è attiva, utilizza gli eventi personalizzati come attivatori nei flussi automatizzati di Omnisend:
Avvocato Iscritto A Invia un'email di benvenuto che spiega come funziona il programma di referral e condivide il link di referral dell'avvocato.
Referral Completato Notifica l'avvocato che il contatto che hanno riferito ha appena effettuato un acquisto, rinforzando il comportamento.
Ricompensa Guadagnata A Invia un'email all'avvocato con la loro ricompensa. Il payload dell'evento include il codice coupon (
codice_coupon), la descrizione (descrizione), e la data di scadenza (timestamp_scadenza_codice_coupon).
Puoi anche utilizzare gli eventi per segmentazione dei contatti – ad esempio, "sostenitori che hanno guadagnato almeno una ricompensa" o "sostenitori senza riferimenti completati" per una campagna di ri-engagement.
Cose da sapere
Gli eventi non sono istantanei. L'integrazione interroga ReferralCandy ogni 12 ore. Aspettati che gli eventi appaiano in Omnisend entro 12 ore dall'attività che si verifica in ReferralCandy.
Nessun ripristino storico. Attivare un flusso automatizzato non riproduce l'attività di referral passata. Solo gli eventi che si verificano dopo l'attivazione fluiscono in Omnisend.
Nessun evento duplicato. Ogni referral, premio e iscrizione di sostenitore viene inviato a Omnisend una sola volta. L'integrazione tiene traccia di ciò che è già stato sincronizzato.
Nessun consenso di marketing. I contatti creati tramite questa integrazione sono impostati sunon iscritti per impostazione predefinita. Non riceveranno email di marketing o SMS fino a quando non si iscriveranno tramite un Modulo di iscrizione Omnisend.
Tempistiche della ricompensa. L'evento Ricompensa Guadagnata si attiva solo dopo che il periodo di revisione di ReferralCandy per il riferimento collegato è terminato. Ciò significa che Ricompensa Guadagnata arriverà sempre dopo Riferimento Completato per lo stesso riferimento.
Solo lettura. L'integrazione legge i dati da ReferralCandy. Non scrive nulla su ReferralCandy.
Risoluzione dei problemi
Un evento non appare in Omnisend
Controlla in questo ordine:
ReferralCandy l'ha registrato? Vai aAcquisti & Riferimenti nel tuo account ReferralCandy e conferma che il riferimento sia attribuito o che la ricompensa esista. Se non è lì, il problema è dalla parte di ReferralCandy.
È stata eseguita una poll? Gli eventi appaiono dopo la prossima poll di 12 ore. Aspetta l'intero intervallo prima di presumere un problema.
Il flusso automatizzato è attivato? Conferma che il flusso automatizzato rilevante sia attivato in Omnisend.
Le credenziali sono ancora valide? Se il tuo ID accesso API o il tuo segreto API sono stati ruotati in ReferralCandy, aggiorna la connessione in Omnisend con le nuove credenziali.
La ricompensa non è arrivata, ma il riferimento sì
Questo è previsto. Ricompensa Guadagnata si attiva solo dopo che il periodo di revisione di ReferralCandy per quel riferimento è terminato.Il tempo di attesa tra Referral Completato e Ricompensa Guadagnata è normale.
Domande frequenti
Quale stato di iscrizione ottengono i nuovi contatti?
I contatti creati tramite questa integrazione sono impostati su non iscritti per impostazione predefinita.Non riceveranno email di marketing o SMS fino a quando non si iscriveranno tramite un Modulo di iscrizione Omnisend.
Posso eseguire solo alcune delle tre automazioni?
Sì. Ogni flusso automatizzato è indipendente.Attiva solo quelle di cui hai bisogno e lascia le altre disattivate.
Posso usare l'Email dell'amico referito in un flusso automatizzato?
L'email dell'amico segnalato (referral_email) è inclusa nel payload dell'evento Referral Completed.Tuttavia, quell'evento è collegato al contatto dell'avvocato – non a quello dell'amico.Per inviare un messaggio direttamente all'amico, dovresti creare un contatto per loro separatamente.
L'integrazione sincronizza i dati storici dei referral?
No. L'unica attività che si verifica dopo aver attivato un flusso automatizzato viene inviata a Omnisend.I riferimenti e le ricompense passate non vengono retroattivamente inseriti.
È avvenuto un referral nel mio Negozio, ma nessun evento è arrivato in Omnisend. Cosa dovrei controllare?
Prima di tutto, verifica se ReferralCandy ha attribuito il riferimento a un sostenitore.Se il sistema di rilevamento delle frodi di ReferralCandy ha bloccato l'attribuzione (es. un'auto-riferimento), nessun evento verrà inviato a Omnisend – quel risultato è deciso interamente all'interno di ReferralCandy.
Posso utilizzare questi eventi nelle campagne Email?
Questi eventi sono progettati come trigger per i flussi automatizzati.Per inviare una campagna una tantum, crea un segmento basato sull'evento personalizzato (ad es., contatti che hanno l'evento ReferralCandy - Reward Earned) e invia una campagna a quel segmento.
Bloccato o incerto su cosa fare dopo? Contatta il nostro team di supporto in qualsiasi momento tramite chat in-app o a[email protected]. Per domande specifiche su ReferralCandy, contattasupporto ReferralCandy