Package google.shopping.merchant.reports.v1beta

Indeks

ReportService

Usługa do pobierania raportów i statystyk dotyczących Twoich produktów, ich skuteczności i konkurencyjnego środowiska w Google.

Wyszukiwarka

rpc Search(SearchRequest) returns (SearchResponse)

Pobiera raport zdefiniowany przez zapytanie. Odpowiedź może zawierać mniej wierszy niż określono w polu page_size. Decyduj na podstawie danych z kolumny next_page_token, czy możesz poprosić o więcej wierszy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.

BestSellersBrandView

Pola dostępne dla zapytania w tabeli best_sellers_brand_view.

Raport o bestsellerach z najpopularniejszymi markami.

Wartości są ustawiane tylko dla pól, które zostały wyraźnie wskazane w zapytaniu w żądaniu.

Pola
report_date

Date

Data raportu. Wartości w tym polu mogą 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 zostanie określony warunek WHERE (report_date), zostanie zwrócony najnowszy dostępny raport tygodniowy lub miesięczny.
report_granularity

ReportGranularityEnum

Szczegółowość raportu. Tworzenie rankingu może zająć tydzień lub miesiąc.

Wymagane w klauzuli SELECT. Warunek dotyczący elementu report_granularity jest wymagany w klauzuli WHERE.
report_country_code

string

Kraj, w którym obliczana jest pozycja w rankingu. Przedstawiona w formacie ISO 3166.

Wymagane w klauzuli SELECT. Warunek dotyczący elementu report_country_code jest wymagany w klauzuli WHERE.
report_category_id

int64

Identyfikator kategorii produktów Google, dla której ma zostać obliczony ranking, umieszczony w mapie kategorii Google.

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

string

Nazwa marki.
rank

int64

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

int64

Pozycja wg popularności w poprzednim tygodniu lub miesiącu.
relative_demand

RelativeDemandEnum

Szacowany popyt w porównaniu z najpopularniejszą marką w tej samej kategorii i tym samym kraju.
previous_relative_demand

RelativeDemandEnum

Szacowany popyt w porównaniu z marką o największej popularności w tej samej kategorii i tym samym kraju w poprzednim tygodniu lub miesiącu.
relative_demand_change

RelativeDemandChangeTypeEnum

Zmiana szacunkowego zapotrzebowania. Czy wzrosła, utknęła czy pozostała płaska.

BestSellersProductClusterView

Pola dostępne dla zapytania w tabeli best_sellers_product_cluster_view.

Raport o bestsellerach z najpopularniejszymi grupami produktów. Klaster produktów to grupa różnych ofert i wersji, które dotyczą tego samego produktu, np. Google Pixel 7.

Wartości są ustawiane tylko dla pól, które zostały wyraźnie wskazane w zapytaniu w żądaniu.

Pola
report_date

Date

Data raportu. Wartości w tym polu mogą 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 zostanie określony warunek WHERE (report_date), zostanie zwrócony najnowszy dostępny raport tygodniowy lub miesięczny.
variant_gtins[]

string

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

ReportGranularityEnum

Szczegółowość raportu. Tworzenie rankingu może zająć tydzień lub miesiąc.

Wymagane w klauzuli SELECT. Warunek dotyczący elementu report_granularity jest wymagany w klauzuli WHERE.
report_country_code

string

Kraj, w którym obliczana jest pozycja w rankingu. Przedstawiona w formacie ISO 3166.

Wymagane w klauzuli SELECT. Warunek dotyczący elementu report_country_code jest wymagany w klauzuli WHERE.
report_category_id

int64

Identyfikator kategorii produktów Google, dla której ma zostać obliczony ranking, umieszczony w mapie kategorii Google.

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

string

Nazwa klastra produktów.
brand

string

Marka klastra produktów.
category_l1

string

Kategoria produktów (pierwszy poziom) klastra produktów przedstawiona w mapie kategorii Google.
category_l2

string

