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 CSS di organizzare gli 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 l'equivalente di alcune delle funzionalità di pubblicità programmatica disponibili nel Comparison Shopping Service Center.
Per ulteriori informazioni sui CSS, consulta la pagina 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ù domini CSS.
- I domini CSS sono gli account dei CSS stessi, che pubblicano gli 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 gli annunci Shopping. I CSS possono essere associati a diversi tipi di account Merchant Center, inclusi gli account multi-cliente (AMC) e singoli account commerciante. Ogni account Merchant Center può essere associato a un solo dominio CSS. Per scoprire di più sui diversi tipi di account Merchant Center, consulta la pagina Tipi di account disponibile 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 account importanti e attività significativa dell'account.
Per ulteriori informazioni sui tipi di etichetta, incluse le etichette automatiche disponibili, 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:
accounts.labels
: consente di creare, recuperare e modificare le etichette da applicare al dominio CSS e agli account Merchant Center. Per un esempio, consulta la sezione Creazione di un'etichetta.accounts.updatelabels
: consente di applicare etichette a un singolo account Merchant Center. Per un esempio, consulta la pagina Applicare un'etichetta a un account Merchant Center.accounts.list
: consente di recuperare tutti gli account Merchant Center associati a un dominio CSS, incluse le etichette applicate a ciascun account. Puoi anche filtrare per etichettaid
per recuperare un sottoinsieme di account associati. Per un esempio, consulta Utilizzare le etichette per filtrare gli account Merchant Center.accounts.get
: consente di recuperare le etichette applicate a un singolo account Merchant Center.csses
: consente di visualizzare e gestire le associazioni tra etichette e domini CSS. Ad esempio, consulta Applicazione di un'etichetta a un dominio CSS.
Quando chiami endpoint accounts
come dominio CSS, tieni presente i seguenti requisiti:
- I domini CSS devono fornire il proprio
cssId
anziché unmerchantId
. - 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
.
Esempio: creare un'etichetta
Puoi usare 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 dei diversi tipi di account sono separate e non possono essere utilizzate in modo intercambiabile. Per
creare un'etichetta a livello di dominio, applicabile agli account Merchant Center
associati al dominio, utilizza l'ID dominio CSS come accountId
durante
la creazione dell'etichetta. Per creare un'etichetta a livello di gruppo, che può essere applicata ai domini CSS affiliati al gruppo, utilizza l'ID gruppo di CSS come accountId
quando crei l'etichetta.
L'esempio seguente mostra come creare un'etichetta degli account chiave a livello di dominio, che può essere applicata agli account Merchant Center associati al dominio. Per creare l'etichetta, effettua una richiesta POST
utilizzando il seguente URL e
il 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 chiave-account creata nell'esempio precedente a uno dei tuoi account Merchant Center più importanti.
Per applicare l'etichetta, effettua 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: utilizzare 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 passare 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 l'attributo id
(123
) dell'etichetta account-chiave creata nell'esempio Creazione di un'etichetta. Per recuperare
gli account, 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 dominio CSS affiliato a un gruppo di CSS. L'esempio seguente mostra come applicare un'etichetta a livello di gruppo key-domains creata utilizzando il metodo accounts.labels.create
a uno dei tuoi account del 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 di CSS come
accountId
.
Per applicare l'etichetta, effettua 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’
}