Bonusaktionen

So funktioniert's

Bonusaktionen sind ein Marketinginstrument, das Anreize für den Kauf von Spielen schafft, indem man Nutzern gleichzeitig Bonusartikel gewährt.

Hauptmerkmale:

• Gewährung eines oder mehrerer Bonusartikel beim Kauf eines Aktionsartikels.
• Festlegen, wie oft ein Nutzer eine Werbeaktion in Anspruch nehmen darf.
• Einrichtung personalisierter Bonusaktionen.

Anwendungsbeispiele:

• Sie können Boni in Form von virtueller Währung gewähren, mit der sich virtuelle Gegenstände oder Spiele erwerben lassen.
• Sie können Bonusaktionen an bedeutenden Tagen (z. B. Jahrestag des Projekts) durchführen, um die Nutzer für ihre Treue zu belohnen.
• Sie können Nutzern, die in einem Spiel ein bestimmtes Level erreicht haben, beim Kauf von Artikeln und Spielen zusätzlich Bonusartikel gewähren.

• Sie können Nutzern für einen begrenzten Zeitraum Bonusartikel gewähren, um sie zum Kauf virtueller Gegenstände und Spiele zu motivieren.

• Bei Bonusaktionen lassen sich keine regionalen Einschränkungen festlegen.
• Nutzer aus jeder Region können ein Spiel als Bonus erhalten, ungeachtet der für dieses Spiel festgelegten regionalen Einschränkungen.

• Sind für das als Bonus gewährte Spiel keine Schlüssel mehr vorhanden, kann der Nutzer keinen mit dieser Bonusaktion verknüpften Aktionsartikel kaufen.

Wenn Sie einen Spielekatalog mithilfe von API-Methoden erstellen, können Sie Informationen über Werbeaktionen abrufen. In der Antwort erhalten Sie (neben den Informationen über das Spiel) die folgenden Informationen über die Werbeaktionsart vom Typ Prämie:

• Name
• Start- und Enddatum
• Bonusartikel
• Wie viele Male der Nutzer die Werbeaktion insgesamt in Anspruch nehmen darf
• Wie viele verbleibende Male der Nutzer die Werbeaktion in Anspruch nehmen darf

Wenn der Nutzer die Werbeaktion nicht mehr in Anspruch nehmen darf (Anzahl der verbleibenden Nutzungen = 0), werden die Werbeaktionsinformationen nicht mehr im Katalog angezeigt.

{
  "item_id": 400962,
  "sku": "test_game",
  "type": "game_key",
  "name": "name_test_limit",
  "description": "description_test_limit",
  "price": {
    "amount": "1.00",
    "amount_without_discount": "1.00",
    "currency": "USD"
  },
  "can_be_bought": true,
  "promotions": [
    {
      "name": "New Year Bonus",
      "date_start": "2022-12-30T22:00:00+03:00",
      "date_end": "2023-01-02T21:59:59+03:00",
      "discount": null,
      "bonus": [
        {
          "quantity": 3,
          "name": "mybonusitem",
          "sku": "444777",
          "type": "virtual_good"
        }
      ],
      "limits": {
        "per_user": {
          "available": 7,
          "total": 7
        }
      }
    }
  ],
  "limits": null,
  "attributes": [],
  "is_free": false,
  "groups": [
    {
      "external_id": "01022023",
      "name": "Group1"
    }
  ],
  "virtual_item_type": "consumable",
  "inventory_options": {
    "consumable": {
      "usages_count": 1
    },
    "expiration_period": null
  }
}

• 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

Bonusaktion einrichten

• über das Kundenportal
• über API-Methoden

Über Kundenportal einrichten

• den Aktionszeitraum festlegen
• festlegen, wie oft ein Nutzer die Werbeaktion in Anspruch nehmen darf
• die Triggerbedingungen für die Werbeaktion festlegen

