Kolekcje produktów umożliwiają definiowanie grup produktów do użycia w formatach rozbudowanych, takich jak reklamy graficzne z możliwością zakupu. Każda kolekcja może zawierać do 100 produktów. Kolekcję możesz utworzyć w Google Merchant Center lub za pomocą interfejsu Content API.
Ten przewodnik pokazuje, jak korzystać z kolekcji produktów za pomocą interfejsu Content API, w tym przykłady tworzenia kolekcji dla reklam graficznych z możliwością zakupu i sprawdzania stanu kolekcji.
Korzystanie z kolekcji produktów
Content API obejmuje 2 usługi do zarządzania kolekcjami produktów:
collections: umożliwia pobieranie, wyświetlanie, wstawianie i usuwanie kolekcji produktów.collectionstatuses: umożliwia pobieranie i wyświetlanie stanu kolekcji, aby sprawdzić, czy nie ma ona problemów, które mogą spowodować, że będzie nieprawidłowa w przypadku miejsca docelowego, np. reklam produktowych.
Przykład: tworzenie kolekcji reklam graficznych z możliwością zakupu
Reklamy graficzne z możliwością zakupu to wysokiej jakości zdjęcia, które pokazują jeden lub więcej produktów z adnotacjami i są konfigurowane za pomocą kolekcji. Aby korzystać z reklam graficznych z możliwością zakupu, musisz podać wartości pól imageLink i featuredProduct, a także pól wymaganych w przypadku wszystkich kolekcji. Więcej informacji o wymaganych polach znajdziesz w dokumentacji referencyjnej Content API.
Aby korzystać z reklam graficznych z możliwością zakupu, musisz utworzyć kolekcję produktów i użyć pola
imageLink, aby określić obraz zawierający maksymalnie 10 produktów. Zalecamy używanie obrazów kwadratowych (o współczynniku proporcji 1:1).
Musisz też określić produkty wyświetlane na zdjęciu za pomocą pola featuredProduct, w tym współrzędne produktów na zdjęciu za pomocą pól x i y. Te pola są wymagane tylko w przypadku kolekcji używanych w reklamach graficznych z możliwością zakupu. Wartości x i y muszą mieścić się w zakresie od 0 do 1 włącznie.
Każda kolekcja może zawierać maksymalnie 100 produktów. W przypadku reklam graficznych z możliwością zakupu zalecamy jednak podanie współrzędnych nie więcej niż 10 produktów na obraz, aby zapewnić wystarczającą ilość miejsca na objaśnienia produktów. Pole offerId, które jest częścią obiektu featuredProduct, musi być zgodne z wartością offerId w zasobie products, która różni się od wartości id w zasobie products.
Oprócz pól imageLink i featuredProduct, które są wymagane w przypadku reklam graficznych z możliwością zakupu, możesz też określić nagłówek kolekcji za pomocą opcjonalnego pola headline. Zalecamy dodanie nagłówka, aby przekazać klientom dodatkowe informacje o kolekcji.
Aby utworzyć nową kolekcję reklam graficznych z możliwością zakupu, wyślij żądanie POST do punktu końcowego collections.insert, używając tego adresu URL i treści żądania:
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"
}
Przykład: sprawdzanie stanu kolekcji
Aby sprawdzić, czy utworzona powyżej kolekcja ma problemy, które uniemożliwiają wyświetlanie w niej reklam, wyślij GETżądanie do punktu końcowegocollectionsstatuses.get, używając tego adresu URL, i dołącz idcollectionsstatuses.get kolekcji, której stan chcesz pobrać. Nie musisz podawać treści żądania.
https://shoppingcontent.googleapis.com/content/v2.1/merchantID/collectionstatuses/collection ID
Przykładowa odpowiedź dotycząca stanu kolekcji
{
"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"
}
]
}