Kategoria produktów (drugi poziom) klastra produktów przedstawiona w mapie kategorii Google.
category_l3

string

Kategoria produktów (trzeci poziom) klastra produktów przedstawiona w mapie kategorii Google.
category_l4

string

Kategoria produktów (czwarty poziom) klastra produktów przedstawiona w mapie kategorii Google.
category_l5

string

Kategoria produktów (piąty poziom) klastra produktów reprezentowana w mapie kategorii Google.
inventory_status

InventoryStatus

Niezależnie od tego, czy klaster produktów to 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 czy w ogóle NOT_IN_INVENTORY.

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

InventoryStatus

Niezależnie od tego, czy w źródle danych o produktach w co najmniej jednym kraju znajduje się co najmniej jeden produkt tej marki, który obecnie jest IN_STOCK, wszystkie produkty mają w źródle danych o produktach wartość „OUT_OF_STOCK”, czyli „NOT_IN_INVENTORY”.

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

int64

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

int64

Pozycja wg popularności w poprzednim tygodniu lub miesiącu.
relative_demand

RelativeDemandEnum

Szacowane zapotrzebowanie w porównaniu do grupy produktów o największej popularności w tej samej kategorii i w tym samym kraju.
previous_relative_demand

RelativeDemandEnum

Szacowane zapotrzebowanie w porównaniu z grupą produktów o najwyższej pozycji w rankingu popularności w tej samej kategorii i tym samym kraju w poprzednim tygodniu lub miesiącu.
relative_demand_change

RelativeDemandChangeTypeEnum

Zmiana szacunkowego zapotrzebowania. Czy wzrosła, utknęła czy pozostała płaska.

InventoryStatus

Stan grupy produktów lub marki w asortymencie.

Wartości w polu enum
INVENTORY_STATUS_UNSPECIFIED Nie określono.
IN_STOCK Masz produkt dla tej grupy produktów lub tej marki w magazynie.
OUT_OF_STOCK Masz w asortymencie produkt dla tej marki lub tego klastra produktów, ale jest on obecnie niedostępny.
NOT_IN_INVENTORY Nie masz produktu dla tego klastra produktów lub tej marki w asortymencie.

CompetitiveVisibilityBenchmarkView

Pola dostępne dla zapytania w tabeli competitive_visibility_benchmark_view.

Widoczność na tle konkurencji z wartością porównawczą kategorii.

Wartości są ustawiane tylko dla pól, które zostały wyraźnie wskazane w zapytaniu w żądaniu.

Pola
date

Date

Data w tym wierszu.

Wymagane w klauzuli SELECT. W klauzuli WHERE wymagany jest warunek dotyczący date.
report_country_code

string

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

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

int64

Identyfikator kategorii produktów Google, dla którego ma zostać wygenerowany raport, przedstawiony w mapie kategorii Google.

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

TrafficSourceEnum

Źródło wizyt dla wyświetleń.

Wymagane w klauzuli SELECT.
your_domain_visibility_trend

double

Zmiana widoczności na podstawie wyświetleń w Twojej domenie względem początku wybranego zakresu czasowego (lub pierwszego dnia z liczbą wyświetleń większą niż zero).

Nie można filtrować według klauzuli „WHERE”.
category_benchmark_visibility_trend

double

Zmiana widoczności na podstawie liczby wyświetleń względem początku wybranego zakresu czasowego (lub pierwszego dnia z liczbą wyświetleń większą niż zero) dla połączonej grupy sprzedawców o największej widoczności w pobliżu rynku.

Nie można filtrować według klauzuli „WHERE”.

CompetitiveVisibilityCompetitorView

Pola dostępne dla zapytania w tabeli competitive_visibility_competitor_view.

Widoczność na tle konkurencji w przypadku firm o podobnej widoczności.

Wartości są ustawiane tylko dla pól, które zostały wyraźnie wskazane w zapytaniu w żądaniu.

Pola
date

Date

Data w tym wierszu.

