Ürün koleksiyonları

Ürün koleksiyonları, Alışveriş Özellikli Resimler gibi zengin biçimlerle kullanılacak ürün gruplarını tanımlamanıza olanak tanır. Her koleksiyonda en fazla 100 ürün bulunabilir. Google Merchant Center veya Content API ile koleksiyon oluşturabilirsiniz.

Bu kılavuzda, Content API aracılığıyla ürün koleksiyonlarının nasıl kullanılacağı gösterilmektedir. Alışveriş özellikli resimler için koleksiyon oluşturma ve koleksiyonun durumunu kontrol etme ile ilgili örnekler de verilmektedir.

Ürün koleksiyonlarını kullanma

Content API, ürün koleksiyonlarını yönetmek için iki hizmet içerir:

  • collections: Ürün koleksiyonlarını almanıza, listelemenize, eklemenize ve silmenize olanak tanır.

  • collectionstatuses: Koleksiyonların durumunu alıp listelemenize olanak tanır. Böylece, koleksiyonun bir hedef için (ör. alışveriş reklamları) geçersiz olmasına neden olabilecek sorunlar olup olmadığını öğrenebilirsiniz.

Örnek: Alışveriş Özellikli Resimler için koleksiyon oluşturma

Alışveriş Özellikli Resimler, bir veya daha fazla ek açıklamalı ürünü gösteren ve koleksiyonlar kullanılarak yapılandırılan yüksek kaliteli resimlerdir. Alışveriş Özellikli Resimleri kullanmak için tüm koleksiyonlar için gerekli alanlara ek olarak imageLink ve featuredProduct alanlarının değerlerini belirtmeniz gerekir. Zorunlu alanlar hakkında daha fazla bilgi için Content API referans belgelerine bakın.

Alışveriş Özellikli Resimler'i kullanmak için bir ürün koleksiyonu oluşturmanız ve imageLink alanını kullanarak en fazla on ürün içeren bir resim belirtmeniz gerekir. Kare resimler (1:1 en boy oranına sahip) kullanmanızı öneririz.

Ayrıca, featuredProduct alanını kullanarak resimde gösterilen ürünleri belirtmeniz gerekir. x ve y alanlarını kullanarak resimdeki ürünlerin koordinatlarını da ekleyin. Bu alanlar yalnızca Alışveriş Özellikli Resimler ile kullanılan koleksiyonlar için zorunludur. x ve y değerleri 0 ile 1 arasında (0 ve 1 dahil) olmalıdır.

Her koleksiyonda en fazla 100 ürün bulunabilir. Ancak alışveriş özellikli resimlerde, ürün açıklamalarının gösterilebilmesi için resimde yeterli alan olmasını sağlamak amacıyla resim başına en fazla 10 ürün için koordinat belirtmenizi öneririz. featuredProduct nesnesinin parçası olan offerId alanı, products kaynağındaki offerId değeriyle eşleşmelidir. Bu değer, products kaynağındaki id değerinden farklıdır.

Alışveriş Özellikli Resimler için zorunlu olan imageLink ve featuredProduct alanlarına ek olarak, isteğe bağlı headline alanını kullanarak bir koleksiyon başlığı da belirtebilirsiniz. Müşterilere koleksiyon hakkında ek ayrıntılar sunmak için başlık eklemenizi öneririz.

Alışveriş Özellikli Resimler için yeni bir koleksiyon oluşturmak üzere aşağıdaki URL'yi ve istek gövdesini kullanarak POST uç noktasına collections.insert isteği gönderin:

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"
}

Örnek: Koleksiyonun durumunu kontrol etme

Yukarıda oluşturduğunuz koleksiyonda, koleksiyonun reklam yayınlamasını engelleyecek sorunlar olup olmadığını öğrenmek için aşağıdaki URL'yi kullanarak GET uç noktasına istek gönderin ve durumunu almak istediğiniz koleksiyonun id değerini ekleyin.collectionsstatuses.get İstek metni sağlamanız gerekmez.

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

Örnek koleksiyon durumu yanıtı

{
  "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"
    }
  ]
}