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.

"item_id": 193166,
"sku": "helmet",
"type": "virtual_good",
"name": "{
Helmet",
"description": "---",
"image_url": "https://static.xsolla.com/misc/publisher_account/virtual_item_default_image.png",
"price": {
    "amount": "31.50",
    "amount_without_discount": "34.99",
    "currency": "TRY"
},
"virtual_prices": [],
"can_be_bought": true,
"promotions": [
    {
        "name": "store_promotion_164901_b5ef62b0551711edaedb22484f053720_name",
        "date_start": "2022-10-25T00:00:00+03:00",
        "date_end": "2022-11-30T23:59:59+03:00",
        "discount": {
            "percent": "10.00",
            "value": null
        },
        "bonus": [],
        "limits": {
            "per_user": {
                "available": 3,
                "total": 3
            }
        }
    },
    {
        "name": "store_promotion_164901_dc1fd2b2551711ed82b722484f053720_name",
        "date_start": "2022-10-24T00:00:00+03:00",
        "date_end": "2022-11-30T23:59:59+03:00",
        "discount": null,
        "bonus": [
            {
                "sku": "22",
                "quantity": 1
            },
            {
                "sku": "sword",
                "quantity": 2
            }
        ],
        "limits": {
            "per_user": {
                "available": 1,
                "total": 1
            }
        }
    }
],
"limits": null,
"attributes": [
    {
        "external_id": "sh4",
        "name": "sh4",
        "values": [
            {
                "external_id": "hd",
                "value": "20"
            }
        ]
    }
],
"is_free": false,
"groups": [
    {
        "external_id": "imported",
        "name": "Imported"
    }
],
"virtual_item_type": "consumable",
"inventory_options": {
    "consumable": {
        "usages_count": 1
    },
    "expiration_period": null
}
}

Wie komme ich dazu

Rabattkampagne einrichten

• über das Kundenportal
• über API-Methoden

Über Kundenportal einrichten

• einen Rabatt mit einem ganzzahligen Prozentwert festlegen;
• eine zeitlich beschränkte Rabattaktion einrichten;
• Rabatte einrichten, die für einen oder mehrere Artikeltypen gelten:
  • virtuelles Währungspaket
  • virtuelle Gegenstände (einschließlich zeitlich begrenzte Artikel)
  • Spielschlüssel
  • Bundles

Folgenden Aktionen sind derzeit im Kundenportal nicht verfügbar:

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

12. 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 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:

• Konfiguration eines Rabatts für alle Artikel im Projekt. Übermitteln Sie dazu den Parameter “items”:null an die Methode Create discount promotion for item oder Update item promotion.

"items": null

• 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 oder Update item promotion.

"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 Create discount promotion for item oder Update item promotion.

"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 Create discount promotion for item oder Update item promotion.

"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 Create discount promotion for item oder Update item promotion.

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

• Konfiguration einer Rabattaktion ohne festgelegte Zeitdauer. Übermitteln Sie dazu den Parameter “date_end”:null an die Methode Create discount promotion for item oder Update item promotion.

“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