So richten Sie ein Programm mit Creator Tags ein

So funktioniert's

Creator Tags sind individuelle Codes, die ein Spieler erhalten kann, wenn er Streams bzw. sonstige Formate auf YouTube, Twitch oder anderen Diensten ansieht. Ein Spieler (Unterstützer) kann diesen Tag bei Ingame-Käufen verwenden, um seinen Lieblings-Influencer zu unterstützen. Die Lösung ermöglicht es Ihnen, das Vertrauen von Influencern zu gewinnen, eine Beziehung zu ihnen aufzubauen und Ihre Einnahmen durch 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, in dem der Influencer seinen Code freigegeben hat. Influencern stehen folgende Dienste zur Auswahl:
    • 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. Influencer, deren Creator Tag beim Kauf zum Einsatz kam, erhalten einen Anteil dieser Einnahmen.

Note
Die Spieleplattform und das Zahlungssystem können eine zusätzliche Provision für Zahlungen erheben.

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 am@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 Influencer keine weitere Einnahmebeteiligung erhalten.
    • Liste der Influencer. Geben Sie für jeden Influencer dessen E-Mail-Adresse, Social-Media-Kanal und Creator Tag an. Beachten Sie bei der Auswahl der Influencer die folgenden Einschränkungen:
      • Nur Influencer ab 18 Jahren dürfen Gelder vom Guthaben abbuchen.
      • Xsolla kooperiert nicht mit Influencern, deren Bankkonten in Ländern registriert sind, die den US-Sanktionen unterliegen.

  1. 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.

  1. 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

Note
Es wird empfohlen, die Creator-Tag-Verbindung auf der Spieloberfläche zu implementieren, damit der Code automatisch bei jedem Kauf des Spielers angewendet wird.

  1. Senden Sie eine E-Mail an am@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).
  2. 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.

Note
Übermitteln Sie im Falle einer Erstattung eines Kaufs, der mithilfe des Creator Tags erfolgte, diese Information mit der Methode Transaktionen stornieren an Xsolla.

  1. Nehmen Sie neue Influencer ins Programm auf (optional).

Note
Wenn Sie Influencer über Xsolla ins Programm aufnehmen, laden Sie die Liste der Influencer regelmäßig mit der Methode Influencer mit Creator Tag abrufen hoch. Es wird empfohlen, die Daten einmal pro Tag zu übermitteln.

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

Influencer ins Programm aufnehmen

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

In Eigenregie

So nehmen Sie Influencer in Eigenregie in Ihr Programm auf:

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

Über Xsolla aufnehmen

Um einen Influencer über Xsolla ins Programm aufzunehmen, senden Sie eine E-Mail an influencer@xsolla.com, und geben Sie dabei den Social-Media-Kanal und das Creator Tag an, den Sie dem Influencer zuweisen möchten.

API-Methoden für die Arbeit mit Creator Tags

Influencer mit Creator-Tag abrufen

Zum Abrufen einer Liste der Influencer im Programm, die über Creator Tags verfügen.

ParameterTypBeschreibung
limit
integerAnzahl der Influencer in der Liste (standardmäßig: 20, maximal: 100).
offset
integerOffset-Wert für das Laden der Influencer-Liste (standardmäßig: 0).
Copy
Full screen
Small screen
Anfrage
GET https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/deals?limit=3&offset=0 HTTP/1.1
Antwort
{
  "items": [
    {
      "creator_tag": "creatorOne",
      "revenue_share_percent": 5
    },
    {
      "creator_tag": "creatorTwo",
      "revenue_share_percent": 10
    },
    {
      "creator_tag": "creatorThree",
      "revenue_share_percent": 50
    }
  ],
  "total_count": 32
}

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:

ParameterTypBeschreibung
creator_tag
stringIndividueller Code des Influencers im Rahmen des Programms. Erforderlich.
transaction_id
stringTransaktions-ID. Erforderlich.
transaction_currency
stringCode der Währung, mit der die Transaktion getätigt wurde. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217. Erforderlich.
transaction_value
numberTransaktionsbetrag. Erforderlich.
transaction_date
stringTransaktionsdatum im Format YYYY-MM-DD’T’HH:MM:SS. Erforderlich.
platform_id
stringPlattform, auf der die Transaktion stattfand. Erforderlich.
user_id
stringSpieler-ID. Erforderlich.
item_id
stringID des gekauften Artikels. Erforderlich.
item_name
stringName des gekauften Artikels. Erforderlich.
Copy
Full screen
Small screen
Anfrage
PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

