Artikelattribute

Attribute sind Merkmale eines Artikels, sie ergänzen den Artikel um zusätzliche Informationen.

Ein Attribut kann die Farbe und Größe eines Artikels, das Spielerlevel, ab dem der Artikel verfügbar ist, oder ein Ereignis in einem Spiel steuern.

Hauptmerkmale:

• Artikel im Online-Shop filtern
• Artikelvarianten (z. B. roter Helm, blauer Helm) und deren Darstellung auf der Artikelkarte festlegen
• Einem Artikel zusätzliche Merkmale zuweisen

Beispiele für Artikelattribute und deren Werte:

So funktioniert's

1. Auf folgende Wege lassen sich Artikelattribute und deren Werte erstellen und mit dem Artikel verknüpfen:

• im Kundenportal oder über die API, indem Sie die External ID der Artikelattribute und die External ID der Attributwerte angeben
• im Kundenportal, indem Sie die Attribute und deren Werte im JSON-Format angeben

2. Mit den Methoden aus dem Unterabschnitt Katalog der Methodengruppe Virtuelle Gegenstände und Währung oder Spielschlüssel können Sie den Artikelkatalog anfordern. Attributdaten werden:

• Im Array Attribute zurückgegeben, sofern Attribute über das Kundenportal oder über API-Methoden erstellt wurden. Dazu müssen Sie die External ID der Artikelattribute und die External ID der Attributwerte angeben.
• im Array custom_attributes, sofern die Attribute und Werte per JSON hinzugefügt wurden. Dazu müssen Sie bei der Katalogabfrage dem Parameter additional_fields den Wert custom_attributes zuweisen.

3. Der Benutzer tätigt einen Kauf. Wenn die Attribute und Werte über JSON hinzugefügt wurden, werden die Artikelattributdaten in den Webhooks Erfolgreiche Bezahlung der Bestellung und Stornierung der Bestellung im Array custom_attributes übermittelt.

Integrationsablauf

Sie können Artikelattribute und deren Werte außerhalb von Xsolla erstellen und sie im JSON-Format dem Artikel im Kundenportal hinzufügen.

Sie können auch Attribute und deren Werte bei Xolla erstellen und sie den Artikeln hinzufügen. So geht’s:

1. Erstellen Sie die Attribute und deren Werte.
2. Verknüpfen Sie die Attribute mit den Artikeln.

Artikelattribute und deren Werte erstellen und einrichten

Jedes Artikelattribut hat die folgenden Parameter:

• External ID – eine eindeutige Attribut-ID, die im Anfragerumpf im Parameter external_id übermittelt wird. Geben Sie die in Ihrem System hinterlegte Attribut-ID an oder vergeben Sie eine neue.
• Name (für jede im Projekt konfigurierte Sprache angegeben).

• Liste der Werte.

• External ID des übergeordneten Artikelattributs.
• External ID des Werts – eindeutige ID des im Parameter external_id übermittelten Wertes in den Pfadparametern. Geben Sie die in Ihrem System hinterlegte Wert-ID an oder vergeben Sie eine neue.

• Name (für jede im Projekt konfigurierte Sprache angegeben).

• im Kundenportal
• über API-Methoden

Attribute und deren Werte im Kundenportal erstellen

1. Öffnen Sie Ihr Projekt im Kundenportal.
2. Navigieren Sie zu Online-Shop > Katalogverwaltung.

3. Klicken Sie bei Artikelattribute auf Konfigurieren.
4. Klicken Sie auf Artikelattribut erstellen.
5. Geben Sie die External ID und den Namen des Artikelattributs an.
6. Klicken Sie auf Speichern und weiter.
7. Geben Sie alle notwendigen Werte für das erstellte Artikelattribut an. Geben Sie für jeden Wert die External ID an. Weitere Werte können Sie hinzufügen, indem Sie auf + klicken.
8. Klicken Sie auf Speichern und weiter.

Attribute und deren Werte über API-Methoden erstellen

Verwenden Sie die Methoden im Unterabschnitt Verwaltung der Methodengruppe Artikelattribute, um Artikelattribute und deren Werte zu erstellen und zu verwalten.

Methoden für die Erstellung und Verwaltung von Attributen:

• Attribut anlegen
• Attribut aktualisieren
• Angegebenes Attribut abrufen
• Attribut löschen

• Liste der Attribute zur Verwaltung abrufen

• Attributwert erstellen
• Alle Werte des Attributs löschen
• Attributwert aktualisieren
• Attributwert löschen

Einem Artikel Attribute hinzufügen

Fügen Sie die erstellten Attribute und Werte den Artikeln hinzu:

• über das Kundenportal
• über API-Methoden

Bestehende Attribute über das Kundenportal hinzufügen

1. Öffnen Sie Ihr Projekt im Kundenportal.
2. Klicken Sie in der Seitenleiste auf Online-Shop.
3. Öffnen Sie den gewünschten Artikeltyp-Abschnitt:
   • Virtuelle Gegenstände
   • Virtuelle Währung
   • Spielschlüssel
   • Bundles
4. Erstellen Sie einen neuen Artikel oder bearbeiten Sie den bestehenden.
5. Stellen Sie im Abschnitt Artikelattribute den Schalter Vorhandene Attribute auswählen oder neue erstellen auf Ein.
6. Daraufhin wird das Feld Artikelattribut angezeigt; wählen Sie dort die dem gewünschten Einzelteilattribut zugeordnete ID aus.
7. Wählen Sie im Feld Wert den dem Artikelattributwert zugeordneten Wert aus.

Bestehende Attribute über API-Methoden hinzufügen

Übermitteln Sie in der Methode Virtuellen Gegenstand erstellen oder Virtuellen Gegenstand aktualisieren eine Objekte-Array mit der External ID des Artikelattributs und der External ID der zu vergebenen Werte.

Beispiel für ein Array mit Attributen und deren Werten:

  "attributes": [
    {
      "external_id": "craft-materials",
      "name": {
        "en": "Craft materials"
      },
      "values": [
        {
          "external_id": "steel",
          "value": {
            "en-US": "5"
          }
        },
        {
          "external_id": "leather",
          "value": {
            "en-US": "1"
          }
        }
      ]
    }
  ],

Attribute aus einer JSON über das Kundenportal hinzufügen

Sie können Attribute und deren Werte per JSON hinzufügen, wenn Sie Artikel erstellen oder bearbeiten. Den folgenden Artikeltypen können Sie dabei Attribute zuweisen:

• virtuelle Währungspakete
• virtuelle Gegenstände, einschließlich zeitlich begrenzte Artikel
• Spielschlüssel
• Bundles

So geht’s:

1. Öffnen Sie Ihr Projekt im Kundenportal.
2. Klicken Sie in der Seitenleiste auf Online-Shop.
3. Öffnen Sie den gewünschten Artikeltyp-Abschnitt:
   • Virtuelle Gegenstände
   • Virtuelle Währung
   • Spielschlüssel
   • Bundles
4. Erstellen Sie einen neuen Artikel oder bearbeiten Sie einen bestehenden.
5. Stellen Sie im Abschnitt Artikelattribute den Schalter Attribute per JSON hinzufügen auf Ein.

6. Fügen Sie in den angezeigten Textbereich eine Liste von Attributen und deren Werten im JSON-Format ein.