L'API Merchant v1beta non sarà più disponibile a partire dal 28 febbraio 2026. Per i passaggi per eseguire la transizione all'ultima versione stabile, consulta Eseguire la migrazione dalla v1beta alla v1.

Performance reports

L'API Merchant offre report sul rendimento, ad esempio product_performance_view. Questa pagina spiega la struttura dei report sul rendimento.

Metriche

Puoi eseguire query per le metriche (ad esempio clicks e impressions) che vuoi vengano restituite. Per eseguire query sul servizio Reports per i dati sul rendimento, devi aggiungere un filtro all'intervallo di date.

Ecco una query di esempio che restituisce una singola riga con il numero totale di clic nell'intervallo di date specificato:

SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'

Devi specificare i dati che vuoi vengano restituiti. I caratteri jolly (ad esempio SELECT *) restituiscono un errore.

La seguente risposta di esempio mostra che il commerciante ha registrato 4440 clic totali su tutti i prodotti e tutti i metodi di marketing tra il 1° dicembre 2023 e il 21 dicembre 2023.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4,440"
      }
    }
  ]
}

Segmenti

Puoi utilizzare i campi dei segmenti per la segmentazione nei report sul rendimento. Ad esempio, la query per marketing_method restituisce un report con una riga per ogni metodo di marketing e le metriche che specifichi per quel metodo di marketing nella clausola SELECT.

I campi dei segmenti possono essere attributi prodotto (ad esempio offer_id, brand e category) o attributi evento (ad esempio date e marketing_method).

I campi dei segmenti si comportano in modo simile a un GROUP BY in SQL. I campi dei segmenti dividono le metriche selezionate, raggruppandole in base a ogni segmento nella clausola SELECT.

Ecco una query di esempio che restituisce i clic al giorno, in ordine decrescente in base a clicks, all'interno della condizione aggiunta di un intervallo di date. Vengono restituite solo le righe in cui almeno una metrica richiesta è diversa da zero.

SELECT
  date,
  clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-03'
ORDER BY clicks DESC

La seguente risposta di esempio mostra che il commerciante ha registrato 1546 clic su tutti i prodotti, in tutti i metodi di marketing, il 1° dicembre 2023 e 829 clic su tutti i prodotti, in tutti i metodi di marketing, il 2 dicembre 2023. Il commerciante non ha ricevuto clic il 3 dicembre 2023, quindi non viene restituito nulla per questa data.

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2023,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2023,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}

Come per i report personalizzati in Merchant Center, puoi specificare più segmenti nella stessa query con l'API Merchant Reports.

Ecco una query di esempio che restituisce i clic per tutti i prodotti nel tuo account in un periodo di 30 giorni, segmentati per marketing_method e offer_id:

SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'

La risposta a questa query include una riga per ogni combinazione di offer_id e marketing_method, con il numero di clic per quella combinazione:

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "125"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "23"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "8"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "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: 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 del tipo di prodotto: Tipi di prodotto che assegni in base alla categorizzazione. 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 restituiscono ogni livello nel proprio campo:

Segmento	Valore
`product_type_l1`	`Home & Garden`
`product_type_l2`	`Kitchen & Dining`
`product_type_l3`	`Kitchen Appliances`
`product_type_l4`	`Refrigerators`

Metriche relative a valuta e prezzo

Le metriche di prezzo, come conversion_value, sono rappresentate utilizzando il tipo Price. Se la metrica è disponibile in più valute, il valore per ogni valuta viene restituito in una riga separata. Ad esempio, la seguente query:

SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'

restituisce i seguenti risultati:

{
  "results": [
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

Se richiedi sia metriche di prezzo che non di prezzo in una query, le metriche di prezzo vengono restituite in righe di risultati separate dalle metriche non di prezzo, una riga di risultati per codice valuta. Ad esempio, la seguente query:

SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'

restituisce la seguente risposta:

{
  "results": [
    {
      "productPerformanceView": {
        "conversions": "27",
        "conversionValue": {
          "amountMicros": "0",
          "currencyCode": ""
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

Tutti i campi selezionati vengono restituiti nella risposta, anche se il loro valore è ancora quello predefinito o zero.

Per ulteriori informazioni sui campi disponibili per le query, consulta Campi nella tabella productPerformanceView.