Referral-Programm

Mit einem Referral-Programm lassen sich neue Nutzer gewinnen. Hierbei können bestehende Nutzer ihre Freunde über einen speziellen Link in den Web Shop einladen. Infolgedessen erhalten beide Nutzer (einladender und eingeladener Nutzer) Belohnungen, wodurch die Motivation steigt, den Web Shop weiterhin zu nutzen.

Influencer und Anführer eines Clans können per Referral-Programm den Web Shop bewerben, wodurch sie selbst und ihrer Abonnenten profitieren. Die eingeladenen Nutzer erhalten eine Belohnung für ihren ersten Kauf – dadurch steigt die Zahl der Nutzer, die den Web Shop aktiv nutzen.

• Gewährung eines oder mehrerer Artikel der folgenden Arten als Belohnung:
  • virtuelle Währung
  • virtueller Gegenstand
  • Bundle mit mehreren Artikeln
• Anpassung des Referral-Programm-Widgets
• Generierung von Referral-Links
• Eingeladener Nutzer kann vor dem ersten Kauf auf ein anderes Referral-Programm umschwenken

• Pro Projekt kann es nur ein Referral-Programm geben.
• Nutzer können sich nicht selbst einladen.

Ablauf für einladende Nutzer

1. Der einladende Nutzer ruft den Web Shop auf.
2. Der einladende Nutzer registriert sich auf der Website oder meldet sich an.
3. Der einladende Nutzer öffnet das Referral-Programm-Widget und liest die Programmbedingungen.
4. Der einladende Nutzer erhält den Referral-Link im Widget.
5. Der einladende Nutzer teilt den Link mit anderen Nutzern.
6. Der eingeladene Nutzer klickt auf den Link und erfüllt die Bedingungen des Programms.
7. Der einladende Nutzer öffnet das Referral-Programm-Widget und sichert sich die Belohnung, indem er auf die entsprechende Schaltfläche klickt.

Ablauf für eingeladene Nutzer

1. Der eingeladene Nutzer erhält einen Referral-Link mitsamt einer Beschreibung der Programmbedingungen und Belohnungen.
2. Der eingeladene Nutzer gelangt über den Referral-Link zum Web Shop.
3. Der eingeladene Nutzer registriert sich im Web Shop.
4. Der eingeladene Nutzer kauft etwas im Web Shop.
5. Der eingeladene Nutzer erhält die Belohnung.

Wie komme ich dazu

Referral-Programm erstellen

1. Öffnen Sie Ihr Projekt im Kundenportal.
2. Klicken Sie in der Seitenleiste auf Store.
3. Klicken Sie bei Live-ops and promotion tools auf:
   • Verknüpfen, sofern Sie noch keine Werbeaktionen oder Belohnungen eingerichtet haben.
   • Konfigurieren, sofern Sie das Modul zuvor bereits verknüpft haben.

4. Klicken Sie auf der Registerkarte Referral-Programm auf Referral-Programm erstellen.
5. Legen Sie die erforderlichen Parameter fest:
   • Namen für das Referral-Programm vergeben
   • Beschreibung eingeben

6. Klicken Sie auf Weiter.
7. Fügen Sie Belohnungen hinzu, die die einladenden und die eingeladenen Nutzer erhalten sollen:
   • Um eine Belohnung für den einladenden Nutzer hinzuzufügen, legen Sie im Abschnitt Belohnung für einladende Spieler die SKUs der Artikel und deren Menge fest.
   • Um eine Belohnung für die eingeladenen Nutzer hinzuzufügen, legen Sie im Abschnitt Belohnung für Eingeladene die SKUs der Artikel und deren Menge fest.

8. Klicken Sie auf Weiter.
9. Überprüfen Sie die Beschreibung des Referral-Programms, und klicken Sie auf Erstellen.

10. Aktivieren Sie den Schalter Referral-Programm, um das Referral-Programm zu aktivieren.

Nachdem das Referral-Programm eingerichtet ist, können Sie das Widget erstellen und anpassen.

