Katalogsonderangebot

So funktioniert's

Katalogsonderangebot – ermöglicht es, im Katalog ausgeblendete Artikel den Nutzern anzuzeigen, die einen Sonderangebotscode eingegeben haben. Die Artikel werden erst angezeigt, nachdem der Code eingegeben wurde.

Hauptmerkmale:

  • Zusammenstellung einer Liste der Artikel, die nach Eingabe des Codes angezeigt werden
  • Einrichtung von Werbeaktionen für die nach Eingabe des Codes angezeigten Artikel
  • Festlegung, wie oft der Code im Rahmen der Kampagne insgesamt eingelöst werden darf
  • Festlegung, wie oft der Code im Rahmen der Kampagne pro Nutzer eingelöst werden darf
  • Festlegung regionaler Beschränkungen auf Anfrage
  • Generierung mehrerer Codes

Einschränkungen:
  • Der Nutzer muss autorisiert sein, um den Code eingeben zu können.
  • Ist der Code mit einem Artikel verknüpft, für den regionale Beschränkungen gelten, können Nutzer aus Regionen, in denen der Artikel nicht verfügbar ist, die mit diesem Code verknüpften Sonderangebote nicht sehen.
    Beispiel: Nach Eingabe des Codes sollte das Legendary Starter Pack angezeigt werden. Für das Legendary Starter Pack gelten regionale Beschränkungen – es ist nur in den USA verfügbar. Wenn ein Nutzer außerhalb der USA den Code eingibt, antwortet die Methode Aktionscode verifizieren mit einer Fehlermeldung, und der Nutzer kann das Legendary Starter Pack weder sehen noch kaufen.

Ablauf für den Nutzer

  1. Der autorisierte Nutzer öffnet den Artikelkatalog, ihm werden alle Artikel außer die Sonderangebote angezeigt.
  2. Der Nutzer gibt den Code in ein spezielles Feld im Katalog ein und aktiviert ihn.
  3. Dem Nutzer werden die erhältlichen Sonderartikel angezeigt.
  4. Der Nutzer kauft einen Sonderartikel, danach gilt der Code als eingelöst.

Integrationsablauf

  1. Richten Sie Katalogsonderangebote ein.
  2. Implementieren Sie, dass der Katalog dem Nutzer angezeigt wird. Verwenden Sie dazu die Methoden aus dem Unterabschnitt Katalog in der Methodengruppe Virtuelle Gegenstände und Währung, um den Katalog zu erstellen.
  3. Implementieren Sie die Anzeige eines Felds, in dem der Nutzer einen Code eingeben kann.
  4. Nutzen Sie die Methode Aktionscode verifizieren, um den Code zu prüfen.
  5. Implementieren Sie die Anzeige des Artikelkatalogs unter Berücksichtigung des Codes. Übermitteln Sie dazu den Codewert im Parameter promo_code, wenn Sie die Methoden für die Katalogerstellung aus dem Unterabschnitt Katalog der Methodengruppe Virtuelle Gegenstände und Währung aufrufen.
  6. Um eine Bestellung mit einem Sonderartikel anzulegen, verwenden Sie die Methode Bestellung mit dem angegebenen Artikel erstellen. Übermitteln Sie den Codewert im Parameter promo_code im Anfragerumpf. Wenn Sie einen Warenkorb verwenden möchten, übermitteln Sie den Codewert im Parameter promo_code im Anfragerumpf beim Aufruf der Methoden Warenkorb erstellen und Bestellung anlegen.

Wie komme ich dazu

Voraussetzungen

  1. Erstellen Sie ein Konto im Kundenportal.
  2. Verknüpfen Sie den Store, und richten Sie das Modul Virtuelle Gegenstände, Virtuelle Währung oder Bundles ein.
Hinweis
Enthält das Katalogsonderangebot virtuelle Gegenstände oder Bundles, empfehlen wir für diese Sonderartikel eine separate Gruppe zu erstellen, um den Katalog besser organisieren zu können.

Katalogsonderangebote einrichten

Nutzen Sie die API-Methoden, um Katalogsonderangebote einzurichten.
  1. Erstellen Sie ein Katalogsonderangebot (Werbeaktion) mit der Methode Katalogsonderangebot erstellen. Übermitteln Sie im Array Artikel die SKUs der Artikel, die nach Aktivierung des Codes angezeigt werden sollen. Sie können außerdem Folgendes festlegen:
    • den Aktionszeitraum; übermitteln Sie dazu:
      • das Startdatum im Parameter date_start,
      • das Enddatum im Parameter date_end. Ist kein Enddatum angegeben, ist die Werbeaktion unbefristet.
    • Einschränkungen; übermitteln Sie dazu:
      • wie oft die Werbeaktion von einem bestimmten Nutzer in Anspruch genommen werden darf im Parameter redeem_user_limit,
      • wie oft der Code eingelöst werden darf im Parameter redeem_code_limit,
      • wie oft die Werbeaktion insgesamt in Anspruch genommen werden darf im Parameter redeem_total_limit.
  2. Generieren Sie Codes für die erstellte Werbeaktion mithilfe der Methode Codes für Katalogsonderangebote generieren, oder erstellen Sie einen Code mithilfe der Methode Code für Katalogsonderangebote erstellen. Sie können bei Bedarf weitere Codes generieren. Mit der Methode Codes für Katalogsonderangebote abrufen können Sie generierte Codes abrufen.
  3. Aktivieren Sie die Werbeaktion mithilfe der Methode Katalogsonderangebot aktivieren.
Achtung
Beim Erstellen eines Katalogsonderangebots wird automatisch eine Kataloganzeigeregel erstellt. Löschen oder ändern Sie diese Regel nicht, um das ordnungsgemäße Funktionieren des Katalogsonderangebots sicherzustellen.

Mit den folgenden Methoden können Sie die Werbeaktion verwalten:

Mit den folgenden Methoden können Sie Infos zu den Katalogsonderangeboten abrufen:

War dieser Artikel hilfreich?
Vielen Dank!
Gibt es etwas, das wir verbessern können? Nachricht
Das tut uns leid
Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
Diese Seite bewerten
Diese Seite bewerten
Gibt es etwas, das wir verbessern können?

Jetzt nicht

Vielen Dank für Ihr Feedback!
Letztmalig aktualisiert: 22. Januar 2024

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!