Package google.shopping.merchant.reports.v1beta

Indeks

ReportService

Usługa służąca do pobierania raportów i statystyk dotyczących Twoich produktów, ich wyników i konkurencji w Google.

Szukaj

rpc Search(SearchRequest) returns (SearchResponse)

Pobiera raport zdefiniowany przez zapytanie. Odpowiedź może zawierać mniej wierszy niż określono w parametry page_size. Aby określić, czy są jeszcze inne wiersze, na które można wysłać żądanie, użyj wartości next_page_token.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/content

Więcej informacji znajdziesz w OAuth 2.0 Overview.

BestSellersBrandView

Pola dostępne do zapytań w tabeli best_sellers_brand_view.

Raport Bestsellery z najpopularniejszymi markami.

Wartości są ustawiane tylko w przypadku pól, które zostały wyraźnie zażądane w zapytaniu wyszukiwania żądania.

Pola
report_date

Date

Data raportu. Wartość tego pola może być tylko jedną z tych wartości:

  • pierwszy dzień tygodnia (poniedziałek) w przypadku raportów tygodniowych,
  • Pierwszy dzień miesiąca w przypadku raportów miesięcznych.

Wymagane w nawiasach klamrowych SELECT. Jeśli w zapytaniu nie jest określony warunek WHERE w elementach report_date, zwracany jest najnowszy raport tygodniowy lub miesięczny.
report_granularity

ReportGranularityEnum

szczegółowość raportu; Ranking może być tworzony w ciągu tygodnia lub miesiąca.

Wymagane w klauzuli SELECT. Warunek report_granularity jest wymagany w klauzuli WHERE.
report_country_code

string

Kraj, w którym obliczany jest ranking. W formacie ISO 3166.

Wymagane w klauzuli SELECT. Warunek report_country_code jest wymagany w klauzuli WHERE.
report_category_id

int64

Identyfikator kategorii produktów Google, dla której ma być obliczany ranking, podany w mapie kategorii produktów Google.

Wymagane w klauzuli SELECT. Jeśli w zapytaniu nie jest określony warunek WHERE w elementach report_category_id, zwracane są rankingi wszystkich kategorii najwyższego poziomu.
brand

string

Nazwa marki.
rank

int64

Popularność marki w reklamach i bezpłatnych wynikach wyszukiwania w wybranej kategorii i kraju na podstawie szacowanej liczby sprzedanych produktów.
previous_rank

int64

Ranking popularności w ciągu ostatniego tygodnia lub miesiąca.
relative_demand

RelativeDemandEnum

Szacowany popyt w porównaniu z marką o najwyższej popularności w tej samej kategorii i tym samym kraju.
previous_relative_demand

RelativeDemandEnum

Szacowany popyt w porównaniu z najpopularniejszą marką w tej samej kategorii i kraju w ciągu poprzedniego tygodnia lub miesiąca.
relative_demand_change

RelativeDemandChangeTypeEnum

zmiana szacowanego popytu; czy wzrosła, spadła czy pozostała na tym samym poziomie.

BestSellersProductClusterView

Pola dostępne do zapytań w tabeli best_sellers_product_cluster_view.

Raport Bestsellery z najważniejszymi grupami produktów. Gromadę produktów stanowi grupa różnych ofert i wersji, które reprezentują ten sam produkt, np. Google Pixel 7.

Wartości są ustawiane tylko w przypadku pól, które zostały wyraźnie zażądane w zapytaniu wyszukiwania żądania.

Pola
report_date

Date

Data raportu. Wartość tego pola może być tylko jedną z tych wartości:

  • pierwszy dzień tygodnia (poniedziałek) w przypadku raportów tygodniowych,
  • Pierwszy dzień miesiąca w przypadku raportów miesięcznych.

Wymagane w klauzuli SELECT. Jeśli w zapytaniu nie jest określony warunek WHERE w elementach report_date, zwracany jest najnowszy raport tygodniowy lub miesięczny.
variant_gtins[]

string

Numery GTIN przykładowych wersji z klastra produktów.
report_granularity

ReportGranularityEnum

szczegółowość raportu; Ranking może być tworzony w ciągu tygodnia lub miesiąca.

Wymagane w klauzuli SELECT. Warunek report_granularity jest wymagany w klauzuli WHERE.
report_country_code

string

Kraj, w którym obliczany jest ranking. W formacie ISO 3166.

Wymagane w klauzuli SELECT. Warunek report_country_code jest wymagany w klauzuli WHERE.
report_category_id

int64

Identyfikator kategorii produktów Google, dla której ma być obliczany ranking, podany w mapie kategorii produktów Google.

