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
- 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
- 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.
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:
- 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:
- Spielplattform:
- 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.
- 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.
- 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
Es wird empfohlen, die Creator-Tag-Verbindung auf der Spieloberfläche zu implementieren, damit der Code automatisch bei jedem Kauf des Spielers angewendet wird.
- 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).
- 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:
- Schicken Sie Ihre Käufe mithilfe der Methode Transaktionen erstellen regelmäßig an Xsolla. Es wird empfohlen, die Daten einmal pro Tag zu übermitteln.
Übermitteln Sie im Falle einer Erstattung eines Kaufs, der mithilfe des Creator Tags erfolgte, diese Information mit der Methode
Transaktionen stornieren an Xsolla.
- Nehmen Sie neue Influencer ins Programm auf (optional).
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.
- Ü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:
- Rufen Sie die Methoden Creator Tag für Influencer erstellen und Influencer ins Programm aufnehmen nacheinander auf.
- 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.
Parameter | Typ | Beschreibung |
---|
limit | integer | Anzahl der Influencer in der Liste (standardmäßig: 20 , maximal: 100 ). |
offset | integer | Offset-Wert für das Laden der Influencer-Liste (standardmäßig: 0 ). |
GET https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/deals?limit=3&offset=0 HTTP/1.1
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:
Parameter | Typ | Beschreibung |
---|
creator_tag | string | Individueller Code des Influencers im Rahmen des Programms. Erforderlich. |
transaction_id | string | Transaktions-ID. Erforderlich. |
transaction_currency | string | Code der Währung, mit der die Transaktion getätigt wurde. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217. Erforderlich. |
transaction_value | number | Transaktionsbetrag. Erforderlich. |
transaction_date | string | Transaktionsdatum im Format YYYY-MM-DD’T’HH:MM:SS . Erforderlich. |
| string | Plattform, auf der die Transaktion stattfand. Erforderlich. |
user_id | string | Spieler-ID. Erforderlich. |
item_id | string | ID des gekauften Artikels. Erforderlich. |
item_name | string | Name des gekauften Artikels. Erforderlich. |
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:
Parameter | Typ | Beschreibung |
---|
transaction_id | string | ID der zu stornierenden Transaktion. Erforderlich. |
refund_id | string | External ID der Zahlungserstattung. |
reason | string | Grund für die Erstattung. |
refund_date | string | Erstattungsdatum im Format YYYY-MM-DD’T’HH:MM:SS . Erforderlich. |
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
}
]
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:
Parameter | Typ | Beschreibung |
---|
date | string | Übermittlungsdatum der Creator-Statistik im Format YYYY-MM-DD . Erforderlich. |
creator_tag | string | Individueller Code des Influencers im Rahmen des Programms. Erforderlich. |
new_supporters | integer | Anzahl der neuen Spieler, die das Creator Tag des Influencers genutzt haben. Erforderlich. |
total_supporters | integer | Anzahl aller Spieler, die das Creator Tag des Influencers genutzt haben. Erforderlich. |
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:
Parameter | Typ | Beschreibung |
---|
creator_tag | string | Individueller Code des Influencers im Rahmen des Programms. Erforderlich. |
creator_email | string | E-Mail-Adresse des Influencers. Erforderlich. |
creator_channels | array of strings | Link zum Social-Media-Kanal des Influencers. Mehrere Kanäle sind möglich. Erforderlich. |
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:
Parameter | Typ | Beschreibung |
---|
creator_tag | string | Individueller Code des Influencers im Rahmen des Programms. Erforderlich. |
revenue_share | integer | Prozentsatz der Einnahmen, den der Influencer für jeden Kauf erhält, bei dem sein Creator Tag zum Einsatz kam. Erforderlich. |
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"
]
}
Letztmalig aktualisiert:
22. Januar 2024Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.