Kolekcje produktów

Kolekcje produktów pozwalają definiować grupy produktów, których chcesz używać w formatach rozszerzonych, 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 Content API.

Z tego przewodnika dowiesz się, jak korzystać z kolekcji produktów za pomocą interfejsu Content API, w tym jak utworzyć kolekcję reklam graficznych z możliwością zakupu i jak sprawdzić stan kolekcji.

Korzystanie z kolekcji produktów

Interfejs Content API zawiera 2 usługi do zarządzania kolekcjami produktów:

  • collections: pozwala pobierać, wyświetlać, wstawiać i usuwać kolekcje produktów.

  • collectionstatuses: pozwala wyświetlić i wyświetlić stan kolekcji, aby sprawdzić, czy w kolekcji występują problemy, które mogą być przyczyną nieprawidłowych kolekcji dla określonego miejsca docelowego, np. reklam produktowych.

Przykład: tworzenie kolekcji reklam graficznych z możliwością zakupu

Obrazy z możliwością zakupu to wysokiej jakości obrazy, które prezentują co najmniej jeden produkt z adnotacjami, i są konfigurowane przy użyciu kolekcji. Aby używać reklam graficznych z możliwością zakupu, musisz podać wartości pól imageLink i featuredProduct oraz wartości wymagane 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ć zdjęcie zawierające maksymalnie 10 produktów. Zalecamy używanie obrazów kwadratowych (o współczynniku proporcji 1:1).

Produkty wyświetlone na zdjęciu musisz też określić w polu 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. Jednak w przypadku reklam graficznych z możliwością zakupu zalecamy określenie współrzędnych maksymalnie 10 produktów na obraz, aby mieć na nim wystarczającą ilość miejsca, aby wyświetlać objaśnienia produktów. Pole offerId, które jest częścią obiektu featuredProduct, musi odpowiadać 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ż podać 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 w utworzonej powyżej kolekcji występują problemy, które unieważniłyby kolekcję z powodu wyświetlania reklam, wyślij żądanie GET do punktu końcowego collectionsstatuses.get przy użyciu tego adresu URL i dołącz id zbioru, którego stan chcesz pobrać. Nie musisz określać treści żądania.

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

Przykładowa odpowiedź na temat 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"
    }
  ]
}