Method: accounts.reports.search

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

string

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

string

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

integer

Opcjonalnie. Liczba elementów typu ReportRows do pobrania na jednej stronie. Domyślna wartość to 1000. Wartości powyżej 5000 są zmieniane na 5000.

pageToken

string

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 nextPageToken w poprzedniej odpowiedzi.

Treść odpowiedzi

Komunikat odpowiedzi dla metody ReportService.Search.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "results": [
    {
      object (ReportRow)
    }
  ],
  "nextPageToken": string
}
Pola
results[]

object (ReportRow)

Wiersze pasujące do zapytania.

nextPageToken

string

Token, który może zostać wysłany jako pageToken w celu pobrania następnej strony. Jeśli nazwa zostanie pominięta, nie będzie kolejnych stron.

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 (ProductPerformanceView)
  },
  "nonProductPerformanceView": {
    object (NonProductPerformanceView)
  },
  "productView": {
    object (ProductView)
  },
  "priceCompetitivenessProductView": {
    object (PriceCompetitivenessProductView)
  },
  "priceInsightsProductView": {
    object (PriceInsightsProductView)
  },
  "bestSellersProductClusterView": {
    object (BestSellersProductClusterView)
  },
  "bestSellersBrandView": {
    object (BestSellersBrandView)
  },
  "competitiveVisibilityCompetitorView": {
    object (CompetitiveVisibilityCompetitorView)
  },
  "competitiveVisibilityTopMerchantView": {
    object (CompetitiveVisibilityTopMerchantView)
  },
  "competitiveVisibilityBenchmarkView": {
    object (CompetitiveVisibilityBenchmarkView)
  }
}
Pola
productPerformanceView

object (ProductPerformanceView)

Pola dostępne na potrzeby zapytań w tabeli productPerformanceView.

nonProductPerformanceView

object (NonProductPerformanceView)

Pola dostępne na potrzeby zapytań w tabeli nonProductPerformanceView.

productView

object (ProductView)

Pola dostępne na potrzeby zapytań w tabeli productView.

priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

Pola dostępne na potrzeby zapytań w tabeli priceCompetitivenessProductView.

priceInsightsProductView

object (PriceInsightsProductView)

Pola dostępne na potrzeby zapytań w tabeli priceInsightsProductView.

bestSellersProductClusterView

object (BestSellersProductClusterView)

Pola dostępne na potrzeby zapytań w tabeli bestSellersProductClusterView.

bestSellersBrandView

object (BestSellersBrandView)

Pola dostępne na potrzeby zapytań w tabeli bestSellersBrandView.

competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

Pola dostępne na potrzeby zapytań w tabeli competitiveVisibilityCompetitorView.

competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

Pola dostępne na potrzeby zapytań w tabeli competitiveVisibilityTopMerchantView.

competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

Pola dostępne na potrzeby zapytań w tabeli competitiveVisibilityBenchmarkView.

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, zgodnie z którymi dane o skuteczności są podzielone na segmenty (np. offerId). Wartości wymiarów produktów, np. offerId, odzwierciedlają stan produktu w chwili 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 (Date)
  },
  "week": {
    object (Date)
  },
  "conversionValue": {
    object (Price)
  },
  "marketingMethod": enum (MarketingMethodEnum),
  "customerCountryCode": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number,
  "conversions": number,
  "conversionRate": number
}
Pola
date

object (Date)

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

W klauzuli WHERE wymagany jest warunek dotyczący date.

week

object (Date)

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

conversionValue

object (Price)

Wartość konwersji przypisanych do produktu, raportowana w dniu konwersji. Dane.

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

marketingMethod

enum (MarketingMethodEnum)

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

customerCountryCode

string

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, zwracany jest specjalny kod „ZZ”.

offerId

string

Identyfikator produktu podany przez sprzedawcę. Segmentowanie.

title

string

Tytuł produktu. Segmentowanie.

brand

string

Marka produktu. Segmentowanie.

categoryL1

string

Kategoria produktu (poziom 1) w mapie kategorii Google. Segmentowanie.

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

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

productTypeL2

string

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

productTypeL3

string

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

productTypeL4

string

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

productTypeL5

string

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

customLabel0

string

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

customLabel1

string

Etykieta własna 1 na potrzeby niestandardowego grupowania produktów. Segmentowanie.

customLabel2

string

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

customLabel3

string

Etykieta własna 3 na potrzeby niestandardowego grupowania produktów. Segmentowanie.

customLabel4

string

Etykieta własna 4 na potrzeby niestandardowego grupowania produktów. Segmentowanie.

clicks

string (int64 format)

Liczba kliknięć. Dane.

impressions

string (int64 format)

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

clickThroughRate

number

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

conversions

number

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 FREE.

conversionRate

