Kolekcje produktów

Kolekcje produktów umożliwiają definiowanie grup produktów do użycia w formatach rozszerzonych, takich jak reklamy graficzne z możliwością zakupu. Każda kolekcja może zawierać maksymalnie 100 produktów. Kolekcję możesz utworzyć w Google Merchant Center lub za pomocą Content API.

Z tego przewodnika dowiesz się, jak korzystać z kolekcji produktów za pomocą Content API. Znajdziesz tu też przykłady tworzenia kolekcji na potrzeby reklam graficznych z możliwością zakupu oraz 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 kolekcja ma jakieś problemy, które mogą spowodować, że nie będzie ona prawidłowa w przypadku miejsca docelowego, takiego jak reklamy produktowe.

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

Reklamy graficzne z możliwością zakupu to wysokiej- jakości zdjęcia, które przedstawiają jeden lub więcej produktów z adnotacjami. Są one konfigurowane za pomocą kolekcji. Aby korzystać z reklam graficznych z możliwością zakupu, oprócz pól wymaganych w przypadku wszystkich kolekcji musisz podać wartości pól imageLink i featuredProduct. 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 obrazie za pomocą pola featuredProduct, w tym współrzędne produktów na obrazie 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 określenie współrzędnych nie więcej niż 10 produktów na obrazie, aby zapewnić wystarczającą ilość miejsca na obrazie do wyświetlania objaśnień 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ę na potrzeby 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 reklam, wyślij żądanie GET do punktu końcowego collectionsstatuses.get, używając tego adresu URL i podając id 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ź ze stanem 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"
    }
  ]
}