W klauzuli WHERE wymagany jest warunek dotyczący date.
domain

string

Domena konkurenta lub Twojej domeny, jeśli parametr „is_your_domain” to prawda.

Wymagane w klauzuli SELECT. Nie można filtrować według klauzuli „WHERE”.
is_your_domain

bool

Prawda, jeśli ten wiersz zawiera dane dla Twojej domeny.

Nie można filtrować według 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 dotyczący report_country_code.
report_category_id

int64

Identyfikator kategorii produktów Google, dla którego ma zostać wygenerowany raport, przedstawiony w mapie kategorii Google.

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

TrafficSourceEnum

Źródło wizyt dla wyświetleń.

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ń. 1 to najwyższa wartość.

Nie można filtrować według klauzuli „WHERE”.
ads_organic_ratio

double

Współczynnik reklam / bezpłatnych wyników wyszukiwania pokazuje, jak często w domenie są wyświetlane reklamy produktowe w porównaniu z ruchem bezpłatnym. Liczba jest zaokrąglona i dojęta do zasobnika.

Nie można filtrować według klauzuli „WHERE”.
page_overlap_rate

double

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 klauzuli „WHERE”.
higher_position_rate

double

Współczynnik wyższej pozycji pokazuje, jak często oferta konkurencyjnej firmy wyświetlała się na stronie wyżej niż Twoja oferta.

Nie można filtrować według klauzuli „WHERE”.
relative_visibility

double

Widoczność względna pokazuje, jak często oferty Twoich konkurentów są wyświetlane w porównaniu z Twoimi ofertami. Inaczej mówiąc, jest to liczba wyświetleń reklam konkurencyjnych sprzedawców podzielona przez liczbę Twoich wyświetleń w wybranym przedziale czasu w przypadku wybranej kategorii produktów i kraju.

Nie można filtrować według klauzuli „WHERE”.

CompetitiveVisibilityTopMerchantView

Pola dostępne dla zapytania w tabeli competitive_visibility_top_merchant_view.

Raport o widoczności na tle konkurencji obejmujący firmy o największej widoczności.

Wartości są ustawiane tylko dla pól, które zostały wyraźnie wskazane w zapytaniu w żądaniu.

Pola
date

Date

Data w tym wierszu.

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

string

Domena konkurenta lub Twojej domeny, jeśli parametr „is_your_domain” to prawda.

Wymagane w klauzuli SELECT. Nie można filtrować według klauzuli „WHERE”.
is_your_domain

bool

Prawda, jeśli ten wiersz zawiera dane dla Twojej domeny.

Nie można filtrować według 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 dotyczący report_country_code.
report_category_id

int64

Identyfikator kategorii produktów Google, dla którego ma zostać wygenerowany raport, przedstawiony w mapie kategorii Google.

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

TrafficSourceEnum

Źródło wizyt dla wyświetleń.

Wymagane w klauzuli SELECT.
rank

int64

Pozycja domeny w rankingu najlepszych sprzedawców dla wybranych kluczy (date, report_category_id, report_country_code, traffic_source) na podstawie wyświetleń. 1 to najwyższa wartość.

Nie można filtrować według klauzuli „WHERE”.
ads_organic_ratio

double

Współczynnik reklam / bezpłatnych wyników wyszukiwania pokazuje, jak często w domenie są wyświetlane reklamy produktowe w porównaniu z ruchem bezpłatnym. Liczba jest zaokrąglona i dojęta do zasobnika.

Nie można filtrować według klauzuli „WHERE”.
page_overlap_rate

double

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 klauzuli „WHERE”.
higher_position_rate

double

Współczynnik wyższej pozycji pokazuje, jak często oferta konkurencyjnej firmy wyświetlała się na stronie wyżej niż Twoja oferta.

Nie można filtrować według klauzuli „WHERE”.

MarketingMethod

Ten typ nie ma żadnych pól.

Metoda marketingowa używana do promowania Twoich produktów w Google (bezpłatnie lub z reklamami).

