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.

Ebenso können Sie personalisierte Werbekampagnen durchführen, richten Sie dazu Kampagnen für bestimmte Benutzer ein. Das ist nur bei Rabattkampagnen und Bonuskampagnen möglich.

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.

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.

Note
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 Online-Shop und dann auf Werbeaktionen.
  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:
  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 die Gesamtanzahl der Gutscheineinlösungen und die Gesamtanzahl der Einlösungen pro Benutzer fest.
  9. Legen Sie den Aktionszeitraum fest.
  10. Klicken Sie auf Weiter.
  11. Prüfen Sie die Einstellungen, und klicken Sie auf Speichern und beenden.

Note
Sobald die Werbeaktion läuft, lassen sich Aktionsboni und ‑bedingungen nicht mehr ändern.

  1. Klicken Sie im seitlichen Menü auf Online-Shop und dann auf Werbeaktionen.
  2. Wählen Sie die Werbeaktion aus, klicken Sie auf die Schaltfläche •••, um das Menü zu öffnen, und dann auf Abo-Modell bearbeiten.
  3. Wechseln Sie zur Registerkarte Codes.
  4. Legen Sie fest, wie Gutscheine generiert werden.
  5. Generieren Sie den Gutscheincode oder geben Sie ihn manuell ein.
  6. Aktivieren Sie die Werbeaktion.

Gutschein per Code einlösen

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

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 im seitlichen Menü auf Online-Shop und dann auf Werbeaktionen.
  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 aus.
  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 die Gesamtanzahl der Einlösungen und die Gesamtanzahl der Einlösungen pro Benutzer fest.
  9. Klicken Sie auf Weiter.
  10. Legen Sie den Aktionszeitraum fest.
  11. Klicken Sie auf Weiter.
  12. Prüfen Sie die Einstellungen, und klicken Sie auf Speichern und beenden.

Note
Sobald die Werbeaktion läuft, lassen sich Aktionsboni und ‑bedingungen nicht mehr ändern.

  1. Klicken Sie im seitlichen Menü auf Online-Shop und dann auf Werbeaktionen.
  2. Wählen Sie die Werbeaktion aus, klicken Sie auf die Schaltfläche •••, um das Menü zu öffnen, und dann auf Abo-Modell bearbeiten.
  3. Wechseln Sie zur Registerkarte Codes.
  4. Legen Sie fest, wie Promocodes generiert werden.
  5. Generieren Sie den Promocode oder geben Sie ihn manuell ein.
  6. Aktivieren Sie die Werbeaktion.

Promocode einlösen

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

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

So starten sie eine Bonuskampagne:

  1. Öffnen Sie Ihr Projekt im Kundenportal.
  2. Klicken Sie in der Seitenleiste auf Online-Shop und dann auf Werbeaktionen.
  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 Bonus aus.
  5. Wählen Sie Aktionsartikel aus.
  6. Wählen Sie aus, welche Artikel der Benutzer beim Kauf von Aktionsartikeln erhält.
  7. Klicken Sie auf Weiter.
  8. Wenn Sie eine Werbeaktion für bestimmte Benutzer einrichten möchten, stellen Sie den Umschalter Werbeaktion nur bei bestimmten Benutzern auslösen auf Ein, und legen Sie die Bedingung(en) fest.
  9. Klicken Sie auf Weiter.
  10. Legen Sie den Aktionszeitraum fest.
  11. Klicken Sie auf Weiter.
  12. Prüfen Sie die Einstellungen, und klicken Sie auf Speichern und beenden.

Note
Sobald die Werbeaktion läuft, lassen sich Aktionsboni und ‑bedingungen nicht mehr ändern.

  1. Klicken Sie in der Seitenleiste auf Online-Shop und dann auf Werbeaktionen.
  2. Wählen Sie die Werbeaktion aus, klicken Sie auf die Schaltfläche •••, um das Menü zu öffnen, und dann auf Abo-Modell bearbeiten.
  3. Aktivieren Sie die Werbeaktion.

Rabattkampagne

Note
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 Online-Shop und dann auf Werbeaktionen.
  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 Rabatt aus.
  5. Wählen Sie die zu rabattierenden Artikel aus.
  6. Legen Sie den Rabattbetrag fest.
  7. Klicken Sie auf Weiter.
  8. Wenn Sie eine Werbeaktion für bestimmte Benutzer einrichten möchten, stellen Sie den Umschalter Werbeaktion nur bei bestimmten Benutzern auslösen auf Ein, und legen Sie die Bedingung(en) fest.
  9. Klicken Sie auf Weiter.
  10. Legen Sie den Aktionszeitraum fest.
  11. Klicken Sie auf Weiter.
  12. Prüfen Sie die Einstellungen, und klicken Sie auf Speichern und beenden.

Note
Sobald die Werbeaktion läuft, lassen sich Aktionsboni und ‑bedingungen nicht mehr ändern.

  1. Klicken Sie in der Seitenleiste auf Online-Shop und dann auf Werbeaktionen.
  2. Wählen Sie die Werbeaktion aus, klicken Sie auf die Schaltfläche •••, um das Menü zu öffnen, und dann auf Abo-Modell bearbeiten.
  3. 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:

Bedingungen von Rabattaktionen anpassen

Sie können einen Rabatt einrichten, der erst gewährt wird, wenn bestimmte Bedingungen erfüllt sind:

  • Rabatt, der ab einer bestimmten Warenkorbsumme angewandt wird
  • Rabatt, der nur gewährt wird, wenn der Warenkorb genügend Artikel enthält
  • Rabatt auf einen Artikel, wenn Benutzer einen anderen Artikel kaufen
Wenden Sie sich an Ihren Account Manager, wenn Sie eine Rabattaktion mit Bedingungen einrichten möchten.

Ihr Fortschritt
Vielen Dank für Ihr Feedback!
Letztmalig aktualisiert: 21. Juni 2022

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!