So richten Sie ein Programm mit Creator Tags ein

So funktioniert's

Creator Tags sind individuelle Codes, die einem Spieler beim Ansehen von Streams bzw. sonstigen Formaten auf YouTube, Twitch oder anderen Diensten angezeigt werden kann. Ein Spieler (Unterstützer) kann diesen Tag bei Ingame-Käufen angeben, um seinen Lieblings-Creator zu unterstützen. Die Lösung ermöglicht es Ihnen, das Vertrauen von Creatorn zu gewinnen, eine Beziehung zu ihnen aufzubauen und Ihre Einnahmen durch die Zuordnung (Tracking) aller Ingame-Käufe zu erhöhen.

Ablauf für Spieler

1. Der Spieler kopiert das Creator Tag oder klickt auf den Link, um den Creator Tag mit dem Dienst zu verknüpfen, bei dem der Creator seinen Code freigegeben hat. Die Creator können aus folgenden Diensten wählen:
   • Twitch
   • YouTube
   • Facebook Gaming
   • sonstige soziale Netzwerke
2. Der Spieler gibt das Creator Tag in das Feld auf der Seite ein, auf der Sie die Creator-Tag-Verbindung implementiert haben. Wenn der Spieler auf den Link klickt, wird das Creator Tag automatisch angewendet.

Monetarisierung

Sie erhalten Einnahmen aus allen Ingame-Käufen. Creator, deren Creator Tag beim Kauf zum Einsatz kam, erhalten einen Anteil dieser Einnahmen.

Für wen ist es

Partner mit einem Spiel, bei dem:

• die voraussichtlichen Monatseinnahmen mindestens 20.000 USD betragen
• Waren nur im Spiel zum Kauf angeboten werden

Wie komme ich dazu

Programm mit Creator Tag einrichten

So richten Sie ein Programm mit einem Creator Tag ein:

1. Senden Sie einen Antrag an csm@xsolla.com (oder an bizdev@xsolla.com, wenn Sie zum ersten Mal ein Xsolla-Produkt integrieren), und warten Sie, bis dieser bearbeitet wurde. Geben Sie im Antrag die folgenden Informationen an:
   • Spielname.
   • Genre.
   • Entwickler (optional).
   • Publisher (optional).
   • Offizielle Website des Spiels.
   • Spielbeschreibung.
   • Steam-App-ID (optional).
   • Release-Termin, falls das Spiel noch nicht veröffentlicht ist (optional).
   • Link zu Werbematerialien (optional).
   • Geschäftsmodell:
     • Premium
     • Free-to-play
   • Spielplattform:
     • PC
     • Steam
     • Mobile
     • Web
   • Programm-Teilnahmezeitraum.
   • Prozentsatz der Einnahmebeteiligung.
   • Enddatum der Einnahmebeteiligung. Der Tag, ab dem teilnehmende Creator keine weitere Einnahmebeteiligung erhalten.
   • Liste der Creator. Geben Sie für jeden Creator dessen E-Mail-Adresse, Social-Media-Kanal und Creator Tag an. Beachten Sie bei der Auswahl der Creator die folgenden Einschränkungen:
     • Nur Creator ab 18 Jahren dürfen Gelder vom Guthaben abbuchen.
     • Xsolla kooperiert nicht mit Creatorn, deren Bankkonten in Ländern registriert sind, die US-Sanktionen unterliegen.

2. Implementieren Sie den Creator-Tag-Verbindungsmechanismus für Spieler auf eine der folgenden Arten:
   • Durch Klick auf den Link. In diesem Fall wird der Creator-Tag-Wert automatisch in das entsprechende Eingabefeld geladen.
   • Durch manuelle Eingabe.

3. Legen Sie fest, wo die Eingabe des Creator Tags erfolgen soll:
   • auf der Benutzeroberfläche des Spiels
   • auf der Website des Spiels
   • im Zahlungsportal, wenn der Spieler für einen Kauf bezahlt

4. Senden Sie eine E-Mail an csm@xsolla.com mit dem Link zu der Seite, mit der das Creator Tag verbunden ist (sofern der Mechanismus auf der Benutzeroberfläche oder Website des Spiels implementiert ist).
5. Implementieren Sie im Spiel Mechanismen für das Verknüpfen des Creator Tags mit den von Unterstützern getätigten Käufen und für das Tracken dieser Käufe.

Programme mit Creator Tags verwalten

So verwalten Sie Programme mit Creator Tags auf effektive Weise:

1. Schicken Sie Ihre Käufe mithilfe der Methode Transaktionen erstellen regelmäßig an Xsolla. Es wird empfohlen, die Daten einmal pro Tag zu übermitteln.

2. Nehmen Sie neue Creator ins Programm auf (optional).

3. Übermitteln Sie mithilfe der Methode Statistiken anhand des Creator Tags senden die Unterstützerstatistikdaten an Xsolla (optional).

Creator ins Programm aufnehmen

Sie können Creator auf eine der folgenden Arten in Ihr Programm aufnehmen:

• in Eigenregie
• über Xsolla

In Eigenregie

1. Rufen Sie die Methoden Creator Tag für Creator erstellen und Creator ins Programm aufnehmen nacheinander auf.
2. Um einen Creator zum Programm einzuladen, senden Sie eine E-Mail an influencer@xsolla.com samt E-Mail-Adresse, Social-Media-Kanal und Creator Tag des Creators, die in der Methode Creator Tag für Creator erstellen angegeben wurden.

Über Xsolla aufnehmen

