Performance reports

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

Metriche

Puoi eseguire query per le metriche (ad esempio, clicks e impressions) che da restituire. Devi aggiungere un filtro sull'intervallo di date per eseguire query sui report per i dati sulle prestazioni.

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

SELECT clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-21'

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

La seguente risposta di esempio mostra che il commerciante ha registrato un totale di 4440 di clic in tutti i prodotti e con tutti i metodi di marketing, tra il 1° dicembre 2020 e il 21 dicembre 2020.

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

Segmenti

Puoi utilizzare la MCQL per eseguire query sui campi dei segmenti. I campi dei segmenti possono essere attributi del prodotto (ad es. offerId, brand e category) o evento (ad esempio date e marketingMethod).

I campi dei segmenti funzionano in modo simile a un GROUP BY in SQL. I campi dei segmenti suddividono metriche selezionate, raggruppando i dati in base a ogni 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. Solo le righe in cui è presente almeno una metrica richiesta è diversa da zero.

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

La seguente risposta di esempio mostra che il commerciante ha ottenuto 1546 clic da tutti i prodotti, con tutti i metodi di marketing, il 1° dicembre 2020 e 829 di clic su tutti i prodotti, con tutti i metodi di marketing, il 2 dicembre 2020. Il commerciante non ha ricevuto clic il 3 dicembre 2020, pertanto non viene restituito nulla per quella data.

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