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 sulle metriche (ad esempio, clicks e impressions) che vuoi vengano restituite. Devi aggiungere un filtro all'intervallo di date per eseguire query sul servizio Report per i dati sul rendimento.

Di seguito è riportato un esempio di query 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 ricevuto un totale di 4440 clic su tutti i prodotti e con tutti i metodi di marketing tra il 1° dicembre 2023 e il 21 dicembre 2023.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4440"
      }
    }
  ]
}

Segmenti

Puoi utilizzare i campi dei segmenti per la segmentazione nei report sul rendimento. Ad esempio, se esegui una query su marketing_method, viene restituito un report con una riga per ogni metodo di marketing e le metriche che hai specificato per quel metodo di marketing nella clausola SELECT.

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

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

Di seguito è riportato un esempio di query che restituisce i clic per 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 1° dicembre 2023 il commerciante ha ricevuto 1546 clic su tutti i prodotti e con tutti i metodi di marketing, mentre il 2 dicembre 2023 ha ricevuto 829 clic su tutti i prodotti e con tutti i metodi di marketing. Il 3 dicembre 2023 il commerciante non ha ricevuto clic, quindi non viene restituito alcun risultato per quella 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.

Di seguito è riportato un esempio di query che restituisce i clic per tutti i prodotti nel tuo account durante 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 metrici in base a due gruppi di attributi che puoi definire per organizzare l'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 alcuna o perfezionare ulteriormente la categoria fornita.

Livelli del tipo di prodotto

Tipi di prodotto che assegni in base alla categoria. A differenza dei livelli di categoria, non esiste un insieme predefinito di valori supportati.

Sia gli attributi di 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 >. Tuttavia, nei report devi selezionare ogni livello della gerarchia separatamente.

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:

Metriche relative a valuta e prezzo

Le metriche relative al prezzo, come conversion_value, sono rappresentate utilizzando il Price tipo. 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 relative al prezzo sia metriche non relative al prezzo in una query, le metriche relative al prezzo vengono restituite in righe di risultati separate dalle metriche non relative al 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 il valore predefinito o zero.

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