Performance reports

Interfejs Merchant API udostępnia raporty skuteczności, na przykład ProductPerformanceView. Na tej stronie objaśniamy strukturę raportów skuteczności.

Wskaźniki

Możesz wysyłać zapytania o dane (np. clicks i impressions), które chcesz zwrócić. Aby wysłać do usługi Raporty zapytanie o dane o skuteczności, musisz dodać filtr w zakresie dat.

Oto przykładowe zapytanie, które zwraca jeden wiersz z łączną liczbą kliknięć w wybranym zakresie dat:

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

Musisz określić dane, które chcesz zwrócić. Symbole wieloznaczne (np. SELECT *) zwracają błąd.

Poniższa przykładowa odpowiedź wskazuje, że w okresie od 1 do 21 grudnia 2020 r. sprzedawca uzyskał łącznie 4440 kliknięć dla wszystkich produktów we wszystkich metodach marketingowych.

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

Segmenty

Za pomocą MCQL możesz wysyłać zapytania o pola segmentów. Polami segmentów mogą być atrybuty produktów (np. offerId, brand i category) lub atrybuty zdarzeń (np. date i marketingMethod).

Pola segmentów działają podobnie do pola GROUP BY w SQL. Pola segmentów służą do podziału wybranych danych, grupując je według każdego segmentu w klauzuli SELECT.

Oto przykładowe zapytanie, które zwraca kliknięcia dziennie w kolejności malejącej według clicks, w ramach dodanego warunku podanego w zakresie dat. Zwracane są tylko wiersze, w których co najmniej jeden żądany rodzaj danych ma wartość inną niż 0.

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

Poniższa przykładowa odpowiedź wskazuje, że 1 grudnia 2020 r. sprzedawca uzyskał 1546 kliknięć wszystkich produktów we wszystkich metodach marketingowych, a 2 grudnia 2020 r. we wszystkich metodach marketingowych – 829 kliknięć we wszystkich produktach. Sprzedawca nie uzyskał żadnych kliknięć 3 grudnia 2020 r., więc nie otrzymuje żadnych wyników z tego dnia.

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