Produktsammlungen

Mit Produktsammlungen können Sie Produktgruppen definieren, die mit Rich-Formaten verwendet werden sollen, z. B. Bilder mit direkten Kaufoptionen: Jedes bis zu 100 Produkte enthalten sein. Sie können eine Sammlung mit entweder über das Google Merchant Center oder über die Content API.

In diesem Leitfaden erfahren Sie, wie Sie Produktsammlungen über die Content API, mit Beispielen, wie eine Sammlung für Bilder mit direkten Kaufoptionen erstellt wird um den Status einer Sammlung zu prüfen.

Produktsammlungen verwenden

Die Content API umfasst zwei Dienste zur Verwaltung von Produktsammlungen:

  • collections: Damit können Sie Produktsammlungen abrufen, auflisten, einfügen und löschen.

  • collectionstatuses: Hier können Sie den Status von Sammlungen abrufen und auflisten, an die um herauszufinden, ob es Probleme gibt, die dazu führen können, für ein Ziel ungültig sein, z. B. Shopping-Anzeigen:

Beispiel: Sammlung für Bilder mit direkten Kaufoptionen erstellen

Bilder mit direkten Kaufoptionen sind hoch qualitativ hochwertige Bilder, die eines oder mehrere mit Annotationen versehene Produkte zeigen und konfiguriert sind. mithilfe von Sammlungen. Wenn Sie Bilder mit direkten Kaufoptionen verwenden möchten, müssen Sie Werte für die imageLink und featuredProduct zusätzlich zu den Feldern, die für alle Sammlungen. Weitere Informationen zu Pflichtfeldern finden Sie in der Content API-Referenzdokumentation

Wenn Sie Bilder mit direkten Kaufoptionen verwenden möchten, müssen Sie eine Sammlung von Produkten erstellen und die imageLink, um ein Image anzugeben, das bis zu zehn Produkte enthält. Mi. empfehlen wir quadratische Bilder mit einem Seitenverhältnis von 1:1.

Außerdem müssen Sie die im Bild angezeigten Produkte mithilfe des featuredProduct-Feld, einschließlich der Koordinaten der Produkte im Bild mithilfe der Felder x und y. Diese Felder sind nur für Sammlungen erforderlich Bilder mit direkten Kaufoptionen. Die Werte für x und y müssen zwischen 0 und 1 liegen. inklusiv.

Jede Sammlung kann maximal 100 Produkte enthalten. Für Für Bilder mit direkten Kaufoptionen empfehlen wir, Koordinaten für maximal 10 Bilder anzugeben. pro Bild, um sicherzustellen, dass auf dem Bild genügend Platz für Erweiterungen mit Produktinformationen. Die offerId -Feld, das zum featuredProduct-Objekt gehört, muss mit dem offerId-Wert übereinstimmen. für die Ressource products, der sich vom Wert für Wert für id für die Ressource products.

Zusätzlich zu den Feldern imageLink und featuredProduct, die Pflichtfelder sind Für Bilder mit direkten Kaufoptionen können Sie auch mithilfe der Funktion optionales headline-Feld. Wir empfehlen, einen Anzeigentitel hinzuzufügen, Kunden zusätzliche Details zur Sammlung zur Verfügung stellen.

Wenn Sie eine neue Sammlung für Bilder mit direkten Kaufoptionen erstellen möchten, senden Sie eine POST-Anfrage an das 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 Sammlung prüfen

Um herauszufinden, ob es bei der oben erstellten Sammlung Probleme gibt, die die Sammlung für die Anzeigenauslieferung ungültig machen, stellen Sie eine GET-Anfrage an den collectionsstatuses.get über die folgende URL und fügen Sie den id ein. der Sammlung, deren Status Sie abrufen möchten. Sie müssen keine einen Anfragetext.

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

Beispiel für eine Antwort zum Sammlungsstatus

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