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:

ArtikeltypArtikelattributnameArtikelattributwert
SpielschlüsselArt des SpielsNeu, Early Access, Demnächst erhältlich, Special
SpielschlüsselGenreAction, Adventure, Casual, Simulator, Strategie, RPG
Virtuelle GegenständeQualitätEpisch, Legendär, Gewöhnlich
Virtuelle GegenständeKlasseKämpfer, Paladin, Jäger, Schamane, Druide
Virtuelle WährungEreignisNeujahr
Virtuelle WährungQuestAbschluss Quest 1, Abschluss Quest 2

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
  1. 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.
  1. 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.
Hinweis

Beim Hinzufügen von Artikelattributen und Werten aus einer JSON gilt ein Limit von 500 Zeichen. Bezüglich der Anzahl der Attribute und Werte gelten keine Einschränkungen.

Wenn Sie Attribute und ihre Werte im Kundenportal oder über API-Methoden erstellen, gelten die folgenden Einschränkungen:

  • Maximal 20 Werte lassen sich einem Artikelattribut zuweisen
  • Maximal 20 Attribute lassen sich einem Artikel zuweisen
  • Einem Artikel können maximal 6 Werte eines Attributs zugewiesen sein

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.

Jeder Artikelattributwert hat die folgenden Parameter:
  • 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).

Artikelattribute und deren Werte können Sie auf die folgenden Wege erstellen:

Attribute und deren Werte im Kundenportal erstellen

  1. Öffnen Sie Ihr Projekt im Kundenportal.
  2. Navigieren Sie zu Online-Shop > Katalogverwaltung.
  1. Klicken Sie bei Artikelattribute auf Konfigurieren.
  2. Klicken Sie auf Artikelattribut erstellen.
  3. Geben Sie die External ID und den Namen des Artikelattributs an.
  4. Klicken Sie auf Speichern und weiter.
  5. 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.
  6. Klicken Sie auf Speichern und weiter.
Hinweis

Sie können unbegrenzt viele Artikelattribute im Projekt erstellen.

Jedoch gilt ein Limit von 20 Werten pro Attribut.

Nachdem Sie die Attribute und Werte erstellt haben, können Sie diese über die API oder im Kundenportal den Artikeln hinzufügen.

Attribute und deren Werte über API-Methoden erstellen

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

Methoden für die Erstellung und Verwaltung von Attributen:

Methoden für die Erstellung und Verwaltung von Attributwerten:
Achtung

Wenn Sie ein Artikelattribut löschen, gehen dessen Werte und Verbindungen mit dem Artikel verloren.

Wenn Sie einen Wert löschen, gehen dessen Verbindungen mit dem Artikel verloren.

Artikelattribut, Werte oder zugehörige Daten lassen sich nicht wiederherstellen.

Nachdem Sie die Attribute und Werte erstellt haben, können Sie diese über die API oder im Kundenportal den Artikeln hinzufügen.

Einem Artikel Attribute hinzufügen

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

Bestehende Attribute über das Kundenportal hinzufügen

So fügen Sie Attribute einem Artikel hinzu:
  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.
Hinweis

Sie können einem Artikel maximal 20 Attribute zuweisen.

Sie können maximal 6 Werte desselben Attributs für einen Artikel festlegen.

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:

Copy
Full screen
Small screen
  "attributes": [
    {
      "external_id": "craft-materials",
      "name": {
        "en": "Craft materials"
      },
      "values": [
        {
          "external_id": "steel",
          "value": {
            "en-US": "5"
          }
        },
        {
          "external_id": "leather",
          "value": {
            "en-US": "1"
          }
        }
      ]
    }
  ],
Hinweis
Wenn Sie den Artikelkatalog mit Methoden aus dem Unterabschnitt Katalog der Methodengruppe Virtuelle Gegenstände und Währung oder Spielschlüssel anfordern, enthält die Antwort auch eine Liste der entsprechenden Attribute und ihrer Werte im Array Attribute.
Hinweis

Sie können einem Artikel maximal 20 Attribute hinzufügen.

Sie können maximal 6 Werte desselben Attributs einem Artikel hinzufügen.

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:

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.
  1. Fügen Sie in den angezeigten Textbereich eine Liste von Attributen und deren Werten im JSON-Format ein.
Hinweis

Sie können beliebig viele Attribute und Werte im JSON-Format hinzufügen, es gibt kein Limit.

Jedoch ist die Länge der JSON auf 500 Zeichen begrenzt.

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: 10. Oktober 2023

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!