Widget-Einrichtung

1. Klicken Sie auf der Seite des Referral-Programms auf Zum Editor.

2. Konfigurieren Sie die Widget-Komponenten für die einzelnen Zustände. Damit das Widget zum Design des Spiels und der Website passt, können Sie es anpassen und dabei Folgendes konfigurieren:
   • Elemente der Benutzeroberfläche
   • Farben der Elemente
   • Schaltfächentexte und Überschriften (auch für andere Sprachen)
   • Schriftart, ‑farbe und ‑größe

In den Widget-Einstellungen können Sie auch den Inhalt des FAQ-Blocks für das Referral-Programm an die Besonderheiten Ihres Spiels anpassen.

3. Richten Sie die Lokalisierung ein. Alle Widget-Texte sind in die Projektsprachen übersetzt, die im Kundenportel unter Projekteinstellungen > Allgemeine Einstellungen > Projektsprachen angegeben sind.
   Klicken Sie zweimal auf den Text und geben Sie Ihre eigene Übersetzung ein, um die Standardübersetzungen zu ändern.
4. Klicken Sie auf Veröffentlichen.
5. Kopieren Sie den Widget-Code aus dem geöffneten Fenster, und fügen Sie ihn auf Ihrer Website ein.

Nachdem Sie den Widget-Code auf der Website eingefügt haben, wird die Schaltfläche zum Öffnen des Widgets auf der Seite angezeigt:

Widget-Code Ihrer Website hinzufügen

1. Öffnen Sie Ihr Projekt im Kundenportal.
2. Klicken Sie in der Seitenleiste auf Site Builder.
3. Wählen Sie im Abschnitt Seiten die gewünschte Website aus, und klicken Sie auf Site Builder öffnen.
4. Klicken Sie auf Block hinzufügen.
5. Wählen Sie den Block Benutzerdefinierter Code aus.
6. Fügen Sie den Code des Referral-Programm-Widgets ein.

Autorisierung einrichten

Wenn Sie Ihre eigene Website-Oberfläche verwenden, müssen Sie die Benutzerautorisierung im Widget implementieren.

Die Autorisierung im Widget erfolgt über die Autorisierung auf der Website, in die das Widget eingebettet ist.

Es gibt zwei Szenarien, je nachdem, wo sich der Nutzer autorisiert – auf der Website oder im Widget:

• Wenn sich der Nutzer auf der Website autorisiert, müssen Sie den Autorisierungstoken des Nutzers mit der Methode onTokenChange() an das Widget übermitteln. Wenn sich der Nutzer beim System abmeldet, müssen Sie null als Methodenparameter übermitteln.

• Wenn sich der Nutzer über das Widget autorisiert, ruft das Widget die Funktion requestAuth auf, die während der Initialisierung übermittelt wurde. Als Antwort sollte die Website den Autorisierungstoken des Nutzers zurückgeben.

window.XESApi.init({
requestAuth: requestAuth,
token: getToken()
})

Die Widget-API bietet eine Reihe von Funktionen und Methoden zur Authentifizierung eines Nutzers im Widget:

So nehmen Sie Änderungen vor

Änderungen an den Einstellungen des Referral-Programms vornehmen

• Die Liste der als Belohnung vergebenen Artikel ist änderbar
• Beschreibungen sind änderbar

1. Wechseln Sie zum erstellten Referral-Programm.
2. Klicken Sie auf Bearbeiten.

3. Aktualisieren Sie den Text oder die Artikel-SKUs.
4. Klicken Sie auf Speichern.

Nachdem Sie die Änderungen gespeichert haben, werden den Nutzern die aktualisierten Programmbedingungen angezeigt, und sie erhalten fortan die neuen Belohnungen.

Belohnungen, die Nutzer bereits vor der Aktualisierung der Bedingungen erhalten haben, sind davon nicht betroffen.

Das Widget muss nach der Aktualisierung der Bedingungen nicht erneut veröffentlicht werden.

Änderungen an den Widget-Einstellungen vornehmen