MarketingMethodEnum

Wartości metod marketingowych.

Wartości w polu enum
MARKETING_METHOD_ENUM_UNSPECIFIED Nie określono.
ORGANIC Bezpłatne wyniki marketingowe.
ADS Marketing oparty na reklamach.

NonProductPerformanceView

Pola dostępne dla zapytania w tabeli non_product_performance_view.

Dane o skuteczności dotyczące zdjęć i linków do sklepów internetowych prowadzących 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ą podzielone na segmenty (np. date).

Pola segmentów nie można wybierać w zapytaniach bez wybrania co najmniej 1 pola danych.

Wartości są ustawiane tylko dla pól, które zostały wyraźnie wskazane w zapytaniu w żądaniu.

Pola
date

Date

Data w strefie czasowej sprzedawcy, do której mają zastosowanie dane. Segmentowanie.

Warunek dotyczący elementu date jest wymagany w klauzuli WHERE.
week

Date

Pierwszy dzień tygodnia (poniedziałek) od daty rozpoczęcia analizy danych w strefie czasowej sprzedawcy. Segmentowanie.
clicks

int64

Liczba kliknięć obrazów i linków do sklepów internetowych prowadzących do stron niedotyczących produktów. Dane.
impressions

int64

Liczba wyświetleń obrazów i linków do sklepów internetowych prowadzących do stron niedotyczących produktów. Dane.
click_through_rate

double

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

PriceCompetitivenessProductView

Pola dostępne dla zapytania w tabeli price_competitiveness_product_view.

Raport o konkurencyjności cenowej.

Wartości są ustawiane tylko dla pól, które zostały wyraźnie wskazane w zapytaniu w żądaniu.

Pola
price

Price

Aktualna cena produktu.
benchmark_price

Price

Najnowsza dostępna porównanie cen z katalogu produktów w kraju objętym testem.
report_country_code

string

Kraj ceny referencyjnej. Przedstawiona w formacie ISO 3166.

Wymagane w klauzuli SELECT.
id

string

Identyfikator REST produktu w formacie channel~languageCode~feedLabel~offerId. Za jej pomocą można złączać dane z tabelą product_view.

Wymagane w klauzuli SELECT.
offer_id

string

Identyfikator produktu podany przez sprzedawcę.
title

string

Nazwa produktu.
brand

string

Marka produktu.
category_l1

string

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

string

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

string

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

string

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

string

Kategoria produktów (piąty poziom) w mapie kategorii Google.
product_type_l1

string

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

string

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

string

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

string

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

string

Typ produktu (poziom 5) w mapie kategorii sprzedawcy.

PriceInsightsProductView

Pola dostępne dla zapytania w tabeli price_insights_product_view.

Statystyki dotyczące cen

Wartości są ustawiane tylko dla pól, które zostały wyraźnie wskazane w zapytaniu w żądaniu.

Pola
price

Price

Aktualna cena produktu.
suggested_price

Price

Najnowsza sugerowana cena produktu.
effectiveness

Effectiveness

Prognozowana skuteczność zastosowania sugerowanej ceny w grupie.
id

string

Identyfikator REST produktu w formacie channel~languageCode~feedLabel~offerId. Za jej pomocą można złączać dane z tabelą product_view.

Wymagane w klauzuli SELECT.
offer_id

string

Identyfikator produktu podany przez sprzedawcę.
title

string

Nazwa produktu.
brand

string

Marka produktu.
category_l1

string

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

string

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

string

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

string

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

string

Kategoria produktów (piąty poziom) w mapie kategorii Google.
product_type_l1

string

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

string

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

string

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

string

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

string

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

double

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%.
predicted_clicks_change_fraction

double

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%.
predicted_conversions_change_fraction

double

Prognozowana zmiana liczby konwersji jako ułamek po wprowadzeniu sugerowanej ceny w porównaniu z aktualną ceną aktywną. Na przykład 0, 05 to przewidywany wzrost liczby konwersji o 5%).

