Werbekampagnen einrichten
Nachdem Sie den Shop in das Spiel integriert haben, können Sie Gutschein-, Promocode-, Boni- oder Rabattaktionen einrichten, um neue Spieler zu gewinnen und den Umsatz anzukurbeln.
Sie können auch personalisierte Werbeaktionen starten, d. h. Kampagnen für bestimmte Benutzer einrichten. Sie können festlegen, wie viele Artikel der Benutzer im Rahmen der Werbeaktion erhalten kann. Das ist nur für Rabatt- und Bonusaktionen möglich.
Wenn Sie sie bereits mit dem Login-Produkt integriert haben, gehen Sie wie folgt vor, bevor Sie personalisierte Werbeaktionen für Benutzer einrichten:
- Richten Sie Attribute für Ihr Projekt ein.
- Legen Sie das Benutzerattribut-Shema im Abschnitt “Login” fest.
Attribute sind Benutzerfunktionen, die als Schlüsselwert-Paare gespeichert werden. Mithilfe der Attribute können Sie:
- Benutzer segmentieren
- Sie können persönliche Shopstartseiten für jede Benutzergruppe in Ihrem Online-Shop vorbereiten.
Um die Integrität der übermittelten Daten sicherzustellen, können Sie im Kundenportal die Attributvalidierungsregeln im Format JSON-Shema einrichten und die Benutzerattribute mithilfe der Login-API-Methoden oder Webhooks verwalten. Sie können in Ihrem Kundenportal die Attributwerte bearbeiten. Weitere Informationen finden Sie unter So werden Benutzerattribute eingerichtet.
Gutscheine sind Codes, die kostenlose Artikel gewähren. Der Benutzer muss den Code im Spiel, auf der Website oder in der mobilen App eingeben. Daraufhin erscheint die mit dem Gutschein verknüpfte Belohnung im Inventar des Benutzers. Mögliche Belohnungen:
Weitere Informationen finden Sie unter Gutscheine.Promocodes gewähren einen Rabatt auf den Warenkorb oder fügen dem Warenkorb beim Bezahlen kostenlose Artikel hinzu. Nach Aktivierung des Promocodes und Bezahlung der im Warenkorb befindlichen Artikel kann der Benutzer eine der folgenden Belohnungen erhalten:
- Rabatt auf den Warenkorb des Benutzers
- Bonusartikel:
- virtuelles Währungspaket
- virtueller Gegenstand, einschließlich Bundle oder zeitlich begrenzte Artikel
Auch beim Kauf von Aktionsartikeln können die Benutzer einen Bonus erhalten. Mögliche Boni:
- virtuelles Währungspaket
- virtueller Gegenstand, einschließlich Bundle oder zeitlich begrenzte Artikel
Rabattaktionen ermöglichen es, ein oder mehrere Produkte ermäßigt anzubieten. Es sind beliebig viele Werbeaktionen für ein Produkt zulässig. Rabatte werden nicht addiert, sondern auf den Preis eines einzelnen Artikels gewährt. Rabatte können auf einen oder mehrere der folgenden Artikel gewährt werden:
- virtuelles Währungspaket
- virtueller Gegenstand, einschließlich zeitlich begrenzte Artikel
Gutscheinkampagne
So starten Sie eine Gutscheinkampagne:
- Richten Sie eine Gutscheinkampagne ein.
- Nutzen Sie die Methoden für die Einlösung von Gutscheinen per Code.
- Nutzen Sie die Methoden für das Abrufen einer Gutscheinbelohnung.
Gutscheinkampagne einrichten
- Öffnen Sie Ihr Projekt im Kundenportal.
- Klicken Sie in der Seitenleiste auf Store und dann auf Werbeaktionen und Belohungen.
- Klicken Sie auf Werbeaktion anlegen.
- Legen Sie die folgenden Parameter fest:
- Benennen Sie die Werbeaktion.
- Wählen Sie als Werbeaktionsart die Option Gutscheine aus.
- Wählen Sie die Belohnung aus, die der Benutzer beim Einlösen eines Gutscheins erhält. Verfügbare Optionen:
- Virtuelles Währungspaket
- Virtueller Gegenstand (einer oder mehrere, einschließlich Bundles und zeitlich begrenzte Artikel).
- Geben Sie Folgendes an:
- Kennung der Werbeaktion im Feld Externe ID.
- Bonusartikel, die der Benutzer beim Einlösen eines Gutscheins erhält.
- Artikeltyp und ‑menge.
- Klicken Sie auf Weiter.
- Legen Sie fest, wie oft der Gutschein insgesamt und pro Benutzer eingelöst werden kann.
- Legen Sie das Start- und Enddatum der Kampagne fest.
- Klicken Sie auf Weiter.
- Prüfen Sie die Einstellungen, und klicken Sie auf Speichern und beenden.
- Klicken Sie in der Seitenleiste auf Store und dann auf Werbeaktionen und Belohungen.
- Wählen Sie die Werbeaktion aus, klicken Sie auf die Schaltfläche •••, um das Menü zu öffnen, und dann auf Werbeaktion bearbeiten.
- Wechseln Sie zur Registerkarte Codes.
- Legen Sie fest, wie Gutscheine generiert werden sollen.
- Generieren Sie den Gutscheincode oder geben Sie ihn manuell ein.
- Aktivieren Sie die Werbeaktion.
Gutschein per Code einlösen
Implementieren Sie den Aufruf der Methode is_selectable
in der Antwort der Methode
- Ist
is_selectable=true
festgelegt, sollte das Objektselected_unit_items
im folgenden Format beim Aufruf der MethodeRedeem coupon code übermittelt werden:
- http
selected_unit_items:{
unit_1_sku: "selected_unit_item_sku",
unit_2_sku: "selected_unit_item_sku"
}
Beispielhafte Antwort:
- http
{
{
"items": [
{
"sku": "xsollus_gold_edition_steam",
"name": "Xsollus: Gold Edition (steam)",
"type": "game_key",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
"attributes": [],
"is_free": true,
"groups": [],
"price": null,
"virtual_prices": [],
"drm_name": "Steam",
"drm_sku": "steam",
"has_keys": false,
"is_pre_order": true,
"release_date": null,
"quantity": 1
},
{
"sku": "xsollus_bonus_pack_edition_origin",
"name": "Xsollus: Bonus Pack (origin)",
"type": "game_key",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
"attributes": [],
"is_free": true,
"groups": [],
"price": null,
"virtual_prices": [],
"drm_name": "Origin",
"drm_sku": "origin",
"has_keys": false,
"is_pre_order": true,
"release_date": null,
"quantity": 3
}
]
}
- Ist
is_selectable=false
festgelegt, sollte der zusätzliche Parameter in der Anfrage nicht übermittelt werden.
Gutscheinbelohnung abrufen
Implementieren Sie den Aufruf der Methode is_selectable
in der Antwort gibt es zwei mögliche Abläufe:
- Ist
is_selectable=true
festgelegt, sollte für jedesitem
mit dem Elementtype=unit
das Formular für die Auswahl von Elementen aus dem Objektunit_items
angezeigt werden. Darin können Benutzer nur ein Element prounit
-Typ wählen.
- http
{
"bonus": [{
"item": {
"sku": "xsollus_gold_edition",
"name": "Xsollus: Gold Edition",
"type": "unit",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
"unit_items": [{
"sku": "xsollus_gold_edition_steam",
"name": "Xsollus: Gold Edition (steam)",
"type": "game_key",
"drm_name": "Steam",
"drm_sku": "steam"
}, {
"sku": "xsollus_gold_edition_playstation",
"name": "Xsollus: Gold Edition (playstation)",
"type": "game_key",
"drm_name": "Playstation",
"drm_sku": "playstation"
}, {
"sku": "xsollus_gold_edition_xbox",
"name": "Xsollus: Gold Edition (xbox)",
"type": "game_key",
"drm_name": "XBox",
"drm_sku": "xbox"
}, {
"sku": "xsollus_gold_edition_rockstar",
"name": "Xsollus: Gold Edition (rockstar)",
"type": "game_key",
"drm_name": "Rockstar Games Launcher",
"drm_sku": "rockstar"
}]
},
"quantity": 1
}, {
"item": {
"sku": "xsollus_bonus_pack_edition",
"name": "Xsollus: Bonus Pack",
"type": "unit",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
"unit_items": [{
"sku": "xsollus_bonus_pack_edition_steam",
"name": "Xsollus: Bonus Pack (steam)",
"type": "game_key",
"drm_name": "Steam",
"drm_sku": "steam"
}, {
"sku": "xsollus_bonus_pack_edition_playstation",
"name": "Xsollus: Bonus Pack (playstation)",
"type": "game_key",
"drm_name": "Playstation",
"drm_sku": "playstation"
}, {
"sku": "xsollus_bonus_pack_edition_xbox",
"name": "Xsollus: Bonus Pack (xbox)",
"type": "game_key",
"drm_name": "XBox",
"drm_sku": "xbox"
}]
},
"quantity": 3
}],
"is_selectable": true
- Ist
is_selectable=false
festgelegt, sollte der zusätzliche Parameter in der Anfrage nicht übermittelt werden.
Promocodekampagne
So starten Sie eine Promocodekampagne:
- Richten Sie eine Promocodekampagne ein.
- Implementieren Sie die Methoden für die Einlösung von Promocodes.
- Implementieren Sie die Methode für den Abruf einer Promocodebelohnung.
Promocodekampagne einrichten
- Öffnen Sie Ihr Projekt im Kundenportal.
- Klicken Sie in der Seitenleiste auf Store und dann auf Werbeaktionen und Belohungen.
- Klicken Sie auf Werbeaktion anlegen.
- Legen Sie die folgenden Parameter fest:
- Benennen Sie die Werbeaktion.
- Wählen Sie als Werbeaktionsart die Option Promocode.
- Legen Sie fest, was der Benutzer erhält, wenn er einen Promocode einlöst: keine Belohnung, Rabatt auf alle Artikel im Warenkorb, Rabatt auf bestimmte Artikel, Bonusartikel oder eine Kombination der voran genannten Optionen.
- Legen Sie den Rabattbetrag fest.
- Klicken Sie auf Weiter.
- Legen Sie fest, wie oft der Promocode insgesamt und pro Benutzer eingelöst werden kann.
- Klicken Sie auf Weiter.
- Legen Sie das Start- und Enddatum der Kampagne fest.
- Klicken Sie auf Weiter.
- Prüfen Sie die Einstellungen, und klicken Sie auf Speichern und beenden.
- Klicken Sie in der Seitenleiste auf Store und dann auf Werbeaktionen und Belohungen.
- Wählen Sie die Werbeaktion aus, klicken Sie auf die Schaltfläche •••, um das Menü zu öffnen, und dann auf Werbeaktion bearbeiten.
- Wechseln Sie zur Registerkarte Codes.
- Legen Sie fest, wie Promocodes generiert werden sollen.
- Generieren Sie den Promocode oder geben Sie ihn manuell ein.
- Aktivieren Sie die Werbeaktion.
Promocode einlösen
Implementieren Sie den Aufruf der Methode is_selectable
in der Antwort der Methode
- Ist
is_selectable=true
festgelegt, sollte das Objektselected_unit_items
im folgenden Format beim Aufruf der MethodeRedeem promo code übermittelt werden:
- http
selected_unit_items:{
unit_1_sku: "selected_unit_item_sku",
unit_2_sku: "selected_unit_item_sku"
}
Beispielhafte Antwort:
- http
{
{
"items": [
{
"sku": "xsollus_gold_edition_steam",
"name": "Xsollus: Gold Edition (steam)",
"type": "game_key",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
"attributes": [],
"is_free": true,
"groups": [],
"price": null,
"virtual_prices": [],
"drm_name": "Steam",
"drm_sku": "steam",
"has_keys": false,
"is_pre_order": true,
"release_date": null,
"quantity": 1
},
{
"sku": "xsollus_bonus_pack_edition_origin",
"name": "Xsollus: Bonus Pack (origin)",
"type": "game_key",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
"attributes": [],
"is_free": true,
"groups": [],
"price": null,
"virtual_prices": [],
"drm_name": "Origin",
"drm_sku": "origin",
"has_keys": false,
"is_pre_order": true,
"release_date": null,
"quantity": 3
}
]
}
- Ist
is_selectable=false
festgelegt, sollte der zusätzliche Parameter in der Anfrage nicht übermittelt werden.
Promocodebelohnungen abrufen
Implementieren Sie den Aufruf der Methode is_selectable
in der Antwort gibt es zwei mögliche Abläufe:
- Ist
is_selectable=true
festgelegt, sollte für jedesitem
mit dem Elementtype=unit
das Formular für die Auswahl von Elementen aus dem Objektunit_items
angezeigt werden. Darin können Benutzer nur ein Element prounit
-Typ wählen.
- http
{
"bonus": [{
"item": {
"sku": "xsollus_gold_edition",
"name": "Xsollus: Gold Edition",
"type": "unit",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
"unit_items": [{
"sku": "xsollus_gold_edition_steam",
"name": "Xsollus: Gold Edition (steam)",
"type": "game_key",
"drm_name": "Steam",
"drm_sku": "steam"
}, {
"sku": "xsollus_gold_edition_playstation",
"name": "Xsollus: Gold Edition (playstation)",
"type": "game_key",
"drm_name": "Playstation",
"drm_sku": "playstation"
}, {
"sku": "xsollus_gold_edition_xbox",
"name": "Xsollus: Gold Edition (xbox)",
"type": "game_key",
"drm_name": "XBox",
"drm_sku": "xbox"
}, {
"sku": "xsollus_gold_edition_nintendo_eshop",
"name": "Xsollus: Gold Edition (nintendo_eshop)",
"type": "game_key",
"drm_name": "Nintendo Switch eShop",
"drm_sku": "nintendo_eshop"
}]
},
"quantity": 1
}, {
"item": {
"sku": "xsollus_bonus_pack_edition",
"name": "Xsollus: Bonus Pack",
"type": "unit",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
"unit_items": [{
"sku": "xsollus_bonus_pack_edition_steam",
"name": "Xsollus: Bonus Pack (steam)",
"type": "game_key",
"drm_name": "Steam",
"drm_sku": "steam"
}, {
"sku": "xsollus_bonus_pack_edition_origin",
"name": "Xsollus: Bonus Pack (origin)",
"type": "game_key",
"drm_name": "Origin",
"drm_sku": "origin"
}, {
"sku": "xsollus_bonus_pack_edition_drmfree",
"name": "Xsollus: Bonus Pack (drmfree)",
"type": "game_key",
"drm_name": "DRM Free",
"drm_sku": "drmfree"
}, {
"sku": "xsollus_bonus_pack_edition_gog",
"name": "Xsollus: Bonus Pack (gog)",
"type": "game_key",
"drm_name": "GOG",
"drm_sku": "gog"
}, {
"sku": "xsollus_bonus_pack_edition_rockstar",
"name": "Xsollus: Bonus Pack (rockstar)",
"type": "game_key",
"drm_name": "Rockstar Games Launcher",
"drm_sku": "rockstar"
}]
},
"quantity": 3
}],
"discount": {
"percent": null
},
"is_selectable": true
- Ist
is_selectable=false
festgelegt, sollte der zusätzliche Parameter in der Anfrage nicht übermittelt werden.
Bonuskampagne
So starten Sie eine Bonuskampagne:
- Öffnen Sie Ihr Projekt im Kundenportal.
- Klicken Sie in der Seitenleiste auf Store und dann auf Werbeaktionen und Belohungen.
- Klicken Sie auf Werbeaktion anlegen.
- Legen Sie die folgenden Parameter fest:
- Benennen Sie die Werbeaktion.
- Wählen Sie als Werbeaktionsart die Option Prämien.
- Wählen Sie Aktionsartikel.
- Wählen Sie Bonusartikel, die die Nutzer beim Kauf der Aktionsartikel erhalten.
- Klicken Sie auf Weiter.
- Sollen nur Erstkäufer die Werbeaktion in Anspruch nehmen dürfen, müssen Sie den Schalter Werbeaktion nur bei Erstkäufern auslösen auf Ein stellen. Die beiden anderen Schalter (Nutzungshäufigkeit der Werbeaktion pro Benutzer begrenzen und Werbeaktion nur bei bestimmten Benutzern auslösen) werden dadurch automatisch aktiviert, und die entsprechenden Bedingungen, bei der die Werbeaktion ausgelöst wird, werden festgelegt. Bei Bedarf können Sie weitere Bedingungen festlegen.
- Klicken Sie auf Weiter.
- Legen Sie das Start- und Enddatum der Kampagne fest.
- Klicken Sie auf Weiter.
- Prüfen Sie die Einstellungen, und klicken Sie auf Speichern und beenden.
- Klicken Sie in der Seitenleiste auf Store und dann auf Werbeaktionen und Belohungen.
- Wählen Sie die Werbeaktion aus, klicken Sie auf die Schaltfläche •••, um das Menü zu öffnen, und dann auf Werbeaktion bearbeiten.
- Aktivieren Sie die Werbeaktion.
Rabattkampagne
Rabattkampagne über das Kundenportal einrichten
So starten Sie eine Rabattkampagne:- Öffnen Sie Ihr Projekt im Kundenportal.
- Klicken Sie in der Seitenleiste auf Store.
- Klicken Sie auf Werbeaktionen und Belohnungen > Werbeaktion anlegen.
- Legen Sie die folgenden Parameter fest:
- Benennen Sie die Werbeaktion.
- Wählen Sie als Werbeaktionsart die Option Rabatt.
- Legen Sie Rabatte für einen oder mehrere Artikel fest.
- Legen Sie den Rabattbetrag fest.
- Klicken Sie auf Weiter.
- Sollen nur Erstkäufer die Werbeaktion in Anspruch nehmen dürfen, müssen Sie den Schalter Werbeaktion nur bei Erstkäufern auslösen auf Ein stellen. Die beiden anderen Schalter (Nutzungshäufigkeit der Werbeaktion pro Benutzer begrenzen und Werbeaktion nur bei bestimmten Benutzern auslösen) werden dadurch automatisch aktiviert, und die entsprechenden Bedingungen, bei der die Werbeaktion ausgelöst wird, werden festgelegt. Bei Bedarf können Sie weitere Bedingungen festlegen.
- Klicken Sie auf Weiter.
- Legen Sie das Start- und Enddatum der Kampagne fest.
- Klicken Sie auf Weiter.
- Prüfen Sie die Einstellungen, und klicken Sie auf Speichern und beenden.
- Klicken Sie in der Seitenleiste auf Store und dann auf Werbeaktionen und Belohungen.
- Wählen Sie die Werbeaktion aus, klicken Sie auf die Schaltfläche •••, um das Menü zu öffnen, und dann auf Werbeaktion bearbeiten.
- Aktivieren Sie die Werbeaktion.
Rabattkampagne über die API einrichten
Sie können die Methoden aus der Untergruppe
So erstellen Sie eine Werbeaktion über API-Methoden:
- Rufen Sie die Methode
Create discount promotion for item mit den erforderlichen Parametern auf. - Rufen Sie die Methode
Update item promotion mit dem Parameter“is_enabled”:true
auf, um die Werbeaktion zu aktivieren.
Rufen Sie die Methode
Beim Erstellen oder Bearbeiten einer Rabattaktion über API-Methoden ist außerdem Folgendes möglich:
- Konfiguration eines Rabatts für alle Artikel im Projekt. Übermitteln Sie dazu den Parameter
“items”:null
an die MethodeCreate discount promotion for item oderUpdate item promotion .
- Konfiguration eines Rabatts für physische Waren. Übermitteln Sie dazu ein Array mit den SKUs der physischen Waren an die Methode
Create discount promotion for item oderUpdate item promotion .
- Konfiguration eines Rabatts mit Dezimalprozentsatz. Übermitteln Sie dazu den Parameter
discount.percent
mit dem Dezimalprozentsatz an die MethodeCreate discount promotion for item oderUpdate item promotion .
- Konfiguration eines Rabatts für verschiedene Artikeltypen. Übermitteln Sie dazu ein Array mit den SKUs der gewünschten Artikel an die Methode
Create discount promotion for item oderUpdate item promotion .
- Konfiguration eines Rabatts für bestimmte DRMs des Spiels. Übermitteln Sie dazu ein Array mit den SKUs der gewünschten DRMs an die Methode
Create discount promotion for item oderUpdate item promotion .
- Konfiguration einer Rabattaktion ohne festgelegte Zeitdauer. Übermitteln Sie dazu den Parameter
“date_end”:null
an die MethodeCreate discount promotion for item oderUpdate item promotion .
Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.