Gestione delle etichette CSS

I Servizi di shopping comparativo (CSS) possono pubblicare annunci Shopping su Google per conto dei commercianti nei paesi in cui il programma CSS è disponibile. L'API Content consente ai domini CSS e ai gruppi di CSS di organizzare i propri account associati utilizzando le etichette. I domini CSS possono elencare, etichettare e filtrare gli account Merchant Center associati al dominio. I gruppi di CSS possono etichettare ed elencare i domini CSS affiliati al gruppo. Questi servizi API Content forniscono equivalenti programmatici ad alcune delle funzionalità disponibili nel Comparison Shopping Service Center.

Per saperne di più sui CSS, consulta la sezione Servizi di shopping comparativo. Per informazioni su come utilizzare le etichette in CSS Center, consulta Utilizzare le etichette dell'account nel Comparison Shopping Service Center.

Tipi di account CSS

I CSS utilizzano i seguenti tre tipi di account:

  • I gruppi di CSS sono gli account di primo livello che possono contenere uno o più domini CSS.
  • I domini CSS sono gli account dei CSS stessi, che pubblicano annunci Shopping per conto dei commercianti. Ogni dominio CSS può appartenere a un solo gruppo di CSS.
  • Gli account Merchant Center sono i commercianti per i quali i domini CSS pubblicano annunci Shopping. I CSS possono essere associati a diversi tipi di account Merchant Center, inclusi gli account multi-cliente (AMC) e i singoli account commerciante. Ogni account Merchant Center può essere associato a un solo dominio CSS. Per ulteriori informazioni sui diversi tipi di account Merchant Center, consulta Tipi di account disponibili in Comparison Shopping Service Center.

Tipi di etichette CSS

I CSS utilizzano due tipi di etichette:

  • Le etichette manuali vengono create e assegnate agli account Merchant Center dai domini CSS e ai domini CSS dai gruppi di CSS.
  • Le etichette automatiche vengono create e assegnate automaticamente agli account Merchant Center da CSS Center. Le etichette automatiche sono disponibili per diversi tipi di metriche dell'account e possono aiutarti a identificare gli account importanti e l'attività significativa dell'account.

Per ulteriori informazioni sui tipi di etichette, incluse quelle automatiche disponibili, consulta Utilizzare le etichette dell'account in Comparison Shopping Service Center.

Funzionalità ed endpoint della Content API per i CSS

L'API Content offre i seguenti endpoint per i CSS:

Quando chiami gli endpoint accounts come dominio CSS, tieni presente i seguenti requisiti:

  • I domini CSS devono fornire il proprio cssId anziché un merchantId.
  • I domini CSS devono fornire un parametro di query di view=CSS.
  • I domini CSS devono fornire l'ID account Merchant Center associato come accountId.

Esempio: creare un'etichetta

Puoi utilizzare il metodo accounts.labels.create per creare una nuova etichetta. Le etichette possono essere applicate ai domini CSS e agli account Merchant Center. Tuttavia, le etichette per i diversi tipi di account sono separate e non possono essere utilizzate in modo intercambiabile. Per creare un'etichetta a livello di dominio, che può essere applicata agli account Merchant Center associati al dominio, utilizza l'ID dominio CSS come accountId quando crei l'etichetta. Per creare un'etichetta a livello di gruppo, che può essere applicata ai domini CSS affiliati al gruppo, utilizza l'ID gruppo CSS come accountId quando crei l'etichetta.

Il seguente esempio mostra come creare un'etichetta per i clienti chiave a livello di dominio, che può essere applicata agli account Merchant Center associati al dominio. Per creare l'etichetta, invia una richiesta POST utilizzando il seguente URL e il seguente corpo della richiesta:

https://shoppingcontent.googleapis.com/content/v2.1/accounts/accountId/labels

{
 "name": "key-accounts",
 "description": "All accounts with over a million products"
}

Esempio: applicare un'etichetta a un account Merchant Center

Puoi utilizzare il metodo accounts.updatelabels per assegnare etichette a un account Merchant Center associato a un dominio CSS. L'esempio seguente mostra come applicare l'etichetta key-accounts creata nell'esempio precedente a uno dei tuoi account Merchant Center più importanti.

Per applicare l'etichetta, invia una richiesta POST utilizzando il seguente URL e il corpo della richiesta:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/

{
 "labelIds": [‘123’] // ‘key-accounts’
}

Esempio: utilizza le etichette per filtrare gli account Merchant Center

Dopo aver creato e applicato le etichette agli account Merchant Center associati a un dominio CSS, puoi utilizzare il metodo accounts.list e trasmettere il parametro di query dell'etichetta nella richiesta per restituire solo gli account con quell'etichetta. L'esempio seguente mostra come filtrare gli account Merchant Center associati a un dominio CSS utilizzando id (123) dell'etichetta key-accounts creata nell'esempio Creazione di un'etichetta. Per recuperare gli account, invia una richiesta GET utilizzando il seguente URL:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123

Non è necessario alcun corpo della richiesta.

Esempio: applicare un'etichetta a un dominio CSS

Puoi anche utilizzare il metodo csses.updatelabels per assegnare etichette a un dominio CSS affiliato a un gruppo di CSS. Il seguente esempio mostra come applicare un'etichetta a livello di gruppo key-domains creata utilizzando il metodo accounts.labels.create a uno dei tuoi account di dominio CSS più importanti. Tieni presente che le etichette per i domini CSS e gli account Merchant Center sono separate. Le etichette a livello di gruppo devono essere create utilizzando un ID gruppo CSS come accountId.

Per applicare l'etichetta, invia una richiesta POST utilizzando il seguente URL e il corpo della richiesta:

https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/

{
 "labelIds": [‘456’] // ‘key-domains’
}