Skuteczność

Zasobnik prognozowanej skuteczności.

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ą. Przewidujemy, ż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 Skuteczność jest wysoka.

ProductPerformanceView

Pola dostępne dla zapytania w tabeli product_performance_view.

Dane dotyczące 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ą podzielone na segmenty (np. offer_id). Wartości wymiarów produktów, np. offer_id, odzwierciedlają stan produktu w momencie wyświetlenia.

Pola segmentów nie można wybierać w zapytaniach bez wybrania co najmniej 1 pola danych.

Wartości są ustawiane tylko dla pól, które zostały wyraźnie wskazane w zapytaniu w żądaniu.

Pola
date

Date

Data w strefie czasowej sprzedawcy, do której mają zastosowanie dane. Segmentowanie.

Warunek dotyczący elementu date jest wymagany w klauzuli WHERE.
week

Date

Pierwszy dzień tygodnia (poniedziałek) od daty rozpoczęcia analizy danych w strefie czasowej sprzedawcy. Segmentowanie.
conversion_value

Price

Wartość konwersji przypisanych do produktu rejestrowana w dniu konwersji. Dane.

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

MarketingMethodEnum

Metoda marketingowa, do której mają zastosowanie dane. Segmentowanie.
customer_country_code

string

Kod kraju, w którym znajduje się klient w momencie wystąpienia zdarzenia. Przedstawiona 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

Nazwa produktu. Segmentowanie.
brand

string

Marka produktu. Segmentowanie.
category_l1

string

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

string

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

string

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

string

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

string

Kategoria produktów (piąty poziom) w mapie kategorii Google. Segmentowanie.
product_type_l1

string

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

string

Typ produktu (poziom 2) w mapie kategorii 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 mapie kategorii 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ę wyświetleń produktów. Dane.
conversions

double

Liczba konwersji przypisanych do produktu zarejestrowanych w dniu konwersji. W zależności od modelu atrybucji konwersja może być rozdzielona na wiele kliknięć, przy czym do każdego kliknięcia jest przypisany własny udział. Ten wskaźnik stanowi sumę wszystkich takich środków. Dane.

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

double

Liczba konwersji podzielona przez liczbę kliknięć odnotowaną w dniu wyświetlenia. Dane.

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

ProductView

Pola dostępne dla zapytania w tabeli product_view.

Produkty w obecnym asortymencie. Produkty w tej tabeli są takie same jak w podrzędnym interfejsie API produktów, ale nie wszystkie atrybuty produktów z tego interfejsu są dostępne do zapytań w tej tabeli. W przeciwieństwie do Podrzędnego interfejsu API produktów ta tabela umożliwia filtrowanie zwróconej listy produktów według atrybutów produktów. Aby pobrać jeden produkt według atrybutu id lub wyświetlić listę wszystkich produktów, należy użyć podrzędnego interfejsu API Produkty.

Wartości są ustawiane tylko dla pól, które zostały wyraźnie wskazane w zapytaniu w żądaniu.

Pola
price

Price

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

string

Lista Globalnych Numerów Jednostki Handlowej (GTIN) produktu.
creation_time

Timestamp

Czas utworzenia produktu przez sprzedawcę w sygnaturze czasowej (w sekundach).
expiration_date

Date

Data ważności produktu określona przy wstawieniu.
item_issues[]

ItemIssue

Lista problemów związanych z produktem.

Tego pola nie można używać 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

Szacunkowy potencjał skuteczności w porównaniu z najlepiej sprzedającymi się produktami sprzedawcy.
id

string

Identyfikator REST produktu w formacie channel~languageCode~feedLabel~offerId. Metody interfejsu API sprzedawcy, które operują na produktach, przyjmują ten parametr jako parametr name.

Wymagane w klauzuli SELECT.
channel

ChannelEnum

Kanał produktu. Może mieć wartość 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

Nazwa produktu.
brand

string

