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 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. L'intera query deve rimanere su una riga per funzionare 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 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 nessuna 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 che assegni in base alla categoria. 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 del 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 proprio campo, come segue:

Metriche relative a valuta e prezzo

Il campo segments.currency_code di un ReportRow indica la valuta in cui vengono restituite le metriche di prezzo come metrics.conversion_value_micros. Poiché è importante per interpretare correttamente queste metriche, il 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 Merchant Center supporta due categorie di metriche per gli ordini 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 a ciascun 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 prodotto degli articoli in ogni ordine.

Puoi selezionare le metriche a livello di elemento in combinazione con qualsiasi segmento disponibile. Tuttavia, la selezione di metriche a livello di ordine in combinazione con uno qualsiasi dei seguenti segmenti delle dimensioni del prodotto 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.