vtwonen API einrichten

1

Schritt 1: Erstelle eine neue Verbindung

• Navigiere zu [Dein Projekt] > Kanäle.

• Klicke +Add new API. Du wirst zur Verbindungsseite deiner Firma weitergeleitet.

• Auf der Verbindungsseite wähle +Neue Verbindung hinzufügen.

• Suche die Verbindung „vtwonen“, indem du durch die Seiten klickst, und wähle sie durch Anklicken aus.

• Füge ein Label hinzu.

• Klicke Erstellen. Du wirst für den nächsten Schritt zu vtwonen weitergeleitet.

• Sobald du weitergeleitet wurdest, melde dich mit deinen vtwonen-Zugangsdaten an.

Nach erfolgreicher Anmeldung ist die Verbindung mit vtwonen bereit. Anschließend wirst du zurück zur API-Einrichtung geleitet.

2

Schritt 2: Erstelle die API

Nachdem du deine Verbindung erstellt hast, musst du deine neue vtwonen-Verbindung auswählen und deine API-Einstellungen konfigurieren:

• Im Name feld, gib einen Namen für deine API ein.

• Wähle die Eigene ID pro Item aus dem Dropdown. Wir empfehlen das Feld 'id'.

• Wähle die Sprache für deine API.

• Klicke Weiter um deine vtwonen-API zu erstellen.

3

Schritt 3: Erstelle deine Produktangebote

Folge diesen Schritten, um deinen Kanal einzurichten.

1

Kategorisiere deine Produkte

Weise deinen Produkten Kategorien zu, um die Produktdaten einzurichten.

• KI-Produktkategorisierung: Weist Produktkategorien automatisch mithilfe unseres Algorithmus zu.

• Manuelle Kategorisierung: Ordne Produktkategorien manuell mit benutzerdefinierten Regeln zu. Du kannst detaillierte Filter erstellen, um jedes Produkt der richtigen Kategorie zuzuordnen.

• Nicht kategorisierte Items: Produkte, die noch überprüft und kategorisiert werden müssen

Erfahre mehr über die Kategorisierung für Marktplätze

2

Regeln einrichten

Regeln helfen dir, deine Produktdaten schnell für den gewünschten Marktplatz zu optimieren.

• Regelvorlagen: Häufig verwendete Regeln, die du an deinen Anwendungsfall anpassen kannst.

• Regel-Setup: Richte Regeln ein, um deine Produktdaten zu verfeinern. Das kann Filtern, Ändern oder Erweitern von Datenfeldern umfassen, damit die Anforderungen des Marktplatzes erfüllt werden.

Lies mehr darüber, wie man Regeln für Marktplätze nutzt

3

Erstelle deine Listings

Der Der Build- Schritt, in dem du deine Produktlistings so konfigurierst, dass sie den Marktplatzanforderungen entsprechen. Dieser Schritt ist wichtig, damit deine Produkte live gehen und Fehler vermieden werden.

Pflicht- und optionale Felder:

• Pflichtfelder : Erforderlich, um deine Produkte auf diesem Marktplatz zu listen

• Empfohlen : Empfohlen, um Fehler zu vermeiden

• Optional : Nicht erforderlich für die Listung

Gemeinsame Attribute

• Gemeinsame Attribute sind die allgemeinen Felder, die für deine Produkte gelten, wie EAN, Preise und Titel. Dieser Schritt sorgt für Einheitlichkeit der Basis-Produktinformationen über deine Listings hinweg.

• Verwende statische oder dynamische Werte:

  • Statische Werte: Feste Werte, die sich nicht ändern (z. B. Markenname, Hersteller)

  • Dynamische Werte: Felder, die sich automatisch anhand der verknüpften Daten ändern (z. B. Bestand, Preise)

Kategorie-spezifische Attribute

• Kategoriespezifische Attribute sind Felder, die speziell für die Kategorie deiner Produkte gelten. Dieser Schritt hilft, deine Listings an die Kategorievorgaben des Marktplatzes anzupassen.

• Fülle Attribute aus, die spezifisch für die ausgewählte Kategorie sind (z. B. Größe bei Kleidung oder Abmessungen bei Möbeln).

Erfahre mehr über den Build-Schritt für Marktplätze

4

Überprüfe die Qualität deiner Einrichtung

Der Qualität Dieser Schritt gibt Feedback zu deinem Kanal, bevor du ihn aktivierst. Er hebt Pflicht- und optionale Fehler hervor, damit deine Produktdaten den Anforderungen für die Listung auf dem Marktplatz entsprechen.

• Behebe Fehler und priorisiere dabei zuerst Pflichtfehler.

Aktionen:

• Artikel anzeigen: Zeigt Produkte mit bestimmten Problemen an.

• Im Aufbau-Schritt anzeigen: Leitet weiter zu den Der Build- Schritt, um fehlende Informationen zuzuordnen.

• Kategorien festlegen: Führt zu den Kategorien Schritt, um Artikel zu kategorisieren.

• Quelle anzeigen: Verfügbar für ID-Felder. Führt zu den Einstellungen Schritt.

Erfahre mehr über den Quality-Schritt für Marktplätze

5

Vorschau vor Aktivierung

Der Vorschau Der Schritt zeigt die Attribute an, die du im Der Build- Schritt zugeordnet hast, und hilft dir zu prüfen, ob alles korrekt konfiguriert ist, indem er eine Übersicht deiner Produkte und möglicher Fehler bietet.

Filterung:

