ReferralCandy ist eine Empfehlungsmarketing-Plattform, die für E-Commerce-Marken entwickelt wurde. Sie ermöglicht es Ihnen, "Freunde-werben-Freunde"-Programme zu betreiben, bei denen Kunden Belohnungen für die Gewinnung neuer Käufer erhalten.
Durch die Verbindung von ReferralCandy mit Omnisend können Sie Aktivitäten des Empfehlungsprogramms in Kontaktereignisse umwandeln – sodass Sie automatisierte E-Mails oder SMS auslösen und Segmente basierend auf den Ereignissen in Ihrem Empfehlungsprogramm erstellen können.
In diesem Artikel erfahren Sie, wie Sie ReferralCandy mit Omnisend verbinden, die drei verfügbaren Automatisierungen aktivieren und die Daten nutzen, die sie senden.
Bevor Sie beginnen
Sie benötigen ein aktives Omnisend-Konto.
Sie benötigen ein aktives ReferralCandy-Konto mit einer laufenden Empfehlungs-Kampagne.
Ihre ReferralCandy API-Anmeldeinformationen (API-Zugangs-ID und API-Geheimnis) sind erforderlich, um die Verbindung zu authentifizieren.Sie können sie in Ihrem ReferralCandy Das Dashboard unter Das Konto → API Tokens finden.
Vorteile
Automatisieren Sie die Kommunikation Ihres Empfehlungsprogramms: Der Trigger-E-Mails oder Die SMS, sobald ein Befürworter sich anmeldet, ein Empfehlungs-Kauf bestätigt wird oder eine Belohnung verdient wird.
Belohnungen sofort liefern: Die Payload des Ereignisses "Belohnung verdient" enthält den Gutscheincode, die Beschreibung und das Ablaufdatum – sodass Sie die Belohnung direkt aus einem Workflow zur Automatisierung senden können.
Gezielte Segmente erstellen: Identifizieren Sie Befürworter, die Belohnungen verdient haben, Kontakte, die mindestens einen Freund geworben haben, oder Befürworter, die noch keine Käufe generiert haben.
So funktioniert's
Die Integration fragt ReferralCandy alle 12 Stunden (ab dem Zeitpunkt, an dem Sie jede Automatisierung aktivieren) ab und sendet neue Aktivitäten an Omnisend als benutzerdefinierte Ereignisse.Jedes Ereignis ist mit dem entsprechenden Kontakt (dem Anwalt) in Omnisend verbunden.
Die folgenden Ereignisse werden von ReferralCandy an Omnisend synchronisiert:
Ereignisname in Omnisend | Tritt auf, wenn |
| Ein Kauf eines geworbenen Freundes wird einem Befürworter zugeordnet |
| Ein neuer Befürworter tritt dem Empfehlungsprogramm bei |
| Ein Befürworter verdient eine Belohnung |
Ereignisse erscheinen in Omnisend innerhalb von bis zu 12 Stunden nach dem Auftreten der Aktivität in ReferralCandy.Die einzige Aktivität, die nach der Aktivierung einer Automatisierung stattfindet, fließt durch; die frühere Empfehlungsverlauf wird nicht nachträglich ausgefüllt.
Einrichtungsprozess
Schritt 1. Holen Sie sich Ihre ReferralCandy API-Anmeldeinformationen
Melden Sie sich bei Ihrem ReferralCandy-Konto an.
Gehe zu Das Konto API-Token.
Kopieren Sie sowohl Ihre API-Zugangs-ID als auch Ihr API-Geheimnis.
Schritt 2. Verbinden Sie ReferralCandy mit Omnisend
Melden Sie sich bei Ihrem Omnisend-Konto an und gehen Sie zu Apps.
Suchen Sie nach ReferralCandy und öffnen Sie die App.
Geben Sie Ihre API-Zugangs-ID und Ihr API-Geheimnis in die entsprechenden Felder ein und klicken Sie auf Verbinden.
Omnisend wird Ihre Anmeldeinformationen mit ReferralCandy validieren.Sobald dies bestätigt ist, sehen Sie ein Verbunden-Abzeichen neben dem App-Namen.
Schritt 3. Aktivieren Sie die Automatisierungen
Nach der Verbindung sehen Sie einen Abschnitt Automatisierungen mit drei Schaltern.Aktivieren Sie die, die Sie verwenden möchten:
ReferralCandy - Empfehlung abgeschlossen Omnisend
ReferralCandy - Befürworter eingeschrieben Omnisend
ReferralCandy - Belohnung verdient Omnisend
Jede Automatisierung ist unabhängig – aktivieren Sie nur die, die für Ihr Setup relevant sind.Sobald sie aktiviert ist, beginnt die Automatisierung, ReferralCandy alle 12 Stunden abzufragen.
Das ist alles! ReferralCandy wird jetzt automatisch neue Empfehlungsereignisse an Omnisend senden.
Welche Daten übermittelt werden
Jede Automatisierung sendet ein benutzerdefiniertes Ereignis an Omnisend mit einer Reihe von Eigenschaften.Hier ist, was jedes Ereignis umfasst:
ReferralCandy - Befürworter eingeschrieben
Tritt auf, wenn ein neuer Befürworter Ihrem Empfehlungsprogramm beitritt.Das Ereignis ist mit dem Kontakt des Anwalts in Omnisend verbunden.
Eigenschaft | Beschreibung |
| ReferralCandy-ID des Befürworters |
| Die E-Mail-Adresse des Anwalts |
| Vorname des Befürworters |
| Nachname des Befürworters |
| Ob der Befürworter einen Kauf getätigt hat ( |
| Array der Käufe des Befürworters |
| ReferralCandy's eigenes Abmeldeflag für diesen Kontakt ( |
Beispielpayload:
{ "id": 430711176, "first_name": "first", "last_name": "last", "email": "[email protected]", "purchase_made": false, "purchases": [], "unsubscribed": false }
ReferralCandy - Empfehlung abgeschlossen
Tritt auf, wenn ein Kauf eines geworbenen Freundes einem Befürworter zugeordnet wird.Das Ereignis ist mit dem Kontakt des Anwalts verbunden – sodass Sie ihnen eine Nachricht senden können, wenn ein Kontakt, den sie geworben haben, einen Kauf tätigt.
Eigenschaft | Beschreibung |
| Die E-Mail-Adresse des Anwalts |
| Die E-Mail-Adresse des empfohlenen Freundes |
| Wann die Empfehlung stattfand (Unix-Zeitstempel) |
| Die Kampagne-ID für Empfehlungen |
| Ob der Überprüfungszeitraum von ReferralCandy für diese Empfehlung abgelaufen ist ( |
| Die Bestell-ID des Webshops für den genannten Kauf |
Beispielpayload:
{ "campaignId": 125143, "external_reference_id": "1480", "referral_email": "[email protected]", "referral_timestamp": 1781607304, "referring_email": "[email protected]", "review_period_over": true }
ReferralCandy - Verdiente Belohnung
Wird ausgelöst, wenn ein Befürworter eine Belohnung verdient, nachdem die Überprüfungsphase von ReferralCandy endet.Das Ereignis ist mit dem Kontakt des Anwalts verbunden.
Eigenschaft | Beschreibung |
| Die E-Mail-Adresse des Anwalts |
| Name des Befürworters |
| Belohnungstyp (z.B. |
| Menschenlesbare Belohnungsbeschreibung (z.B. "ein e450 Rabatt") |
| Der Belohnungsgutschein-Code |
| Ablaufdatum des Gutscheins (Unix-Zeitstempel) |
| Ob der Gutschein eingelöst wurde ( |
| Belohnungsstatus (z.B. |
| Wann die Belohnung verdient wurde (Unix-Zeitstempel) |
| Belohnungs-ID |
| Link zum zugrunde liegenden Shopify-Rabatt |
Beispielpayload:
{ "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" }Hinweis: Jedes Ereignis verwendet einen anderen Feldnamen für die E-Mail-Adresse des Anwalts. Beim Erstellen von Segmenten oder Workflows, die sich über mehrere Ereignisse erstrecken, verwenden Sie das richtige Feld für jedes Ereignis.
Ereignis | E-Mail-Feld des Anwalts |
Befürworter eingeschrieben |
|
Empfehlung abgeschlossen |
|
Verdiente Belohnung |
|
Die E-Mail des empfohlenen Freundes (referral_email) ist nur im Referral Completed Ereignis verfügbar.
Automatisierungs-Workflows erstellen
Sobald die Integration aktiv ist, verwenden Sie die benutzerdefinierten Ereignisse als Auslöser in den Omnisend Automatisierungs-Workflows:
Anwalt eingeschrieben 4E6; Senden Sie eine Willkommens-E-Mail, die erklärt, wie das Empfehlungsprogramm funktioniert und den Empfehlungslink des Anwalts teilt.
Referral Abgeschlossen Benachrichtigen Sie den Anwalt, dass der Kontakt, den sie geworben haben, gerade einen Kauf getätigt hat, um das Verhalten zu verstärken.
Belohnung verdient 4E6; E-Mail an den Anwalt mit seiner Belohnung. Die Ereignislast enthält den Gutscheincode (
coupon_code), die Beschreibung (beschreibung), und das Ablaufdatum (coupon_code_expiry_timestamp).
Sie können die Ereignisse auch für Die Segmentierung verwenden – zum Beispiel "Befürworter, die mindestens eine Belohnung verdient haben" oder "Befürworter ohne abgeschlossene Empfehlungen" für eine Wiederengagement-Kampagne.
Wichtige Informationen
Events sind nicht sofort. Die Integration fragt ReferralCandy alle 12 Stunden ab. Erwarten Sie, dass Ereignisse innerhalb von bis zu 12 Stunden nach dem Auftreten der Aktivität in ReferralCandy in Omnisend erscheinen.
Keine historische Nachfüllung. Das Aktivieren einer Automatisierung spielt frühere Empfehlungsaktivitäten nicht erneut ab. Nur Ereignisse, die nach der Aktivierung stattfinden, fließen in Omnisend.
Keine doppelten Ereignisse. Jeder Referral, jede Belohnung und jede Anmeldung eines Befürworters wird einmal an Omnisend gesendet. Die Integration verfolgt, was bereits synchronisiert wurde.
Keine Marketingeinwilligung. Kontakte, die durch diese Integration erstellt wurden, sind aufnicht abonniert standardmäßig. Sie werden keine Marketing-E-Mails oder SMS erhalten, bis sie sich über ein Omnisend Das Anmeldeformular anmelden.
Belohnungszeitpunkt. Das Ereignis "Verdiente Belohnung" wird nur ausgelöst, nachdem die Überprüfungsphase von ReferralCandy für die verlinkte Empfehlung endet. Das bedeutet, dass "Verdiente Belohnung" immer nach "Empfehlung abgeschlossen" für dieselbe Empfehlung ankommt.
Nur-Lesezugriff. Die Integration liest Daten von ReferralCandy. Sie schreibt nichts zurück an ReferralCandy.
Fehlerbehebung
Ein Ereignis wird nicht in Omnisend angezeigt
Überprüfen Sie in dieser Bestellung:
Hat ReferralCandy es aufgezeichnet? Gehe zuEinkäufe & Empfehlungen in Ihrem ReferralCandy-Konto und bestätigen Sie, dass die Empfehlung zugeordnet ist oder die Belohnung existiert. Wenn es nicht dort ist, liegt das Problem auf der Seite von ReferralCandy.
Wurde bereits eine Umfrage durchgeführt? Ereignisse erscheinen nach der nächsten 12-Stunden-Umfrage. Warte den gesamten Zeitraum ab, bevor du ein Problem annimmst.
Ist die Automatisierung aktiviert? Bestätigen Sie, dass die relevante Automatisierung in Omnisend aktiviert ist.
Sind die Anmeldeinformationen noch gültig? Wenn Ihre API-Zugangs-ID oder Ihr API-Geheimnis in ReferralCandy geändert wurde, aktualisieren Sie die Verbindung in Omnisend mit den neuen Anmeldeinformationen.
Die Belohnung ist nicht angekommen, aber die Empfehlung ist
Das ist zu erwarten. Die "Verdiente Belohnung" wird nur ausgelöst, nachdem die Überprüfungsphase von ReferralCandy für diese Empfehlung endet.Die Wartezeit zwischen "Überweisung abgeschlossen" und "Belohnung verdient" ist normal.
Häufig gestellte Fragen
Welchen Abonnementstatus erhalten neue Kontakte?
Durch diese Integration erstellte Kontakte sind standardmäßig auf nicht abonniert gesetzt.Sie werden keine Marketing-E-Mails oder SMS erhalten, bis sie sich über ein Omnisend Das Anmeldeformular anmelden.
Kann ich nur einige der drei Automatisierungen ausführen?
Ja. Jede Automatisierung ist unabhängig.Aktiviere nur die, die du benötigst, und lasse die anderen deaktiviert.
Kann ich die E-Mail des empfohlenen Freundes in einer Automatisierung verwenden?
Die E-Mail des empfohlenen Freundes (referral_email) ist in der Ereignislast von Referral Completed enthalten.Das Ereignis ist jedoch mit dem Kontakt des Anwalts verbunden – nicht mit dem des Freundes.Um den Freund direkt zu benachrichtigen, müssten Sie einen Kontakt für ihn separat erstellen.
Synchronisiert die Integration historische Referral-Daten?
Nein. Die einzige Aktivität, die nach der Aktivierung einer Automatisierung erfolgt, wird an Omnisend gesendet.Vergangene Empfehlungen und Belohnungen werden nicht nachträglich hinzugefügt.
Es gab eine Empfehlung in meinem Der Webshop, aber kein Ereignis ist in Omnisend angekommen. Was sollte ich überprüfen?
Überprüfe zuerst, ob ReferralCandy die Empfehlung einem Befürworter zugeordnet hat.Wenn die Betrugserkennung von ReferralCandy die Zuordnung blockiert hat (z.B. eine Selbstempfehlung), wird kein Ereignis an Omnisend gesendet – dieses Ergebnis wird vollständig innerhalb von ReferralCandy entschieden.
Kann ich diese Ereignisse in E-Mail-Kampagnen verwenden?
Diese Ereignisse sind als Auslöser für Automatisierungs-Workflows konzipiert.Um eine einmalige Kampagne zu senden, erstellen Sie ein Segment basierend auf dem benutzerdefinierten Ereignis (z. B. Kontakte, die das ReferralCandy - Belohnung Verdient Ereignis haben) und senden Sie eine Kampagne an dieses Segment.
Festgefahren oder unsicher, was als Nächstes zu tun ist? Kontaktiere unser Support-Team jederzeit über den In-App-Chat oder unter[email protected]. Für spezifische Fragen zu ReferralCandy kontaktieren SieReferralCandy-Support