Kolekcje produktów

Dzięki kolekcjom produktów możesz określić grupy produktów, które mają być używane z formatami rozszerzonymi, Reklamy graficzne z możliwością zakupu. Każdy kolekcja może obejmować do 100 produktów. Kolekcję możesz utworzyć za pomocą: z Google Merchant Center albo za pomocą Content API.

Z tego przewodnika dowiesz się, jak korzystać z kolekcji produktów za pomocą Content API w tym przykłady tworzenia kolekcji reklam graficznych z możliwością zakupu oraz instrukcja aby sprawdzić stan kolekcji.

Użyj 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: umożliwia pobieranie i wyświetlanie stanu kolekcji w ustalenie, czy w kolekcji występują jakieś problemy, które mogłyby spowodować mogą być nieprawidłowe dla danego miejsca docelowego, takiej jak Reklamy produktowe.

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

Reklamy graficzne z możliwością zakupu mają wysoką jakość wysokiej jakości zdjęcia, które pokazują co najmniej jeden produkt z adnotacjami i są skonfigurowane przy użyciu kolekcji. Aby korzystać z reklam graficznych z możliwością zakupu, musisz określić wartości atrybutu imageLink i featuredProduct, oprócz pól wymaganych w przypadku wszystkich kolekcji. Więcej informacji o polach wymaganych znajdziesz w Dokumentacja interfejsu Content API

Aby korzystać z reklam graficznych z możliwością zakupu, musisz utworzyć kolekcję produktów i użyć atrybutu imageLink, aby określić zdjęcie przedstawiające maksymalnie 10 produktów. Śr zalecamy użycie kwadratowych obrazów (o współczynniku proporcji 1:1).

Produkty widoczne na zdjęciu musisz też określić za pomocą atrybutu Pole 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żywane 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 dla Reklamy graficzne z możliwością zakupu. Zalecamy podanie współrzędnych nie więcej niż 10 na zdjęcie, aby zapewnić wystarczającą ilość miejsca do wyświetlania objaśnienia produktów. offerId pole, które jest częścią obiektu featuredProduct, musi być zgodne z polem offerId w zasobie products, która jest inna niż wartość Wartość 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ą atrybutu opcjonalne pole headline. Zalecamy podanie nagłówka, klientów, udostępniając im dodatkowe informacje o kolekcji.

Aby utworzyć nową kolekcję dla reklam graficznych z możliwością zakupu, wyślij żądanie POST do Punkt końcowy collections.insert przy użyciu 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 przez Ciebie kolekcji występują problemy, które unieważni zbiór z wyświetlania reklam, wyślij żądanie GET do collectionsstatuses.get za pomocą tego adresu URL i uwzględnij id kolekcji, której stan chcesz pobrać. Nie musisz podawać treść żą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"
    }
  ]
}