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, se esegui una query su segments.program
, viene generato un report con una riga per ciascun 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 utilizzando l'API di reporting.
La seguente query di esempio recupera i clic per tutti i prodotti nel tuo account in 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 poter funzionare con Explorer API, la query completa deve rimanere su una sola riga.
Il risultato dell'invio di questa query a reports.search
è 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 alcuna oppure perfezionare ulteriormente la categoria fornita.
- Livelli del tipo di prodotto (
segments.product_type_l1
,segments.product_type_l2
e così via) - Tipi di prodotto assegnati in base alla classificazione. A differenza dei livelli di categoria, non esiste un insieme predefinito di valori supportati.
Entrambi gli attributi categoria e tipo di prodotto sono organizzati in una gerarchia a più livelli. La specifica di prodotto separa ogni livello con il carattere >
, ma nei report puoi selezionare separatamente ogni livello della gerarchia.
Ad esempio, considera un prodotto con i seguenti livelli di tipo di prodotto:
Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators
I report restituiranno ciascun livello nel proprio 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 su valuta e prezzo
Il campo segments.currency_code
di un ReportRow
indica la valuta in cui vengono restituite metriche di prezzo come metrics.order_item_sales_micros
.
Poiché ciò è importante per interpretare correttamente queste metriche, il ReportRow
restituito includerà automaticamente segments.currency_code
ogni volta che selezioni una delle seguenti metriche relative al prezzo.
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 del prodotto 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 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 del prodotto degli articoli in ogni ordine.
Puoi selezionare metriche a livello di articolo in combinazione con qualsiasi segmento disponibile. Tuttavia, la selezione di metriche a livello di ordine in combinazione con uno qualsiasi dei seguenti segmenti di dimensione prodotto avrà esito negativo:
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.