Produktsammlungen

Produktkollektionen ermöglichen Ihnen die Definition von Produktgruppen für Rich-Media-Formate wie Bilder mit direkten Kaufoptionen. Jede Kollektion kann bis zu 100 Produkte enthalten. Sie können eine Kollektion entweder im Google Merchant Center oder über die Content API erstellen.

In dieser Anleitung erfahren Sie, wie Sie Produktkollektionen über die Content API verwenden. Außerdem finden Sie Beispiele dafür, wie Sie eine Kollektion für Bilder mit direkten Kaufoptionen erstellen und den Status einer Kollektion prüfen.

Produktkollektionen verwenden

Die Content API enthält zwei Dienste zum Verwalten von Produktkollektionen:

  • collections: Mit diesem Dienst können Sie Produktkollektionen abrufen, auflisten, einfügen und löschen.

  • collectionstatuses: Mit diesem Dienst können Sie den Status von Kollektionen abrufen und auflisten, um herauszufinden, ob es Probleme mit einer Kollektion gibt, die dazu führen könnten, dass sie für ein Ziel wie Shopping-Anzeigenungültig ist.

Beispiel: Kollektion für Bilder mit direkten Kaufoptionen erstellen

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

Wenn Sie Bilder mit direkten Kaufoptionen verwenden möchten, müssen Sie eine Produktkollektion erstellen und im Feld imageLink ein Bild mit bis zu zehn Produkten angeben. Wir empfehlen, quadratische Bilder mit einem Seitenverhältnis von 1:1 zu verwenden.

Sie müssen auch die Produkte angeben, die im Bild zu sehen sind. Verwenden Sie dazu das Feld featuredProduct. Geben Sie außerdem die Koordinaten der Produkte im Bild mit den Feldern x und y an. Diese Felder sind nur für Kollektionen erforderlich, die mit Bildern mit direkten Kaufoptionen verwendet werden. Die Werte für x und y müssen zwischen 0 und 1 liegen (einschließlich).

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

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 Kollektionsüberschrift angeben. Wir empfehlen, eine Überschrift hinzuzufügen, um Kunden zusätzliche Informationen zur Kollektion zu geben.

Wenn Sie eine neue Kollektion 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 folgenden 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"
}

Beispiel: Status einer Kollektion prüfen

Wenn Sie herausfinden möchten, ob es Probleme mit der oben erstellten Kollektion gibt, die dazu führen könnten, dass sie nicht für Anzeigen verwendet werden kann, senden Sie eine GET-Anfrage an den Endpunkt collectionsstatuses.get mit der folgenden URL und fügen Sie die id der Kollektion 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 Kollektionsstatus

{
  "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"
    }
  ]
}