Wymagane w klauzuli SELECT. Jeśli w zapytaniu nie jest określony warunek WHERE w elementach report_category_id, zwracane są rankingi wszystkich kategorii najwyższego poziomu.
title

string

Nazwa grupy produktów.
brand

string

Marka klastra produktów.
category_l1

string

Kategoria produktów (1 poziom) z klastra produktów, reprezentowana w mapie kategorii Google.
category_l2

string

Kategoria produktów (2 poziom) w klastrze produktów, reprezentowana w mapie kategorii Google.
category_l3

string

Kategoria produktów (3 poziom) z klastra produktów, reprezentowana w mapie kategorii Google.
category_l4

string

Kategoria produktów (4 poziom) w klastrze produktów, reprezentowana w mapie kategorii Google.
category_l5

string

Kategoria produktów (5 poziom) z klastra produktów, reprezentowana w mapie kategorii Google.
inventory_status

InventoryStatus

Określ, czy klaster produktów jest IN_STOCK w źródle danych o produktach w co najmniej jednym kraju, OUT_OF_STOCK w źródle danych o produktach we wszystkich krajach lub NOT_IN_INVENTORY w ogóle.

To pole nie uwzględnia filtra kraju z raportu o bestsellerach.
brand_inventory_status

InventoryStatus

Czy w źródle danych o produktach w co najmniej jednym kraju znajduje się co najmniej 1 produkt tej marki, czy wszystkie produkty w źródle danych o produktach we wszystkich krajach są OUT_OF_STOCK, czy też NOT_IN_INVENTORY.IN_STOCK

To pole nie uwzględnia filtra kraju z raportu o bestsellerach.
rank

int64

Popularność grupy produktów w reklamach i bezpłatnych wynikach wyszukiwania w wybranej kategorii i kraju na podstawie szacowanej liczby sprzedanych produktów.
previous_rank

int64

Ranking popularności w ciągu ostatniego tygodnia lub miesiąca.
relative_demand

RelativeDemandEnum

Szacowany popyt w porównaniu z produktem należącym do klastra produktów o najwyższej popularności w tej samej kategorii i tym samym kraju.
previous_relative_demand

RelativeDemandEnum

Szacowany popyt w porównaniu z produktami z najwyższą pozycją w rankingu popularności w tej samej kategorii i kraju w poprzednim tygodniu lub miesiącu.
relative_demand_change

RelativeDemandChangeTypeEnum

zmiana szacowanego popytu; czy wzrosła, spadła czy pozostała na tym samym poziomie.

InventoryStatus

Stan grupy produktów lub marki w Twoim asortymencie.

Wartości w polu enum
INVENTORY_STATUS_UNSPECIFIED Nie określono.
IN_STOCK masz produkt należący do tego klastra produktów lub tej marki w magazynie;
OUT_OF_STOCK Masz produkt należący do tego zbioru produktów lub marki w swoim asortymencie, ale jest on obecnie niedostępny.
NOT_IN_INVENTORY Nie masz produktu dla tego klastra produktów lub marki w składzie.

CompetitiveVisibilityBenchmarkView

Pola dostępne do zapytań w tabeli competitive_visibility_benchmark_view.

Raport Widoczność na tle konkurencji z benchmarkiem kategorii.

Wartości są ustawiane tylko w przypadku pól, które zostały wyraźnie zażądane w zapytaniu wyszukiwania żądania.

Pola
date

Date

Data tego wiersza.

Wymagane w klauzuli SELECT. W klauzuli WHERE musi być podany warunek date.
report_country_code

string

Kraj, w którym pojawiły się wyświetlenia.

Wymagane w klauzuli SELECT. W klauzuli WHERE musi być podany warunek report_country_code.
report_category_id

int64

Identyfikator kategorii produktów Google, dla której ma być obliczany raport, podany w mapie kategorii produktów Google.

Wymagane w klauzuli SELECT. W klauzuli WHERE musi być podany warunek report_category_id.
traffic_source

TrafficSourceEnum

Źródło wizyty, w której nastąpiło wyświetlenie.

Wymagane w klauzuli SELECT.
your_domain_visibility_trend

double

Zmiana widoczności na podstawie wyświetleń Twojej domeny w stosunku do początku wybranego zakresu czasowego (lub pierwszego dnia z wyświetleniami niezerowymi).

Nie można ich filtrować w klauzuli „WHERE”.
category_benchmark_visibility_trend

double

Zmiana widoczności na podstawie wyświetleń w porównaniu z początkiem wybranego zakresu czasowego (lub pierwszego dnia z wyświetleniami niezerowymi) w przypadku zbioru sprzedawców o największej widoczności, który w przybliżeniu odzwierciedla rynek.

