Produktsammlungen

Mit Produktsammlungen können Sie Produktgruppen definieren, die in Rich-Formaten wie Bilder mit direkten Kaufoptionen verwendet werden sollen. Jede Sammlung kann bis zu 100 Produkte enthalten. Sie können eine Sammlung entweder mit dem Google Merchant Center oder der Content API erstellen.

In diesem Leitfaden erfahren Sie, wie Sie Produktsammlungen über die Content API verwenden. Außerdem erfahren Sie, wie Sie eine Sammlung für Bilder mit direkten Kaufoptionen erstellen und den Status einer Sammlung prüfen können.

Hinweis :Bilder mit direkten Kaufoptionen sind derzeit das einzige Anzeigenformat, das Sammlungen unterstützt. Es können jedoch weitere Formate hinzugefügt werden, damit Sie Ihre Sammlungen in verschiedenen Anzeigenformaten verwenden können.

Produktsammlungen verwenden

Die Content API umfasst zwei Dienste zum Verwalten von Produktsammlungen:

• collections: Ermöglicht das Abrufen, Auflisten, Einfügen und Löschen von Produktsammlungen.

• collectionstatuses: Hiermit können Sie den Status von Sammlungen abrufen und auflisten, um festzustellen, ob eine Sammlung Probleme hat, die dazu führen können, dass die Sammlung für ein Ziel wie Shopping-Anzeigen ungültig ist.

Beispiel: Sammlung für Bilder mit direkten Kaufoptionen erstellen

Images mit direkten Kaufoptionen sind Bilder von hoher Qualität, die ein oder mehrere annotierte Produkte zeigen und mithilfe von Sammlungen konfiguriert werden. Wenn Sie Bilder mit direkten Kaufoptionen verwenden möchten, müssen Sie zusätzlich zu den für alle Sammlungen erforderlichen Feldern Werte für die Felder imageLink und featuredProduct angeben. Weitere Informationen zu Pflichtfeldern finden Sie in der Referenzdokumentation zur Content API.

Wenn Sie Bilder mit direkten Kaufoptionen verwenden möchten, müssen Sie eine Produktsammlung erstellen und im Feld imageLink ein Bild angeben, das bis zu zehn Produkte enthält. Wir empfehlen die Verwendung quadratischer Bilder (mit einem Seitenverhältnis von 1:1).

Wichtiger Hinweis :Das Feld imageLink für Sammlungen akzeptiert ein Array von Bildlink-Werten. Allerdings wird nur der erste Wert im Array für das Format von Bildern mit direkten Kaufoptionen verwendet.

Außerdem müssen Sie mit dem Feld featuredProduct die im Bild angezeigten Produkte einschließlich der Koordinaten der Produkte im Bild mithilfe der Felder x und y angeben. Diese Felder sind nur für Sammlungen erforderlich, die mit Bildern mit direkten Kaufoptionen verwendet werden. Die Werte für x und y müssen zwischen 0 und 1 (einschließlich) liegen.

Jede Sammlung kann maximal 100 Produkte enthalten. Für Bilder mit direkten Kaufoptionen empfehlen wir jedoch, die Koordinaten für nicht mehr als zehn Produkte pro Bild anzugeben, damit auf dem Bild genügend Platz für die Zusatzinformationen zu Produkten bleibt. Das Feld offerId, das Teil des Objekts featuredProduct ist, muss mit dem Wert offerId für die Ressource products übereinstimmen, der sich vom Wert id in der Ressource products unterscheidet.

Zusätzlich zu den Feldern imageLink und featuredProduct, die für Bilder mit direkten Kaufoptionen erforderlich sind, können Sie mit dem optionalen Feld headline auch eine Überschrift für die Sammlung angeben. Wir empfehlen, eine Überschrift hinzuzufügen, um Kunden zusätzliche Details zur Sammlung bereitzustellen.

Wichtiger Hinweis: Das Feld headline für Sammlungen akzeptiert ein Array von Anzeigentitelwerten. Allerdings wird nur der erste Wert im Array für das Format von Bildern mit direkten Kaufoptionen verwendet.

Wenn Sie eine neue Sammlung für Bilder mit direkten Kaufoptionen erstellen möchten, senden Sie eine POST-Anfrage an den Endpunkt collections.insert mit der folgenden URL und dem Anfragetext:

https://shoppingcontent.googleapis.com/content/v2.1/merchantId/collections

{
  "id": "exampleCollection"
  "language": "en",
  "productCountry": "UK",
  "imageLink": ["www.imageLink.example"],
  "featuredProduct": [
{
  "offerId": '432',
  "x": 0.11,
  "y": 0.99
},
{ "offerId": '433',
  "x": 0.53,
  "y": 0.89
}
],
  "link": "www.link.example",
  "mobileLink": "www.mobileLink.example",
  "headline": "www.link.example",
  "customLabel0": "Organize",
  "customLabel1": "Your",
  "customLabel2": "Bidding/Reporting",
  "customLabel3": "With",
  "customLabel4": "Me"
}

Warnung: Wenn eine Sammlung mit demselben id vorhanden ist, wird die Ressource bei einer Anfrage an collections.insert vollständig ersetzt.

Beispiel: Status einer Sammlung prüfen

Wenn Sie herausfinden möchten, ob es in der oben erstellten Sammlung Probleme gibt, die die Bereitstellung von Anzeigen verhindern, senden Sie eine GET-Anfrage an den Endpunkt collectionsstatuses.get mit der folgenden URL und fügen Sie die id der Sammlung ein, deren Status Sie abrufen möchten. Sie müssen keinen Anfragetext angeben.

https://shoppingcontent.googleapis.com/content/v2.1/merchantID/collectionstatuses/collection ID

Beispiel für eine Antwort zum Erfassungsstatus

{
  "id": "exampleCollection",
  "creationDate": "2020-09-22T00:26:51Z",
  "lastUpdateDate": "2020-09-22T00:26:51Z",
  "collectionLevelIssues": [
    {
      "code": "invalid_url",
      "servability": "unaffected",
      "resolution": "merchant_action",
      "attributeName": "link",
      "description": "Invalid URL [link]",
      "detail": "Use a complete URL that starts with http:// or https:// and
          links to a valid destination such as an image or a landing page",
      "documentation": "https://support.google.com/merchants/answer/7052112"
    },
    {
      "code": "invalid_url",
      "servability": "unaffected",
      "resolution": "merchant_action",
      "attributeName": "imageLink",
      "description": "Invalid URL [imageLink]",
      "detail": "Use a complete URL that starts with http:// or https:// and
          links to a valid destination such as an image or a landing page",
      "documentation": "https://support.google.com/merchants/answer/7052112"
    }
  ]
}