1. Was ist PA API 5.0?

PA API 5.0 (PA API 5) ist die neueste Version der Product Advertising API. Es ist die verbesserte Version der Vorgänger-Version, die wir als PA API 4 bezeichnen, und ermöglicht Zugriff auf die neuesten Retail-Produktinformationen. PA API 5 ist verfügbar für die Marketplaces in den Vereinigten Staaten (US), Kanada (CA), Mexiko (MX), Brasilien (BR), im Vereinigten Königreich (UK), in Deutschland (DE), Spanien (ES), Frankreich (FR), Indien (IN), Italien (IT), den Vereinigten Arabischen Emiraten (AE), der Türkei (TR), Japan (JP), Singapur (SG) und Australien (AU). Alle neuen Marketplaces werden nur in PA API 5 unterstützt. Mehr Details findest du unter Hinweise zu den Regionen.

2. Ich benutze PA API 4. Warum muss ich ein Upgrade auf die neuere Version von PA API durchführen?

Mit PA API 5 kannst du die neuesten Funktionen nutzen – nicht nur die wichtigsten Funktionen von PA API 4, sondern auch neue Funktionen, die Amazon-Produkten hinzugefügt werden. Diese neuen Möglichkeiten helfen dir, deinen Kunden ein besseres Einkaufserlebnis zu bieten. PA API 5 umfasst einen neuen Support für Entwickler, um API einfach zu integrieren und die Entwicklung deiner Anwendungen und Seiten schneller zu gestalten. Alle künftigen Produktverbesserungen werden nur über PA API 5 verfügbar sein. Eine detaillierte Liste der neuen Funktionen findest du in den nachfolgenden Fragen und in den entsprechenden Unterlagen. PA API 4 basiert auf einer auslaufenden Technologie. Wir werden PA API 4 am 9. März 2020 abschalten. All deine Anwendungen und Seiten, die PA API 4 verwenden, werden nach diesem Datum nicht mehr wie erwartet funktionieren. Daher ist es wichtig, das Upgrade auf die neueste Version von PA API durchzuführen.

3. Was ist der Geschäftswert des Upgrades auf PA API 5 für einen Partner?

PA API 5 ist eine API, die dir als Partner hilft, Produkte zu bewerben und somit eine Provision zu erhalten. Sie bietet dir folgende Vorteile:

Verbesserte Möglichkeiten, deine Seite und Social-Media-Posts zu Geld zu machen, indem du unter Verwendung der weltweiten Product Advertising API (PA API 5) und des Web-Services von Amazon auf deiner Seite Produkte verkaufst, die bei Amazon erhältlich sind.

• Zugang zu Informationen über die neuesten Angebote und Produkte in der gesamten Amazon-Produktdatenbank / im Amazon-Produktkatalog.
• Neuere, verbesserte Wege, die für die Werbung relevantesten Produktinformationen zu erhalten.
• Schnelle Integration und einfachere Entwicklung mit geringeren Engineering-Kosten durch die Verwendung beliebter Tools und Sprachen.
• Führe ein Update von PA API 4 durch, bevor der Service abgeschaltet wird, um Ausfallzeiten und einen Umsatzverlust zu vermeiden.
• NEU! Greife auf die relevantesten Produktdaten der Amazon-Retail-Seite zu: Informationen zu neuen Angeboten wie Prime, Gratisversand etc. sind über PA API 5 verfügbar.
• NEU! Entdecke Produkte und Angebote mithilfe verbesserter Suchergebnisse zu Produkten für deine Content-Recherche, indem du nach Prime, FulfillmentByAmazon und weiteren Programmen filterst.
• VERBESSERT! Finde die Produkte, die sich am besten zum Bewerben eignen, mithilfe von granulareren Verkaufsplatzierungen innerhalb von Kategorien.
• NEU! Erobere globale Märkte, indem du deine Inhalte globalisierst und regionalisierst – verschiedene Währungen und verschiedene Sprachen.
• NEU! Finde mehr Angebotsinformationen – PA API 5 bietet neue Angebotsinformationen, wie das SubscribeAndSave-Angebot mit reduzierten Preisen.
• Erhalte Programmzugriff auf die neuesten Amazon-Produktangebote, indem du Informationen über Artikel-Eigenschaften, Angebote, Bilder und Verkaufsplatzierungen verwendest.
• NEU! Werbe für Produkte, die Teil der Programme Prime exclusive, PrimePantry oder Fulfilled by Amazon sind, um deine Conversion unter Amazon-Kunden zu verbessern.
• NEU! Für globale Kunden kannst du Preisinformationen im Währungsformat und Produktinformationen in der bevorzugten Sprache für bestimmte weltweite Marketplaces erhalten.
• NEU! Reduziere Integrationskosten für die API, indem du SDKs für Java, PHP, Python und JavaScript verwendest und die Datenverarbeitung mit JSON verbesserst.
• Was sind die technischen Vorteile eines Upgrades auf PA API 5 für Entwickler?

