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.

Achtung
Sie können einen personalisierten Katalog nur mit dem Login-Produkt verwenden.

Wenn Sie sie bereits mit dem Login-Produkt integriert haben, gehen Sie wie folgt vor, bevor Sie personalisierte Werbeaktionen für Benutzer einrichten:

  1. Richten Sie Attribute für Ihr Projekt ein.
  2. 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:

Weitere Informationen finden Sie unter Promocodes.

Auch beim Kauf von Aktionsartikeln können die Benutzer einen Bonus erhalten. Mögliche Boni:

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:

Weitere Informationen finden Sie unter Rabattaktionen.

Achtung
In Rabatt-, Promocode- oder Gutscheinkampagnen können Sie lediglich virtuelle Währungspakete verwenden. Nur in Bonuskampagnen kann eine beliebige Menge virtueller Währung festgelegt werden.

Gutscheinkampagne

So starten Sie eine Gutscheinkampagne:

  1. Richten Sie eine Gutscheinkampagne ein.
  2. Nutzen Sie die Methoden für die Einlösung von Gutscheinen per Code.
  3. Nutzen Sie die Methoden für das Abrufen einer Gutscheinbelohnung.

Hinweis
Regionale Einschränkungen gelten für die gesamte Werbekampagne. Sie können eine E-Mail an Xsolla senden, um regionale Einschränkungen festzulegen.

Gutscheinkampagne einrichten

  1. Öffnen Sie Ihr Projekt im Kundenportal.
  2. Klicken Sie in der Seitenleiste auf Store und dann auf Werbeaktionen und Belohungen.
  1. Klicken Sie auf Werbeaktion anlegen.
  1. Legen Sie die folgenden Parameter fest:
    1. Benennen Sie die Werbeaktion.
    2. Wählen Sie als Werbeaktionsart die Option Gutscheine aus.
  2. Wählen Sie die Belohnung aus, die der Benutzer beim Einlösen eines Gutscheins erhält. Verfügbare Optionen:
  3. Geben Sie Folgendes an:
    1. Kennung der Werbeaktion im Feld Externe ID.
    2. Bonusartikel, die der Benutzer beim Einlösen eines Gutscheins erhält.
    3. Artikeltyp und ‑menge.
  4. Klicken Sie auf Weiter.
  1. Legen Sie fest, wie oft der Gutschein insgesamt und pro Benutzer eingelöst werden kann.
  1. Legen Sie das Start- und Enddatum der Kampagne fest.
  2. Klicken Sie auf Weiter.

  1. Prüfen Sie die Einstellungen, und klicken Sie auf Speichern und beenden.

Hinweis
Solange eine Werbeaktion aktiv ist, können Sie keine Änderungen daran vornehmen.

  1. Klicken Sie in der Seitenleiste auf Store und dann auf Werbeaktionen und Belohungen.
  2. Wählen Sie die Werbeaktion aus, klicken Sie auf die Schaltfläche •••, um das Menü zu öffnen, und dann auf Werbeaktion bearbeiten.

  1. Wechseln Sie zur Registerkarte Codes.
  2. Legen Sie fest, wie Gutscheine generiert werden sollen.
  1. Generieren Sie den Gutscheincode oder geben Sie ihn manuell ein.
  2. Aktivieren Sie die Werbeaktion.

Gutschein per Code einlösen

Hinweis
Um die Xsolla-API aufzurufen, können Sie die vorgefertigten SDK-Methoden für Spiel-Engines und Plattformen verwenden:

Implementieren Sie den Aufruf der Methode Redeem coupon code, damit ein Gutschein eingelöst werden kann. Je nach Wert des Parameters is_selectable in der Antwort der Methode Get coupon rewards gibt es zwei mögliche Abläufe:

  1. Ist is_selectable=true festgelegt, sollte das Objekt selected_unit_items im folgenden Format beim Aufruf der Methode Redeem coupon code übermittelt werden:

Copy
Full screen
Small screen
selected_unit_items:{
      unit_1_sku: "selected_unit_item_sku",
      unit_2_sku: "selected_unit_item_sku"
}

Beispielhafte Antwort:

Copy
Full screen
Small screen
{
  {
    "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
  }
  ]
}
  1. Ist is_selectable=false festgelegt, sollte der zusätzliche Parameter in der Anfrage nicht übermittelt werden.

Gutscheinbelohnung abrufen