Nie można ich filtrować w klauzuli „WHERE”.

CompetitiveVisibilityCompetitorView

Pola dostępne do zapytań w tabeli competitive_visibility_competitor_view.

Raport Widoczność na tle konkurencji z firmami o podobnej widoczności.

Wartości są ustawiane tylko w przypadku pól, które zostały wyraźnie zażądane w zapytaniu wyszukiwania żądania.

Pola
date

Date

Data tego wiersza.

W klauzuli WHERE wymagany jest warunek date.
domain

string

Domena konkurencji lub Twoja domena, jeśli parametr „is_your_domain” ma wartość true.

Wymagane w klauzuli SELECT. Nie można ich filtrować w klauzuli „WHERE”.
is_your_domain

bool

Prawda, jeśli wiersz zawiera dane Twojej domeny.

Nie można ich filtrować w klauzuli „WHERE”.
report_country_code

string

Kraj, w którym pojawiły się wyświetlenia.

Wymagane w klauzuli SELECT. W klauzuli WHERE wymagany jest warunek report_country_code.
report_category_id

int64

Identyfikator kategorii produktów Google, dla której ma być obliczany raport, podany w mapie kategorii produktów Google.

Wymagane w klauzuli SELECT. W klauzuli WHERE wymagany jest warunek report_category_id.
traffic_source

TrafficSourceEnum

Źródło wizyty, w której nastąpiło wyświetlenie.

Wymagane w klauzuli SELECT.
rank

int64

Pozycja domeny w rankingu podobnych firm dla wybranych kluczy (date, report_category_id, report_country_code, traffic_source) na podstawie wyświetleń. Najwyższa wartość to 1.

Nie można ich filtrować w klauzuli „WHERE”.
ads_organic_ratio

double

Współczynnik reklam / bezpłatnych wyników wyszukiwania określa, jak często domena uzyskuje wyświetlenia z reklam produktowych w porównaniu do bezpłatnych wyników wyszukiwania. Liczba jest zaokrąglana i umieszczana w grupach.

Nie można ich filtrować w klauzuli „WHERE”.
page_overlap_rate

double

Współczynnik pokrywających się stron określa, jak często oferty konkurencyjnych sprzedawców wyświetlają się razem z Twoimi ofertami na tej samej stronie.

Nie można ich filtrować w klauzuli „WHERE”.
higher_position_rate

double

Współczynnik wyższej pozycji określa, jak często oferta konkurenta wyświetlała się na stronie na pozycji wyższej niż Twoja.

Nie można ich filtrować w klauzuli „WHERE”.
relative_visibility

double

Widoczność względna określa, jak często oferty Twoich konkurentów są wyświetlane w porównaniu do Twoich ofert. Krótko mówiąc, jest to liczba wyświetleń konkurencyjnych sprzedawców podzielona przez liczbę Twoich wyświetleń w wybranym przedziale czasu dla określonej kategorii produktów i kraju.

Nie można ich filtrować w klauzuli „WHERE”.

CompetitiveVisibilityTopMerchantView

Pola dostępne do zapytań w tabeli competitive_visibility_top_merchant_view.

Raport Widoczność na tle konkurencji z firmą o najwyższej widoczności.

Wartości są ustawiane tylko w przypadku pól, które zostały wyraźnie zażądane w zapytaniu wyszukiwania żądania.

Pola
date

Date

Data tego wiersza.

Nie można ich wybrać w klauzuli SELECT. W klauzuli WHERE wymagany jest warunek date.
domain

string

Domena konkurencji lub Twoja domena, jeśli parametr „is_your_domain” ma wartość true.

Wymagane w klauzuli SELECT. Nie można ich filtrować w klauzuli „WHERE”.
is_your_domain

bool

Prawda, jeśli wiersz zawiera dane Twojej domeny.

Nie można ich filtrować w klauzuli „WHERE”.
report_country_code

string

Kraj, w którym pojawiły się wyświetlenia.

Wymagane w klauzuli SELECT. W klauzuli WHERE musi być podany warunek report_country_code.
report_category_id

int64

Identyfikator kategorii produktów Google, dla której ma być obliczany raport, podany w mapie kategorii produktów Google.

Wymagane w klauzuli SELECT. W klauzuli WHERE musi być podany warunek report_category_id.
traffic_source

TrafficSourceEnum

Źródło wizyty, w której nastąpiło wyświetlenie.

Wymagane w klauzuli SELECT.
rank

int64

Pozycja domeny w rankingu najlepszych sprzedawców w przypadku wybranych słów kluczowych (date, report_category_id, report_country_code, traffic_source) na podstawie wyświetleń. Najwyższa wartość to 1.

