Inventarmigration von V1 zu V2

V1-Inventar ist eine hierarchische Struktur von Feedentitäten im JSON-LD-Format. Dank dieses Schemas konnten Partner von Early Access-Programmen das Schema für die Integration in „Ordering End-to-End“ verwenden. Das v1-Inventarschema wurde verworfen.

Die neueste Version der Datenfeedspezifikation, das V2-Inventar, hat eine flache Struktur und verwendet ein relationales Schemamodell. So können Partner auf einfachere Weise Entitäten aus ihrer relationalen Datenbank extrahieren und transformieren, um die Datenfeeds zu erstellen. Das V2-Inventar wird im NDJSON-Format bereitgestellt, einem durch Zeilenumbruch getrennten JSON-Format.

Gründe für die Migration von Version 1 zu Version 2

Wir bieten Partnern mit Bestellsystem-End-to-End-Inventarschema-Integrationen von Version 1 zwar weiterhin Wartungssupport, aber alle neuen Partnerintegrationen müssen das V2-Inventar verwenden.

Neue Funktionen im V2-Inventar sind möglicherweise nicht im V1-Inventar verfügbar. Ein Beispiel finden Sie unter Deal.

Migrationsanleitung

Die Verwendung von V2-Inventar erfordert ein separates End-to-End-Projekt für die Auftragsabwicklung und eine neue Integration. Im Folgenden wird erläutert, wie Sie ein V1-Inventar zu einem V2-Inventar migrieren.

  1. Wenn Sie ein neues v2-Projekt erstellen möchten, führen Sie zuerst die Integrationsschritte aus.
    1. Verwenden Sie zum Implementieren der Datenfeeds das relationale Inventarschema.
    2. Verwenden Sie gegebenenfalls den Auftragsausführungsendpunkt aus Ihrem v1-Projekt.
  2. Wenn Ihr v2-Projekt startbereit ist, gehen Sie so vor:
  3. Sorgen Sie dafür, dass Ihr v2-Projekt die Checkliste für die Bereitschaft zur Einführung erfüllt.
    1. Wenn Sie verhindern möchten, dass Endnutzer sowohl Ihr V1- als auch Ihr V2-Inventarschema nutzen, heben Sie die Bereitstellung des Produktionsrelease in Ihrem V1-Projekt auf. Das Inventar Ihres v1-Projekts wird innerhalb weniger Minuten nach diesem Schritt nicht mehr in der Produktion bereitgestellt.
    2. Erstellen Sie einen Produktionsrelease für Ihr v2-Projekt und benachrichtigen Sie Ihren Google-Berater.

Rollback-Schritte durchführen

Wenn Sie nach der Bereitstellung Ihres v2-Projekts in der Produktion ein Rollback auf v1 durchführen möchten, können Sie die Bereitstellung des Produktionsrelease in Ihrem v2-Projekt aufheben und dann den Produktionsrelease Ihres v1-Projekts noch einmal bereitstellen.

Auswirkungen auf Partnerdaten und das Anbieter-Ranking

Im Folgenden sind mögliche Auswirkungen auf Partnerdaten und das Anbieter-Ranking aufgeführt.

  • Transaktionslogs und Analysedaten aus Ihrem v1-Projekt werden nicht in Ihr v2-Projekt übertragen.
  • Leistungsmesswerte wie Conversion-Raten und API-Messwerte aus Ihrem v1-Projekt werden nicht in das v2-Projekt übertragen. Dadurch wird das Ranking Ihres Anbieters in der End-to-End-Bestellung zurückgesetzt.