• VERBESSERT! Finde die Produkte, die sich am besten zum Bewerben eignen, mithilfe von granulareren Verkaufsplatzierungen innerhalb von Kategorien – PA API 5 bietet jetzt Informationen zu Verkaufsplatzierungen bezüglich jeder Kategorie in einem einheitlichen Format, wie du auf der Amazon-Produktseite siehst. (PA API 4 hatte nur eine einzelne Platzierung.)
• NEU! Einfache Integration mithilfe unterstützter SDKs: PA API 5 enthält SDKs für die gängigsten Programmiersprachen (Java, PHP, Python und JavaScript), um deine Integration zu vereinfachen, die Code-Komplexität zu reduzieren und die Einführung neuer Funktionen mit minimalem Entwicklungsaufwand zu erleichtern.
• NEU! Flexibilität der Datenverarbeitung unter Verwendung des JSON-Austauschformats, das lesbarer, schneller und flexibler in der Verarbeitung und viel schlanker ist.
• NEU! PA API 5 verwendet die neueste AWS Signature Version 4, die verbesserte Sicherheit bietet, indem ein Signaturschlüssel anstelle deiner geheimen Zugangsschlüssel verwendet wird.

• Was muss ich als aktueller Nutzer von PA API tun, um auf PA API 5 zu aktualisieren?
• Wenn du aktuell PA API 4 verwendest, kannst du mit den folgenden Schritten das Upgrade auf PA API 5 durchführen.

• Wenn du alte AWS-Zugangsdaten verwendest, migriere dein Konto zum neuen PA-API-Konto.
• Erhalte neue Zugangsdaten von PartnerNet.
• Teste PA API 5 mithilfe von Scratchpad.
• Aktualisiere all deine Anwendungen und Seiten, um sie in APIs von PA API 5 zu integrieren und PA API 4 zu ersetzen.
• Teste deine neu aktualisierte Anwendung und stelle sie bereit. Eine detaillierte Anleitung findest du im Leitfaden für die Umstellung.

4. Bedeutet das, dass ich meine Seite oder Anwendung aktualisieren muss, um das Upgrade von PA API 4 auf PA API 5 durchzuführen?

Ja, wenn du derzeit PA API 4 verwendest, musst du deine Seite oder Anwendung mithilfe von PA API 5 aktualisieren, um alle API-Aufrufe über PA API 4 durch entsprechende PA-API-5-APIs zu ersetzen. Um dir zu helfen, haben wir eine einfache Tabelle erstellt, die die API-Aufrufe über PA API 4 und die API-Aufrufe über PA API 5 gegenüberstellt. Diese Tabelle findest du im Leitfaden für die Umstellung.

5. Wie viel Aufwand und Zeit erfordert das Upgrade von PA API 4 auf PA API 5?