Nie można ich filtrować w klauzuli „WHERE”.
ads_organic_ratio

double

Współczynnik reklam / bezpłatnych wyników wyszukiwania określa, jak często domena uzyskuje wyświetlenia z reklam produktowych w porównaniu do bezpłatnych wyników wyszukiwania. Liczba jest zaokrąglana i umieszczana w grupach.

Nie można ich filtrować w klauzuli „WHERE”.
page_overlap_rate

double

Współczynnik pokrywających się stron określa, jak często oferty konkurencyjnych sprzedawców wyświetlają się razem z Twoimi ofertami na tej samej stronie.

Nie można ich filtrować w klauzuli „WHERE”.
higher_position_rate

double

Współczynnik wyższej pozycji określa, jak często oferta konkurenta wyświetlała się na stronie na pozycji wyższej niż Twoja.

Nie można ich filtrować w klauzuli „WHERE”.

MarketingMethod

Ten typ nie ma pól.

Metoda marketingowa używana do promowania produktów w Google (bezpłatne wyniki wyszukiwania lub reklamy).

MarketingMethodEnum

Wartości metody marketingowej.

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 do zapytań w tabeli non_product_performance_view.

dane o skuteczności obrazów 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ą dzielone na segmenty (np. date).

W zapytaniach nie można wybierać pól segmentu bez wybierania co najmniej 1 pola danych.

Wartości są ustawiane tylko w przypadku pól, które zostały wyraźnie zażądane w zapytaniu wyszukiwania.

Pola
date

Date

Data w strefie czasowej sprzedawcy, do której odnoszą się dane. Segmentowanie.

Warunek date jest wymagany w klauzuli WHERE.
week

Date

Pierwszy dzień tygodnia (poniedziałek) z daty danych w strefie czasowej sprzedawcy. Segmentowanie.
clicks

int64

Liczba kliknięć obrazów i linków do sklepu internetowego, które prowadzą do stron niedotyczących produktów. Dane.
impressions

int64

Liczba wyświetleń obrazów i linków do sklepu internetowego, które prowadzą do stron niedotyczących produktów. Dane.
click_through_rate

double

Współczynnik klikalności – liczba kliknięć (clicks) podzielona przez liczbę wyświetleń (impressions) obrazów i linków do sklepu internetowego prowadzących do stron niedotyczących produktów. Dane.

PriceCompetitivenessProductView

Pola dostępne do zapytań w tabeli price_competitiveness_product_view.

Raport Konkurencyjność cenowa.

Wartości są ustawiane tylko w przypadku pól, które zostały wyraźnie zażądane w zapytaniu wyszukiwania żądania.

Pola
price

Price

Obecna cena produktu.
benchmark_price

Price

najnowsze dostępne dane porównawcze dotyczące katalogu produktów w kraju odniesienia;
report_country_code

string

Kraj, w którym obowiązuje cena referencyjna. W formacie ISO 3166.

Wymagane w klauzuli SELECT.
id

string

Identyfikator REST produktu w formie channel~languageCode~feedLabel~offerId. Można go używać do złączania danych z tabelą product_view.

Wymagane w klauzuli SELECT.
offer_id

string

Identyfikator produktu podany przez sprzedawcę.
title

string

Tytuł produktu.
brand

string

Marka produktu.
category_l1

string

Kategoria produktów (1 poziom) w mapie kategorii Google.
category_l2

string

Kategoria produktów (2 poziom) w mapie kategorii Google.
category_l3

string

Kategoria produktów (3 poziom) w mapie kategorii Google.
category_l4

string

Kategoria produktów (4 poziom) w mapie kategorii Google.
category_l5

string

Kategoria produktów (poziom 5) w mapie kategorii Google.
product_type_l1

string

Typ produktu (poziom 1) w mapie kategorii produktów sprzedawcy.
product_type_l2

string

Typ produktu (poziom 2) w mapie kategorii produktów sprzedawcy.
product_type_l3

string

Typ produktu (poziom 3) w mapie kategorii produktów sprzedawcy.
product_type_l4

string

Typ produktu (poziom 4) w mapie kategorii produktów sprzedawcy.
product_type_l5

string

Typ produktu (poziom 5) w mapie kategorii produktów sprzedawcy.

PriceInsightsProductView

Pola dostępne do zapytań w tabeli price_insights_product_view.

raport Statystyki dotyczące cen.

Wartości są ustawiane tylko w przypadku pól, które zostały wyraźnie zażądane w zapytaniu wyszukiwania żądania.

Pola
price

Price

Obecna cena produktu.
suggested_price