• Werbeaktionen einrichten, die für verschiedene Artikeltypen gelten:

  • virtuelle Währungspakete
  • virtuelle Gegenstände (einschließlich zeitlich begrenzter Artikel)
  • Spielschlüssel
  • Bundles

Bonusaktionen mit dem Status Aktiv lassen sich derzeit im Kundenportal nicht bearbeiten.

Die API-Methoden bieten erweiterte Konfigurationsmöglichkeiten für Bonusaktionen.

So richten Sie eine Werbeaktion über das Kundenportal ein:

1. Navigieren Sie im Kundenportal zu Store > Werbeaktionen und Belohungen.

2. Klicken Sie auf Werbeaktion anlegen.

3. Legen Sie die folgenden Parameter fest:
   1. Geben Sie den Titel der Werbeaktion ein.
   2. Wählen Sie als Werbeaktionsart die Option Prämie aus.
   3. Legen Sie die Aktionsartikel fest.
   4. Legen Sie den Artikel fest, der dem Nutzer beim Kauf des Aktionsartikels gewährt wird.

4. Klicken Sie auf Weiter.
5. Bei Bedarf können Sie festlegen, wie oft die Werbeaktion in Anspruch genommen werden darf. Stellen Sie dazu auf der Seite Bedingungen und Begrenzungen den Schalter Nutzungshäufigkeit der Werbeaktion pro Benutzer begrenzen auf Ein, und legen Sie das Limit fest.
6. Um personalisierte Werbeaktionen einzurichten, müssen Sie den Schalter Werbeaktion nur bei bestimmten Benutzern auslösen auf Ein stellen und die Bedingung(en) festlegen. Befolgen Sie dazu diese Anweisungen.
7. Klicken Sie auf Weiter.
8. Legen Sie den Aktionszeitraum fest.

9. Klicken Sie auf Weiter.
10. Prüfen Sie die Einstellungen, und klicken Sie auf Speichern und beenden.
11. So aktivieren Sie eine Werbeaktion:
    1. Finden Sie die Werbeaktion in Ihrem Werbeaktionskatalog.
    2. Klicken Sie auf das •••-Symbol, und wählen Sie in der Drop-down-Liste die Option Werbeaktion bearbeiten aus. Alternativ können Sie auch direkt auf die gewünschte Werbeaktion im Katalog klicken.
    3. Öffnen Sie oben recht auf der Seite das Drop-down-Menü, und wählen Sie Werbeaktion aktivieren.

Über API-Methoden einrichten

Sie können die Methoden aus den Untergruppen Allgemeines und Prämien der Methodengruppe Werbeaktionen nutzen, um mit Bonusaktionen zu arbeiten.

Nutzen Sie die Methode Bonusaktion erstellen und legen Sie die nötigen Parameter fest, um eine Bonusaktion zu erstellen.

Nutzen Sie die Methode Bonusaktion aktualisieren mitsamt dem Parameter “is_enabled”:true oder die Methode Werbeaktion aktivieren, um eine Bonusaktion zu aktivieren.

Nutzen Sie die Methode Werbeaktion deaktivieren, um eine Werbeaktion zu deaktivieren.

Rufen Sie die API-Methode Bonusaktion aktualisieren mit den neuen Werbeaktionsparametern auf, um eine Werbeaktion zu bearbeiten. Zudem lassen sich Werbeaktionen mit dem Status Aktiv bearbeiten.

Wenn Sie eine Bonusaktion über API-Methoden erstellen oder bearbeiten, können Sie ebenfalls:

• die Werbeaktion auf alle Artikel im Projekt ausweiten. Übermitteln Sie dazu den Parameter “condition”:null an die Methode Bonusaktion erstellen bzw. Bonusaktion aktualisieren.

“condition”: null

• eine zeitlich unbefristete Werbeaktion einrichten. Übermitteln Sie dazu den Parameter “date_end”:null an die Methode Bonusaktion erstellen bzw. Bonusaktion aktualisieren.

“date_end”: null