Der Aufwand und die benötigte Zeit für das Upgrade auf PA API 5 hängen von der Komplexität deiner Seite oder Anwendung ab. Wir können hierzu keine genauen Informationen geben. Wir haben festgestellt, dass es 3–4 Wochen dauert, um die zur Aktualisierung von PA API 4 auf PA API 5 notwendigen Änderungen an einer typischen Anwendung zu vollziehen. Die Zeit für Tests und Bereitstellung hängt von deinen individuellen Konfigurationen ab. Während der Upgrade-Zeit von jetzt bis zum 9. März 2020 kannst du sowohl auf PA API 4 als auch auf PA API 5 zugreifen. Zur Vereinfachung haben wir Informationen zur Fehlerbehebung bereitgestellt. Du kannst uns auch über die E-Mail-Adresse in den FAQ kontaktieren.

6. Brauche ich neue Zugangsdaten, um auf PA API 5 zuzugreifen, oder kann ich meine alten verwenden?

Wenn du deine Zugangsdaten nach dem 30. September 2017 erstellt hast, sind keine Maßnahmen erforderlich. Wenn du deine Zugangsdaten vor dem 29. September 2017 erstellt hast, besuche bitte die PA-API-Seite in PartnerNet und klicke auf „Jetzt umstellen“ (migrate now), um deine Zugangsdaten durch solche zu ersetzen, die mit PA API 5 kompatibel sind. Stelle sicher, dass du dich mit deinem primären Besitzerkonto anmeldest. Weitere Informationen findest du unter Migrieren deines Kontos. Bitte vergewissere dich, dass du all deine bestehenden Zugangsdaten und Konfigurationsdateien umgehend aktualisierst, um PA API weiterhin erfolgreich zu verwenden.

7. Ich weiß nicht mehr, ob ich neue Zugangsdaten erstellt habe. Woher weiß ich, ob ich alte oder neue Zugangsdaten habe?

Die einfachste Art, PA API zu prüfen, besteht darin, die PA-API-Seite in PartnerNet anzusehen. Stelle sicher, dass du dich mit deinem primären Besitzerkonto anmeldest.

Bitte verwende das Scratchpad für PA API 5, um zu überprüfen, ob deine Zugangsdaten mit PA API 5 kompatibel sind. Nutze die Option „Tour starten“ (Start Tour) für eine Einweisung in das Tool. Wenn du Fragen hast, sieh dir die Scratchpad-Gebrauchsanleitung an.

Wenn du eine „AccessDeniedException“ mit dem „AccessDeniedAwsUsers“-Code erhältst, klicke bitte auf den PA-API-Tab auf der PartnerNet-Website und migriere deine Zugangsdaten.

Wenn du die oben genannte Ausnahme nicht erhältst, spiele mit dem Scratchpad herum, um die Funktionalität zu sehen, die in PA API 5 angeboten wird.

Solltest du während der Anwendungsentwicklung deine Anwendung von Fehlern befreien wollen, kannst du Scratchpad verwenden, um die Antworten der API zu bestätigen. Mehr Details dazu findest du unter „zusätzliche Hilfe“ (additional help).

8. Kann ich neue Zugangsdaten verwenden, um auf PA API 4 zuzugreifen?

Ja, du kannst neue Zugangsdaten verwenden, um auf PA API 4 zuzugreifen. Dies ist bis zur Abschaltung des Zugangs zu PA API 4 am 9. März 2020 möglich. Du kannst auch weiterhin deine alten Zugangsdaten für PA API 4 verwenden, solange es verfügbar ist. Aber um nicht zwei Sätze an Zugangsdaten verwalten zu müssen (alte und neue), kannst du die neuen Zugangsdaten für alle PA-API-Versionen verwenden.

9. Kann ich, wenn ich das Upgrade zu PA API 5 durchgeführt habe, zurück zu PA API 4 wechseln?

Sobald du auf PA API 5 umgestellt hast, kannst du weiterhin sowohl PA API 5 als auch PA API 4 verwenden. Dadurch kannst du während des Upgrades beide Systeme parallel zu Testzwecken verwenden und vermeidest so Ausfallzeiten. Am 9. März 2020 schalten wir PA API 4 ab. Danach wirst du es nicht weiter verwenden können. Du kannst PA API 5 weiterhin mit den aktuellen Zugangsdaten verwenden.