Price

Najnowsza sugerowana cena produktu.
effectiveness

Effectiveness

Prognozowana skuteczność zastosowania sugestii ceny, pogrupowana.
id

string

Identyfikator REST produktu w formie channel~languageCode~feedLabel~offerId. Można go używać do złączania danych z tabelą product_view.

Wymagane w klauzuli SELECT.
offer_id

string

Identyfikator produktu podany przez sprzedawcę.
title

string

Tytuł produktu.
brand

string

Marka produktu.
category_l1

string

Kategoria produktów (1 poziom) w mapie kategorii Google.
category_l2

string

Kategoria produktów (2 poziom) w mapie kategorii Google.
category_l3

string

Kategoria produktów (3 poziom) w mapie kategorii Google.
category_l4

string

Kategoria produktów (4 poziom) w mapie kategorii Google.
category_l5

string

Kategoria produktów (poziom 5) w mapie kategorii Google.
product_type_l1

string

Typ produktu (poziom 1) w mapie kategorii produktów sprzedawcy.
product_type_l2

string

Typ produktu (poziom 2) w mapie kategorii produktów sprzedawcy.
product_type_l3

string

Typ produktu (poziom 3) w mapie kategorii produktów sprzedawcy.
product_type_l4

string

Typ produktu (poziom 4) w mapie kategorii produktów sprzedawcy.
product_type_l5

string

Typ produktu (poziom 5) w mapie kategorii produktów sprzedawcy.
predicted_impressions_change_fraction

double

Przewidywana zmiana liczby wyświetleń jako ułamek po wprowadzeniu sugerowanej ceny w porównaniu z bieżącą ceną aktywną. Na przykład wartość 0, 05 oznacza prognozowany wzrost liczby wyświetleń o 5%.
predicted_clicks_change_fraction

double

Przewidywana zmiana liczby kliknięć jako ułamek po wprowadzeniu sugerowanej ceny w porównaniu z bieżącą ceną aktywną. Na przykład wartość 0, 05 oznacza przewidywany wzrost liczby kliknięć o 5%.
predicted_conversions_change_fraction

double

Przewidywana zmiana liczby konwersji wyrażona jako ułamek po wprowadzeniu sugerowanej ceny w porównaniu z bieżącą ceną aktywną. Wartość 0, 05 oznacza np.5% prognozowany wzrost liczby konwersji.

Skuteczność

Grupa prognozowanej skuteczności.

Wskaźnik Skuteczność informuje, 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 HIGH spowodują największy wzrost skuteczności.

Wartości w polu enum
EFFECTIVENESS_UNSPECIFIED Skuteczność jest nieznana.
LOW Skuteczność jest niska.
MEDIUM Skuteczność jest średnia.
HIGH Wysoka skuteczność.

ProductPerformanceView

Pola dostępne do zapytań w tabeli product_performance_view.

Dane o skuteczności produktów na Twoim koncie, w tym dane o skuteczności (np. clicks) i wymiary, według których dane o skuteczności są dzielone na segmenty (np. offer_id). Wartości wymiarów produktów, np. offer_id, odzwierciedlają stan produktu w momencie wyświetlenia.

W zapytaniach nie można wybierać pól segmentu bez wybierania co najmniej 1 pola danych.

Wartości są ustawiane tylko w przypadku pól, które zostały wyraźnie zażądane w zapytaniu wyszukiwania.

Pola
date

Date

Data w strefie czasowej sprzedawcy, do której odnoszą się dane. Segmentowanie.

Warunek date jest wymagany w klauzuli WHERE.
week

Date

Pierwszy dzień tygodnia (poniedziałek) z datą danych w strefie czasowej sprzedawcy. Segmentowanie.
conversion_value

Price

Wartość konwersji przypisanych do produktu, zgłaszanych w dniu konwersji. Dane.

Dostępne tylko w przypadku źródła wizyt FREE.
marketing_method

MarketingMethodEnum

Metoda marketingowa, do której odnoszą się dane. Segmentowanie.
customer_country_code

string

Kod kraju, w którym znajduje się klient w chwili zdarzenia. W formacie ISO 3166. Segmentowanie.

Jeśli nie można określić kraju klienta, zwracany jest specjalny kod „ZZ”.
offer_id

string

Identyfikator produktu podany przez sprzedawcę. Segmentowanie.
title

string

Tytuł produktu. Segmentowanie.
brand

string

Marka produktu. Segmentowanie.
category_l1

string

Kategoria produktów (1 poziom) na mapie kategorii produktów Google. Segmentowanie.
category_l2

string

Kategoria produktów (2 poziom) w mapie kategorii Google. Segmentowanie.
category_l3