[
  {
    "transaction_id": "123456789",
    "creator_tag": "creatorOne",
    "platform_id": "steam",
    "user_id": "0123456",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_1",
    "item_name": "hk416",
    "transaction_currency_code": "USD",
    "transaction_value": 5
  },
  {
    "transaction_id": "123456788",
    "creator_tag": "creatorOne",
    "platform_id": "steam",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_2",
    "item_name": "hk416",
    "transaction_currency_code": "EUR",
    "transaction_value": 10
  },
  {
    "transaction_id": "123456781",
    "creator_tag": "creatorOne",
    "platform_id": "xbox",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_1",
    "item_name": "hk416",
    "transaction_currency_code": "USD",
    "transaction_value": 3
  }
]

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:

ParameterTypBeschreibung
transaction_id
stringID der zu stornierenden Transaktion. Erforderlich.
refund_id
stringExternal ID der Zahlungserstattung.
reason
stringGrund für die Erstattung.
refund_date
stringErstattungsdatum im Format YYYY-MM-DD’T’HH:MM:SS. Erforderlich.
Copy
Full screen
Small screen
PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/refund HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

[
  {     
     "transaction_id": "123456781",
     "refund_id": "12331",
     "reason": "user_chargeback",
     "refund_date": "2020-04-10T06:06:24.830Z"
  },
  {     
     "transaction_id": "123456781",
     "refund_id": "12331",
     "reason": "user_chargeback",
     "refund_date": "2020-04-10T06:06:24.830Z"
  }
]

Statistiken anhand des Creator Tags senden

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

ParameterTypBeschreibung
date
stringÜbermittlungsdatum der Creator-Statistik im Format YYYY-MM-DD. Erforderlich.
creator_tag
stringIndividueller Code des Influencers im Rahmen des Programms. Erforderlich.
new_supporters
integerAnzahl der neuen Spieler, die das Creator Tag des Influencers genutzt haben. Erforderlich.
total_supporters
integerAnzahl aller Spieler, die das Creator Tag des Influencers genutzt haben. Erforderlich.
Copy
Full screen
Small screen
Anfrage
PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/supporters HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

[
  {
    "date": "2020-04-10",
    "creator_tag": "creatorOne",
    "new_supporters": 125,
    "total_supporters": 35900
  },
  {
    "date": "2020-04-10",
    "creator_tag": "creatorTwo",
    "new_supporters": 123,
    "total_supporters": 34567
  }
]

Creator Tag für Influencer erstellen

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

ParameterTypBeschreibung
creator_tag
stringIndividueller Code des Influencers im Rahmen des Programms. Erforderlich.
creator_email
stringE-Mail-Adresse des Influencers. Erforderlich.
creator_channels
array of stringsLink zum Social-Media-Kanal des Influencers. Mehrere Kanäle sind möglich. Erforderlich.
Copy
Full screen
Small screen
Anfrage
PUT https://influencer.xsolla.com/api/partner/v2/tags HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

{
  "creator_tag": "creatorOne",
  "creator_email": "influencer@example.com",
  "creator_channels": [
    "https://www.twitch.tv/creatorOne"
  ]
}

Influencer ins Programm aufnehmen

Zum Aufnehmen eines neuen Influencers ins Programm. Im Anfrage-Body wird ein Array mit den folgenden Objekten übermittelt:

ParameterTypBeschreibung
creator_tag
stringIndividueller Code des Influencers im Rahmen des Programms. Erforderlich.
revenue_share
integerProzentsatz der Einnahmen, den der Influencer für jeden Kauf erhält, bei dem sein Creator Tag zum Einsatz kam. Erforderlich.
Copy
Full screen
Small screen
Anfrage
PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/deals HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

{
  "creator_tag": "creatorOne",
  "revenue_share": 50
}

War dieser Artikel hilfreich?
Vielen Dank!
Gibt es etwas, das wir verbessern können? Nachricht
Das tut uns leid
Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
Diese Seite bewerten
Diese Seite bewerten
Gibt es etwas, das wir verbessern können?

Jetzt nicht

Vielen Dank für Ihr Feedback!
Letztmalig aktualisiert: 4. Mai 2021

Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

Problem melden
Wir überprüfen unsere Inhalte ständig. Ihr Feedback hilft uns, sie zu verbessern.
Geben Sie eine E-Mail-Adresse an, damit wir Sie erreichen können
Vielen Dank für Ihr Feedback!