Collezioni di prodotti

Le raccolte di prodotti ti consentono di definire gruppi di prodotti da utilizzare con formati multimediali, ad esempio le immagini Shopping. Ogni raccolta può includere fino a 100 prodotti. Puoi creare una collezione con Google Merchant Center o l'API Content.

Questa guida mostra come utilizzare le raccolte di prodotti tramite l'API Content, inclusi esempi su come creare una collezione di immagini Shopping e come controllare lo stato di una collezione.

Nota: attualmente le immagini Shopping sono l'unico formato di annuncio che supporta le raccolte. Tuttavia, puoi aggiungere altri formati per riutilizzare le raccolte in diversi formati di annunci.

Utilizza le raccolte di prodotti

L'API Content include due servizi per gestire le raccolte di prodotti:

• collections: consente di recuperare, elencare, inserire ed eliminare le raccolte di prodotti.

• collectionstatuses: consente di recuperare ed elencare lo stato delle raccolte per scoprire se una raccolta presenta problemi che potrebbero rendere la raccolta non valida per una destinazione, ad esempio Annunci Shopping.

Esempio: creare una raccolta per le immagini Shopping

Le immagini Shopping sono immagini di alta qualità che mostrano uno o più prodotti annotati e sono configurate mediante le raccolte. Per utilizzare le immagini Shopping, devi specificare i valori per i campi imageLink e featuredProduct, oltre ai campi obbligatori per tutte le collezioni. Per ulteriori informazioni sui campi obbligatori, consulta la documentazione di riferimento dell'API Content.

Per utilizzare le immagini Shopping, devi creare una raccolta di prodotti e utilizzare il campo imageLink per specificare un'immagine contenente fino a dieci prodotti. Ti consigliamo di utilizzare immagini quadrate (con proporzioni 1:1).

Punto chiave: il campo imageLink per le raccolte accetta un array di valori per i link immagine. Tuttavia, viene utilizzato solo il primo valore nell'array per il formato Immagini Shopping.

Devi inoltre specificare i prodotti visualizzati nell'immagine utilizzando il campo featuredProduct e le coordinate dei prodotti nell'immagine usando i campi x e y. Questi campi sono obbligatori solo per le collezioni utilizzate con le immagini Shopping. I valori x e y devono essere compresi tra 0 e 1 inclusi.

Ogni collezione può includere un massimo di 100 prodotti. Tuttavia, per le immagini Shopping, ti consigliamo di specificare le coordinate per non più di dieci prodotti per immagine, in modo che ci sia spazio sufficiente sull'immagine per mostrare i callout del prodotto. Il campo offerId che fa parte dell'oggetto featuredProduct deve corrispondere al valore offerId nella risorsa products, che è diverso dal valore id nella risorsa products.

Oltre ai campi imageLink e featuredProduct, obbligatori per le immagini Shopping, puoi specificare anche il titolo di una raccolta utilizzando il campo headline facoltativo. Ti consigliamo di includere un titolo per fornire ai clienti ulteriori dettagli sulla raccolta.

Punto chiave: il campo headline per le raccolte accetta un array di valori per i titoli. Tuttavia, viene utilizzato solo il primo valore nell'array per il formato Immagini Shopping.

Per creare una nuova raccolta per le immagini Shopping, effettua una richiesta POST all'endpoint collections.insert utilizzando il seguente URL e il corpo della richiesta:

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

Avviso: se esiste una raccolta con lo stesso id, effettuando una richiesta a collections.insert la risorsa viene sostituita completamente.

Esempio: controllare lo stato di una raccolta

Per scoprire se la raccolta creata in precedenza presenta problemi che reificherebbero la pubblicazione degli annunci per la raccolta, effettua una richiesta GET all'endpoint collectionsstatuses.get utilizzando il seguente URL e includi il id della raccolta di cui vuoi recuperare lo stato. Non è necessario fornire il corpo della richiesta.

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

Esempio di risposta relativa allo stato della raccolta

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