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

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

Katalogsonderangebote einrichten

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.

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

• Katalogsonderangebot aktualisieren
• Katalogsonderangebot deaktivieren

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

• Liste von Katalogsonderangeboten abrufen
• Katalogsonderangebot abrufen