Wie verbinde ich die Selling Partner API?
Mit der Selling Partner API erhältst du Zugriff auf organische Daten aus deinem Amazon-Seller- oder Vendor-Konto. Dieser Zugang ermöglicht erweiterte Analysen.
Auf dieser Seite
- Übersicht
- Zugriff auf die Funktion
- Schritt-für-Schritt-Anleitung
- Schritt 1: Region wählen
- Schritt 2: Amazon-Konto verbinden
- Schritt 3.1: Selling Partner (Seller) verbinden
- Schritt 3.2: Selling Partner (Vendor) verbinden
- Schritt 4: Funktion der SP-API prüfen
- Schritt 5: Verbindung verwalten
- Einstellungen & Optionen
- Einschränkungen & Besonderheiten
- Tipps & Best Practices
Übersicht
Die Anbindung Deines Amazon-Kontos für die Selling Partner API in BidX besteht aus zwei Schritten. Zunächst verbindest Du Dein Amazon-Konto (Seller Central oder Vendor Central), um Werbedaten abzurufen. Anschließend verknüpfst Du die Selling Partner API, um Zugriff auf organische Daten zu erhalten. Dabei kannst Du die gewünschte Region und den Kontotyp auswählen und bei Bedarf bestehende Verbindungen verwalten.
Zugriff auf die Funktion
Du erreichst die Anbindung in den Kontoeinstellungen unter dem Punkt Amazon Verbindung. Dort findest Du die Übersicht und alle notwendigen Schritte, um die SP-API einzurichten und zu verwalten.
Schritt-für-Schritt-Anleitung
Schritt 1: Region wählen
Öffne Kontoeinstellungen > Amazon Verbindung. Wähle die gewünschte Region aus. Zur Auswahl stehen Europa & Indien, Nordamerika sowie Fernost. Je nach gewählter Region werden Dir nur die für diese Region verfügbaren Konten angezeigt. Nicht alle Regionen sind zwangsläufig für jeden Account verfügbar.
Schritt 2: Amazon-Konto verbinden
Unter den jeweiligen Logos Seller Central und Vendor Central klickst Du auf den Login with Amazon-Button. Dadurch startest Du den Anmeldeprozess bei Amazon für das gewählte Konto. Nach erfolgreicher Anmeldung wird die Verbindung hergestellt und Du erhältst die Meldung VERBUNDEN sowie den Hinweis Dein Konto ist verbunden. Über Verknüpfung aufheben kannst Du die Verbindung wieder trennen. Mit Marktplätze bearbeiten lässt sich steuern, für welche Marktplätze Dein Konto verbunden sein soll. Mehr dazu in diesem Artikel.
Schritt 3.1: Selling Partner (Seller) verbinden
Im Bereich Selling Partner (Seller) wählst Du aus dem Dropdown Wähle einen Account aus das gewünschte Verkäuferkonto. Nach Auswahl wirst Du zu Amazon weitergeleitet, um die Freigabe für den Zugriff auf organische Daten zu erteilen. Ist die Verbindung erfolgreich, erscheint VERBUNDEN sowie der Name des verknüpften Accounts. Über Verknüpfung aufheben kannst Du die SP-API-Verbindung bei Bedarf trennen.
Falls kein Seller-Konto hinterlegt ist, wird Dir dieser Bereich nicht angezeigt. In diesem Fall verbinde zunächst Dein Seller Central-Konto (siehe Schritt 2.).
Schritt 3.2: Selling Partner (Vendor) verbinden
Analog zu den Verkäuferkonten gehst Du im Abschnitt Selling Partner (Vendor) vor. Hier wählst Du einen Vendor-Account aus und wirst zu Amazon geleitet, um die Freigabe für die SP-API zu erteilen. Nach erfolgreicher Autorisierung erscheint der Hinweis VERBUNDEN zusammen mit dem Namen des zugeordneten Vendor-Kontos. Auch hier steht Dir Verknüpfung aufheben zur Verfügung.
Fehlt ein Vendor-Konto, ist dieser Bereich nicht sichtbar. Verbinde dann zunächst Dein Vendor Central-Konto.
Schritt 4: Funktion der SP-API prüfen
Nachdem die SP-API-Verbindung für den gewünschten Account aktiv ist, prüfe die Statushinweise rund um die verbundenen Bereiche. Wenn der Hinweis VERBUNDEN angezeigt wird, werden die organischen Daten künftig abgerufen und in BidX zur Verfügung gestellt. Sollte ein Fehler auftreten oder die Autorisierung nicht erfolgreich gewesen sein, erhältst Du eine entsprechende Statusmeldung, etwa „unbekannter Fehler“ oder „Die Autorisierung wurde erfolgreich abgeschlossen“.
Schritt 5: Verbindung verwalten
Um eine bestehende Verbindung zu entfernen, klicke im jeweiligen Bereich auf Verknüpfung aufheben. Es erscheint ein Dialog zur Bestätigung. Erst nach Deinem expliziten Einverständnis wird die Verbindung gelöst. Möchtest Du Deine Datenabdeckung anpassen, kannst Du über Marktplätze bearbeiten gezielt die zu verbindenden Marktplätze für Dein Konto auswählen oder ändern.
Bitte beachte, dass je nach Nutzerrolle manche Aktionen wie Verknüpfung aufheben nicht immer verfügbar sind.
Einstellungen & Optionen
In den Kontoeinstellungen findest Du unter Amazon Verbindung eine Übersicht und Verwaltung aller bestehenden Amazon- und SP-API-Verbindungen. Im Menüpunkt Integrationen lassen sich weitere Drittanbieter anbinden – für die Selling Partner API sind jedoch keine weiteren Integrationen erforderlich.
Einschränkungen & Besonderheiten
- Die Anbindung ist regionsspezifisch. Überprüfe also immer, ob Du in der gewünschten Region arbeitest, bevor Du eine Verbindung einrichtest.
- Für die Amazon-Freigabe öffnet sich ein neues Fenster. Pop-up-Blocker sollten dafür deaktiviert sein.
- Die Statusanzeigen VERBUNDEN und der Name des Accounts helfen Dir zu erkennen, welche Konten derzeit erfolgreich angebunden sind.
- Solange kein Seller- oder Vendor-Konto angebunden ist, erscheint der dazugehörige SP-API-Bereich nicht.
- Beachte, dass die Verbindung zu Deinem Amazon-Konto alle 2 Jahre erneuert werden muss. Ist die Verbindung abgelaufen, siehst Du keine Daten mehr in Deinen Dashboards und Du musst die Verbindung aufheben und neu verknüpfen.
Tipps & Best Practices
- Verbinde erst Dein Seller oder Vendor Central-Konto, bevor Du die Selling Partner API einrichtest. So erscheinen Deine verfügbaren Accounts automatisch im Auswahlfeld.
- Halte Deine Anbindungen aktuell: Sollte eine Verbindung entfernt werden, prüfe, ob alle erforderlichen Funktionen weiterhin wie gewünscht arbeiten.
## Übersicht
Die Anbindung Deines Amazon-Kontos für die Selling Partner API in BidX besteht aus zwei Schritten. Zunächst verbindest Du Dein Amazon-Konto (Seller Central oder Vendor Central), um Werbedaten abzurufen. Anschließend verknüpfst Du die Selling Partner API, um Zugriff auf organische Daten zu erhalten. Dabei kannst Du die gewünschte Region und den Kontotyp auswählen und bei Bedarf bestehende Verbindungen verwalten.
## Zugriff auf die Funktion
Du erreichst die Anbindung in den **Kontoeinstellungen** unter dem Punkt **Amazon Verbindung**. Dort findest Du die Übersicht und alle notwendigen Schritte, um die SP-API einzurichten und zu verwalten.
## Schritt-für-Schritt-Anleitung
### Schritt 1: Region wählen
Öffne **Kontoeinstellungen > Amazon Verbindung**. Wähle die gewünschte Region aus. Zur Auswahl stehen **Europa & Indien**, **Nordamerika** sowie **Fernost**. Je nach gewählter Region werden Dir nur die für diese Region verfügbaren Konten angezeigt. Nicht alle Regionen sind zwangsläufig für jeden Account verfügbar.
### Schritt 2: Amazon-Konto verbinden
Unter den jeweiligen Logos **Seller Central** und **Vendor Central** klickst Du auf den **Login with Amazon**-Button. Dadurch startest Du den Anmeldeprozess bei Amazon für das gewählte Konto. Nach erfolgreicher Anmeldung wird die Verbindung hergestellt und Du erhältst die Meldung **VERBUNDEN** sowie den Hinweis **Dein Konto ist verbunden**. Über **Verknüpfung aufheben** kannst Du die Verbindung wieder trennen. Mit **Marktplätze bearbeiten** lässt sich steuern, für welche Marktplätze Dein Konto verbunden sein soll. Mehr dazu in diesem Artikel.
### Schritt 3.1: Selling Partner (Seller) verbinden
Im Bereich **Selling Partner (Seller)** wählst Du aus dem Dropdown **Wähle einen Account aus** das gewünschte Verkäuferkonto. Nach Auswahl wirst Du zu Amazon weitergeleitet, um die Freigabe für den Zugriff auf organische Daten zu erteilen. Ist die Verbindung erfolgreich, erscheint **VERBUNDEN** sowie der Name des verknüpften Accounts. Über **Verknüpfung aufheben** kannst Du die SP-API-Verbindung bei Bedarf trennen.
Falls kein Seller-Konto hinterlegt ist, wird Dir dieser Bereich nicht angezeigt. In diesem Fall verbinde zunächst Dein Seller Central-Konto (siehe Schritt 2.).
### Schritt 3.2: Selling Partner (Vendor) verbinden
Analog zu den Verkäuferkonten gehst Du im Abschnitt **Selling Partner (Vendor)** vor. Hier wählst Du einen Vendor-Account aus und wirst zu Amazon geleitet, um die Freigabe für die SP-API zu erteilen. Nach erfolgreicher Autorisierung erscheint der Hinweis **VERBUNDEN** zusammen mit dem Namen des zugeordneten Vendor-Kontos. Auch hier steht Dir **Verknüpfung aufheben** zur Verfügung.
Fehlt ein Vendor-Konto, ist dieser Bereich nicht sichtbar. Verbinde dann zunächst Dein Vendor Central-Konto.
### Schritt 4: Funktion der SP-API prüfen
Nachdem die SP-API-Verbindung für den gewünschten Account aktiv ist, prüfe die Statushinweise rund um die verbundenen Bereiche. Wenn der Hinweis **VERBUNDEN** angezeigt wird, werden die organischen Daten künftig abgerufen und in BidX zur Verfügung gestellt. Sollte ein Fehler auftreten oder die Autorisierung nicht erfolgreich gewesen sein, erhältst Du eine entsprechende Statusmeldung, etwa „unbekannter Fehler“ oder „Die Autorisierung wurde erfolgreich abgeschlossen“.
### Schritt 5: Verbindung verwalten
Um eine bestehende Verbindung zu entfernen, klicke im jeweiligen Bereich auf **Verknüpfung aufheben**. Es erscheint ein Dialog zur Bestätigung. Erst nach Deinem expliziten Einverständnis wird die Verbindung gelöst. Möchtest Du Deine Datenabdeckung anpassen, kannst Du über **Marktplätze bearbeiten** gezielt die zu verbindenden Marktplätze für Dein Konto auswählen oder ändern.
Bitte beachte, dass je nach Nutzerrolle manche Aktionen wie **Verknüpfung aufheben** nicht immer verfügbar sind.
## Einstellungen & Optionen
In den **Kontoeinstellungen** findest Du unter **Amazon Verbindung** eine Übersicht und Verwaltung aller bestehenden Amazon- und SP-API-Verbindungen. Im Menüpunkt **Integrationen** lassen sich weitere Drittanbieter anbinden – für die Selling Partner API sind jedoch keine weiteren Integrationen erforderlich.
## Einschränkungen & Besonderheiten
- Die Anbindung ist regionsspezifisch. Überprüfe also immer, ob Du in der gewünschten Region arbeitest, bevor Du eine Verbindung einrichtest.
- Für die Amazon-Freigabe öffnet sich ein neues Fenster. Pop-up-Blocker sollten dafür deaktiviert sein.
- Die Statusanzeigen **VERBUNDEN** und der Name des Accounts helfen Dir zu erkennen, welche Konten derzeit erfolgreich angebunden sind.
- Solange kein Seller- oder Vendor-Konto angebunden ist, erscheint der dazugehörige SP-API-Bereich nicht.
- Beachte, dass die Verbindung zu Deinem Amazon-Konto alle 2 Jahre erneuert werden muss. Ist die Verbindung abgelaufen, siehst Du keine Daten mehr in Deinen Dashboards und Du musst die Verbindung aufheben und neu verknüpfen.
## Tipps & Best Practices
- Verbinde erst Dein Seller oder Vendor Central-Konto, bevor Du die Selling Partner API einrichtest. So erscheinen Deine verfügbaren Accounts automatisch im Auswahlfeld.
- Halte Deine Anbindungen aktuell: Sollte eine Verbindung entfernt werden, prüfe, ob alle erforderlichen Funktionen weiterhin wie gewünscht arbeiten.