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:

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:

• virtuelles Währungspaket
• virtueller Gegenstand

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:

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.

Gutscheinkampagne einrichten

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

3. Klicken Sie auf Werbeaktion anlegen.

4. Legen Sie die folgenden Parameter fest:
   1. Benennen Sie die Werbeaktion.
   2. Wählen Sie als Werbeaktionsart die Option Gutscheine aus.
5. 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).
6. 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.
7. Klicken Sie auf Weiter.

8. Legen Sie fest, wie oft der Gutschein insgesamt und pro Benutzer eingelöst werden kann.

9. Legen Sie das Start- und Enddatum der Kampagne fest.
10. Klicken Sie auf Weiter.

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

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

14. Wechseln Sie zur Registerkarte Codes.
15. Legen Sie fest, wie Gutscheine generiert werden sollen.

16. Generieren Sie den Gutscheincode oder geben Sie ihn manuell ein.
17. Aktivieren Sie die Werbeaktion.

Gutschein per Code einlösen

Implementieren Sie den Aufruf der Methode Gutscheincode einlösen, damit ein Gutschein eingelöst werden kann. Je nach Wert des Parameters is_selectable in der Antwort der Methode Gutscheinbelohnung abrufen 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 Gutscheincode einlösen übermittelt werden:

selected_unit_items:{
      unit_1_sku: "selected_unit_item_sku",
      unit_2_sku: "selected_unit_item_sku"
}

Beispielhafte Antwort:

{
  {
    "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
  }
  ]
}

2. Ist is_selectable=false festgelegt, sollte der zusätzliche Parameter in der Anfrage nicht übermittelt werden.

Gutscheinbelohnung abrufen

Implementieren Sie den Aufruf der Methode Gutscheinbelohnung abrufen, um die Liste der Artikel 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 ein Formular angezeigt werden, über das sich Elemente aus dem Objekt unit_items auswählen lassen. In dem Formular können Benutzer nur ein Element pro unit-Typ wählen.

{
	"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

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

3. Klicken Sie auf Werbeaktion anlegen.

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

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

10. Legen Sie das Start- und Enddatum der Kampagne fest.
11. Klicken Sie auf Weiter.

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

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

15. Wechseln Sie zur Registerkarte Codes.
16. Legen Sie fest, wie Promocodes generiert werden sollen.
17. Generieren Sie den Promocode oder geben Sie ihn manuell ein.

18. Aktivieren Sie die Werbeaktion.

Promocode einlösen

Implementieren Sie den Aufruf der Methode Promocode einlösen, damit ein Promocode eingelöst werden kann. Je nach Wert des Parameters is_selectable in der Antwort der Methode Promocode-Belohnung abrufen gibt es zwei mögliche Abläufe:

1. Ist is_selectable=true festgelegt, sollte das Objekt selected_unit_items beim Aufruf der Methode Promocode einlösen im folgenden Format übermittelt werden:

selected_unit_items:{
      unit_1_sku: "selected_unit_item_sku",
      unit_2_sku: "selected_unit_item_sku"
}

Beispielhafte Antwort:

{
  {
    "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
    }
    ]
}

2. Ist is_selectable=false festgelegt, sollte der zusätzliche Parameter in der Anfrage nicht übermittelt werden.

Promocodebelohnungen abrufen

Implementieren Sie den Aufruf der Methode Promocode-Belohnung abrufen, um die Liste der Artikel 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 ein Formular angezeigt werden, über das sich Elemente aus dem Objekt unit_items auswählen lassen. In dem Formular können Benutzer nur ein Element pro unit-Typ wählen.

{
	"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

2. Ist is_selectable=false festgelegt, sollte der zusätzliche Parameter in der Anfrage nicht übermittelt werden.

Bonuskampagne

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.

3. Klicken Sie auf Werbeaktion anlegen.

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

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

8. 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.
9. Klicken Sie auf Weiter.

10. Legen Sie das Start- und Enddatum der Kampagne fest.
11. Klicken Sie auf Weiter.

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

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

15. Aktivieren Sie die Werbeaktion.

Rabattkampagne

Rabattkampagne über das Kundenportal einrichten

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

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

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

8. 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.
9. Klicken Sie auf Weiter.

10. Legen Sie das Start- und Enddatum der Kampagne fest.
11. Klicken Sie auf Weiter.

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

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

15. Aktivieren Sie die Werbeaktion.

Über API-Methoden einrichten

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

So erstellen Sie eine Werbeaktion über API-Methoden:

1. Rufen Sie die Methode Rabattaktion für Artikel erstellen mit den erforderlichen Parametern auf.
2. Rufen Sie die Methode Artikelaktion aktualisieren mit dem Parameter “is_enabled”:true auf, um die Werbeaktion zu aktivieren.

Rufen Sie die Methode Artikelaktion aktualisieren mit den neuen Werbeaktionsparametern auf, um die Werbeaktion zu bearbeiten. Sie können auch Werbeaktionen mit dem Status Active bearbeiten.

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 Methode Rabattaktion für Artikel erstellen oder Artikelaktion aktualisieren.

"items": null

• Konfiguration eines Rabatts für physische Waren. Übermitteln Sie dazu ein Array mit den SKUs der physischen Waren an die Methode Rabattaktion für Artikel erstellen oder Artikelaktion aktualisieren.

"items": [{
     “sku”: “strw2030”
  }, {
     “sku”: “strw4060”
  }, {
     “sku”: “cupred200”
  }
]

• Konfiguration eines Rabatts mit Dezimalprozentsatz. Übermitteln Sie dazu den Parameter discount.percent mit dem Dezimalprozentsatz an die Methode Rabattaktion für Artikel erstellen oder Artikelaktion aktualisieren.

"discount": {
    “percent”: ”49.9”
}

• Konfiguration eines Rabatts für verschiedene Artikeltypen. Übermitteln Sie dazu ein Array mit den SKUs der gewünschten Artikel an die Methode Rabattaktion für Artikel erstellen oder Artikelaktion aktualisieren.

"items": [{
     “sku”: “storm_shield”
  }, {
     “sku”: “heaven_crystals_pack_x500”
  },{
     “sku”: “strw2030”
  }
]

• Konfiguration eines Rabatts für bestimmte DRMs des Spiels. Übermitteln Sie dazu ein Array mit den SKUs der gewünschten DRMs an die Methode Rabattaktion für Artikel erstellen oder Artikelaktion aktualisieren.

"items": [{
     “sku”: “brilliant_game_sku_steam”
  }
  ]

• Konfiguration einer Rabattaktion ohne festgelegte Zeitdauer. Übermitteln Sie dazu den Parameter “date_end”:null an die Methode Rabattaktion für Artikel erstellen oder Artikelaktion aktualisieren.

“date_end”: null

• Richten Sie eine Werbeaktion für Erstkäufer ein. Übermitteln Sie dazu im API-Aufruf Rabattaktion für Artikel erstellen oder im API-Aufruf Artikelaktion aktualisieren ein Objekt im Array attribute_conditions:

"attribute_conditions": [
{
"attribute": "has_purchase",
"operator": "eq",
"value": "0",
"type": "number"
}
],
"limits": {
"per_user": 1
}