Mit Produktsammlungen können Sie Gruppen von Produkten definieren, die mit ansprechenden Formaten wie Bildern mit direkten Kaufoptionen verwendet werden sollen. Jede Sammlung kann bis zu 100 Produkte enthalten. Sie können eine Sammlung entweder über das Google Merchant Center oder die Content API erstellen.
In dieser Anleitung wird beschrieben, wie Sie Produktkollektionen über die Content API verwenden. Außerdem finden Sie Beispiele dafür, wie Sie eine Kollektion für Shoppable Images erstellen und den Status einer Kollektion prüfen.
Produktsammlungen verwenden
Die Content API umfasst zwei Dienste zum Verwalten von Produktsammlungen:
collections: Ermöglicht das Abrufen, Auflisten, Einfügen und Löschen von Produktkollektionen.collectionstatuses: Hiermit können Sie den Status von Sammlungen abrufen und auflisten, um herauszufinden, ob eine Sammlung Probleme aufweist, die dazu führen können, dass sie für ein Ziel wie Shopping-Anzeigen ungültig ist.
Beispiel: Sammlung für Bilder mit direkten Kaufoptionen erstellen
Bilder mit direkten Kaufoptionen sind hochwertige Bilder, auf denen ein oder mehrere Produkte mit Anmerkungen zu sehen sind. Sie werden mithilfe von Sammlungen konfiguriert. 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 erforderlichen Feldern 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 mit dem 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).
Sie müssen die im Bild gezeigten Produkte auch über das Feld featuredProduct angeben, einschließlich der Koordinaten der Produkte im Bild über die Felder x und y. 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 liegen (einschließlich).
Jede Sammlung kann maximal 100 Produkte enthalten. Bei Bildern mit direkten Kaufoptionen empfehlen wir jedoch, Koordinaten für maximal 10 Produkte pro Bild anzugeben, damit genügend Platz für die Produkterweiterungen mit Zusatzinformationen ist. Das Feld offerId, 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 Überschrift für die Sammlung angeben. Wir empfehlen, einen Titel hinzuzufügen, um Kunden zusätzliche Informationen zur Sammlung zu geben.
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 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
Wenn Sie herausfinden möchten, ob die oben erstellte Sammlung Probleme aufweist, die dazu führen, dass keine Anzeigen ausgeliefert werden können, senden Sie eine GET-Anfrage an den collectionsstatuses.get-Endpunkt mit der folgenden URL und geben Sie die id der Sammlung an, 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"
}
]
}