1. Wechseln Sie in die Widget-Einstellungen.
2. Nehmen Sie die gewünschten Änderungen vor.
3. Klicken Sie auf Veröffentlichen.

Widget-Zustände

Das Referral-Programm-Widget kann verschiedene Zustände annehmen, je nach Art des Nutzers (einladender oder eingeladener Nutzer), dem Autorisierungsstatus des Nutzers und je nachdem, ob der Nutzer die Programmbedingungen erfüllt hat oder nicht.

Zu den Widget-Komponenten zählen Benutzeroberflächen-Elemente für verschiedene Zustände. Sie können die Komponenten beim Einrichten des Widgets konfigurieren.

Schaltfläche zum Öffnen des Widgets:

Zustand	Beschreibung	Wem es angezeigt wird	Editierbare Komponenten	Bild
Details anzeigen	Dient dazu, den Nutzer zur Teilnahme an dem Programm zu ermuntern.	Autorisierte Nutzer, die noch nicht an dem Programm teilnehmen.	Hintergrund- und Textfarbe. Text der Schaltfläche zum Öffnen des Widgets sowie Text der Schaltfläche zum Anzeigen von Details.
Warten auf Autorisierung	Dient dazu, den Nutzer zu ermuntern, sich über das Widget anzumelden.	Nicht autorisierte Nutzer, die auf den Referral-Link geklickt haben.	Hintergrund- und Textfarbe. Schaltflächentexte.
Warten auf den ersten Kauf	Dient dazu, den Nutzer zum Kauf zu animieren.	Nutzer, die auf den Referral-Link geklickt und sich auf der Website angemeldet haben.	Hintergrund- und Textfarbe. Schaltflächentexte.
Belohnung sichern	Dient dazu, den Nutzer zu ermuntern, sich die Belohnung zu sichern.	Einladende Nutzer, deren Freunde die Programmbedingungen erfüllt haben.	Hintergrund- und Textfarbe. Schaltflächentexte.
Widget schließen	Das Widget ist geöffnet, die Schaltfläche hat sich in ein ×-Symbol verwandelt.	Autorisierte Nutzer, die die Details des Widgets geöffnet haben.	Hintergrund- und Textfarbe. Schaltflächenfarbe.
Standard	Das Widget ist geschlossen.	Nutzer, die das Widget geschlossen haben.	Hintergrund- und Textfarbe. Schaltflächentext.

Widget-Seite für den einladenen Nutzer:

Beschreibung	Wem es angezeigt wird	Editierbare Komponenten	Bild
Details des Referral-Programms. Schaltfläche zum Senden des Referral-Links. Liste der Belohnungen samt Status: Gesichert – die Belohnung für das Einladen eines Nutzers wurde erhalten. In Bearbeitung – der eingeladene Nutzer hat sich bei der Website angemeldet, aber noch nichts gekauft. Sichern – der eingeladene Nutzer hat sich bei der Website angemeldet und etwas gekauft. Der einladende Nutzer kann sich die Belohnung sichern.	Ein autorisierter einladender Nutzer, dessen Freund auf den Referral-Link geklickt und sich auf der Website angemeldet hat.	Hintergrund- und Textfarbe. Widget- und Schaltflächentext.
Abschnitt “Häufig gestellte Fragen”	Ein autorisierter einladender Nutzer, der auf die Schaltfläche für die Programminformationen geklickt hat.	Hinzufügen und Entfernen von Blöcken mit Fragen. Hintergrund- und Textfarbe. Fragen- und Antworttexte.

Widget-Seite für den eingeladenen Nutzer:

Beschreibung	Wem es angezeigt wird	Editierbare Komponenten	Bild
Der Widget-Text ermutigt dazu, etwas auf der Website zu kaufen. Nach dem Kauf wird dem Nutzer eine Benachrichtigung über den Erhalt eines Bonus angezeigt.	Nutzer, die auf den Referral-Link geklickt und sich angemeldet haben.	Hintergrund- und Textfarbe. Widget- und Schaltflächentext.