Hinweis
Um die Xsolla-API aufzurufen, können Sie die vorgefertigten SDK-Methoden für Spiel-Engines und Plattformen verwenden:

Implementieren Sie den Aufruf der Methode Get coupon rewards, um die Liste der Gegenstände abrufen zu können, welche der Benutzer nach Einlösen eines Gutscheins erhält. Je nach Wert des Parameters is_selectable in der Antwort gibt es zwei mögliche Abläufe:

  1. Ist is_selectable=true festgelegt, sollte für jedes item mit dem Element type=unit das Formular für die Auswahl von Elementen aus dem Objekt unit_items angezeigt werden. Darin können Benutzer nur ein Element pro unit-Typ wählen.
Beispielhafte Antwort:

Copy
Full screen
Small screen
{
	"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
  1. Ist is_selectable=false festgelegt, sollte der zusätzliche Parameter in der Anfrage nicht übermittelt werden.

Promocodekampagne

So starten Sie eine Promocodekampagne:

  1. Richten Sie eine Promocodekampagne ein.
  2. Implementieren Sie die Methoden für die Einlösung von Promocodes.
  3. Implementieren Sie die Methode für den Abruf einer Promocodebelohnung.

Promocodekampagne einrichten

  1. Öffnen Sie Ihr Projekt im Kundenportal.
  2. Klicken Sie in der Seitenleiste auf Store und dann auf Werbeaktionen und Belohungen.

  1. Klicken Sie auf Werbeaktion anlegen.

  1. Legen Sie die folgenden Parameter fest:
    1. Benennen Sie die Werbeaktion.
    2. Wählen Sie als Werbeaktionsart die Option Promocode.
  2. 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.
  3. Legen Sie den Rabattbetrag fest.
  4. Klicken Sie auf Weiter.

  1. Legen Sie fest, wie oft der Promocode insgesamt und pro Benutzer eingelöst werden kann.
  2. Klicken Sie auf Weiter.

  1. Legen Sie das Start- und Enddatum der Kampagne fest.
  2. Klicken Sie auf Weiter.

  1. Prüfen Sie die Einstellungen, und klicken Sie auf Speichern und beenden.

Hinweis
Solange eine Werbeaktion aktiv ist, können Sie keine Änderungen daran vornehmen.
  1. Klicken Sie in der Seitenleiste auf Store und dann auf Werbeaktionen und Belohungen.
  2. Wählen Sie die Werbeaktion aus, klicken Sie auf die Schaltfläche •••, um das Menü zu öffnen, und dann auf Werbeaktion bearbeiten.
  1. Wechseln Sie zur Registerkarte Codes.
  2. Legen Sie fest, wie Promocodes generiert werden sollen.
  3. Generieren Sie den Promocode oder geben Sie ihn manuell ein.
  1. Aktivieren Sie die Werbeaktion.

Promocode einlösen

Hinweis
Um die Xsolla-API aufzurufen, können Sie die vorgefertigten SDK-Methoden für Spiel-Engines und Plattformen verwenden:

Implementieren Sie den Aufruf der Methode Redeem promo code, damit ein Promocode eingelöst werden kann. Je nach Wert des Parameters is_selectable in der Antwort der Methode Get promo code rewards gibt es zwei mögliche Abläufe:

  1. Ist is_selectable=true festgelegt, sollte das Objekt selected_unit_items im folgenden Format beim Aufruf der Methode Redeem promo code übermittelt werden:

Copy
Full screen
Small screen
selected_unit_items:{
      unit_1_sku: "selected_unit_item_sku",
      unit_2_sku: "selected_unit_item_sku"
}

Beispielhafte Antwort:

Copy
Full screen
Small screen
{
  {
    "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
    }
    ]
}
  1. Ist is_selectable=false festgelegt, sollte der zusätzliche Parameter in der Anfrage nicht übermittelt werden.

Promocodebelohnungen abrufen

Hinweis
Um die Xsolla-API aufzurufen, können Sie die vorgefertigten SDK-Methoden für Spiel-Engines und Plattformen verwenden:

Implementieren Sie den Aufruf der Methode Get promo code rewards, um die Liste der Gegenstände abrufen zu können, welche der Benutzer nach Einlösen eines Promocodes erhält. Je nach Wert des Parameters is_selectable in der Antwort gibt es zwei mögliche Abläufe:

  1. Ist is_selectable=true festgelegt, sollte für jedes item mit dem Element type=unit das Formular für die Auswahl von Elementen aus dem Objekt unit_items angezeigt werden. Darin können Benutzer nur ein Element pro unit-Typ wählen.