number

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

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

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ą podzielone na segmenty (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 (Date)
  },
  "week": {
    object (Date)
  },
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number
}
Pola
date

object (Date)

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

W klauzuli WHERE wymagany jest warunek dotyczący date.

week

object (Date)

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

clicks

string (int64 format)

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

impressions

string (int64 format)

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

clickThroughRate

number

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

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 (Price)
  },
  "gtin": [
    string
  ],
  "creationTime": string,
  "expirationDate": {
    object (Date)
  },
  "itemIssues": [
    {
      object (ItemIssue)
    }
  ],
  "clickPotential": enum (ClickPotential),
  "id": string,
  "channel": enum (ChannelEnum),
  "languageCode": string,
  "feedLabel": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "condition": string,
  "availability": string,
  "shippingLabel": string,
  "itemGroupId": string,
  "thumbnailLink": string,
  "aggregatedReportingContextStatus": enum (AggregatedReportingContextStatus),
  "clickPotentialRank": string
}
Pola
price

object (Price)

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

gtin[]

string

Lista globalnych numerów jednostki handlowej (GTIN) produktu.

creationTime

string (Timestamp format)

Czas utworzenia produktu przez sprzedawcę podany w sygnaturze czasowej (sekundy).

expirationDate

object (Date)

Data ważności produktu podana po przesłaniu.

itemIssues[]

object (ItemIssue)

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. itemIssues.severity.aggregated_severity).

clickPotential

enum (ClickPotential)

Szacowany 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 dla sprzedawców, które działają na produktach, przyjmują ten parametr jako parametr name.

Wymagane w klauzuli SELECT.

channel

enum (ChannelEnum)

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

languageCode

string

Kod języka produktu w formacie BCP 47.

feedLabel

string

Etykieta pliku danych produktu.

offerId

string

Identyfikator produktu podany przez sprzedawcę.

title

string

Tytuł produktu.

brand

string

Marka produktu.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

Typ produktu (poziom 1) w mapie kategorii sprzedawcy.

productTypeL2

string

Typ produktu (poziom 2) w mapie kategorii sprzedawcy.

productTypeL3

string

Typ produktu (poziom 3) w mapie kategorii sprzedawcy.

productTypeL4

string

Typ produktu (poziom 4) w mapie kategorii sprzedawcy.

productTypeL5

string

Typ produktu (poziom 5) w mapie kategorii sprzedawcy.

condition

string

Stan produktu.

availability

string

Dostępność produktu.

shippingLabel

string

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

itemGroupId

string

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

aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

Stan zagregowany.

clickPotentialRank

string (int64 format)

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

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 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 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 (ItemIssueType)
  },
  "severity": {
    object (ItemIssueSeverity)
  },
  "resolution": enum (ItemIssueResolution)
}
Pola
type

object (ItemIssueType)

Typ problemu dotyczącego produktu.

severity

object (ItemIssueSeverity)

Waga problemu dotyczącego produktu.

resolution

enum (ItemIssueResolution)

Rozwiązanie problemu dotyczącego produktu.

ItemIssueType

Typ problemu.

Zapis JSON
{
  "code": string,
  "canonicalAttribute": string
}
Pola
code

string

Kod błędu problemu równoważny z kodem błędu code w sekcji Problemy z usługą.

canonicalAttribute

string

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

ItemIssueSeverity

Jak problem wpływa na wyświetlanie produktu.

Zapis JSON
{
  "severityPerReportingContext": [
    {
      object (IssueSeverityPerReportingContext)
    }
  ],
  "aggregatedSeverity": enum (AggregatedIssueSeverity)
}
Pola
severityPerReportingContext[]

object (IssueSeverityPerReportingContext)

Waga problemu według kontekstu raportowania.

aggregatedSeverity

enum (AggregatedIssueSeverity)

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 (ReportingContextEnum)
}
Pola
disapprovedCountries[]

string

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

demotedCountries[]

string

Lista krajów z obniżoną pozycją w kontekście raportowania przedstawiona w formacie ISO 3166.

reportingContext

enum (ReportingContextEnum)

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 określić, jaka jest 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.

Konkurencyjność cenowa.

Wartości są ustawiane tylko dla pól, które zostały bezpośrednio zażądane w zapytaniu żądania.

Zapis JSON
{
  "price": {
    object (Price)
  },
  "benchmarkPrice": {
    object (Price)
  },
  "reportCountryCode": string,
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string
}
Pola
price

object (Price)

Aktualna cena produktu.

benchmarkPrice

object (Price)

Najnowsza wartość referencyjna cen dla katalogu produktów w kraju, w którym jest poruszona.

reportCountryCode

string

Kraj odniesienia dla cen. Wartość powinna być podana w formacie ISO 3166.

Wymagane w klauzuli SELECT.

id

string

