Referral-Programm

So funktioniert's

Ein Referral-Programm ist ein Tool zur Gewinnung neuer Nutzer, bei dem bestehende Nutzer andere über einen Referral-Link einladen. Das Programm kann auf einer Website oder in ein Spiel integriert werden. Alle, die mitmachen, erhalten in der Folge Belohnungen:

• Der eingeladene Nutzer erhält nur dann eine Belohnung, nachdem er erstmalig etwas gekauft hat.
• Der einladende Nutzer erhält eine Belohnung für jeden eingeladenen Nutzer, der etwas im Shop kauft.

• Websites, einschließlich solcher, die mit Xsolla Site Builder erstellt wurden
• Spiele

Unabhängig davon, wo das Referral-Programm integriert ist (auf einer Website oder in einem Spiel), bleiben die Mechanismen und Belohnungsbedingungen unverändert.

Referral-Programme lassen sich für die folgenden Szenarien konfigurieren:

• Verkauf von Ingame-Items: virtuelle Gegenstände, virtuelle Währungspakete und Bundles
• Verkauf von Spielen und DLCs über Spielschlüssel

• Gewährung eines oder mehrerer Artikel der folgenden Arten als Belohnung:
  • virtuelle Währung
  • virtueller Gegenstand
  • Bundle mit mehreren Artikeln
• Referral-Programm-Widget ist anpassbar
• Referral-Links lassen sich generieren
• Nutzer hat die Möglichkeit, das Referral-Programm vor dem erstmaligen Kauf zu ändern

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

Ablauf für den Nutzer

Ablauf für einladende Nutzer

1. Der Nutzer meldet sich auf der Website oder im Spiel an oder er registriert sich.
2. Der Nutzer öffnet das Referral-Programm-Widget und liest die Programmbedingungen.
3. Der Nutzer erhält den Referral-Link im Widget.
4. Der Nutzer teilt den Referral-Link mit einem anderen Nutzer.
5. Der Nutzer öffnet das Referral-Programm-Widget und erhält eine Belohnung, sofern der eingeladene Nutzer auf den Referral-Link geklickt und die Programmbedingungen erfüllt hat.

Ablauf für eingeladene Nutzer

1. Der Nutzer erhält einen Referral-Link mitsamt einer Beschreibung der Programmbedingungen und Belohnungen.
2. Der Nutzer klickt auf den Referral-Link.
3. Der Nutzer registriert sich auf der Website oder im Spiel.
4. Der Nutzer kauft erstmalig etwas.
5. Der Nutzer erhält die Belohnung.

Einrichtung

Referral-Programm erstellen

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt LiveOps > Referral-Programm.

2. Klicken Sie auf Referral-Programm erstellen.
3. Legen Sie die erforderlichen Parameter fest:
   • Vergeben Sie einen Namen für das Referral-Programm.
   • Geben Sie eine Beschreibung ein.

4. Klicken Sie auf Weiter.
5. Fügen Sie die Belohnungen hinzu, die die Nutzer erhalten werden:

• Geben Sie unter Belohnung für einladende Spieler die Artikel-SKUs und deren Menge an, die der einladende Nutzer erhalten soll.

• Geben Sie unter Belohnung für Eingeladene die Artikel-SKUs und deren Menge an, die die eingeladenen Nutzer erhalten sollen.

6. Klicken Sie auf Weiter.
7. Überprüfen Sie die Einstellungen des Referral-Programms, und klicken Sie auf Erstellen.

Referral-Programm bearbeiten

Sie können Änderungen an aktiven Referral-Programms vornehmen:

• die Liste der Artikel, die als Belohnung vergeben werden, lässt sich ändern
• die Bedingungen lassen sich ändern

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

3. Aktualisieren Sie den Text und/oder die Artikelliste.
4. Klicken Sie auf Weiter.
5. Überprüfen Sie die Einstellungen des Referral-Programms, und klicken Sie auf Erstellen.

Das bearbeitete Referral-Programm ist standardmäßig aktiviert und wird im Abschnitt Referral-Programm angezeigt. Nachdem Sie die Änderungen gespeichert haben, werden den Nutzern die aktualisierten Programmbedingungen angezeigt und sie erhalten 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.

Anzeige

