Performance reports

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

Metriche

Puoi eseguire query sulle metriche (ad es. clicks e impressions) che vuoi recuperare. Devi aggiungere un filtro all'intervallo di date per eseguire query sul servizio Report per i dati sul rendimento.

Di seguito è riportata una query di esempio che restituisce una singola riga con il numero totale di clic all'interno dell'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 che vengano restituiti. I caratteri jolly (ad es. SELECT *) restituiscono un errore.

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

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

Punto chiave: se non selezioni alcun campo dei segmenti nella query, ricevi solo una riga di metriche.

Segmenti

Puoi utilizzare i campi 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 specificate per quel metodo nella clausola SELECT.

I campi dei segmenti possono essere attributi dei prodotti (ad es. offer_id, brand e category) o attributi degli eventi (ad es. date e marketing_method).

I campi Segmento agiscono in modo simile a un GROUP BY in SQL. I campi Segmenti suddividono le metriche selezionate, raggruppandole in base a ciascun segmento nella clausola SELECT.

Ecco un esempio di query che restituisce i clic giornalieri, in ordine decrescente per 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 1.546 clic su tutti i prodotti e su tutti i metodi di marketing il 1° dicembre 2023 e 829 clic su tutti i prodotti e su tutti i metodi di marketing il 2 dicembre 2023. Il commerciante non ha registrato clic il 3 dicembre 2023, pertanto non viene restituito alcun valore per quella data.

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

Punto chiave: puoi selezionare campi di segmenti specifici solo se selezioni anche le metriche. Se non selezioni alcuna metrica nella query, l'API Merchant Reports restituisce un errore.

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

Ecco un esempio di query che restituisce i clic per tutti i prodotti del 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"
      }
    }
  ]
}

Attenzione: poiché viene restituita una nuova riga per ogni combinazione di campi segmenti nella clausola SELECT, il numero totale di righe nella risposta aumenta in modo esponenziale con ogni campo segmenti aggiuntivo.

Categoria e tipo di prodotto

Il linguaggio di query di Merchant Center supporta il segmentare 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 oppure perfezionare la categoria fornita.

Livelli di tipo di prodotto

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 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 valute e prezzi

Le metriche relative ai prezzi, 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 in una query richiedi sia le metriche relative al prezzo sia quelle non relative al prezzo, le metriche relative al prezzo vengono riportate in righe di risultati separate rispetto alle metriche non relative al prezzo, con una riga di risultati per ogni 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.