Gestione delle etichette CSS

I Servizi di shopping comparativo (CSS) possono pubblicare annunci Shopping su Google per conto dei commercianti nei paesi in cui è disponibile il programma CSS. API Content consente ai domini CSS e ai gruppi di CSS di organizzare gli account associati utilizzando 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 affiliato al gruppo. Questi servizi di API Content offrono pubblicità programmatica equivalenti ad alcune delle funzionalità disponibili nella scheda Shopping comparativo Centro assistenza.

Per ulteriori informazioni sui CSS, consulta Servizi di shopping comparativo. Per informazioni sull'utilizzo delle etichette in CSS Center, consulta Utilizzare le etichette dell'account in 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ù CSS domini.
  • I domini CSS sono gli account dei CSS stessi, che consentono di creare gli annunci 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 inseriscono Annunci Shopping. I CSS possono essere associati a diversi tipi di commercianti Account Center, inclusi gli account multi-cliente (AMC) e i singoli commercianti . Ogni account Merchant Center può essere associato a un solo CSS dominio. Per ulteriori informazioni sui diversi tipi di account Merchant Center, vedi 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 dal CSS domini CSS e ai domini CSS dai gruppi di CSS.
  • Le etichette automatiche vengono create e assegnate automaticamente a Merchant Center account da CSS Center. Le etichette automatiche sono disponibili per diversi tipi di le metriche dell'account e può aiutarti a identificare gli account importanti e l'attività dell'account.

Per ulteriori informazioni sui tipi di etichetta, tra cui le vedi le etichette, consulta Utilizzare le etichette dell'account in Comparison Shopping Service Center.

Funzionalità ed endpoint dell'API Content per i CSS

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

Quando chiami endpoint accounts come dominio CSS, tieni presente quanto segue requisiti:

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

Esempio: creare un'etichetta

Puoi utilizzare il metodo accounts.labels.create per creare una nuova etichetta. Etichette. possono essere applicate ai domini CSS e agli account Merchant Center. Tuttavia, le etichette per i diversi tipi di account sono separati e non possono essere utilizzati in modo intercambiabile. A Creare un'etichetta a livello di dominio che può essere applicata agli account Merchant Center associato al dominio, utilizza l'ID dominio CSS come accountId quando la creazione dell'etichetta. Per creare un'etichetta a livello di gruppo, che possa essere applicata ai CSS domini affiliati al gruppo, utilizza l'ID gruppo di CSS come accountId quando la creazione dell'etichetta.

L'esempio seguente mostra come creare un account chiave a livello di dominio che potrà essere applicata agli account Merchant Center associati all' dominio. Per creare l'etichetta, effettua una richiesta POST utilizzando il seguente URL e 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 commerciante Account Center associato a un dominio CSS. L'esempio seguente dimostra come applicare l'etichetta key-accounts creata nell'esempio precedente a una dei tuoi account Merchant Center più importanti.

Per applicare l'etichetta, effettua una richiesta POST utilizzando il seguente URL e richiedi Corpo:

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

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

Esempio: utilizzare le etichette per filtrare gli account Merchant Center

Dopo aver creato e applicato le etichette agli account Merchant Center associati con un dominio CSS, puoi utilizzare il metodo accounts.list e trasmettere l'etichetta nella tua richiesta di restituire solo gli account con quell'etichetta. La l'esempio seguente mostra come filtrare gli account Merchant Center associate a un dominio CSS, utilizzando i id (123) degli account chiave etichetta creata nell'esempio Creazione di un'etichetta. Per recuperare il accoungs, effettua 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 CSS dominio affiliato a un gruppo di CSS. L'esempio seguente mostra come applica un'etichetta key-domains creata a livello di gruppo utilizzando accounts.labels.create a uno dei tuoi domini 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 di CSS come accountId.

Per applicare l'etichetta, effettua una richiesta POST utilizzando il seguente URL e richiedi Corpo:

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

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