- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- ReportRow
- ProductPerformanceView
- MarketingMethodEnum
- NonProductPerformanceView
- ProductView
- AggregatedReportingContextStatus
- ItemIssue
- ItemIssueType
- ItemIssueSeverity
- IssueSeverityPerReportingContext
- AggregatedIssueSeverity
- ItemIssueResolution
- ClickPotential
- PriceCompetitivenessProductView
- PriceInsightsProductView
- Skuteczność
- BestSellersProductClusterView
- ReportGranularityEnum
- InventoryStatus
- RelativeDemandEnum
- RelativeDemandChangeTypeEnum
- BestSellersBrandView
- CompetitiveVisibilityCompetitorView
- TrafficSourceEnum
- CompetitiveVisibilityTopMerchantView
- CompetitiveVisibilityBenchmarkView
- Wypróbuj
Pobiera raport zdefiniowany przez zapytanie. Odpowiedź może zawierać mniej wierszy niż określono w polu pageSize
. Skorzystaj z narzędzia nextPageToken
, aby określić, czy można zażądać więcej wierszy.
Żądanie HTTP
POST https://merchantapi.googleapis.com/reports/v1beta/{parent=accounts/*}/reports:search
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
parent |
Wymagane. Identyfikator konta, z którego nawiązano połączenie. Musi to być samodzielne konto lub subkonto MCA. Format: konta/{konto} |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "query": string, "pageSize": integer, "pageToken": string } |
Pola | |
---|---|
query |
Wymagane. Zapytanie, które określa raport do pobrania. Szczegółowe informacje o tworzeniu zapytań znajdziesz w Przewodniku po języku zapytań. Pełną listę dostępnych tabel i pól znajdziesz w sekcji Dostępne pola. |
pageSize |
Opcjonalnie: Liczba elementów typu |
pageToken |
Opcjonalnie: Token strony do pobrania. Jeśli nie określono tego ustawienia, zwracana jest pierwsza strona wyników. Aby zażądać następnej strony wyników, należy użyć wartości uzyskanej z elementu |
Treść odpowiedzi
Komunikat odpowiedzi dla metody ReportService.Search
.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"results": [
{
object ( |
Pola | |
---|---|
results[] |
Wiersze pasujące do zapytania. |
nextPageToken |
Token, który może zostać wysłany jako |
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/content
Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
ReportRow
Wiersz wyników zwrócony z zapytania.
Odpowiedź zawiera tylko komunikat odpowiadający tabeli, której dotyczy zapytanie. W komunikacie wypełnionym są tylko pola wymagane w zapytaniu.
Zapis JSON |
---|
{ "productPerformanceView": { object ( |
Pola | |
---|---|
productPerformanceView |
Pola dostępne na potrzeby zapytań w tabeli |
nonProductPerformanceView |
Pola dostępne na potrzeby zapytań w tabeli |
productView |
Pola dostępne na potrzeby zapytań w tabeli |
priceCompetitivenessProductView |
Pola dostępne na potrzeby zapytań w tabeli |
priceInsightsProductView |
Pola dostępne na potrzeby zapytań w tabeli |
bestSellersProductClusterView |
Pola dostępne na potrzeby zapytań w tabeli |
bestSellersBrandView |
Pola dostępne na potrzeby zapytań w tabeli |
competitiveVisibilityCompetitorView |
Pola dostępne na potrzeby zapytań w tabeli |
competitiveVisibilityTopMerchantView |
Pola dostępne na potrzeby zapytań w tabeli |
competitiveVisibilityBenchmarkView |
Pola dostępne na potrzeby zapytań w tabeli |
ProductPerformanceView
Pola dostępne na potrzeby zapytań w tabeli productPerformanceView
.
Dane o skuteczności produktu na Twoim koncie, w tym dane o skuteczności (np. clicks
) i wymiary, według których dane o skuteczności są posegmentowane (np. offerId
). Wartości wymiarów produktu (np. offerId
) odzwierciedlają stan produktu w momencie wyświetlenia.
W zapytaniach nie można wybierać pól segmentów, jeśli nie wybrano też co najmniej jednego pola danych.
Wartości są ustawiane tylko dla pól, które zostały bezpośrednio zażądane w zapytaniu żądania.
Zapis JSON |
---|
{ "date": { object ( |
Pola | |
---|---|
date |
Data w strefie czasowej sprzedawcy, do której mają zastosowanie dane. Segmentowanie. W klauzuli |
week |
Pierwszy dzień tygodnia (poniedziałek) daty danych w strefie czasowej sprzedawcy. Segmentowanie. |
conversionValue |
Wartość konwersji przypisanych do produktu, raportowana w dniu konwersji. Dane. Dostępne tylko w przypadku źródła wizyt |
marketingMethod |
Metoda marketingowa, do której mają zastosowanie dane. Segmentowanie. |
customerCountryCode |
Kod kraju, w którym znajduje się klient w momencie wystąpienia zdarzenia. Wartość powinna być podana w formacie ISO 3166. Segmentowanie. Jeśli nie można określić kraju klienta, przedrostek „ZZ” . |
offerId |
Identyfikator produktu podany przez sprzedawcę. Segmentowanie. |
title |
Tytuł produktu. Segmentowanie. |
brand |
Marka produktu. Segmentowanie. |
categoryL1 |
Kategoria produktu (poziom 1) w mapie kategorii Google. Segmentowanie. |
categoryL2 |
Kategoria produktów (2 poziom) w mapie kategorii Google. Segmentowanie. |
categoryL3 |
Kategoria produktów (trzeci poziom) w mapie kategorii Google. Segmentowanie. |
categoryL4 |
Kategoria produktów (poziom 4) w mapie kategorii Google. Segmentowanie. |
categoryL5 |
Kategoria produktów (poziom 5) w mapie kategorii Google. Segmentowanie. |
productTypeL1 |
Typ produktu (poziom 1) w mapie kategorii sprzedawcy. Segmentowanie. |
productTypeL2 |
Typ produktu (poziom 2) w mapie kategorii sprzedawcy. Segmentowanie. |
productTypeL3 |
Typ produktu (poziom 3) w mapie kategorii sprzedawcy. Segmentowanie. |
productTypeL4 |
Typ produktu (poziom 4) w mapie kategorii sprzedawcy. Segmentowanie. |
productTypeL5 |
Typ produktu (poziom 5) w mapie kategorii sprzedawcy. Segmentowanie. |
customLabel0 |
Etykieta własna 0 do niestandardowego grupowania produktów. Segmentowanie. |
customLabel1 |
Etykieta własna 1 na potrzeby niestandardowego grupowania produktów. Segmentowanie. |
customLabel2 |
Etykieta własna 2 do niestandardowego grupowania produktów. Segmentowanie. |
customLabel3 |
Etykieta własna 3 na potrzeby niestandardowego grupowania produktów. Segmentowanie. |
customLabel4 |
Etykieta własna 4 na potrzeby niestandardowego grupowania produktów. Segmentowanie. |
clicks |
Liczba kliknięć. Dane. |
impressions |
Liczba wyświetleń produktów sprzedawcy. Dane. |
clickThroughRate |
Współczynnik klikalności – liczba kliknięć produktów sprzedawcy (kliknięcia) podzielona przez liczbę wyświetleń produktów. Dane. |
conversions |
Liczba konwersji przypisanych do produktu raportowanych w dniu konwersji. W zależności od modelu atrybucji konwersja może zostać rozdzielona na wiele kliknięć, przy czym każde kliknięcie otrzymuje własny udział. Te dane to suma wszystkich takich kwot. Dane. Dostępne tylko w przypadku źródła wizyt |
conversionRate |
Liczba konwersji podzielona przez liczbę kliknięć odnotowanych w dniu wyświetlenia. Dane. Dostępne tylko w przypadku źródła wizyt |
MarketingMethodEnum
Wartości metod marketingowych.
Wartości w polu enum | |
---|---|
MARKETING_METHOD_ENUM_UNSPECIFIED |
Nie określono. |
ORGANIC |
Marketing bezpłatny. |
ADS |
Marketing oparty na reklamach. |
NonProductPerformanceView
Pola dostępne na potrzeby zapytań w tabeli nonProductPerformanceView
.
Dane dotyczące skuteczności zdjęć i linków do sklepu internetowego, które prowadzą do stron niedotyczących produktów. Obejmuje to dane o skuteczności (np. clicks
) i wymiary, według których dane o skuteczności są posegmentowane (np. date
).
W zapytaniach nie można wybierać pól segmentów, jeśli nie wybrano też co najmniej jednego pola danych.
Wartości są ustawiane tylko dla pól, które zostały bezpośrednio zażądane w zapytaniu żądania.
Zapis JSON |
---|
{ "date": { object ( |
Pola | |
---|---|
date |
Data w strefie czasowej sprzedawcy, do której mają zastosowanie dane. Segmentowanie. W klauzuli |
week |
Pierwszy dzień tygodnia (poniedziałek) daty danych w strefie czasowej sprzedawcy. Segmentowanie. |
clicks |
Liczba kliknięć zdjęć i linków do sklepu internetowego, które prowadzą do stron niedotyczących produktów. Dane. |
impressions |
Liczba wyświetleń zdjęć i linków do sklepu internetowego, które prowadzą do stron niedotyczących produktów. Dane. |
clickThroughRate |
Współczynnik klikalności – liczba kliknięć ( |
ProductView
Pola dostępne na potrzeby zapytań w tabeli productView
.
Produkty w bieżącym asortymencie. Produkty w tej tabeli są takie same jak w podrzędnym interfejsie API Products, ale nie wszystkie atrybuty produktów z podrzędnego interfejsu API są dostępne do zapytań w tej tabeli. W przeciwieństwie do podrzędnego interfejsu API Produkty ta tabela umożliwia filtrowanie zwróconej listy produktów według atrybutów produktów. Aby pobrać 1 produkt według atrybutu id
lub wyświetlić listę wszystkich produktów, użyj podrzędnego interfejsu API produktów.
Wartości są ustawiane tylko dla pól, które zostały bezpośrednio zażądane w zapytaniu żądania.
Zapis JSON |
---|
{ "price": { object ( |
Pola | |
---|---|
price |
Cena produktu Brak, jeśli informacje o cenie produktu są niedostępne. |
gtin[] |
Lista globalnych numerów jednostki handlowej (GTIN) produktu. |
creationTime |
Czas utworzenia produktu przez sprzedawcę podany w sygnaturze czasowej (sekundy). |
expirationDate |
Data ważności produktu podana po przesłaniu. |
itemIssues[] |
Lista problemów związanych z tym produktem. Tego pola nie można używać do sortowania wyników. Do filtrowania wyników można używać tylko wybranych atrybutów z tego pola (np. |
clickPotential |
Szacowany potencjał skuteczności w porównaniu z najlepiej sprzedającymi się produktami sprzedawcy. |
id |
Identyfikator REST produktu w formacie Wymagane w klauzuli |
channel |
Kanał produktu. Może to być |
languageCode |
Kod języka produktu w formacie BCP 47. |
feedLabel |
Etykieta pliku danych produktu. |
offerId |
Identyfikator produktu podany przez sprzedawcę. |
title |
Tytuł produktu. |
brand |
Marka produktu. |
categoryL1 |
Kategoria produktów (pierwszy poziom) w mapie kategorii Google. |
categoryL2 |
Kategoria produktów (2 poziom) w mapie kategorii Google. |
categoryL3 |
Kategoria produktów (trzeci poziom) w mapie kategorii Google. |
categoryL4 |
Kategoria produktów (czwarty poziom) w mapie kategorii Google. |
categoryL5 |
Kategoria produktów (5 poziom) w mapie kategorii Google. |
productTypeL1 |
Typ produktu (poziom 1) w mapie kategorii sprzedawcy. |
productTypeL2 |
Typ produktu (poziom 2) w mapie kategorii sprzedawcy. |
productTypeL3 |
Typ produktu (poziom 3) w mapie kategorii sprzedawcy. |
productTypeL4 |
Typ produktu (poziom 4) w mapie kategorii sprzedawcy. |
productTypeL5 |
Typ produktu (poziom 5) w mapie kategorii sprzedawcy. |
condition |
Stan produktu. |
availability |
Dostępność produktu. |
shippingLabel |
Znormalizowana etykieta wysyłki określona w źródle danych. |
itemGroupId |
Identyfikator grupy produktów podany przez sprzedawcę w celu grupowania wersji. |
thumbnailLink |
Link do przetworzonego zdjęcia produktu hostowanego w infrastrukturze Google. |
aggregatedReportingContextStatus |
Stan zagregowany. |
clickPotentialRank |
Pozycja produktu na podstawie jego potencjału kliknięcia. Produkt z |
AggregatedReportingContextStatus
Stan usługi zagregowany we wszystkich kontekstach raportowania.
Oto przykład obliczania stanu agregacji:
Bezpłatne informacje | Reklamy produktowe | Stan |
---|---|---|
Zatwierdzono | Zatwierdzono | ODPOWIEDNIA |
Zatwierdzono | Oczekuje | ODPOWIEDNIA |
Zatwierdzono | Odrzucona | ELIGIBLE_LIMITED |
Oczekuje | Oczekuje | OCZEKUJĄCE |
Odrzucona | Odrzucona | NOT_ELIGIBLE_OR_DISAPPROVED |
Wartości w polu enum | |
---|---|
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED |
Nie określono. |
NOT_ELIGIBLE_OR_DISAPPROVED |
Produkt jest nieodpowiedni lub został odrzucony we wszystkich kontekstach raportowania. |
PENDING |
Stan produktu „Oczekujący” we wszystkich kontekstach raportowania. |
ELIGIBLE_LIMITED |
Usługa kwalifikuje się do niektórych (ale nie wszystkich) kontekstów raportowania. |
ELIGIBLE |
Usługa jest odpowiednia we wszystkich kontekstach raportowania. |
ItemIssue
Problem z produktem powiązany z produktem.
Zapis JSON |
---|
{ "type": { object ( |
Pola | |
---|---|
type |
Typ problemu dotyczącego produktu. |
severity |
Waga problemu dotyczącego produktu. |
resolution |
Rozwiązanie problemu dotyczącego produktu. |
ItemIssueType
Typ problemu.
Zapis JSON |
---|
{ "code": string, "canonicalAttribute": string } |
Pola | |
---|---|
code |
Kod błędu problemu odpowiadający |
canonicalAttribute |
Kanoniczna nazwa atrybutu dla problemów związanych z atrybutami. |
ItemIssueSeverity
Jak problem wpływa na wyświetlanie produktu.
Zapis JSON |
---|
{ "severityPerReportingContext": [ { object ( |
Pola | |
---|---|
severityPerReportingContext[] |
Waga problemu według kontekstu raportowania. |
aggregatedSeverity |
Zbiorcza ważność problemu we wszystkich kontekstach raportowania, na które on wpływa. To pole może służyć do filtrowania wyników. |
IssueSeverityPerReportingContext
Waga problemu według kontekstu raportowania.
Zapis JSON |
---|
{
"disapprovedCountries": [
string
],
"demotedCountries": [
string
],
"reportingContext": enum ( |
Pola | |
---|---|
disapprovedCountries[] |
Lista krajów, które zostały odrzucone w kontekście raportowania, podana w formacie ISO 3166. |
demotedCountries[] |
Lista krajów z obniżoną pozycją w kontekście raportowania przedstawiona w formacie ISO 3166. |
reportingContext |
Kontekst raportowania, którego dotyczy problem. |
AggregatedIssueSeverity
Waga problemu zbiorcza dla wszystkich kontekstów raportowania.
Wartości w polu enum | |
---|---|
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED |
Nie określono. |
DISAPPROVED |
Problem powoduje odrzucenie produktu w co najmniej 1 kontekście raportowania. |
DEMOTED |
Problem powoduje obniżenie pozycji usługi w dół we wszystkich kontekstach raportowania, na które ma wpływ. |
PENDING |
Rozwiązanie problemu: PENDING_PROCESSING . |
ItemIssueResolution
Jak rozwiązać ten problem.
Wartości w polu enum | |
---|---|
ITEM_ISSUE_RESOLUTION_UNSPECIFIED |
Nie określono. |
MERCHANT_ACTION |
Sprzedawca musi rozwiązać ten problem. |
PENDING_PROCESSING |
Problem zostanie rozwiązany automatycznie (np. przez zindeksowanie zdjęć) lub poprzez sprawdzenie witryny przez Google. Nie musisz teraz podejmować żadnych działań. Rozwiązanie może spowodować inny problem (na przykład w przypadku niepowodzenia indeksowania). |
ClickPotential
Potencjał kliknięcia produktu pozwala oszacować spodziewaną skuteczność w porównaniu z najlepiej sprzedającymi się produktami sprzedawcy. Potencjał kliknięcia produktu pomaga sprzedawcom ustalić, które produkty należy poprawić, i poznać skuteczność produktów w porównaniu z ich potencjałem.
Wartości w polu enum | |
---|---|
CLICK_POTENTIAL_UNSPECIFIED |
Nieznany przewidywany wpływ kliknięć. |
LOW |
Potencjał uzyskania małej liczby kliknięć w porównaniu z najlepiej sprzedającymi się produktami sprzedawcy. |
MEDIUM |
Potencjał uzyskania średniej liczby kliknięć w porównaniu z najlepiej sprzedającymi się produktami sprzedawcy. |
HIGH |
potencjał uzyskania liczby kliknięć podobnej do tej w przypadku najlepiej sprzedających się produktów sprzedawcy. |
PriceCompetitivenessProductView
Pola dostępne na potrzeby zapytań w tabeli priceCompetitivenessProductView
.
Wartości są ustawiane tylko dla pól, które zostały bezpośrednio zażądane w zapytaniu żądania.
Zapis JSON |
---|
{ "price": { object ( |
Pola | |
---|---|
price |
Aktualna cena produktu. |
benchmarkPrice |
Najnowsza wartość referencyjna cen dla katalogu produktów w kraju, w którym jest poruszona. |
reportCountryCode |
Kraj odniesienia dla cen. Wartość powinna być podana w formacie ISO 3166. Wymagane w klauzuli |
id |
Identyfikator REST produktu w formacie Wymagane w klauzuli |
offerId |
Identyfikator produktu podany przez sprzedawcę. |
title |
Tytuł produktu. |
brand |
Marka produktu. |
categoryL1 |
Kategoria produktów (pierwszy poziom) w mapie kategorii Google. |
categoryL2 |
Kategoria produktów (2 poziom) w mapie kategorii Google. |
categoryL3 |
Kategoria produktów (trzeci poziom) w mapie kategorii Google. |
categoryL4 |
Kategoria produktów (czwarty poziom) w mapie kategorii Google. |
categoryL5 |
Kategoria produktów (5 poziom) w mapie kategorii Google. |
productTypeL1 |
Typ produktu (poziom 1) w mapie kategorii sprzedawcy. |
productTypeL2 |
Typ produktu (poziom 2) w mapie kategorii sprzedawcy. |
productTypeL3 |
Typ produktu (poziom 3) w mapie kategorii sprzedawcy. |
productTypeL4 |
Typ produktu (poziom 4) w mapie kategorii sprzedawcy. |
productTypeL5 |
Typ produktu (poziom 5) w mapie kategorii sprzedawcy. |
PriceInsightsProductView
Pola dostępne na potrzeby zapytań w tabeli priceInsightsProductView
.
Raport Statystyki cen
Wartości są ustawiane tylko dla pól, które zostały bezpośrednio zażądane w zapytaniu żądania.
Zapis JSON |
---|
{ "price": { object ( |
Pola | |
---|---|
price |
Aktualna cena produktu. |
suggestedPrice |
Najnowsza sugerowana cena produktu. |
effectiveness |
Prognozowana skuteczność zastosowania sugerowanej ceny w podziale na kategorie. |
id |
Identyfikator REST produktu w formacie Wymagane w klauzuli |
offerId |
Identyfikator produktu podany przez sprzedawcę. |
title |
Tytuł produktu. |
brand |
Marka produktu. |
categoryL1 |
Kategoria produktów (pierwszy poziom) w mapie kategorii Google. |
categoryL2 |
Kategoria produktów (2 poziom) w mapie kategorii Google. |
categoryL3 |
Kategoria produktów (trzeci poziom) w mapie kategorii Google. |
categoryL4 |
Kategoria produktów (czwarty poziom) w mapie kategorii Google. |
categoryL5 |
Kategoria produktów (5 poziom) w mapie kategorii Google. |
productTypeL1 |
Typ produktu (poziom 1) w mapie kategorii sprzedawcy. |
productTypeL2 |
Typ produktu (poziom 2) w mapie kategorii sprzedawcy. |
productTypeL3 |
Typ produktu (poziom 3) w mapie kategorii sprzedawcy. |
productTypeL4 |
Typ produktu (poziom 4) w mapie kategorii sprzedawcy. |
productTypeL5 |
Typ produktu (poziom 5) w mapie kategorii sprzedawcy. |
predictedImpressionsChangeFraction |
Prognozowana zmiana liczby wyświetleń jako ułamek po wprowadzeniu sugerowanej ceny w porównaniu z aktualną ceną aktywną. Na przykład 0, 05 to przewidywany wzrost liczby wyświetleń o 5%. |
predictedClicksChangeFraction |
Prognozowana zmiana liczby kliknięć jako ułamek po wprowadzeniu sugerowanej ceny w porównaniu z aktualną ceną aktywną. Na przykład 0, 05 to przewidywany wzrost liczby kliknięć o 5%. |
predictedConversionsChangeFraction |
Prognozowana zmiana liczby konwersji jako ułamek po wprowadzeniu sugerowanej ceny w porównaniu z aktualną ceną aktywną. np.0, 05 to przewidywany wzrost liczby konwersji o 5%). |
Skuteczność
Zbiorcza prognozowanej skuteczności.
Wskaźnik Skuteczność wskazuje, które produkty najbardziej skorzystają na zmianie cen. Ocena ta uwzględnia przewidywany wzrost skuteczności wynikający z dostosowania ceny promocyjnej oraz różnicy między ceną bieżącą a sugerowaną. Przewiduje się, że sugestie dotyczące cen o skuteczności na poziomie HIGH
przyniosą największy wzrost skuteczności.
Wartości w polu enum | |
---|---|
EFFECTIVENESS_UNSPECIFIED |
Skuteczność nie jest znana. |
LOW |
Skuteczność jest niska. |
MEDIUM |
Skuteczność jest średnia. |
HIGH |
Skuteczność jest wysoka. |
BestSellersProductClusterView
Pola dostępne na potrzeby zapytań w tabeli bestSellersProductClusterView
.
Raport o bestsellerach zawierający klastry produktów. Klaster produktów to grupa różnych ofert i wersji, które przedstawiają ten sam produkt, np. Google Pixel 7.
Wartości są ustawiane tylko dla pól, które zostały bezpośrednio zażądane w zapytaniu żądania.
Zapis JSON |
---|
{ "reportDate": { object ( |
Pola | |
---|---|
reportDate |
Data raportu. W tym polu może znajdować się tylko jedna z tych wartości:
Wymagane w klauzuli |
variantGtins[] |
Numery GTIN przykładowych wersji grupy produktów. |
reportGranularity |
Szczegółowość raportu. Ranking może obejmować okres tygodnia lub miesiąca. Wymagane w klauzuli |
reportCountryCode |
Kraj, w którym obliczamy ranking. Wartość powinna być podana w formacie ISO 3166. Wymagane w klauzuli |
reportCategoryId |
Identyfikator kategorii produktów Google, dla której chcesz obliczyć ranking, przedstawiony w mapie kategorii Google. Wymagane w klauzuli |
title |
Nazwa grupy produktów. |
brand |
Marka klastra produktów. |
categoryL1 |
Kategoria produktów (pierwszy poziom) klastra produktów uwzględniona w mapie kategorii Google. |
categoryL2 |
Kategoria produktów (2 poziom) klastra produktów uwzględniona w mapie kategorii Google. |
categoryL3 |
Kategoria produktów (trzeci poziom) klastra produktów uwzględniona w mapie kategorii Google. |
categoryL4 |
Kategoria produktów (czwarty poziom) klastra produktów uwzględniona w mapie kategorii Google. |
categoryL5 |
Kategoria produktów (5 poziom) klastra produktów uwzględniona w mapie kategorii Google. |
inventoryStatus |
Określa, czy klaster produktów to To pole nie uwzględnia filtra kraju z raportu o bestsellerach. |
brandInventoryStatus |
Niezależnie od tego, czy w co najmniej 1 kraju w źródle danych o produktach jest obecnie co najmniej 1 produkt marki To pole nie uwzględnia filtra kraju z raportu o bestsellerach. |
rank |
Popularność klastra produktów w Google Ads i na platformach organicznych w wybranej kategorii i w wybranym kraju na podstawie szacowanej liczby sprzedanych produktów. |
previousRank |
Pozycja w rankingu popularności w poprzednim tygodniu lub miesiącu. |
relativeDemand |
Szacowany popyt w porównaniu z grupą produktów o największej popularności w tej samej kategorii i kraju. |
previousRelativeDemand |
Szacowany popyt w porównaniu z grupą produktów o największej popularności w tej samej kategorii i tym samym kraju w poprzednim tygodniu lub miesiącu. |
relativeDemandChange |
Zmiana szacowanego popytu. Czy rosło, tonęło, czy utrzymywało się na stałym poziomie. |
ReportGranularityEnum
Wartości szczegółowości raportu.
Wartości w polu enum | |
---|---|
REPORT_GRANULARITY_ENUM_UNSPECIFIED |
Nie określono. |
WEEKLY |
Raport jest generowany w ciągu tygodnia. |
MONTHLY |
Raport jest generowany w ciągu miesiąca. |
InventoryStatus
Stan klastra produktów lub marki w Twoim asortymencie.
Wartości w polu enum | |
---|---|
INVENTORY_STATUS_UNSPECIFIED |
Nie określono. |
IN_STOCK |
Masz w magazynie produkt tej grupy produktów lub tej marki. |
OUT_OF_STOCK |
Masz w asortymencie produkt dla tej grupy produktów lub tej marki, ale jest on obecnie niedostępny. |
NOT_IN_INVENTORY |
W asortymencie nie masz produktu dla tego klastra produktów lub tej marki. |
RelativeDemandEnum
Wartości względnego popytu.
Wartości w polu enum | |
---|---|
RELATIVE_DEMAND_ENUM_UNSPECIFIED |
Nie określono. |
VERY_LOW |
Popyt to 0–5% popytu na najpopularniejszy klaster produktów lub markę. |
LOW |
Popyt to 6–10% popytu na najpopularniejszy klaster produktów lub markę. |
MEDIUM |
Popyt to 11–20% popytu na najpopularniejszy klaster produktów lub markę. |
HIGH |
Popyt to 21–50% popytu na najpopularniejszy klaster produktów lub markę. |
VERY_HIGH |
Popyt to 51–100% popytu na najpopularniejszy klaster produktów lub markę. |
RelativeDemandChangeTypeEnum
Wartości typu zmiany względnego popytu.
Wartości w polu enum | |
---|---|
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED |
Nie określono. |
SINKER |
Względny popyt jest niższy niż w poprzednim okresie. |
FLAT |
Względny popyt jest równy poprzedniemu okresowi. |
RISER |
Względny popyt jest wyższy niż w poprzednim okresie. |
BestSellersBrandView
Pola dostępne na potrzeby zapytań w tabeli bestSellersBrandView
.
Raport bestsellerów przedstawiający najpopularniejsze marki.
Wartości są ustawiane tylko dla pól, które zostały bezpośrednio zażądane w zapytaniu żądania.
Zapis JSON |
---|
{ "reportDate": { object ( |
Pola | |
---|---|
reportDate |
Data raportu. W tym polu może znajdować się tylko jedna z tych wartości:
Wymagane w klauzuli |
reportGranularity |
Szczegółowość raportu. Ranking może obejmować okres tygodnia lub miesiąca. Wymagane w klauzuli |
reportCountryCode |
Kraj, w którym obliczamy ranking. Wartość powinna być podana w formacie ISO 3166. Wymagane w klauzuli |
reportCategoryId |
Identyfikator kategorii produktów Google, dla której chcesz obliczyć ranking, przedstawiony w mapie kategorii Google. Wymagane w klauzuli |
brand |
Nazwa marki. |
rank |
Popularność marki w Google Ads i na platformach bezpłatnych w wybranej kategorii i kraju na podstawie szacowanej liczby sprzedanych produktów. |
previousRank |
Pozycja w rankingu popularności w poprzednim tygodniu lub miesiącu. |
relativeDemand |
Szacowany popyt w porównaniu z najpopularniejszą marką w tej samej kategorii i kraju. |
previousRelativeDemand |
Szacowany popyt w odniesieniu do marki o największej popularności w tej samej kategorii i tym samym kraju w poprzednim tygodniu lub miesiącu. |
relativeDemandChange |
Zmiana szacowanego popytu. Czy rosło, tonęło, czy utrzymywało się na stałym poziomie. |
CompetitiveVisibilityCompetitorView
Pola dostępne na potrzeby zapytań w tabeli competitiveVisibilityCompetitorView
.
Raport Widoczność na tle konkurencji w przypadku firm o podobnej widoczności.
Wartości są ustawiane tylko dla pól, które zostały bezpośrednio zażądane w zapytaniu żądania.
Zapis JSON |
---|
{ "date": { object ( |
Pola | |
---|---|
date |
Data w tym wierszu. W klauzuli |
domain |
domena konkurenta lub Twoja domena, jeśli „isYourDomain”; to prawda. Wymagane w klauzuli |
isYourDomain |
Wartość to „prawda”, jeśli ten wiersz zawiera dane dotyczące Twojej domeny. Nie można filtrować według zakresu „WHERE” . |
reportCountryCode |
Kraj, w którym pojawiły się wyświetlenia. Wymagane w klauzuli |
reportCategoryId |
Identyfikator kategorii produktów Google, dla której chcesz obliczyć raport, przedstawiony w mapie kategorii Google. Wymagane w klauzuli |
trafficSource |
Źródło wizyt wyświetleń. Wymagane w klauzuli |
rank |
Pozycja domeny w rankingu podobnych firm dla wybranych kluczy ( Nie można filtrować według zakresu „WHERE” . |
adsOrganicRatio |
Współczynnik reklam / bezpłatnych wyników wyszukiwania pokazuje, jak często domena uzyskuje wyświetlenia z reklam produktowych w porównaniu do ruchu bezpłatnego. Liczba jest zaokrąglona i połączona z grupą odbiorców. Nie można filtrować według zakresu „WHERE” . |
pageOverlapRate |
Współczynnik pokrywania się stron pokazuje, jak często oferty konkurencyjnych sprzedawców wyświetlają się razem z Twoimi ofertami na tej samej stronie. Nie można filtrować według zakresu „WHERE” . |
higherPositionRate |
Współczynnik wyższej pozycji pokazuje, jak często oferta konkurenta wyświetliła się na stronie na wyższej pozycji niż Twoja. Nie można filtrować według zakresu „WHERE” . |
relativeVisibility |
Widoczność względna pokazuje, jak często oferty Twoich konkurentów są wyświetlane w porównaniu z Twoimi ofertami. Innymi słowy, jest to liczba wyświetleń u konkurencji, podzielona przez liczbę Twoich wyświetleń w wybranym przedziale czasu dla wybranej kategorii produktów i kraju. Nie można filtrować według zakresu „WHERE” . |
TrafficSourceEnum
Wartości źródeł wizyt.
Wartości w polu enum | |
---|---|
TRAFFIC_SOURCE_ENUM_UNSPECIFIED |
Nie określono. |
ORGANIC |
Ruch bezpłatny. |
ADS |
Ruch z reklam. |
ALL |
Ruch z bezpłatnych wyników wyszukiwania i reklam. |
CompetitiveVisibilityTopMerchantView
Pola dostępne na potrzeby zapytań w tabeli competitiveVisibilityTopMerchantView
.
Raport Widoczność na tle konkurencji o największej widoczności.
Wartości są ustawiane tylko dla pól, które zostały bezpośrednio zażądane w zapytaniu żądania.
Zapis JSON |
---|
{ "date": { object ( |
Pola | |
---|---|
date |
Data w tym wierszu. Nie można wybrać w klauzuli |
domain |
domena konkurenta lub Twoja domena, jeśli „isYourDomain”; to prawda. Wymagane w klauzuli |
isYourDomain |
Wartość to „prawda”, jeśli ten wiersz zawiera dane dotyczące Twojej domeny. Nie można filtrować według zakresu „WHERE” . |
reportCountryCode |
Kraj, w którym pojawiły się wyświetlenia. Wymagane w klauzuli |
reportCategoryId |
Identyfikator kategorii produktów Google, dla której chcesz obliczyć raport, przedstawiony w mapie kategorii Google. Wymagane w klauzuli |
trafficSource |
Źródło wizyt wyświetleń. Wymagane w klauzuli |
rank |
Pozycja domeny w rankingu najlepszych sprzedawców dla wybranych kluczy ( Nie można filtrować według zakresu „WHERE” . |
adsOrganicRatio |
Współczynnik reklam / bezpłatnych wyników wyszukiwania pokazuje, jak często domena uzyskuje wyświetlenia z reklam produktowych w porównaniu do ruchu bezpłatnego. Liczba jest zaokrąglona i połączona z grupą odbiorców. Nie można filtrować według zakresu „WHERE” . |
pageOverlapRate |
Współczynnik pokrywania się stron pokazuje, jak często oferty konkurencyjnych sprzedawców wyświetlają się razem z Twoimi ofertami na tej samej stronie. Nie można filtrować według zakresu „WHERE” . |
higherPositionRate |
Współczynnik wyższej pozycji pokazuje, jak często oferta konkurenta wyświetliła się na stronie na wyższej pozycji niż Twoja. Nie można filtrować według zakresu „WHERE” . |
CompetitiveVisibilityBenchmarkView
Pola dostępne na potrzeby zapytań w tabeli competitiveVisibilityBenchmarkView
.
Widoczność na tle konkurencji za pomocą testu porównawczego kategorii.
Wartości są ustawiane tylko dla pól, które zostały bezpośrednio zażądane w zapytaniu żądania.
Zapis JSON |
---|
{ "date": { object ( |
Pola | |
---|---|
date |
Data w tym wierszu. Wymagane w klauzuli |
reportCountryCode |
Kraj, w którym pojawiły się wyświetlenia. Wymagane w klauzuli |
reportCategoryId |
Identyfikator kategorii produktów Google, dla której chcesz obliczyć raport, przedstawiony w mapie kategorii Google. Wymagane w klauzuli |
trafficSource |
Źródło wizyt wyświetleń. Wymagane w klauzuli |
yourDomainVisibilityTrend |
Zmiana widoczności na podstawie wyświetleń w domenie od początku wybranego zakresu czasowego (lub pierwszego dnia z liczbą wyświetleń inną niż zero). Nie można filtrować według zakresu „WHERE” . |
categoryBenchmarkVisibilityTrend |
Zmiana widoczności na podstawie wyświetleń na początku wybranego zakresu czasowego (lub pierwszego dnia z liczbą wyświetleń większą niż zero) w grupie sprzedawców o największej widoczności zbliżonej do rynku. Nie można filtrować według zakresu „WHERE” . |