string

Kategoria produktów (3 poziom) w mapie kategorii Google. Segmentowanie.
category_l4

string

Kategoria produktów (4 poziom) na mapie kategorii Google. Segmentowanie.
category_l5

string

Kategoria produktów (5 poziom) na mapie kategorii Google. Segmentowanie.
product_type_l1

string

Typ produktu (poziom 1) w własnej mapie kategorii sprzedawcy. Segmentowanie.
product_type_l2

string

Typ produktu (poziom 2) w taksonomii produktów sprzedawcy. Segmentowanie.
product_type_l3

string

Typ produktu (poziom 3) w mapie kategorii produktów sprzedawcy. Segmentowanie.
product_type_l4

string

Typ produktu (poziom 4) w mapie kategorii produktów sprzedawcy. Segmentowanie.
product_type_l5

string

Typ produktu (poziom 5) w taksonomii produktów sprzedawcy. Segmentowanie.
custom_label0

string

Etykieta własna 0 do niestandardowego grupowania produktów. Segmentowanie.
custom_label1

string

Etykieta własna 1 do niestandardowego grupowania produktów. Segmentowanie.
custom_label2

string

Etykieta własna 2 do niestandardowego grupowania produktów. Segmentowanie.
custom_label3

string

Etykieta własna 3 do niestandardowego grupowania produktów. Segmentowanie.
custom_label4

string

Etykieta własna 4 do niestandardowego grupowania produktów. Segmentowanie.
clicks

int64

Liczba kliknięć. Dane.
impressions

int64

Liczba wyświetleń produktów sprzedawcy. Dane.
click_through_rate

double

Współczynnik klikalności – liczba kliknięć produktów sprzedawcy (kliknięć) podzielona przez liczbę ich wyświetleń (wyświetleń). Dane.
conversions

double

Liczba konwersji przypisanych do produktu, zgłoszonych w dniu konwersji. W zależności od modelu atrybucji konwersja może być przypisana do kilku kliknięć, a każde z nich otrzyma własny udział. Te dane to suma wszystkich takich środków. Dane.

Dostępne tylko w przypadku źródła wizyt FREE.
conversion_rate

double

Liczba konwersji podzielona przez liczbę kliknięć, raportowana według daty wyświetlenia. Dane.

Dostępne tylko w przypadku źródła wizyt FREE.

ProductView

Pola dostępne do zapytań w tabeli product_view.

produkty z bieżącego asortymentu; Produkty w tej tabeli są takie same jak w interfejsie podrzędnym Products, ale nie wszystkie atrybuty produktów z interfejsu podrzędnego Products są dostępne do zapytań w tej tabeli. W przeciwieństwie do podrzędnego interfejsu Products ta tabela umożliwia filtrowanie zwróconej listy produktów według atrybutów produktów. Aby pobrać pojedynczy produkt według id lub wyświetlić listę wszystkich produktów, należy użyć podinterfejsu Products.

Wartości są ustawiane tylko w przypadku pól, które zostały wyraźnie zażądane w zapytaniu wyszukiwania żądania.

Pola
price

Price

Cena produktu Brakuje, jeśli informacje o cenie produktu są niedostępne.
gtin[]

string

Lista globalnych numerów jednostek handlowych (GTIN) produktu.
creation_time

Timestamp

Czas utworzenia produktu przez sprzedawcę w sekundach.
expiration_date

Date

Data ważności produktu określona w miejscu wstawienia.
item_issues[]

ItemIssue

Lista problemów z produktem.

Nie można używać tego pola do sortowania wyników.

Do filtrowania wyników można używać tylko wybranych atrybutów tego pola (np. item_issues.severity.aggregated_severity).
click_potential

ClickPotential

Szacowana skuteczność w porównaniu z najlepiej sprzedającymi się produktami sprzedawcy.
id

string

Identyfikator REST produktu w formie channel~languageCode~feedLabel~offerId. Metody Merchant API, które działają na produktach, przyjmują to jako parametr name.

Wymagane w klauzuli SELECT.
channel

ChannelEnum

Kanał produktu. Może to być ONLINE lub LOCAL.
language_code

string

Kod języka produktu w formacie BCP 47.
feed_label

string

Etykieta pliku danych produktu.
offer_id

string

Identyfikator produktu podany przez sprzedawcę.
title

string

Tytuł produktu.
brand

string

Marka produktu.
category_l1

string

Kategoria produktów (1 poziom) w mapie kategorii Google.
category_l2

string

Kategoria produktów (2 poziom) w mapie kategorii Google.
category_l3

string

Kategoria produktów (3 poziom) w mapie kategorii Google.
category_l4