Das Referral-Programm wird in einem Widget angezeigt. Platzieren Sie das Widget auf Ihrer Website oder integrieren Sie es in Ihr Spiel, damit Nutzer die Programmbedingungen einsehen und am Programm teilnehmen können.

Widget einrichten

1. Klicken Sie auf der Seite des erstellten 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:
   • UI-Elemente
   • Farben der UI-Elemente
   • Schaltflächentexte und Überschriften (auch für andere Sprachen)
   • Schriftart, ‑farbe und ‑größe

3. Richten Sie die Lokalisierung ein. Alle Widget-Texte sind in die Projektsprachen übersetzt, die im Kundenportal 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. Änderungen veröffentlichen
5. Kopieren Sie den Widget-Code aus dem geöffneten Fenster, und fügen Sie ihn auf Ihrer Website ein.

Nach der Veröffentlichung des Widgets können Sie jederzeit zu den Widget-Einstellungen zurückkehren und Änderungen vornehmen. Damit die Änderungen übernommen werden, müssen Sie das Widget erneut veröffentlichen.

In Xsolla Site Builder den Widget-Code auf Ihrer Website integrieren

Wenn Sie eine eigene Website-Oberfläche implementieren, müssen Sie den Widget-Code in den Code Ihrer Website einfügen. Wenn Sie Xsolla Site Builder verwenden, befolgen Sie die folgenden Schritte, um ein Referral-Programm-Widget Ihrer Website hinzuzufügen:

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Storefronts > Websites.
2. Wählen Sie im Abschnitt Seiten die gewünschte Website aus, und klicken Sie auf Site Builder öffnen.
3. Klicken Sie auf Block hinzufügen.
4. Wählen Sie den Block Benutzerdefinierter Code aus.
5. Fügen Sie den Code des Referral-Programm-Widgets ein.
6. Damit die Änderungen wirksam werden, müssen Sie die Website veröffentlichen:

1. 1. Klicken Sie oben rechts im Site Builder auf Veröffentlichen.

1. 2. Aktivieren Sie die Kontrollkästchen neben den Seiten, die Sie veröffentlichen möchten.

1. 3. Bestätigen Sie, dass die Website zur Veröffentlichung bereit ist, und klicken Sie auf Veröffentlichen.

In das Spiel oder auf Ihrer eigenen Website integrieren

Um das Referral-Programm in ein Spiel oder auf einer Website zu integrieren, die nicht mit Xsolla Site Builder erstellt wurden, gehen Sie bitte wie folgt vor:

1. Implementieren Sie die Benutzerauthentifizierung in Ihrem System. Die Authentifizierung der Nutzer im Referral-Programm-Widget erfolgt durch Authentifizierung auf der Website, in die das Widget eingebettet ist. Es gibt zwei Szenarien bei der Benutzerauthentifizierung – auf der Website oder im Widget:

1. • Wenn sich der Nutzer auf der Website anmeldet, 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.

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent' }}}%%
sequenceDiagram
    participant User as Nutzer
    participant WebShop as Web Shop
    participant Widget as Widget
    User ->> WebShop: Anmeldung
    activate WebShop
    WebShop ->> Widget: Benachrichtigung mit Token
    deactivate WebShop

1. • Wenn sich der Nutzer über das Widget anmeldet, ruft das Widget die Funktion requestAuth auf, die dem Widget bei der Initialisierung übermittelt wurde. Als Antwort sollte die Website den Autorisierungstoken des Nutzers zurückgeben.

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent' }}}%%
sequenceDiagram
    participant User as Nutzer
    participant WebShop as Web Shop
    participant Widget as Widget
    User ->> Widget: Anmeldung
    activate Widget
    Widget ->> WebShop: Login-Anfrage
    deactivate Widget
    activate WebShop
    WebShop ->> Widget: Token
    deactivate WebShop

Beispielcode für die Initialisierung des Widgets:

1window.XESApi.init({
2requestAuth: requestAuth,
3token: getToken()
4})

2. Stellen Sie sicher, dass die Referral-Daten korrekt übermittelt werden.
3. Betten Sie den Code des Referral-Programm-Widgets in die Benutzeroberfläche des Spiels oder der Website ein.

Widget API

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

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 UI-Elemente für die verschiedenen 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 offen, die Schaltfläche erscheint als ×-Symbol.	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.
FAQ-Abschnitt	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.