Bonusaktionen

So funktioniert's

Bonusaktionen sind ein Marketinginstrument, das Anreize für den Kauf virtueller Gegenstände 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:

• Boni in Form von virtueller Währung, mit der sich virtuelle Gegenstände erwerben lassen.
• Bonusaktionen an bedeutenden Tagen (z. B. Jahrestag des Projekts), um die Nutzer für ihre Treue zu belohnen.
• Nutzer, die ein bestimmtes Level in einem Spiel erreicht haben, erhalten neben dem eigentlich gekauften Artikel einen Bonusartikel als Belohnung für ihre Treue.

• Für eine begrenzte Zeit erhältliche Bonusartikel, um Nutzer zum Kauf virtueller Gegenstände zu motivieren.

Wenn Sie einen Artikelkatalog mithilfe von API-Methoden erstellen, können Sie Informationen über Werbeaktionen abrufen. In der Antwort erhalten Sie (neben den Informationen über virtuelle Gegenstände) 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_item",
  "type": "virtual_good",
  "name": "name_test_limit",
  "description": "description_test_limit",
  "price": {
    "amount": "1.00",
    "amount_without_discount": "1.00",
    "currency": "USD"
  },
  "virtual_prices": [
    {
      "description": null,
      "item_id": 322172,
      "sku": "1234500",
      "name": "virt currency only",
      "type": "virtual_currency",
      "amount": 1,
      "amount_without_discount": 1,
      "calculated_price": {
        "amount": "1.00",
        "amount_without_discount": "1.00"
      },
      "is_default": true
    }
  ],
  "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
  }
}

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