Package google.shopping.merchant.conversions.v1beta

Indeks

ConversionSourcesService

Usługa do zarządzania źródłami konwersji na koncie sprzedawcy.

CreateConversionSource

rpc CreateConversionSource(CreateConversionSourceRequest) returns (ConversionSource)

Tworzy nowe źródło konwersji.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie OAuth 2.0.
DeleteConversionSource

rpc DeleteConversionSource(DeleteConversionSourceRequest) returns (Empty)

Archiwizuje istniejące źródło konwersji. Jeśli źródłem konwersji jest miejsce docelowe w Merchant Center, będzie można je przywrócić przez 30 dni. Jeśli źródłem konwersji jest połączenie z Google Analytics, zostanie ono natychmiast usunięte i będzie można je przywrócić, tworząc nowe.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie OAuth 2.0.
GetConversionSource

rpc GetConversionSource(GetConversionSourceRequest) returns (ConversionSource)

Pobiera źródło konwersji.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie OAuth 2.0.
ListConversionSources

rpc ListConversionSources(ListConversionSourcesRequest) returns (ListConversionSourcesResponse)

Pobiera listę źródeł konwersji, do których ma dostęp wywołujący.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie OAuth 2.0.
UndeleteConversionSource

rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource)

Ponownie włącza zarchiwizowane źródło konwersji. Dostępne tylko w przypadku źródeł konwersji w Merchant Center.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie OAuth 2.0.
UpdateConversionSource

rpc UpdateConversionSource(UpdateConversionSourceRequest) returns (ConversionSource)

Aktualizuje informacje o dotychczasowym źródle konwersji. Dostępne tylko w przypadku źródeł konwersji w Merchant Center.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie OAuth 2.0.

AttributionSettings

Reprezentują ustawienia atrybucji źródeł konwersji, które otrzymują dane przed atrybucją.

Pola
attribution_lookback_window_days

int32

Wymagane. Okresy ważności (w dniach) używane do atrybucji w tym źródle. Obsługiwane wartości to 7, 30 i 40.
attribution_model

AttributionModel

Wymagane. Model atrybucji.
conversion_type[]

ConversionType

Niezmienna. Lista nieuporządkowana. Lista różnych typów konwersji, do których może należeć zdarzenie konwersji. Jeśli ta lista będzie pusta w momencie tworzenia, zostanie automatycznie utworzony standardowy typ „purchase” (zakup).

AttributionModel

Model atrybucji używany w przypadku tego źródła. Obsługujemy ten sam zestaw modeli oferowanych przez Google Analytics 4, jak opisano na stronie https://support.google.com/analytics/answer/10596866.

Wartości w polu enum
ATTRIBUTION_MODEL_UNSPECIFIED Nieokreślony model.
CROSS_CHANNEL_LAST_CLICK Model ostatniego kliknięcia w wielu kanałach.
ADS_PREFERRED_LAST_CLICK Model ostatniego kliknięcia preferowany w Google Ads.
CROSS_CHANNEL_DATA_DRIVEN Model oparty na danych w wielu kanałach.
CROSS_CHANNEL_FIRST_CLICK Model pierwszego kliknięcia w wielu kanałach.
CROSS_CHANNEL_LINEAR Model liniowy w wielu kanałach.
CROSS_CHANNEL_POSITION_BASED Model z uwzględnieniem pozycji w wielu kanałach.
CROSS_CHANNEL_TIME_DECAY Model spadku udziału z upływem czasu w wielu kanałach.

ConversionType

Komunikat przedstawiający rodzaje zdarzeń konwersji

Pola
name

string

Tylko dane wyjściowe. Nazwa zdarzenia konwersji, jaką będzie ono zgłaszane przez klienta.
report

bool

Tylko dane wyjściowe. Opcja wskazująca, czy dany typ powinien być uwzględniany w raportach Merchant Center.

ConversionSource

Reprezentuje źródło konwersji należące do konta sprzedawcy. Konto sprzedawcy może mieć maksymalnie 200 źródeł konwersji.

Pola
name

string

Tylko dane wyjściowe. Identyfikator. Generowane przez Content API po utworzeniu nowego ConversionSource. Format: [a-z]{4}:.+ 4 znaki przed dwukropkiem oznaczają typ źródła konwersji. Treść po dwukropku to identyfikator źródła konwersji w ramach danego typu. Identyfikator 2 różnych źródeł konwersji może być taki sam w przypadku różnych typów. Obsługiwane są te prefiksy typów: – galk: źródła GoogleAnalyticsLink. – mcdn: w przypadku źródeł Merchant CenterDestination.
state

State

Tylko dane wyjściowe. Bieżący stan tego źródła konwersji. Nie można ich edytować za pomocą interfejsu API.
expire_time

Timestamp