string

Kategoria produktów (4 poziom) w mapie kategorii Google.
category_l5

string

Kategoria produktów (poziom 5) w mapie kategorii Google.
product_type_l1

string

Typ produktu (poziom 1) w mapie kategorii produktów sprzedawcy.
product_type_l2

string

Typ produktu (poziom 2) w mapie kategorii produktów sprzedawcy.
product_type_l3

string

Typ produktu (poziom 3) w mapie kategorii produktów sprzedawcy.
product_type_l4

string

Typ produktu (poziom 4) w mapie kategorii produktów sprzedawcy.
product_type_l5

string

Typ produktu (poziom 5) w mapie kategorii produktów sprzedawcy.
condition

string

Stan produktu.
availability

string

Dostępność produktu.
shipping_label

string

Znormalizowana etykieta wysyłki określona w źródle danych.
item_group_id

string

Identyfikator grupy produktów podany przez sprzedawcę w celu pogrupowania wersji.
aggregated_reporting_context_status

AggregatedReportingContextStatus

Stan zbiorczy.
click_potential_rank

int64

Ranking produktu na podstawie jego potencjału kliknięć. Produkt z wartością click_potential_rank 1 ma największy potencjał kliknięcia spośród produktów sprzedawcy, które spełniają warunki zapytania wyszukiwania.

AggregatedReportingContextStatus

Stan produktu zagregowany dla wszystkich kontekstów raportowania.

Oto przykład obliczania zbiorczego stanu:

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 nie kwalifikuje się lub został odrzucony w przypadku wszystkich kontekstów raportowania.
PENDING Stan produktu jest oczekujący we wszystkich kontekstach raportowania.
ELIGIBLE_LIMITED Produkt jest dostępny w niektórych (ale nie we wszystkich) kontekstach raportowania.
ELIGIBLE Produkt kwalifikuje się do wszystkich kontekstów raportowania.

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 pomaga im określić skuteczność produktów w porównaniu z ich potencjałem.

Wartości w polu enum
CLICK_POTENTIAL_UNSPECIFIED Nieznany wpływ prognozowanej liczby kliknięć.
LOW Potencjał uzyskania niewielkiej liczby kliknięć w porównaniu z najlepiej sprzedającymi się produktami sprzedawcy.
MEDIUM potencjał uzyskania umiarkowanej 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;

ItemIssue

Problem z produktem.

Pola
type

ItemIssueType

Typ problemu dotyczącego produktu.
severity

ItemIssueSeverity

Poważność problemu z produktem.
resolution

ItemIssueResolution

Rozwiązanie problemu z elementem.

ItemIssueResolution

Jak rozwiązać problem.

Wartości w polu enum
ITEM_ISSUE_RESOLUTION_UNSPECIFIED Nie określono.
MERCHANT_ACTION Sprzedawca musi rozwiązać problem.
PENDING_PROCESSING Problem zostanie rozwiązany automatycznie (np. przez indeksowanie obrazu) lub w ramach weryfikacji Google. Obecnie sprzedawca nie musi nic robić. Rozwiązanie może spowodować pojawienie się innego problemu (np. nieudanego indeksowania).

ItemIssueSeverity

Jak problem wpływa na wyświetlanie produktu.

Pola
severity_per_reporting_context[]

IssueSeverityPerReportingContext

Waga problemu w kontekście raportowania.
aggregated_severity

AggregatedIssueSeverity

Łączna waga problemu w przypadku wszystkich kontekstów raportowania, których dotyczy.

Tego pola można używać do filtrowania wyników.

AggregatedIssueSeverity

Waga problemu zagregowana 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 jednym kontekście raportowania.
DEMOTED Problem obniża rangę produktu we wszystkich kontekstach raportowania, na które wpływa.
PENDING Rozwiązanie problemu: PENDING_PROCESSING.

IssueSeverityPerReportingContext

Waga problemu w kontekście raportowania.

Pola
disapproved_countries[]

string

Lista krajów, które nie zostały zatwierdzone w kontekście raportowania, w formacie ISO 3166.
demoted_countries[]

string

Lista krajów, które zostały zdegradowane w kontekście raportowania, w formacie ISO 3166.
reporting_context

ReportingContextEnum

Kontekst raportowania, którego dotyczy problem.

ItemIssueType

Typ problemu.

Pola
code

string

Kod błędu odpowiadający code w problemach z produktami.
canonical_attribute

string

Kanoniczna nazwa atrybutu dla problemów związanych z konkretnym atrybutem.

RelativeDemand

Ten typ nie ma pól.

Względny popyt na grupę produktów lub markę w raporcie o bestsellerach.