Beispielhafte Antwort:

Copy
Full screen
Small screen
{
	"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
  1. Ist is_selectable=false festgelegt, sollte der zusätzliche Parameter in der Anfrage nicht übermittelt werden.

Bonuskampagne

Achtung
In Rabatt-, Promocode- oder Gutscheinkampagnen können Sie lediglich virtuelle Währungspakete verwenden. Nur in Bonuskampagnen kann eine beliebige Menge virtueller Währung festgelegt werden.

So starten Sie eine Bonuskampagne:

  1. Öffnen Sie Ihr Projekt im Kundenportal.
  2. Klicken Sie in der Seitenleiste auf Store und dann auf Werbeaktionen und Belohungen.

  1. Klicken Sie auf Werbeaktion anlegen.

  1. Legen Sie die folgenden Parameter fest:
    1. Benennen Sie die Werbeaktion.
    2. Wählen Sie als Werbeaktionsart die Option Prämien.
  2. Wählen Sie Aktionsartikel.

  1. Wählen Sie Bonusartikel, die die Nutzer beim Kauf der Aktionsartikel erhalten.
  2. Klicken Sie auf Weiter.

  1. 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.
  2. Klicken Sie auf Weiter.

  1. Legen Sie das Start- und Enddatum der Kampagne fest.
  2. Klicken Sie auf Weiter.

  1. Prüfen Sie die Einstellungen, und klicken Sie auf Speichern und beenden.

Hinweis
Solange eine Werbeaktion aktiv ist, können Sie keine Änderungen daran vornehmen.

  1. Klicken Sie in der Seitenleiste auf Store und dann auf Werbeaktionen und Belohungen.
  2. Wählen Sie die Werbeaktion aus, klicken Sie auf die Schaltfläche •••, um das Menü zu öffnen, und dann auf Werbeaktion bearbeiten.

  1. Aktivieren Sie die Werbeaktion.

Rabattkampagne

Hinweis
Bei Rabattaktionen lassen sich keine regionalen Einschränkungen festlegen.

Rabattkampagne über das Kundenportal einrichten

So starten Sie eine Rabattkampagne:
  1. Öffnen Sie Ihr Projekt im Kundenportal.
  2. Klicken Sie in der Seitenleiste auf Store.

  1. Klicken Sie auf Werbeaktionen und Belohnungen > Werbeaktion anlegen.

  1. Legen Sie die folgenden Parameter fest:
    1. Benennen Sie die Werbeaktion.
    2. Wählen Sie als Werbeaktionsart die Option Rabatt.
  2. Legen Sie Rabatte für einen oder mehrere Artikel fest.
  3. Legen Sie den Rabattbetrag fest.
  4. Klicken Sie auf Weiter.

  1. 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.
  2. Klicken Sie auf Weiter.

  1. Legen Sie das Start- und Enddatum der Kampagne fest.
  2. Klicken Sie auf Weiter.

  1. Prüfen Sie die Einstellungen, und klicken Sie auf Speichern und beenden.

Hinweis
Solange eine Werbeaktion aktiv ist, können Sie keine Änderungen daran vornehmen.

  1. Klicken Sie in der Seitenleiste auf Store und dann auf Werbeaktionen und Belohungen.
  2. Wählen Sie die Werbeaktion aus, klicken Sie auf die Schaltfläche •••, um das Menü zu öffnen, und dann auf Werbeaktion bearbeiten.

  1. Aktivieren Sie die Werbeaktion.

Rabattkampagne über die API einrichten

Sie können die Methoden aus der Untergruppe Discount der Methodengruppe Promotions nutzen, um mit Rabattaktionen zu arbeiten.

So erstellen Sie eine Werbeaktion über API-Methoden:

  1. Rufen Sie die Methode Create discount promotion for item mit den erforderlichen Parametern auf.
  2. Rufen Sie die Methode Update item promotion mit dem Parameter “is_enabled”:true auf, um die Werbeaktion zu aktivieren.

Rufen Sie die Methode Update item promotion mit den neuen Werbeaktionsparametern auf, um die Werbeaktion zu bearbeiten. Zudem lassen sich Werbeaktionen mit dem Status Active bearbeiten.

Beim Erstellen oder Bearbeiten einer Rabattaktion über API-Methoden ist außerdem Folgendes möglich:

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.
Letztmalig aktualisiert: 16. Oktober 2024

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!