La segmentazione, disponibile nei report personalizzati di Merchant Center, può essere implementata nell'API Reporting aggiungendo il campo appropriato a una query. Ad esempio, la query per segments.program
genera un report con una riga per ogni programma (annunci Shopping, schede di prodotto senza costi e così via) che include le metriche (impressioni, clic e così via) per quel programma come specificato nella clausola SELECT
.
Come per i report personalizzati in Merchant Center, puoi specificare più segmenti nella stessa query con l'API Reporting.
La seguente query di esempio recupera i clic per tutti i prodotti nel tuo account
durante un periodo di 30 giorni, segmentati per program
e offer_id
:
SELECT
segments.program,
segments.offer_id,
metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'
Fai clic su Esegui per provare il sample in API Explorer. Dopo aver fatto clic su Esegui, aggiorna il segnaposto ID commerciante con il tuo ID commerciante nell' URL della richiesta. Puoi modificare la query. La query completa deve rimanere su una riga per essere utilizzata con Explorer API.
I risultati dell'invio di questa query a reports.search
sono una riga che specifica i clic per ogni combinazione di offer_id
e program
, come in questa stringa JSON di esempio:
{
"results": [
{
"segments": {
"program": "SHOPPING_ADS",
"offerId": "12345"
},
"metrics": {
"clicks": "38"
}
},
{
"segments": {
"program": "SHOPPING_ADS",
"offerId": "12346"
},
"metrics": {
"clicks": "125"
}
},
{
"segments": {
"program": "FREE_PRODUCT_LISTING",
"offerId": "12346"
},
"metrics": {
"clicks": "23"
}
},
{
"segments": {
"program": "SHOPPING_ADS",
"offerId": "12347"
},
"metrics": {
"clicks": "8"
}
},
{
"segments": {
"program": "FREE_PRODUCT_LISTING",
"offerId": "12347"
},
"metrics": {
"clicks": "3"
}
}
]
}
Categoria e tipo di prodotto
Il linguaggio di query di Merchant Center supporta la segmentazione delle metriche in base a due gruppi di attributi che puoi definire per organizzare il tuo inventario:
- Livelli di categoria (
segments.category_l1
,segments.category_l2
e così via) - Categorie della tassonomia dei prodotti di Google. Google potrebbe assegnare automaticamente la categoria al tuo prodotto se non ne è stata fornita una o perfezionare ulteriormente la categoria fornita.
- Livelli di tipo di prodotto (
segments.product_type_l1
,segments.product_type_l2
e così via) - Tipi di prodotti che assegni in base alla classificazione. A differenza dei livelli di categoria, non esiste un insieme predefinito di valori supportati.
Sia gli attributi categoria sia quelli di tipo di prodotto sono organizzati in una gerarchia con più livelli. La specifica del prodotto separa ogni livello con il carattere >
, ma nei report selezioni ogni livello della gerarchia separatamente.
Ad esempio, prendiamo in considerazione un prodotto con i seguenti livelli di tipo di prodotto:
Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators
I report restituiranno ogni livello nel proprio campo, come segue:
Segmento | Valore |
---|---|
segments.product_type_l1 |
Home & Garden |
segments.product_type_l2 |
Kitchen & Dining |
segments.product_type_l3 |
Kitchen Appliances |
segments.product_type_l4 |
Refrigerators |
Metriche relative a valute e prezzi
Il campo segments.currency_code
di un ReportRow
indica la valuta in cui vengono restituite le metriche dei prezzi, ad esempio metrics.conversion_value_micros
.
Poiché questo è importante per interpretare correttamente queste metriche, il valore ReportRow
restituito includerà automaticamente segments.currency_code
ogni volta che selezioni una delle metriche dei prezzi riportate di seguito.
metrics.conversion_value_micros
metrics.aov_micros
metrics.ordered_item_sales_micros
metrics.returns_micros
metrics.shipped_item_sales_micros
Metriche di Acquista su Google
Il linguaggio di query di Merchant Center supporta due categorie di metriche per gli ordini di Acquista su Google: metriche a livello di articolo e metriche a livello di ordine.
- Metriche a livello di articolo
Metriche calcolate in base agli articoli all'interno degli ordini e associate alle dimensioni dei prodotti degli articoli in ogni ordine.
metrics.item_days_to_ship
metrics.item_fill_rate
metrics.ordered_items
metrics.ordered_item_sales_micros
metrics.rejected_items
metrics.returned_items
metrics.return_rate
metrics.returns_micros
metrics.shipped_items
metrics.shipped_item_sales_micros
metrics.unshipped_items
- Metriche a livello di ordine
Metriche calcolate in base agli ordini.
metrics.aos
metrics.aov_micros
metrics.days_to_ship
metrics.orders
metrics.shipped_orders
metrics.unshipped_orders
Le metriche a livello di ordine non sono associate alle dimensioni dei prodotti degli articoli in ogni ordine.
Puoi selezionare le metriche a livello di articolo in combinazione con qualsiasi segmento disponibile. Tuttavia, la selezione delle metriche a livello di ordine in combinazione con uno dei seguenti segmenti di dimensioni dei prodotti non andrà a buon fine:
segments.brand
segments.category_l1
,segments.category_l2
,segments.category_l3
,segments.category_l4
,segments.category_l5
segments.custom_label1
,segments.custom_label2
,segments.custom_label3
,segments.custom_label4
,segments.custom_label5
segments.offer_id
segments.product_type_l1
,segments.product_type_l2
,segments.product_type_l3
,segments.product_type_l4
,segments.product_type_l5
segments.title
Scopri di più
Per un elenco completo dei segmenti, consulta la documentazione.