API-Methoden für die Arbeit mit Creator Tags

Creator mit Creator-Tag abrufen

Zum Abrufen einer Liste der Creator im Programm, die ein Creator Tag haben.

Anfragebeispiel:

1GET https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/deals?limit=3&offset=0 HTTP/1.1

Antwortbeispiel:

 1{
 2  "items": [
 3    {
 4      "creator_tag": "creatorOne",
 5      "revenue_share_percent": 5
 6    },
 7    {
 8      "creator_tag": "creatorTwo",
 9      "revenue_share_percent": 10
10    },
11    {
12      "creator_tag": "creatorThree",
13      "revenue_share_percent": 50
14    }
15  ],
16  "total_count": 32
17}

Transaktionen erstellen

Zum Erstellen/Aktualisieren von Transaktionen, die im Zusammenhang mit dem Creator Tag erfolgten. Im Anfrage-Body wird ein Array mit den folgenden Objekten übermittelt:

Anfragebeispiel:

 1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1
 2
 3X-API-key: {YOUR_API_KEY}
 4Content-Type: application/json
 5
 6[
 7  {
 8    "transaction_id": "123456789",
 9    "creator_tag": "creatorOne",
10    "platform_id": "steam",
11    "user_id": "0123456",
12    "transaction_date": "2020-04-10T06:06:24.830Z",
13    "item_id": "GAME_sku_1",
14    "item_name": "hk416",
15    "transaction_currency_code": "USD",
16    "transaction_value": 5
17  },
18  {
19    "transaction_id": "123456788",
20    "creator_tag": "creatorOne",
21    "platform_id": "steam",
22    "transaction_date": "2020-04-10T06:06:24.830Z",
23    "item_id": "GAME_sku_2",
24    "item_name": "hk416",
25    "transaction_currency_code": "EUR",
26    "transaction_value": 10
27  },
28  {
29    "transaction_id": "123456781",
30    "creator_tag": "creatorOne",
31    "platform_id": "xbox",
32    "transaction_date": "2020-04-10T06:06:24.830Z",
33    "item_id": "GAME_sku_1",
34    "item_name": "hk416",
35    "transaction_currency_code": "USD",
36    "transaction_value": 3
37  }
38]

Transaktionen stornieren

Zum Stornieren von Transaktionen, die im Zusammenhang mit dem Creator Tag erfolgten. Im Anfrage-Body wird ein Array mit den folgenden Objekten übermittelt:

Anfragebeispiel:

 1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1
 2
 3X-API-key: {YOUR_API_KEY}
 4Content-Type: application/json
 5
 6[
 7  {
 8    "transaction_id": "123456789",
 9    "creator_tag": "creatorOne",
10    "platform_id": "steam",
11    "user_id": "0123456",
12    "transaction_date": "2020-04-10T06:06:24.830Z",
13    "item_id": "GAME_sku_1",
14    "item_name": "hk416",
15    "transaction_currency_code": "USD",
16    "transaction_value": 5
17  },
18  {
19    "transaction_id": "123456788",
20    "creator_tag": "creatorOne",
21    "platform_id": "steam",
22    "transaction_date": "2020-04-10T06:06:24.830Z",
23    "item_id": "GAME_sku_2",
24    "item_name": "hk416",
25    "transaction_currency_code": "EUR",
26    "transaction_value": 10
27  },
28  {
29    "transaction_id": "123456781",
30    "creator_tag": "creatorOne",
31    "platform_id": "xbox",
32    "transaction_date": "2020-04-10T06:06:24.830Z",
33    "item_id": "GAME_sku_1",
34    "item_name": "hk416",
35    "transaction_currency_code": "USD",
36    "transaction_value": 3
37  }
38]

Statistiken anhand des Creator Tags senden

Zum Senden von Statistiken über die Creator-Tag-Verbindungen des Creators (in Tagen). Diese Informationen werden im Bereich Statistik im Creator-Konto veröffentlicht. Im Anfragerumpf wird ein Array mit den folgenden Objekten übermittelt:

Anfragebeispiel:

 1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/supporters HTTP/1.1
 2
 3X-API-key: {YOUR_API_KEY}
 4Content-Type: application/json
 5
 6[
 7  {
 8    "date": "2020-04-10",
 9    "creator_tag": "creatorOne",
10    "new_supporters": 125,
11    "total_supporters": 35900
12  },
13  {
14    "date": "2020-04-10",
15    "creator_tag": "creatorTwo",
16    "new_supporters": 123,
17    "total_supporters": 34567
18  }
19]

Creator Tag für Creator erstellen

Zum Erstellen von Creator Tags für neue Creator im Programm. Im Anfragerumpf wird ein Array mit den folgenden Objekten übermittelt:

Anfragebeispiel:

 1PUT https://influencer.xsolla.com/api/partner/v2/tags HTTP/1.1
 2
 3X-API-key: {YOUR_API_KEY}
 4Content-Type: application/json
 5
 6{
 7  "creator_tag": "creatorOne",
 8  "creator_email": "influencer@example.com",
 9  "creator_channels": [
10    "https://www.twitch.tv/creatorOne"
11  ]
12}

Creator ins Programm aufnehmen

Zum Aufnehmen eines neuen Creators ins Programm. Im Anfragerumpf wird ein Array mit den folgenden Objekten übermittelt:

Anfragebeispiel:

1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/deals HTTP/1.1
2X-API-key: {YOUR_API_KEY}
3
4Content-Type: application/json
5
6{
7  "creator_tag": "creatorOne",
8  "revenue_share": 30
9}