RelativeDemandEnum

Wartości względnego popytu.

Wartości w polu enum
RELATIVE_DEMAND_ENUM_UNSPECIFIED Nie określono.
VERY_LOW Popyt wynosi 0–5% popytu na najpopularniejsze grupy produktów lub marki.
LOW Popyt wynosi 6–10% popytu na najpopularniejszy produkt lub markę.
MEDIUM Popyt wynosi 11–20% popytu na najpopularniejsze grupy produktów lub marki.
HIGH Popyt wynosi 21–50% popytu na najpopularniejszy klaster produktów lub markę.
VERY_HIGH Popyt wynosi 51–100% popytu na najpopularniejsze grupy produktów lub marki.

RelativeDemandChangeType

Ten typ nie ma pól.

Względny popyt na grupę produktów lub markę w raporcie o bestsellerach w porównaniu z poprzednim okresem.

RelativeDemandChangeTypeEnum

Typy zmian 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 Wartość względnego popytu jest równa wartości z poprzedniego okresu.
RISER Względny popyt jest wyższy niż w poprzednim okresie.

ReportGranularity

Ten typ nie ma pól.

szczegółowość raportu o bestsellerach, Raporty o bestsellerach są obliczane w okresie tygodnia i miesiąca.

ReportGranularityEnum

Raportowanie wartości szczegółowych.

Wartości w polu enum
REPORT_GRANULARITY_ENUM_UNSPECIFIED Nie określono.
WEEKLY Raport jest obliczany w okresie tygodnia.
MONTHLY Raport jest obliczany na podstawie danych z okresu miesięcznego.

ReportRow

Wynikowy wiersz zwrócony przez zapytanie wyszukiwania.

W odpowiedzi jest wypełniane tylko wiadomość odpowiadająca zapytanej tabeli. W wypełnionej wiadomości wypełniane są tylko pola wyraźnie określone w zapytaniu.

Pola
product_performance_view

ProductPerformanceView

Pola dostępne do zapytań w tabeli product_performance_view.
non_product_performance_view

NonProductPerformanceView

Pola dostępne do zapytań w tabeli non_product_performance_view.
product_view

ProductView

Pola dostępne do zapytań w tabeli product_view.
price_competitiveness_product_view

PriceCompetitivenessProductView

Pola dostępne do zapytań w tabeli price_competitiveness_product_view.
price_insights_product_view

PriceInsightsProductView

Pola dostępne do zapytań w tabeli price_insights_product_view.
best_sellers_product_cluster_view

BestSellersProductClusterView

Pola dostępne do zapytań w tabeli best_sellers_product_cluster_view.
best_sellers_brand_view

BestSellersBrandView

Pola dostępne do zapytań w tabeli best_sellers_brand_view.
competitive_visibility_competitor_view

CompetitiveVisibilityCompetitorView

Pola dostępne do zapytań w tabeli competitive_visibility_competitor_view.
competitive_visibility_top_merchant_view

CompetitiveVisibilityTopMerchantView

Pola dostępne do zapytań w tabeli competitive_visibility_top_merchant_view.
competitive_visibility_benchmark_view

CompetitiveVisibilityBenchmarkView

Pola dostępne do zapytań w tabeli competitive_visibility_benchmark_view.

SearchRequest

Żądanie wiadomości dla metody ReportService.Search.

Pola
parent

string

Wymagane. Identyfikator konta nawiązującego połączenie. Musi to być samodzielne konto lub subkonto MCA. Format: accounts/{account}
query

string

Wymagane. Zapytanie określające raport do pobrania.

Szczegółowe informacje o składaniu zapytań znajdziesz w przewodniku po języku zapytań. Pełną listę dostępnych tabel i pol znajdziesz w sekcji Dostępne pola.
page_size

int32

Opcjonalnie: Liczba ReportRows do pobrania na jednej stronie. Domyślna wartość to 1000. Wartości powyżej 5000 są przymusowo ustawiane na 5000.
page_token

string

Opcjonalnie: Token strony do pobrania. Jeśli nie określisz tej wartości, zwrócona zostanie pierwsza strona wyników. Aby zażądać następnej strony wyników, należy użyć wartości uzyskanej z next_page_token w poprzedniej odpowiedzi.

SearchResponse

wiadomość z odpowiedzią dla metody ReportService.Search.

Pola
results[]

ReportRow

Wiersze pasujące do zapytania.
next_page_token

string

Token, który można wysłać jako page_token, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

TrafficSource

Ten typ nie ma pól.

Źródło wizyty, z którego pochodzą wyświetlenia w raporcie Widoczność na tle konkurencji.

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 bezpłatny i z reklam.