Identyfikator REST produktu w formacie channel~languageCode~feedLabel~offerId. Umożliwia złączenie danych z tabelą productView.

Wymagane w klauzuli SELECT.

offerId

string

Identyfikator produktu podany przez sprzedawcę.

title

string

Tytuł produktu.

brand

string

Marka produktu.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

Typ produktu (poziom 1) w mapie kategorii sprzedawcy.

productTypeL2

string

Typ produktu (poziom 2) w mapie kategorii sprzedawcy.

productTypeL3

string

Typ produktu (poziom 3) w mapie kategorii sprzedawcy.

productTypeL4

string

Typ produktu (poziom 4) w mapie kategorii sprzedawcy.

productTypeL5

string

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 (Price)
  },
  "suggestedPrice": {
    object (Price)
  },
  "effectiveness": enum (Effectiveness),
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "predictedImpressionsChangeFraction": number,
  "predictedClicksChangeFraction": number,
  "predictedConversionsChangeFraction": number
}
Pola
price

object (Price)

Aktualna cena produktu.

suggestedPrice

object (Price)

Najnowsza sugerowana cena produktu.

effectiveness

enum (Effectiveness)

Prognozowana skuteczność zastosowania sugerowanej ceny w podziale na kategorie.

id

string

Identyfikator REST produktu w formacie channel~languageCode~feedLabel~offerId. Umożliwia złączenie danych z tabelą productView.

Wymagane w klauzuli SELECT.

offerId

string

Identyfikator produktu podany przez sprzedawcę.

title

string

Tytuł produktu.

brand

string

Marka produktu.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

Typ produktu (poziom 1) w mapie kategorii sprzedawcy.

productTypeL2

string

Typ produktu (poziom 2) w mapie kategorii sprzedawcy.

productTypeL3

string

Typ produktu (poziom 3) w mapie kategorii sprzedawcy.

productTypeL4

string

Typ produktu (poziom 4) w mapie kategorii sprzedawcy.

productTypeL5

string

Typ produktu (poziom 5) w mapie kategorii sprzedawcy.

predictedImpressionsChangeFraction

number

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

number

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

number

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 (Date)
  },
  "variantGtins": [
    string
  ],
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "inventoryStatus": enum (InventoryStatus),
  "brandInventoryStatus": enum (InventoryStatus),
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
Pola
reportDate

object (Date)

Data raportu. W tym polu może znajdować się tylko jedna z tych wartości:

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

Wymagane w klauzuli SELECT. Jeśli w zapytaniu nie określisz warunku WHERE w dniu reportDate, zwrócony zostanie najnowszy dostępny raport tygodniowy lub miesięczny.

variantGtins[]

string

Numery GTIN przykładowych wersji grupy produktów.

reportGranularity

enum (ReportGranularityEnum)

Szczegółowość raportu. Ranking może obejmować okres tygodnia lub miesiąca.

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

reportCountryCode

string

Kraj, w którym obliczamy ranking. Wartość powinna być podana w formacie ISO 3166.

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

reportCategoryId

string (int64 format)

Identyfikator kategorii produktów Google, dla której chcesz obliczyć ranking, przedstawiony w mapie kategorii Google.

Wymagane w klauzuli SELECT. Jeśli w zapytaniu nie określono warunku WHERE w elemencie reportCategoryId, zwracane są rankingi ze wszystkich kategorii najwyższego poziomu.

title

string

Nazwa grupy produktów.

brand

string

Marka klastra produktów.

categoryL1

string

Kategoria produktów (pierwszy poziom) klastra produktów uwzględniona w mapie kategorii Google.

categoryL2

string

Kategoria produktów (2 poziom) klastra produktów uwzględniona w mapie kategorii Google.

categoryL3

string

Kategoria produktów (trzeci poziom) klastra produktów uwzględniona w mapie kategorii Google.

categoryL4

string

Kategoria produktów (czwarty poziom) klastra produktów uwzględniona w mapie kategorii Google.

categoryL5

string

Kategoria produktów (5 poziom) klastra produktów uwzględniona w mapie kategorii Google.

inventoryStatus

enum (InventoryStatus)

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

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

brandInventoryStatus

enum (InventoryStatus)

Niezależnie od tego, czy w co najmniej 1 kraju w źródle danych o produktach jest obecnie co najmniej 1 produkt marki IN_STOCK, wszystkie produkty mają stan OUT_OF_STOCK w źródle danych o produktach we wszystkich krajach lub NOT_IN_INVENTORY.

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

rank

string (int64 format)

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

string (int64 format)

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

relativeDemand

enum (RelativeDemandEnum)

Szacowany popyt w porównaniu z grupą produktów o największej popularności w tej samej kategorii i kraju.

previousRelativeDemand

enum (RelativeDemandEnum)

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

