Collezioni di prodotti

Le raccolte di prodotti ti consentono di definire gruppi di prodotti da utilizzare con formati avanzati, ad esempio Immagini Shopping. Ogni raccolta può includere fino a 100 prodotti. Puoi creare una raccolta 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 raccolta per le immagini Shopping e come controllare lo stato di una raccolta.

Nota: al momento le immagini Shopping sono l'unico formato dell'annuncio che supporta le raccolte. Tuttavia, potrebbero essere aggiunti altri formati per consentirti di riutilizzare le tue raccolte in diversi formati degli annunci.

Utilizzare le raccolte di prodotti

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

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

• collectionstatuses: consente di ottenere ed elencare lo stato delle raccolte per scoprire se una raccolta presenta problemi che potrebbero renderla 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 con annotazioni e vengono configurate utilizzando le raccolte. Per utilizzare le immagini Shopping, devi specificare i valori per i campi imageLink e featuredProduct, oltre ai campi obbligatori per tutte le raccolte. Per saperne di più 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 che contenga 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 di link immagine. Tuttavia, per il formato Immagini Shopping viene utilizzato solo il primo valore dell'array.

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

Ogni raccolta può includere un massimo di 100 prodotti. Tuttavia, per le immagini Shopping, ti consigliamo di specificare le coordinate per non più di 10 prodotti per immagine per assicurarti che ci sia spazio sufficiente nell'immagine per mostrare i callout dei prodotti. Il campo offerId che fa parte dell'oggetto featuredProduct deve corrispondere al valore offerId della risorsa products, che è diverso dal valore id della risorsa products.

Oltre ai campi imageLink e featuredProduct, obbligatori per le immagini Shopping, puoi anche specificare un titolo della raccolta utilizzando il campo facoltativo headline. 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 di titolo. Tuttavia, per il formato Immagini Shopping viene utilizzato solo il primo valore dell'array.

Per creare una nuova raccolta per le immagini Shopping, invia una richiesta POST all'endpoint collections.insert utilizzando il seguente URL e 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, l'invio di una richiesta a collections.insert sostituisce completamente la risorsa.

Esempio: controllare lo stato di una raccolta

Per scoprire se la raccolta che hai creato sopra presenta problemi che potrebbero invalidare la pubblicazione degli annunci, invia una richiesta GET all'endpoint collectionsstatuses.get utilizzando il seguente URL e includi l'id della raccolta di cui vuoi recuperare lo stato. Non devi fornire un corpo della richiesta.

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

Esempio di risposta sullo 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"
    }
  ]
}