Interfejs Merchant API oferuje raporty skuteczności, np.
product_performance_view.
Na tej stronie wyjaśniamy strukturę raportów skuteczności.
Dane
Możesz wysyłać zapytania o dane (np. clicks i impressions), które chcesz uzyskać. Aby wysłać zapytanie do usługi Raporty o dane o skuteczności, musisz dodać filtr zakresu dat.
Oto przykładowe zapytanie, które zwraca jeden wiersz z łączną liczbą kliknięć w określonym zakresie dat:
SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'
Musisz określić dane, które chcesz uzyskać. Symbole wieloznaczne (np. SELECT
*) powodują zwrócenie błędu.
Z poniższej przykładowej odpowiedzi wynika, że sprzedawca uzyskał łącznie 4440 kliknięć we wszystkich produktach i we wszystkich metodach marketingowych w okresie od 1 do 21 grudnia 2023 r.
{
"results": [
{
"productPerformanceView": {
"clicks": "4440"
}
}
]
}
Segmenty
W raportach skuteczności
możesz używać pól segmentów
do
segmentacji.
Na przykład zapytanie o marketing_method zwraca raport z wierszem dla
każdej metody marketingowej oraz
dane określone dla tej metody w klauzuli SELECT.
Pola segmentów mogą być atrybutami produktu (np. offer_id, brand i category) lub atrybutami zdarzenia (np. date i marketing_method).
Pola segmentów działają podobnie jak klauzula GROUP BY w SQL. Pola segmentów dzielą wybrane dane, 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 dodanym warunku zakresu dat. Zwracane są tylko wiersze, w których co najmniej 1 żądana wartość jest różna od zera.
SELECT
date,
clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-03'
ORDER BY clicks DESC
Z poniższej przykładowej odpowiedzi wynika, że 1 grudnia 2023 r. sprzedawca uzyskał 1546 kliknięć we wszystkich produktach i we wszystkich metodach marketingowych, a 2 grudnia 2023 r. – 829 kliknięć we wszystkich produktach i we wszystkich metodach marketingowych. 3 grudnia 2023 r. sprzedawca nie uzyskał żadnych kliknięć, więc dla tej daty nie są zwracane żadne dane.
{
"results": [
{
"productPerformanceView": {
"date": {
"year": 2023,
"month": 12,
"day": 1
},
"clicks": "1546"
}
},
{
"productPerformanceView": {
"date": {
"year": 2023,
"month": 12,
"day": 2
},
"clicks": "829"
}
}
]
}
Podobnie jak w przypadku raportów niestandardowych w Merchant Center, w tym samym zapytaniu możesz określić wiele segmentów za pomocą interfejsu Merchant Reports API.
Oto przykładowe zapytanie, które zwraca liczbę kliknięć wszystkich produktów na Twoim koncie w okresie 30 dni, podzieloną na segmenty według marketing_method i offer_id:
SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'
Odpowiedź na to zapytanie zawiera wiersz dla każdej kombinacji offer_id i marketing_method z liczbą kliknięć dla tej kombinacji:
{
"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"
}
}
]
}
Kategoria i typ produktu
Język zapytań Merchant Center obsługuje segmentowanie danych według 2 grup atrybutów, które możesz zdefiniować, aby uporządkować swoje zasoby:
- Poziomy kategorii
- Kategorie z taksonomii produktów Google. Jeśli nie podasz kategorii produktu, Google może przypisać ją automatycznie lub doprecyzować podaną kategorię.
- Poziomy typu produktu Typy produktów, które przypisujesz na podstawie własnego podziału na kategorie.
- W przeciwieństwie do poziomów kategorii nie ma wstępnie zdefiniowanego zestawu obsługiwanych wartości.
Zarówno atrybuty kategorii, jak i typu produktu są uporządkowane w hierarchii z wieloma poziomami. Specyfikacja produktu oddziela poszczególne poziomy znakiem >, ale w raportach każdy poziom hierarchii wybierasz osobno.
Rozważmy na przykład produkt z tymi poziomami typu produktu:
Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators
Raporty zwracają każdy poziom w osobnym polu:
| Segment | Wartość |
|---|---|
product_type_l1 |
Home & Garden |
product_type_l2 |
Kitchen & Dining |
product_type_l3 |
Kitchen Appliances |
product_type_l4 |
Refrigerators |
Dane o walucie i cenie
Dane o cenie, takie jak conversion_value, są reprezentowane za pomocą typu.Price Jeśli dane są dostępne w wielu walutach, wartość dla każdej waluty jest zwracana w osobnym wierszu. Na przykład to zapytanie:
SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'
zwraca te wyniki:
{
"results": [
{
"productPerformanceView": {
"conversionValue": {
"amountMicros": "150000000",
"currencyCode": "USD"
}
}
},
{
"productPerformanceView": {
"conversionValue": {
"amountMicros": "70000000",
"currencyCode": "CAD"
}
}
}
]
}
Jeśli w zapytaniu poprosisz o dane o cenie i inne dane, dane o cenie będą zwracane w oddzielnych wierszach wyników od innych danych – po 1 wierszu wyników na kod waluty. Na przykład to zapytanie:
SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'
zwraca tę odpowiedź:
{
"results": [
{
"productPerformanceView": {
"conversions": "27",
"conversionValue": {
"amountMicros": "0",
"currencyCode": ""
}
}
},
{
"productPerformanceView": {
"conversions": "0",
"conversionValue": {
"amountMicros": "150000000",
"currencyCode": "USD"
}
}
},
{
"productPerformanceView": {
"conversions": "0",
"conversionValue": {
"amountMicros": "70000000",
"currencyCode": "CAD"
}
}
}
]
}
W odpowiedzi są zwracane wszystkie wybrane pola, nawet jeśli ich wartość jest nadal wartością domyślną lub zerem.
Więcej informacji o polach dostępnych w zapytaniu znajdziesz w artykule Pola w tabeli productPerformanceView.