enum (RelativeDemandChangeTypeEnum)

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 (Date)
  },
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "brand": string,
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
Pola
reportDate

object (Date)

Data raportu. W tym polu może znajdować się tylko jedna z tych wartości:

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

Wymagane w klauzuli SELECT. Jeśli w zapytaniu nie określisz warunku WHERE w dniu reportDate, zwrócony zostanie najnowszy dostępny raport tygodniowy lub miesięczny.

reportGranularity

enum (ReportGranularityEnum)

Szczegółowość raportu. Ranking może obejmować okres tygodnia lub miesiąca.

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

reportCountryCode

string

Kraj, w którym obliczamy ranking. Wartość powinna być podana w formacie ISO 3166.

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

reportCategoryId

string (int64 format)

Identyfikator kategorii produktów Google, dla której chcesz obliczyć ranking, przedstawiony w mapie kategorii Google.

Wymagane w klauzuli SELECT. Jeśli w zapytaniu nie określono warunku WHERE w elemencie reportCategoryId, zwracane są rankingi ze wszystkich kategorii najwyższego poziomu.

brand

string

Nazwa marki.

rank

string (int64 format)

Popularność marki w Google Ads i na platformach bezpłatnych w wybranej kategorii i kraju na podstawie szacowanej liczby sprzedanych produktów.

previousRank

string (int64 format)

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

relativeDemand

enum (RelativeDemandEnum)

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

previousRelativeDemand

enum (RelativeDemandEnum)

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

enum (RelativeDemandChangeTypeEnum)

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 (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number,
  "relativeVisibility": number
}
Pola
date

object (Date)

Data w tym wierszu.

W klauzuli WHERE wymagany jest warunek date.

domain

string

Domena Twojego konkurenta lub Twoja domena, jeśli pole „isYourDomain” ma wartość prawda.

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

isYourDomain

boolean

Wartość to „prawda”, jeśli ten wiersz zawiera dane dotyczące Twojej domeny.

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

reportCountryCode

string

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

Wymagane w klauzuli SELECT. W klauzuli WHERE wymagany jest warunek reportCountryCode.

reportCategoryId

string (int64 format)

Identyfikator kategorii produktów Google, dla której chcesz obliczyć raport, przedstawiony w mapie kategorii Google.

Wymagane w klauzuli SELECT. W klauzuli WHERE wymagany jest warunek reportCategoryId.

trafficSource

enum (TrafficSourceEnum)

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

Wymagane w klauzuli SELECT.

rank

string (int64 format)

Pozycja domeny w rankingu podobnych firm dla wybranych kluczy (date, reportCategoryId, reportCountryCode, trafficSource) na podstawie wyświetleń. 1 to najwyższa wartość.

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

adsOrganicRatio

number

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

pageOverlapRate

number

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”.

higherPositionRate

number

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

relativeVisibility

number

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ń konkurencji podzielona przez liczbę Twoich wyświetleń w wybranym przedziale czasu dla wybranej kategorii produktów i kraju.

Nie można filtrować według klauzuli „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 (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number
}
Pola
date

object (Date)

Data w tym wierszu.

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

domain

string

Domena Twojego konkurenta lub Twoja domena, jeśli pole „isYourDomain” ma wartość prawda.

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

isYourDomain

boolean

Wartość to „prawda”, jeśli ten wiersz zawiera dane dotyczące Twojej domeny.

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

reportCountryCode

string

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

Wymagane w klauzuli SELECT. W klauzuli WHERE wymagany jest warunek reportCountryCode.

reportCategoryId

string (int64 format)

Identyfikator kategorii produktów Google, dla której chcesz obliczyć raport, przedstawiony w mapie kategorii Google.

Wymagane w klauzuli SELECT. W klauzuli WHERE wymagany jest warunek reportCategoryId.

trafficSource

enum (TrafficSourceEnum)

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

Wymagane w klauzuli SELECT.

rank

string (int64 format)

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

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

adsOrganicRatio

number

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

pageOverlapRate

number

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”.

higherPositionRate

number

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 klauzuli „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 (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}
Pola
date

object (Date)

Data w tym wierszu.

Wymagane w klauzuli SELECT. W klauzuli WHERE wymagany jest warunek date.

reportCountryCode

string

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

Wymagane w klauzuli SELECT. W klauzuli WHERE wymagany jest warunek reportCountryCode.

reportCategoryId

string (int64 format)

Identyfikator kategorii produktów Google, dla której chcesz obliczyć raport, przedstawiony w mapie kategorii Google.

Wymagane w klauzuli SELECT. W klauzuli WHERE wymagany jest warunek reportCategoryId.

trafficSource

enum (TrafficSourceEnum)

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

Wymagane w klauzuli SELECT.

yourDomainVisibilityTrend

number

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

categoryBenchmarkVisibilityTrend

number

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