10. Gelten für das Upgrade auf PA API 5 die Effizienz-Richtlinien?

Ja, nach dem Upgrade auf PA API 5 gelten dieselben Effizienzrichtlinien und -beschränkungen.

11. Ich habe PA API nie verwendet. Was muss ich tun, um PA API 5 zu verwenden?

Wenn du dich registriert hast, um Teil des Amazon-Partnerprogramms zu sein, und dein Konto genehmigt wurde, kannst du Zugang zu PA API anfordern. Sobald du deine Zugangsdaten vom PartnerNet erhältst, kannst du sie verwenden, um PA API 5 aufzurufen. Mehr Informationen findest du unter Für PA API anmelden.

12. Wenn ich neue Zugangsdaten generiere, um mit dem Upgrade auf PA API 5 zu beginnen, wie lange funktionieren meine alten Zugangsdaten mit meiner vorhandenen PA-API-4-Integration?

Deine alten Zugangsdaten funktionieren mit PA API 4, bis es abgeschaltet wird.

13. Kann ich mit den neuen Zugangsdaten dennoch auf PA API 4 zugreifen?

Du kannst die neuen Zugangsdaten verwenden, um auf PA API 4 zuzugreifen, bis es abgeschaltet wird.

14. Ich verwende derzeit AWS Signature V2, um signierte Anfragen zu generieren. Muss ich auf AWS Signature V4 migrieren, um eine Anfrage an PA API 4 zu stellen?

Du wirst weiterhin den vorhandenen AWS-Signature-V2-Mechanismus verwenden, wenn du eine Anfrage an PA API 4 signierst, egal, ob du alte oder neue Zugangsdaten verwendest. Zum Signieren einer Anfrage an PA API 5 musst du den AWS-Signature-V4-Mechanismus verwenden. Du kannst PA API 5 SDK verwenden, um Anfragen an PA API 5 zu senden. Diese übernimmt die Signatur der Anfrage für dich.

15. Wenn ich mich als Partner in verschiedenen Marketplaces mit derselben E-Mail-ID angemeldet habe, muss ich dann in jedem Marketplace auf der PartnerNet-Website Zugangsdaten generieren?

Mit PA API 5 kannst du auf alle Marketplaces außer JP mit demselben Satz Zugangsdaten zugreifen, wenn die genehmigten Shops im Marketplace mit demselben primären Besitzer (E-Mail-ID) übereinstimmen. Für JP benötigst du einen separaten Satz Zugangsdaten, den du auf der JP-PartnerNet-Seite generieren und nur im JP-Marketplace verwenden kannst. Wenn du dich in verschiedenen Marketplaces mit unterschiedlichen E-Mail-IDs als Partner angemeldet hast, musst du für jede E-Mail-ID eigene Zugangsdaten generieren.

16. Ich bin nicht sicher, welche API-Version ich verwende.

Wenn du ItemLookup, ItemSearch, SimilarityLookup, CartCreate, CartAdd, CartGet, CartModify und CartClear verwendest, nutzt du PA API 4, andernfalls PA API 5. Wenn du eine Antwort in XML erhältst, verwendest du PA API 4, bei JSON PA API 5. Wenn du eine Software oder ein Plug-in eines externen Anbieters oder eines Drittanbieters verwendest, erkundige dich bei diesem nach den Einzelheiten.

17. Wann werden SDKs auf Drittspeicher und Github hochgeladen?

Wir arbeiten daran und werden sie bald hochladen.

18. Wird Power Search von PA API 5 unterstützt?

Power Search wird abgeschafft und von PA API 5 nicht unterstützt.

19. Wird Batching von PA API 5 unterstützt?

Mit PA API 5 kannst du verschiedene Artikel-IDs (bis zu 10) für GetItems API und verschiedene BrowseNode-IDs (bis zu 10) für GetBrowseNodes API spezifizieren.

