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"
}
}
]
}