Rabattaktion

So funktioniert's

Rabattaktionen sind Marketinginstrumente, um neue Spieler zu gewinnen und den Umsatz anzukurbeln.

Hauptmerkmale:

• Konfigurieren eines Rabatts für einen oder mehrere Artikel.
• Anwenden einer unbegrenzten Anzahl von Rabattaktionen auf einen Artikel.
• Erstellen eines Artikelkatalogs samt automatischer Kalkulation der Artikelpreise. Methoden für das Erstellen eines Katalogs geben das price-Objekt für jeden Artikel zurück. Dieses Objekt enthält den rabattierten und unrabattierten Preis eines jeden Artikels.

"price": {
  "amount": "2.3900000000000000",
  "amount_without_discount": "2.9900000000000000",
  "currency": "USD"
}

Einschränkungen:

• Der Rabatt lässt sich nur als Prozentsatz von 1 bis 99 festlegen.
• Es lassen sich keine regionalen Beschränkungen für Rabattaktionen festlegen.

Sie können Werbeaktionen für beliebige viele Artikel einrichten und ebenso beliebig viele Rabattaktionen auf einen Artikel anwenden.

Der Benutzer sieht Informationen zu Werbeaktionen, wenn er:

• durch den Spielekatalog navigiert,
• etwas bestellt.

Wenn Sie einen Online-Shop mit dem Site Builder erstellen, zeigt der Spielekatalog Folgendes an: den Rabatt, den durchgestrichenen Preis ohne Rabatt und den Preis mit Rabatt.

Wenn Sie einen Online-Shop ohne den Site Builder erstellen, implementieren Sie die Anzeige von Werbeaktionen im Katalog basierend auf den in der Methode Spieleliste abrufen erhaltenen Daten. In der Antwort sind neben den Informationen über das Spiel folgende Informationen über Werbeaktionen enthalten:

• Titel
• Start- und Enddatum
• bei einer Rabattaktion: die Höhe des Rabatts
• bei einer Rabattaktion: der Artikelpreis mit und ohne Rabatt
• bei einer Bonusaktion: der Bonusartikel

{
  "items": [
    {
      "sku": "game_1",
      "name": "Game name",
      "groups": [
        {
          "external_id": "all",
          "name": "All games"
        },
        {
          "external_id": "Xsolla",
          "name": "Xsolla games"
        }
      ],
      "type": "unit",
      "unit_type": "game",
      "description": "Game description",
      "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
      "attributes": {
        "$ref": "../examples/client-attribute-game.yaml#/value"
      },
      "promotions": [],
      "unit_items": [
        {
          "sku": "game_key_01",
          "type": "game_key",
          "is_free": false,
          "price": {
            "amount": "30.5",
            "amount_without_discount": "30.5",
            "currency": "USD"
          },
          "virtual_prices": [],
          "can_be_bought": true,
          "drm_name": "Steam",
          "drm_sku": "steam",
          "has_keys": true,
          "is_pre_order": true,
          "release_date": "2020-08-11T10:00:00+03:00"
        },
        {
          "sku": "game_key_02",
          "type": "game_key",
          "is_free": false,
          "price": {
            "amount": "30.5",
            "amount_without_discount": "30.5",
            "currency": "USD"
          },
          "virtual_prices": [],
          "can_be_bought": true,
          "drm_name": "Origin",
          "drm_sku": "origin",
          "has_keys": false,
          "is_pre_order": false,
          "release_date": null
        }
      ]
    },
    {
      "sku": "game_2",
      "name": "Game name",
      "groups": [
        {
          "external_id": "all",
          "name": "All games"
        }
      ],
      "type": "unit",
      "unit_type": "game",
      "description": "Game description",
      "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
      "attributes": [
        {
          "external_id": "OS",
          "name": "OS",
          "values": [
            {
              "external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723",
              "value": "Windows"
            }
          ]
        }
      ],
      "promotions": [],
      "unit_items": [
        {
          "sku": "game_key_01",
          "type": "game_key",
          "is_free": false,
          "price": {
            "amount": "30.5",
            "amount_without_discount": "30.5",
            "currency": "USD"
          },
          "virtual_prices": [],
          "can_be_bought": true,
          "drm_name": "Steam",
          "drm_sku": "steam",
          "has_keys": false,
          "is_pre_order": false,
          "release_date": null
        }
      ]
    }
  ]
}

Im Bestellfenster werden die folgenden Informationen über die in Anspruch genommenen Werbeaktionen angezeigt:

• bei einer Rabattaktion:
  • Rabatt im Rahmen der Werbeaktion
  • durchgestrichener Preis ohne Rabatt
  • rabattierter Preis
• bei einer Bonusaktion:
  • Bonusartikel
  • der Schriftzug Kostenlos in der Preiszeile des Bonusartikels
• nach Eingabe eines Promocodes:
  • durch den Promocode erzielter Rabatt
  • durchgestrichener Preis ohne Rabatt
  • rabattierter Preis
  • Bonusartikel
  • der Schriftzug Kostenlos in der Preiszeile des Bonusartikels

Wie komme ich dazu

Rabattkampagne einrichten

• über das Kundenportal
• über API-Methoden

Über Kundenportal einrichten

• Einrichten eines Rabatts mit einem ganzzahligen Prozentwert.
• Einrichten einer Rabattaktion mit einer beschränkten Zeitdauer.
• Einrichten von Rabatten die für eine oder mehrere Pakete von Spielschlüsseln für bestimmte Plattformen gelten.

• Einrichten eines Rabatts mit Dezimalwerten.
• Einrichten eines zeitlich unbegrenzten Rabatts.
• Bearbeiten von Rabattaktionen mit dem Status “Aktiv”.

1. Navigieren Sie im Kundenportal zu Store > Werbeaktionen und Belohungen, und klicken Sie auf Werbeaktion anlegen.

2. Legen Sie die erforderlichen Parameter fest:
   1. Geben Sie den Titel der Werbeaktion ein.
   2. Wählen Sie als Werbeaktionsart die Option Rabatt aus.
   3. Legen Sie den Rabattbetrag fest.
   4. Wählen Sie den Produkttyp aus.

• 5. Wählen Sie einen oder mehrere Artikel aus, für die ein Rabatt gelten soll.

3. Klicken Sie auf Weiter.
4. Sie können begrenzen, wie oft ein Benutzer eine Werbeaktion in Anspruch nehmen darf. Dazu müssen Sie auf der Seite Bedingungen und Begrenzungen den Schalter Nutzungshäufigkeit der Werbeaktion pro Benutzer begrenzen auf Ein stellen, und das Limit festlegen.
5. Um personalisierte Werbeaktionen einzurichten, müssen Sie den Schalter Werbeaktion nur bei bestimmten Benutzern auslösen auf Ein stellen und diese Anweisungen befolgen.
6. Klicken Sie auf Weiter.

7. Legen Sie das Start- und Enddatum der Kampagne fest.
8. Klicken Sie auf Weiter.

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

10. So aktivieren Sie eine Werbeaktion:
    1. Finden Sie die Werbeaktion in Ihrem Werbeaktionskatalog.
    2. Klicken Sie auf das •••-Symbol, und wählen Sie Werbeaktion bearbeiten aus.

• 3. Öffnen Sie oben rechts das Drop-down-Menü, und wählen Sie Werbeaktion aktivieren.

Ü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
}

Bedingungen von Rabattaktionen anpassen

• 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