Tylko dane wyjściowe. Moment, w którym zarchiwizowane źródło konwersji zostaje trwale usunięte i nie można już go cofnąć.
controller

Controller

Tylko dane wyjściowe. Administrator źródła konwersji.
Pole unii source_data. Wymagane. Dane o źródłach konwersji dotyczące poszczególnych typów źródeł. source_data może być tylko jednym z tych elementów:
merchant_center_destination

MerchantCenterDestination

Źródło konwersji typu „Miejsce docelowe tagu Merchant Center”.

Kontroler

Jednostka kontrolująca źródło konwersji.

Wartości w polu enum
CONTROLLER_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
MERCHANT Kontrolowane przez sprzedawcę, który jest właścicielem źródła konwersji.
YOUTUBE_AFFILIATES kontrolowane przez program partnerski YouTube,

Stan

Reprezentuje stan źródła konwersji.

Wartości w polu enum
STATE_UNSPECIFIED Źródło konwersji ma stan nieokreślony.
ACTIVE Źródło konwersji działa prawidłowo.
ARCHIVED Źródło konwersji zostało zarchiwizowane w ciągu ostatnich 30 dni i nie jest obecnie aktywne. Można je przywrócić za pomocą metody przywracania po usunięciu.
PENDING Tworzenie źródła konwersji już się rozpoczęło, ale nie zostało jeszcze w pełni zakończone.

CreateConversionSourceRequest

Komunikat żądania metody CreateConversionSource.

Pola
parent

string

Wymagane. Konto sprzedawcy, które będzie właścicielem nowego źródła konwersji. Format: accounts/{account}
conversion_source

ConversionSource

Wymagane. Opis źródła konwersji. Po utworzeniu zostanie mu automatycznie przypisany nowy identyfikator.

DeleteConversionSourceRequest

Komunikat z prośbą o wykonanie metody DeleteConversionSource.

Pola
name

string

Wymagane. Nazwa źródła konwersji do usunięcia. Format: accounts/{konto}/conversionSources/{conversion_source}

GetConversionSourceRequest

Komunikat o żądaniu dotyczący metody GetConversionSource.

Pola
name

string

Wymagane. Nazwa źródła konwersji, które ma zostać pobrane. Format: accounts/{konto}/conversionSources/{conversion_source}

ListConversionSourcesRequest

Żądanie dotyczące metody ListConversionSources.

Pola
parent

string

Wymagane. Konto sprzedawcy, które jest właścicielem kolekcji źródeł konwersji. Format: accounts/{account}
page_size

int32

Opcjonalnie: Maksymalna liczba źródeł konwersji zwracanych na stronie. Jeśli nie podasz żadnego elementu page_size, domyślną wartością będzie 100. Maksymalna wartość to 200. Wartości powyżej 200 zostaną skonwertowane na 200. Niezależnie od podziału na strony zwracana jest maksymalna liczba 200 źródeł konwersji.
page_token

string

Opcjonalnie: Token strony.
show_deleted

bool

Opcjonalnie: Pokaż opcję usunięte (zarchiwizowane).

ListConversionSourcesResponse

Wiadomość odpowiedzi dla metody ListConversionSources.

Pola
conversion_sources[]

ConversionSource

Lista źródeł konwersji.
next_page_token

string

Token do użycia w celu pobrania następnej strony z wynikami.

MerchantCenterDestination

Źródła „Miejsce docelowe Merchant Center” mogą służyć do wysyłania zdarzeń konwersji ze sklepu internetowego za pomocą tagu Google bezpośrednio na konto Merchant Center, na którym zostało utworzone źródło.

Pola
destination

string

Tylko dane wyjściowe. Identyfikator miejsca docelowego w Merchant Center.
attribution_settings

AttributionSettings

Wymagane. Ustawienia atrybucji używane w przypadku miejsca docelowego Merchant Center.
display_name

string

Wymagane. Wyświetlana nazwa miejsca docelowego określona przez sprzedawcę. Jest to nazwa identyfikująca źródło konwersji w interfejsie Merchant Center. Może zawierać maksymalnie 64 znaki.
currency_code

string

Wymagane. Trzyliterowy kod waluty (ISO 4217). Kod waluty określa, w jakiej walucie konwersje wysyłane do tego miejsca docelowego będą raportowane w Merchant Center.

UndeleteConversionSourceRequest

Komunikat żądania dotyczący metody UndeleteConversionSource.

Pola
name

string

Wymagane. Nazwa źródła konwersji, które ma być przywrócone. Format: accounts/{account}/conversionSources/{conversion_source}

UpdateConversionSourceRequest

Wiadomość z prośbą o zaktualizowanie metody UpdateConversionSource.

Pola
conversion_source

ConversionSource

Wymagane. Nowa wersja danych źródła konwersji. Format: accounts/{konto}/conversionSources/{conversion_source}
update_mask

FieldMask

Wymagane. Lista pól, które są aktualizowane.