La segmentazione, disponibile nei report personalizzati di Merchant Center, può essere implementata nell'API di reporting aggiungendo il campo appropriato a una query. Ad esempio, quando esegui una query per segments.program
, viene generato 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 di 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 l'esempio in Explorer API. Dopo aver fatto clic su Esegui, aggiorna il segnaposto dell'ID commerciante con il tuo ID commerciante nell'URL della richiesta. Puoi modificare la query. Per funzionare con Explorer API, la query completa deve rimanere su una riga.
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 tratte dalla tassonomia dei prodotti di Google. Google potrebbe assegnare automaticamente la categoria al tuo prodotto se non ne è stata specificata nessuna o perfezionare ulteriormente la categoria fornita.
- Livelli del tipo di prodotto (
segments.product_type_l1
,segments.product_type_l2
e così via) - Tipi di prodotti assegnati in base alla classificazione. A differenza dei livelli di categoria, non esiste un insieme predefinito di valori supportati.
Gli attributi categoria e tipo di prodotto sono organizzati in una gerarchia con più livelli. La specifica di prodotto separa ogni livello con il carattere >
, ma selezioni ogni livello della gerarchia separatamente nei report.
Ad esempio, considera un prodotto con i seguenti livelli di tipo di prodotto:
Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators
I report restituiranno ogni livello nel relativo campo, come indicato di seguito:
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 di valuta e prezzo
Il campo segments.currency_code
di ReportRow
indica la valuta in cui vengono restituite le metriche relative al prezzo, 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 di prezzo 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 ciascun 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 per ordine.
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 ciascun ordine.
Puoi selezionare 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 del prodotto non riuscirà:
segments.brand
segments.category_l1
,segments.category_l2
,segments.category_l3
,segments.category_l4
esegments.category_l5
segments.custom_label1
,segments.custom_label2
,segments.custom_label3
,segments.custom_label4
esegments.custom_label5
segments.offer_id
segments.product_type_l1
,segments.product_type_l2
,segments.product_type_l3
,segments.product_type_l4
esegments.product_type_l5
segments.title
Scopri di più
Per un elenco completo dei segmenti, consulta la documentazione.