REST Resource: accounts.reports

Zasób: 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.

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

nonProductPerformanceView

object (NonProductPerformanceView)

Pola dostępne do zapytań w tabeli nonProductPerformanceView.

productView

object (ProductView)

Pola dostępne do zapytań w tabeli productView.

priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

Pola dostępne do zapytań w tabeli priceCompetitivenessProductView.

priceInsightsProductView

object (PriceInsightsProductView)

Pola dostępne do zapytań w tabeli priceInsightsProductView.

bestSellersProductClusterView

object (BestSellersProductClusterView)

Pola dostępne do zapytań w tabeli bestSellersProductClusterView.

bestSellersBrandView

object (BestSellersBrandView)

Pola dostępne do zapytań w tabeli bestSellersBrandView.

competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

Pola dostępne do zapytań w tabeli competitiveVisibilityCompetitorView.

competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

Pola dostępne do zapytań w tabeli competitiveVisibilityTopMerchantView.

competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

Pola dostępne do zapytań w tabeli competitiveVisibilityBenchmarkView.

ProductPerformanceView

Pola dostępne do zapytań w tabeli productPerformanceView.

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. offerId). Wartości wymiarów produktów, np. offerId, 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 żą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 odnoszą się dane. Segmentowanie.

Warunek date jest wymagany w klauzuli WHERE.

week

object (Date)

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

conversionValue

object (Price)

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

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

marketingMethod

enum (MarketingMethodEnum)

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

customerCountryCode

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

offerId

string

Identyfikator produktu podany przez sprzedawcę. Segmentowanie.

title

string

Tytuł produktu. Segmentowanie.

brand

string

Marka produktu. Segmentowanie.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

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

productTypeL2

string

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

productTypeL3

string

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

productTypeL4

string

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

productTypeL5

string

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

customLabel0

string

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

customLabel1

string

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

customLabel2

string

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

customLabel3

string

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

customLabel4

string

Etykieta własna 4 do 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ęć) podzielona przez liczbę ich wyświetleń (wyświetleń). Dane.

conversions

number

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.

conversionRate

number

Liczba konwersji podzielona przez liczbę kliknięć, zgłaszana w dacie wyświetlenia. Dane.

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

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

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 żą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 odnoszą się dane. Segmentowanie.

Warunek date jest wymagany w klauzuli WHERE.

week

object (Date)

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

clicks

string (int64 format)

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

impressions

string (int64 format)

Liczba wyświetleń obrazów 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 do sklepu internetowego prowadzących do stron niedotyczących produktów. Dane.

ProductView

Pola dostępne do zapytań w tabeli productView.

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.

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 Brakuje, jeśli informacje o cenie produktu są niedostępne.

gtin[]

string

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

creationTime

string (Timestamp format)

Czas utworzenia produktu przez sprzedawcę w postaci sygnatury czasowej w sekundach.

expirationDate

object (Date)

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

itemIssues[]

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

clickPotential

enum (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

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 (1 poziom) w mapie kategorii Google.

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

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

productTypeL2

string

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

productTypeL3

string

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

productTypeL4

string

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

productTypeL5

string

Typ produktu (poziom 5) w mapie kategorii produktów 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 pogrupowania wersji.

aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

Stan zbiorczy.

clickPotentialRank

string (int64 format)

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

ItemIssue

Problem 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)

Poważność problemu z produktem.

resolution

enum (ItemIssueResolution)

Rozwiązanie problemu z elementem.

ItemIssueType

Typ problemu.

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

string

Kod błędu odpowiadający code w sekcji Problemy z produktem.

canonicalAttribute

string

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

ItemIssueSeverity

Jak problem wpływa na wyświetlanie produktu.

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

object (IssueSeverityPerReportingContext)

Waga problemu w kontekście raportowania.

aggregatedSeverity

enum (AggregatedIssueSeverity)

Ogółem powaga problemu w przypadku wszystkich kontekstów raportowania, których dotyczy.

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

IssueSeverityPerReportingContext

Waga problemu w kontekście raportowania.

Zapis JSON
{
  "disapprovedCountries": [
    string
  ],
  "demotedCountries": [
    string
  ],
  "reportingContext": enum (ReportingContextEnum)
}
Pola
disapprovedCountries[]

string

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

demotedCountries[]

string

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

reportingContext

enum (ReportingContextEnum)

Kontekst raportowania, w którym występuje problem.

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.

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

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 prognozowanych 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;

PriceCompetitivenessProductView

Pola dostępne do zapytań w tabeli priceCompetitivenessProductView.

Raport Konkurencyjność cenowa.

Wartości są ustawiane tylko w przypadku pól, które zostały wyraźnie zażądane w zapytaniu wyszukiwania żą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)

Obecna cena produktu.

benchmarkPrice

object (Price)

najnowsze dostępne ceny referencyjne katalogu produktów w kraju odniesienia.

reportCountryCode

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 jej używać do złączania 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 (1 poziom) w mapie kategorii Google.

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

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

productTypeL2

string

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

productTypeL3

string

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

productTypeL4

string

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

productTypeL5

string

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

PriceInsightsProductView

Pola dostępne do zapytań w tabeli priceInsightsProductView.

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.

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)

Obecna cena produktu.

