Interfejs Merchant API udostępnia raporty wyników, np. product_performance_view.
Na tej stronie znajdziesz informacje o strukturze raportów skuteczności.
Dane
Możesz wysyłać zapytania o dane (np. clicks i impressions), które chcesz otrzymać. Aby wysłać do usługi Raporty zapytanie o dane o skuteczności, musisz dodać filtr zakresu dat.
Oto przykładowe zapytanie, które zwraca pojedynczy 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 zwrócić. Symbole wieloznaczne (np. SELECT
*) zwracają błąd.
Poniższa przykładowa odpowiedź pokazuje, ż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
Do segmentacji w raportach wyników możesz używać pól segmentów.
Na przykład zapytanie o marketing_method zwraca raport z wierszem dla każdej metody marketingowej i danymi, które określisz dla tej metody marketingowej w klauzuli SELECT.
Pola segmentów mogą być atrybutami produktów (np. offer_id, brand i category) lub atrybutami zdarzeń (np. date i marketing_method).
Pola segmentów działają podobnie do GROUP BY w SQL. Pola segmentów dzielą wybrane dane, grupując 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 zakresu dat. Zwracane są tylko wiersze, w których co najmniej 1 żądany rodzaj danych ma wartość inną niż 0.
SELECT
date,
clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-03'
ORDER BY clicks DESC
Przykładowa odpowiedź poniżej pokazuje, że 1 grudnia 2023 r. sprzedawca uzyskał 1546 kliknięć wszystkich produktów we wszystkich metodach marketingowych, a 2 grudnia 2023 r. – 829 kliknięć wszystkich produktów we wszystkich metodach marketingowych. Sprzedawca nie miał kliknięć 3 grudnia 2023 r., więc nie zostaną zwrócone żadne dane z tego dnia.
{
"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 Merchant Reports API możesz określić wiele segmentów w tym samym zapytaniu.
Oto przykładowe zapytanie, które zwraca liczbę kliknięć wszystkich produktów na Twoim koncie w ciągu 30 dni, podzieloną 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ć asortyment:
- Poziomy kategorii
- Kategorie z mapy kategorii produktów Google. Jeśli nie podasz kategorii, Google może automatycznie przypisać kategorię do Twojego produktu lub doprecyzować podaną kategorię.
- Poziomy typów produktów
- 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.
Atrybuty kategorii i typu produktu są uporządkowane w hierarchii z wieloma poziomami. W specyfikacji produktów poszczególne poziomy są rozdzielone znakiem >, ale w raportach każdy poziom hierarchii wybiera się osobno.
Weźmy na przykład produkt o tych poziomach 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 dotyczące cen, 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 zarówno o dane dotyczące cen, jak i dane niezwiązane z cenami, dane dotyczące cen zostaną zwrócone w osobnych wierszach wyników, po jednym wierszu na kod waluty. Na przykład to zapytanie:
SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'
zwróci 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"
}
}
}
]
}
Wszystkie wybrane pola są zwracane w odpowiedzi, 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.