Marka produktu.
category_l1

string

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

string

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

string

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

string

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

string

Kategoria produktów (piąty poziom) w mapie kategorii Google.
product_type_l1

string

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

string

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

string

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

string

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

string

Typ produktu (poziom 5) w mapie kategorii 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ę na potrzeby grupowania wersji.
aggregated_reporting_context_status

AggregatedReportingContextStatus

Stan zbiorczy.
click_potential_rank

int64

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

AggregatedReportingContextStatus

Zbiorcze informacje o stanie produktu na potrzeby wszystkich kontekstów raportowania.

Oto przykład obliczania stanu zagregowanego:

Bezpłatne informacje Reklamy produktowe Stan
Zatwierdzono Zatwierdzono ODPOWIEDNIA
Zatwierdzono Oczekuje ODPOWIEDNIA
Zatwierdzono Odrzucone ELIGIBLE_LIMITED
Oczekuje Oczekuje OCZEKUJĄCE
Odrzucone Odrzucone NOT_ELIGIBLE_OR_DISAPPROVED
Wartości w polu enum
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED Nie określono.
NOT_ELIGIBLE_OR_DISAPPROVED Usługa nie kwalifikuje się do wyświetlania lub została odrzucona we wszystkich kontekstach raportowania.
PENDING Produkt ma stan „oczekujący” we wszystkich kontekstach raportowania.
ELIGIBLE_LIMITED Usługa może być używana w niektórych (ale nie wszystkich) kontekstach raportowania.
ELIGIBLE Usługa może być używana we wszystkich kontekstach 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 warto naprawić, i pomaga określić 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 niewielkiej 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.

ItemIssue

Problem związany z produktem.

Pola
type

ItemIssueType

Typ problemu dotyczącego produktu.
severity

ItemIssueSeverity

Poziom ważności problemu dotyczącego produktu.
resolution

ItemIssueResolution

Rozwiązanie problemu z produktem.

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. w wyniku indeksowania zdjęcia) lub w trakcie sprawdzania w Google. W tej chwili sprzedawca nie musi nic robić. Rozwiązanie może spowodować inny problem (na przykład jeśli indeksowanie się nie powiedzie).

ItemIssueSeverity

Jak problem wpływa na wyświetlanie produktu.

Pola
severity_per_reporting_context[]

IssueSeverityPerReportingContext

Waga problemu według kontekstu raportowania.
aggregated_severity

AggregatedIssueSeverity

Łączna waga problemu we wszystkich kontekstach raportowania, w których on występuje.

To pole może służyć do filtrowania wyników.

AggregatedIssueSeverity

Zbiorcza waga problemu 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 przesuwa usługę w dół we wszystkich kontekstach raportowania, których dotyczy.
PENDING Rozwiązanie problemu: PENDING_PROCESSING.

IssueSeverityPerReportingContext

Waga problemu według kontekstu raportowania.

Pola
disapproved_countries[]

string

Lista odrzuconych krajów w kontekście raportowania, przedstawiona w formacie ISO 3166.
demoted_countries[]

string

Lista krajów o degradacji w kontekście raportowania przedstawiona w formacie ISO 3166.
reporting_context

ReportingContextEnum

Kontekst raportowania, którego dotyczy problem.

ItemIssueType

Typ problemu.

Pola
code

string

Kod błędu problemu – odpowiednik code sekcji Problemy z produktem.
canonical_attribute

string

Kanoniczna nazwa atrybutu w przypadku problemów związanych z atrybutami.

RelativeDemand

Ten typ nie ma żadnych pól.

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

RelativeDemandEnum

Względne wartości popytu.

Wartości w polu enum
RELATIVE_DEMAND_ENUM_UNSPECIFIED Nie określono.
VERY_LOW Popyt stanowi 0–5% popytu na najpopularniejszą grupę produktów lub markę.
LOW Popyt to 6–10% popytu na najpopularniejszą grupę produktów lub markę.
MEDIUM Popyt to 11–20% popytu na najpopularniejszą grupę produktów lub markę.
HIGH Popyt to 21–50% popytu na najpopularniejszą grupę produktów lub markę.
VERY_HIGH Popyt to 51–100% popytu na najpopularniejszą grupę produktów lub markę.