• Nach Fehler filtern: Klicke auf das alle Dropdown und wähle aus, ob nur Produkte mit Fehlern oder Produkte mit einem bestimmten Fehler angezeigt werden sollen.

• Nach Kategorie filtern: Klicke auf das Alle Kategorien Dropdown und wähle die Kategorie, nach der du filtern möchtest.

Bevor du fortfährst:

• Geteilte Attribute prüfen: Stelle sicher, dass alle verpflichtenden gemeinsamen Attribute ausgefüllt sind.

• Kategoriespezifische Attribute prüfen: Stelle sicher, dass alle verpflichtenden kategoriespezifischen Attribute ausgefüllt sind.

• Auf Fehler prüfen: Korrigiere alle rot markierten Felder.

Erfahre mehr über den Vorschau-Schritt für Marktplätze

4

Zusätzliche Anforderungen für vtwonen

Diese Attributanforderungen sind spezifisch für vtwonen und gelten für die Attribute im Der Build- Schritt.

Tab „Geteilte Attribute“

• Versandklasse (logistische Klasse): Die logistischen Klassen bestimmen die jeweiligen Versandkosten für deine Items. Gib die logistische Klasse deines Produkts an.

• Lieferzeit bis Versand: Die Versandvorlaufzeit gibt an, wie lange es bis zur Übergabe des Pakets an den Versand dauert. Gib die Versandzeit in Tagen an.

Anforderungen an den Titel

Produkt-Titel sollten aus Folgendem bestehen:

Marke	Der Markenname, so wie er registriert ist
Produkttyp	Die Produktkategorie, zum Beispiel „sofa“. Diese muss in Kleinbuchstaben geschrieben sein
Reihe/Produktname	Die Reihe oder der Produktname, der hilft, die Variante des Produkts zu identifizieren. Jedes Wort muss mit einem Großbuchstaben beginnen
Attribute	Die unterscheidenden Merkmale des Produkts, z. B. Farbe, Maße oder Material

• Struktur: Marke Produkttyp Name - Attribute

• Beispiel: vtwonen Pendelleuchte Titan - schwarz.

Produktbeschreibung

Die Produktbeschreibungen für deine vtwonen-API sollten:

• den Kunden ansprechen („du“ und „dein“)

• in einem freundlichen, hilfreichen und respektvollen Ton verfasst sein

• Fachbegriffe oder technische Ausdrücke vermeiden, wenn sie für die Zielgruppe nicht relevant sind

• die Produktmerkmale sowie Vorteile und Nutzungserlebnis beschreiben

• relevante Keywords verwenden

• keine Abkürzungen enthalten

Produktbeschreibungen sollten Folgendes enthalten:

Kurzbeschreibung	Eine Übersicht über das Produkt, die die wichtigsten Merkmale hervorhebt. HTML ist nicht erlaubt
Aufzählungspunkte	Die wichtigsten Merkmale und Vorteile des Produkts. Mindestens 3 und maximal 5 Punkte
Lange Beschreibung	Detaillierte Informationen zu Produktmerkmalen, Spezifikationen, Materialien und Nutzung. Ebenso Stil- und Pflegehinweise. HTML ist erlaubt (fett und Listen)

Bildanforderungen

Minimale Auflösung	800 x 800 px
Maximale Auflösung	4472 x 4472 px
Unterstützte Formate	JPEG, PNG, WebP, GIF
Stil	Keine Wasserzeichen, Logos oder Textbestandteile

Videoanforderungen

Dauer	Zwischen 30 Sek. und 2 Min.
Auflösung	1080p oder höher
Unterstützte Formate	.mp4, .mov, .avi, .flv
Stil	Keine Rahmen, Skizzen, Wasserzeichen, Logos, Etiketten oder Preise

5

Best Practices

• Mehrere Attributwerte hinzufügen: Wenn du bei Mirakl-Marktplätzen mehrere Werte in einem Attributfeld angibst, trenne jeden Wert mit einem senkrechten Strich "|", damit die Werte korrekt erkannt und verarbeitet werden.

• Seller-Produkt-ID für Einzel-/einfache Produkte: Es gibt zwei Attribute namens 'SellerArticleId' bzw. 'SellerProductId'. 'SellerProductId' bezieht sich auf die Parent-ID, während 'SellerArticleId' die Variantenartikel bezeichnet. Bei Einzelprodukten müssen beide Attribute mit demselben Wert gefüllt werden.

Für weitere Informationen zu Mirakl-Marktplatz-Fehlern, Anleitungen und Best Practices, sieh dir unsere spezielle Anleitung.

6

Schritt 4: Sende deine Produktlistings an vtwonen

Sobald deine Produktlistings fertig sind, musst du sie an vtwonen senden:

• Wenn du dein Projekt noch nicht aktiviert hast, gehe zu [Dein Projekt] > Einstellungen und klicke Projekt aktivieren.

• In [Dein Projekt] > APIs, gehe zu [Deine vtwonenAPI] > Einstellungen.

• Klicke API aktivieren.

• Nachdem du die API aktiviert hast, navigiere zurück zu APIs.

• Klicke auf die Aktualisieren Button in der Spalte ‚Status‘, um deine Produktlistings an vtwonen zu senden.

7

Schritt 5: Überprüfe deine Produktangebote auf Fehler

• Um auf Fehler zu prüfen, navigiere zur Resultat > Tab Fehler. Hier findest du eine Liste der Produktlistings, die Fehler aufweisen.

• Klicke auf den spezifischen Fehler, um mehr Informationen darüber anzuzeigen, was den Fehler verursacht.