20. Woher weiß ich, ob ich das PA API 5 Scratchpad verwende?

Sieh dir das Logo an. PA API 5 Scratchpad verweist auf Product Advertising API 5.0. Bitte benutze die folgenden Links, um auf Scratchpad zuzugreifen: PA API 5 Scratchpad, PA API 4 Scratchpad.

21. Ich kann die Migrationsschaltfläche im PA-API-Tab der PartnerNet-Website nicht finden. Wie kann ich migrieren?

Besuche die PartnerNet-Website. Melde dich mit der E-Mail-ID des primären Besitzers des Shops an. Wähle in der Navigationsleiste „Tools“ > „Product Advertising API“. Wähle im Abschnitt „Zugangsdaten verwalten“ (Manage your credential) die Option zum Migrieren deiner Zugangsdaten. Sobald die Zugangsdaten erstellt wurden, kannst du sie mit Amazon Product Advertising API 5.0 Scratchpad verwenden.

22. Warum ist die Schaltfläche „Beitreten/Migrieren“ (Join/Migrate) deaktiviert?

Auf die PA API 5 kann nur der primäre Besitzer des Shops zugreifen, der genehmigt wurde. Wenn die Schaltfläche „Beitreten/Migrieren“ (Join/Migrate) oder die Schaltfläche zum Erstellen oder Hinzufügen von Zugangsdaten deaktiviert ist, stelle sicher, dass dein Geschäft genehmigt wurde und du als primärer Besitzer des Shops in PartnerNet angemeldet bist.

23. Ich verwende derzeit IAM-Benutzer zum Generieren von API-Schlüsseln. Muss ich auf der PartnerNet-Website migrieren, um neue Zugangsdaten zu erhalten?

Ja, du musst in PartnerNet migrieren.

24. Wie kann ich überprüfen, ob ich mich mit meinem primären Konto angemeldet habe?

Melde dich auf der PartnerNet-Website an. Wenn du Zugang zu den Seiten zur Aktualisierung der Zahlungsmethode und zu den Steuerfragen für den ausgewählten Shop hast, dann bist du der primäre Besitzer des Shops.

25. Wie finde ich den primären Besitzer des Shops?

Du kannst den Kundenservice über die PartnerNet-Website kontaktieren.

26. Ich sehe, dass die URLs in PA API 4 und PA API 5 unterschiedlich sind. Funktioniert die Zuordnung für beide?

Ja, die Zuordnung funktioniert mit beiden. Derzeit zeigt der Linkart-Bericht keine Daten für PA API 5 an. Wir werden sie bald hinzufügen.

27. Ich suche nach der Cart-Funktion, die in PA API 4 unterstützt wurde. Wie kann ich Carts verwenden?

Cart API wird durch PA API 5 nicht mehr unterstützt. Du kannst das Formular „In den Einkaufswagen“ verwenden.

28. In PA API 4 habe ich Artikel mithilfe von EAN/UPC/ISBN mit ItemLookup API gesucht. Wie unterstützt PA API 5 diese Nutzung?

Im Bereich Suche mit externen Kennungen (UPC/EAN/ISBN) findest du weitere Informationen.

29. Ich habe Fragen oder Feedback. Wie erhalte ich zusätzliche Hilfe?

Wenn du Fragen/Feedback hast, kannst du wie folgt Hilfe erhalten:

Die Unterlagen enthalten viele Beispiele für die Verwendung von PA API 5.

Bei Fehler-Codes und -Meldungen siehe Fehlerbehebung.

Um Beispiel-Anfragen und Code-Beispiele zu erstellen, siehe Verwendung des Amazon Product Advertising API 5.0 Scratchpads.

Wenn dies deine Frage nicht beantwortet, kannst du dich mit einer der Methoden, die auf der Hauptseite von PartnerNet aufgeführt sind, an den Support wenden: https://affiliate-program.amazon.co.uk/