RelativeDemandChangeType

Ten typ nie ma żadnych pól.

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

RelativeDemandChangeTypeEnum

Wartości typu względnej zmiany 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 taki sam jak poprzedni okres.
RISER Względny popyt jest wyższy niż w poprzednim okresie.

ReportGranularity

Ten typ nie ma żadnych pól.

Szczegółowość raportu o bestsellerach Raporty o bestsellerach uwzględniają okres obejmujący tydzień i miesiąc.

ReportGranularityEnum

Wartości szczegółowości raportu.

Wartości w polu enum
REPORT_GRANULARITY_ENUM_UNSPECIFIED Nie określono.
WEEKLY Raport jest generowany w okresie tygodniowym.
MONTHLY Raport jest generowany na okres miesięczny.

ReportRow

Wiersz wyników zwrócony przez zapytanie.

W odpowiedzi zostanie wypełniony tylko komunikat odpowiadający tabeli, której dotyczy zapytanie. W wypełnionej wiadomości wypełniane są tylko pola wyraźnie wskazane w zapytaniu.

Pola
product_performance_view

ProductPerformanceView

Pola dostępne dla zapytania w tabeli product_performance_view.
non_product_performance_view

NonProductPerformanceView

Pola dostępne dla zapytania w tabeli non_product_performance_view.
product_view

ProductView

Pola dostępne dla zapytania w tabeli product_view.
price_competitiveness_product_view

PriceCompetitivenessProductView

Pola dostępne dla zapytania w tabeli price_competitiveness_product_view.
price_insights_product_view

PriceInsightsProductView

Pola dostępne dla zapytania w tabeli price_insights_product_view.
best_sellers_product_cluster_view

BestSellersProductClusterView

Pola dostępne dla zapytania w tabeli best_sellers_product_cluster_view.
best_sellers_brand_view

BestSellersBrandView

Pola dostępne dla zapytania w tabeli best_sellers_brand_view.
competitive_visibility_competitor_view

CompetitiveVisibilityCompetitorView

Pola dostępne dla zapytania w tabeli competitive_visibility_competitor_view.
competitive_visibility_top_merchant_view

CompetitiveVisibilityTopMerchantView

Pola dostępne dla zapytania w tabeli competitive_visibility_top_merchant_view.
competitive_visibility_benchmark_view

CompetitiveVisibilityBenchmarkView

Pola dostępne dla zapytania w tabeli competitive_visibility_benchmark_view.

SearchRequest

Prośba o wiadomość dla metody ReportService.Search.

Pola
parent

string

Wymagane. Identyfikator konta, z którego nawiązano połączenie. Musi to być samodzielne konto lub subkonto MCA. Format: accounts/{konto}
query

string

Wymagane. Zapytanie, które określa raport do pobrania.

Szczegółowe informacje na temat tworzenia zapytań można znaleźć w przewodniku po języku zapytań. Pełną listę dostępnych tabel i pól znajdziesz w sekcji Dostępne pola.
page_size

int32

Opcjonalnie. Liczba elementów ReportRows do pobrania na jednej stronie. Domyślna wartość to 1000. Wartości powyżej 5000 zostają przekształcone na 5000.
page_token

string

Opcjonalnie. Token strony do pobrania. Jeśli nie podasz żadnej wartości, wyświetlana będzie pierwsza strona wyników. Aby zażądać następnej strony wyników, należy użyć wartości uzyskanej z funkcji 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 go pominiesz, nie będzie dalszych stron.

TrafficSource

Ten typ nie ma żadnych pól.

Źródło wizyt wyświetleń 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 z bezpłatnych wyników wyszukiwania i ruchu z reklam.