Segmentazione

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'

Corsa

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.