Performance reports

Merchant API oferuje raporty skuteczności, na przykład ProductPerformanceView Na tej stronie omawiamy strukturę raportów skuteczności.

Dane

Możesz wysyłać zapytania o dane (np. clicks i impressions), które wykorzystasz które chcą zwrócić. Aby wysłać zapytanie dotyczące raportów, musisz dodać filtr według zakresu dat i zapewnia dostęp do danych o wydajności.

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.

Przykładowa odpowiedź poniżej pokazuje,że sprzedawca uzyskał łącznie 4440 zł we wszystkich usługach i metodach marketingowych, od 1 grudnia 2020 i 21 grudnia 2020 r.

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

Segmenty

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

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

Oto przykładowe zapytanie, które zwraca liczbę kliknięć dziennie, w kolejności malejącej według clicks w ramach dodanego warunku z zakresu dat. Tylko wiersze, w których co najmniej jedna z żądanych wartości ma wartość różną od zera.

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

Poniższa przykładowa odpowiedź pokazuje,że sprzedawca uzyskał 1546 kliknięć na wszystkich usług i metod marketingowych w okresie 1 grudnia 2020 r. i 829 2 grudnia 2020 r. we wszystkich usługach i metodach marketingowych. 3 grudnia 2020 r. sprzedawca nie uzyskał żadnych kliknięć, więc nic nie zwróci tej daty.

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