So gruppieren und sortieren Sie Artikel im Katalog

Die Reihenfolge der Gruppen und der darin enthaltenen Artikel beeinflusst, wie der Katalog in Ihrem Shop – auf der Website oder in der App – aussieht. Eine richtig konfigurierte Reihenfolge hilft Ihnen, effektiver mit Verkäufen zu arbeiten: Sie können beliebte Artikel und Gruppen zuerst den Nutzern anzeigen.

Wenn Sie die Liste der Artikelgruppen anfordern, werden die Gruppen in der sortierten Reihenfolge zurückgegeben. Ebenso werden beim Anfordern von Artikeln nach Gruppe die Artikel in ihrer sortierten Reihenfolge zurückgegeben. Artikel ohne eine angegebene Gruppe werden automatisch der Ungrouped-Gruppe hinzugefügt – sie können nicht sortiert werden und werden nicht zurückgegeben, wenn Artikel nach Gruppe angefordert werden.

Hauptmerkmale:

• Hinzufügen eines Artikels zu mehreren Gruppen.
• Sortieren von Gruppen.
• Sortieren von Artikeln innerhalb einer Gruppe.

Gruppen einrichten:

1. Erstellen und bearbeiten Sie Gruppen im Kundenportal.
2. Fügen Sie Artikel hinzu und erhalten Sie Informationen über Gruppen:
   • im Kundenportal
   • über API-Aufrufe

Über Kundenportal einrichten

Gruppe erstellen

Gruppe erstellen:

1. Öffnen Sie Ihr Projekt im Kundenportal und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel.
2. Klicken Sie auf Gruppen und Reihenfolge bearbeiten.

3. Klicken Sie auf Gruppe erstellen.

4. Geben Sie die erforderlichen Parameter an:
   • Externe ID — eine eindeutige Gruppen-ID.
   • Gruppenname.

5. Fügen Sie Artikel zur Gruppe hinzu (optional). Wenn Ihr Katalog noch keine Artikel enthält, können Sie die aktuellen Einstellungen speichern und später zu diesem Schritt zurückkehren.
6. Wählen Sie den Status Aktiviert in der Drop-down-Liste, um die Gruppe im Shop anzuzeigen.
7. Klicken Sie auf Erstellen.

Gruppe bearbeiten

So bearbeiten Sie eine Gruppe:

1. Öffnen Sie Ihr Projekt im Kundenportal und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel.
2. Klicken Sie auf Gruppen und Reihenfolge bearbeiten.
3. Klicken Sie auf ⋮ neben der gewünschten Gruppe und wählen Sie in der Drop-down-Liste die Option Bearbeiten aus.

4. Nehmen Sie die nötigen Änderungen vor und klicken Sie auf Speichern.

Gruppe löschen

Sie können nur Gruppen löschen, die keine Artikel enthalten.

So löschen Sie eine Gruppe:

1. Öffnen Sie Ihr Projekt im Kundenportal und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel.
2. Wählen Sie im Filter-Feld die Gruppe aus. Alle darin enthaltenen Artikel werden angezeigt.

3. Entfernen Sie im Gruppen-Feld das Kontrollkästchen der zu löschenden Gruppe für jeden Artikel.
4. Klicken Sie auf Gruppen und Reihenfolge bearbeiten.
5. Klicken Sie auf ⋮ neben der gewünschten Gruppe und wählen Sie in der Drop-down-Liste die Option Löschen aus.

Gegenstand zu Gruppe hinzufügen

Um einen Artikel (am Beispiel virtueller Gegenstände) der gewünschten Gruppe hinzuzufügen, geben Sie die Gruppe beim Erstellen oder Bearbeiten des virtuellen Gegenstands an:

• in den Grundeinstellungen des virtuellen Gegenstands;

• in der Drop-down-Liste der Gruppen in der Liste der virtuellen Gegenstände.

Gegenstände sortieren

Um Artikel (am Beispiel virtueller Gegenstände) zu sortieren:

1. Öffnen Sie Ihr Projekt im Kundenportal und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel.
2. Klicken Sie auf Gruppen und Reihenfolge bearbeiten.
3. Klicken Sie auf ⋮ neben der gewünschten Gruppe und wählen Sie in der Drop-down-Liste die Option Bearbeiten aus.
4. Erweitern Sie den Block der virtuellen Gegenstände, indem Sie auf ⌄ klicken.
5. Bewegen Sie den Mauszeiger über die Nummer des virtuellen Gegenstands. Das ☰-Symbol wird angezeigt. Ziehen Sie den virtuellen Gegenstand an die gewünschte Position. Sie können den Artikel auch direkt an den Anfang oder das Ende der Liste verschieben. Klicken Sie dazu auf ⋮ und wählen Sie die entsprechende Option aus.

6. Klicken Sie auf Speichern.

Gruppen sortieren

Gruppen sortieren:

Über die API einrichten

Gegenstand zu Gruppe hinzufügen

Um einen Artikel über API-Aufrufe einer bestehenden Gruppe hinzuzufügen, müssen Sie das Array mit dem external_id-Parameter der Gruppen, zu denen der Artikel gehören soll, im Feld group übermitteln:

• Spielschlüssel – verwenden Sie die API-Aufrufe Spiel erstellen, Spiel nach SKU aktualisieren und Spiel nach ID aktualisieren.
• Virtuelle Gegenstände – verwenden Sie die API-Aufrufe Virtuellen Gegenstand erstellen und Virtuellen Gegenstand aktualisieren.
• Virtuelle Währung – verwenden Sie die API-Aufrufe Virtuelle Währung erstellenund Virtuelle Währung aktualisieren.
• Virtuelle Währungspakete – verwenden Sie die API-Aufrufe Virtuelles Währungspaket erstellen und Virtuelles Währungspaket aktualisieren.
• Bundles – verwenden Sie die API-Aufrufe Bundle erstellen und Bundle aktualisieren.

Anfragebeispiel:

 1{
 2  "sku": "sword",
 3  "name": {
 4    "en": "Sword"
 5  },
 6  "is_enabled": true,
 7  "is_free": false,
 8  "order": 1,
 9  "description": {
10    "en": "A sword is a bladed melee weapon intended for cutting or thrusting that is longer than a knife or dagger, consisting of a long blade attached to a hilt."
11  },
12  "prices": [
13    {
14      "amount": 100,
15      "currency": "USD",
16      "is_enabled": true,
17      "is_default": true
18    }
19  ],
20  "vc_prices": [],
21  "is_show_in_store": true,
22  "groups": [
23    "chests",
24    "bonus"
25  ]
26}

Liste der Gruppen abrufen

Um die Liste aller Gruppen abzurufen, verwenden Sie den API-Aufruf Gegenstandsgruppen-Liste erhalten. Um die Liste der Gegenstände der angegebenen Gruppe abzurufen, übergeben Sie den external_id Parameter an den API-Aufruf Abrufen der Gegenstandsliste nach der angegebenen Gruppe.

Artikel filtern

So filtern Sie Artikel der gewünschten Gruppe:

1. Rufen Sie die Artikelliste über die folgenden API-Aufrufe ab:
   • Spieleliste abrufen
   • Liste der virtuellen Währungen abrufen
   • Liste der virtuellen Währungspakete abrufen
   • Liste der Bundles abrufen
2. Suchen Sie mithilfe der Filterung die Artikel mit dem Parameter external_id in der gewünschten Gruppe, die im Parameter groups angegeben ist.