suggestedPrice

object (Price)

Najnowsza sugerowana cena produktu.

effectiveness

enum (Effectiveness)

Prognozowana skuteczność zastosowania sugestii ceny, pogrupowana.

id

string

Identyfikator REST produktu w formie channel~languageCode~feedLabel~offerId. Można jej używać do złączania 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 (1 poziom) w mapie kategorii Google.

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

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

productTypeL2

string

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

productTypeL3

string

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

productTypeL4

string

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

productTypeL5

string

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

predictedImpressionsChangeFraction

number

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

predictedClicksChangeFraction

number

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

predictedConversionsChangeFraction

number

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ść.

BestSellersProductClusterView

Pola dostępne do zapytań w tabeli bestSellersProductClusterView.

Raport Bestsellery z najpopularniejszymi 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.

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. 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 reportDate, zwracany jest najnowszy dostępny raport tygodniowy lub miesięczny.

variantGtins[]

string

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

reportGranularity

enum (ReportGranularityEnum)

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

Wymagane w klauzuli SELECT. Warunek reportGranularity jest wymagany w klauzuli WHERE.

reportCountryCode

string

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

Wymagane w klauzuli SELECT. Warunek reportCountryCode jest wymagany w klauzuli WHERE.

reportCategoryId

string (int64 format)

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 reportCategoryId, zwracane są rankingi wszystkich kategorii najwyższego poziomu.

title

string

Nazwa grupy produktów.

brand

string

Marka klastra produktów.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

inventoryStatus

enum (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.

brandInventoryStatus

enum (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

string (int64 format)

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

previousRank

string (int64 format)

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

relativeDemand

enum (RelativeDemandEnum)

Szacowany popyt w porównaniu z produktami z najwyższym współczynnikiem popularności w tej samej kategorii i kraju.

previousRelativeDemand

enum (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.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

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

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.

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.

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 najpopularniejszy klaster produktów lub markę.
LOW Popyt wynosi 6–10% popytu na najpopularniejszy produkt lub markę.
MEDIUM Popyt wynosi 11–20% popytu na najpopularniejszy klaster produktów lub markę.
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.

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 Względny popyt jest równy poprzedniemu okresowi.
RISER Względny popyt jest wyższy niż w poprzednim okresie.

BestSellersBrandView

Pola dostępne do zapytań w tabeli bestSellersBrandView.

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.

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. 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 reportDate, zwracany jest najnowszy dostępny raport tygodniowy lub miesięczny.

reportGranularity

enum (ReportGranularityEnum)

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

Wymagane w klauzuli SELECT. Warunek reportGranularity jest wymagany w klauzuli WHERE.

reportCountryCode

string

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

Wymagane w klauzuli SELECT. Warunek reportCountryCode jest wymagany w klauzuli WHERE.

reportCategoryId

string (int64 format)

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 reportCategoryId, zwracane są rankingi wszystkich kategorii najwyższego poziomu.

brand

string

Nazwa marki.

rank

string (int64 format)

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

previousRank

string (int64 format)

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

relativeDemand

enum (RelativeDemandEnum)

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

previousRelativeDemand

enum (RelativeDemandEnum)

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

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

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

CompetitiveVisibilityCompetitorView

Pola dostępne do zapytań w tabeli competitiveVisibilityCompetitorView.

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.

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 tego wiersza.

W klauzuli WHERE wymagany jest warunek date.

domain

string

Domena konkurencji lub Twoja domena, jeśli parametr „isYourDomain” ma wartość „true” (prawda).

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

isYourDomain

boolean

Prawda, jeśli wiersz zawiera dane Twojej domeny.

Nie można ich filtrować w 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 ma być obliczany raport, podany w mapie kategorii produktów Google.

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

trafficSource

enum (TrafficSourceEnum)

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

Wymagane w klauzuli SELECT.

rank

string (int64 format)

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

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

adsOrganicRatio

number

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

pageOverlapRate

number

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

higherPositionRate

number

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

relativeVisibility

number

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

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.

CompetitiveVisibilityTopMerchantView

Pola dostępne do zapytań w tabeli competitiveVisibilityTopMerchantView.

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.

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 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 „isYourDomain” ma wartość „true” (prawda).

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

isYourDomain

boolean

Prawda, jeśli wiersz zawiera dane Twojej domeny.

Nie można ich filtrować w 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 ma być obliczany raport, podany w mapie kategorii produktów Google.

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

trafficSource

enum (TrafficSourceEnum)

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

Wymagane w klauzuli SELECT.

rank

string (int64 format)

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

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

adsOrganicRatio

number

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

pageOverlapRate

number

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

higherPositionRate

number

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

CompetitiveVisibilityBenchmarkView

Pola dostępne do zapytań w tabeli competitiveVisibilityBenchmarkView.

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.

Zapis JSON
{
  "date": {
    object (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}
Pola
date

object (Date)

Data tego wiersza.

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 ma być obliczany raport, podany w mapie kategorii produktów Google.

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

trafficSource

enum (TrafficSourceEnum)

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

Wymagane w klauzuli SELECT.

yourDomainVisibilityTrend

number

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

categoryBenchmarkVisibilityTrend

number

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

Metody

Pobiera raport zdefiniowany przez zapytanie.