Package google.shopping.merchant.conversions.v1beta

Indeks

ConversionSourcesService

Usługa 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 omówieniu protokołu 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 Merchant Center, będzie można je odzyskać 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 omówieniu protokołu 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 omówieniu protokołu OAuth 2.0.
ListConversionSources

rpc ListConversionSources(ListConversionSourcesRequest) returns (ListConversionSourcesResponse)

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

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

rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource)

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

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

rpc UpdateConversionSource(UpdateConversionSourceRequest) returns (ConversionSource)

Aktualizuje informacje o istniejącym źródle konwersji. Dostępne tylko w przypadku źródeł konwersji docelowych w Merchant Center.

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.

AttributionSettings

Reprezentuje ustawienia atrybucji w przypadku źródeł konwersji, które otrzymują dane poprzedzające atrybucję.

Pola
attribution_lookback_window_days

int32

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

AttributionModel

Wymagane. Model atrybucji.
conversion_type[]

ConversionType

Stałe. Lista nieuporządkowana. Lista różnych typów konwersji, do których można sklasyfikować zdarzenie konwersji. Jeśli lista będzie pusta w momencie tworzenia, zostanie utworzony automatycznie standardowy typ „zakupu”.

AttributionModel

Model atrybucji używany na potrzeby tego źródła. Obsługujemy ten sam zestaw modeli, który jest dostępny w Google Analytics 4, zgodnie z opisem 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 na podstawie 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 oparty na pozycji w wielu kanałach.
CROSS_CHANNEL_TIME_DECAY Model spadku udziału z upływem czasu w wielu kanałach.

ConversionType

Wiadomość reprezentująca typy zdarzeń konwersji

Pola
name

string

Tylko dane wyjściowe. Nazwa zdarzenia konwersji, zgodnie z raportem 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. Wygenerowane przez Content API po utworzeniu nowego elementu ConversionSource. Format: [a-z]{4}:.+ Cztery znaki przed dwukropkiem określają typ źródła konwersji. Treść po dwukropku reprezentuje identyfikator źródła konwersji w ramach danego typu. Identyfikatory 2 różnych źródeł konwersji mogą być takie same w zależności od typu. Obsługiwane są następujące prefiksy typu: – galk: dla źródeł połączeń Google Analytics. – mcdn: dotyczy źródeł miejsca docelowego MerchantCenter.
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. Czas, kiedy zarchiwizowane źródło konwersji zostanie trwale usunięte i nie można go już przywrócić.
controller

Controller

Tylko dane wyjściowe. Kontroler źródła konwersji.
Pole sumy source_data. Wymagane. Dane źródła konwersji specyficzne dla poszczególnych typów źródeł. source_data może być tylko jedną z tych wartości:
merchant_center_destination

MerchantCenterDestination

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

Kontroler

Podmiot kontrolujący źródło konwersji.

Wartości w polu enum
CONTROLLER_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
MERCHANT Kontrolowane przez sprzedawcę, do którego należy źródło 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 nieokreślony stan.
ACTIVE Źródło konwersji jest w pełni funkcjonalne.
ARCHIVED Źródło konwersji zostało zarchiwizowane w ciągu ostatnich 30 dni i obecnie nie działa. Można je przywrócić, korzystając z metody „undelete”.
PENDING Tworzenie źródła konwersji już się rozpoczęło, ale nie zostało jeszcze w pełni zakończone.

CreateConversionSourceRequest

Komunikat żądania dla metody CreateConversionSource.

Pola
parent

string

Wymagane. Konto sprzedawcy, do którego będzie przypisane nowe źródło konwersji. Format: accounts/{konto}
conversion_source

ConversionSource

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

DeleteConversionSourceRequest

Komunikat żądania dla metody DeleteConversionSource.

Pola
name

string

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

GetConversionSourceRequest

Komunikat żądania dla metody GetConversionSource.

Pola
name

string

Wymagane. Nazwa źródła konwersji do pobrania. Format: accounts/{konto}/źródła_konwersji/{źródło_konwersji}

ListConversionSourcesRequest

Komunikat żądania dla metody ListConversionSources.

Pola
parent

string

Wymagane. Konto sprzedawcy, do którego należy zbiór źródeł konwersji. Format: accounts/{konto}
page_size

int32

Opcjonalnie. Maksymalna liczba źródeł konwersji do zwrócenia na stronie. Jeśli nie określono elementu page_size, domyślną wartością jest 100. Maksymalna wartość to 200. Wartości powyżej 200 zostaną przekształcone na 200. Niezależnie od podziału na strony łącznie zwracanych jest maksymalnie 200 źródeł konwersji.
page_token

string

Opcjonalnie. Token strony.
show_deleted

bool

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

ListConversionSourcesResponse

Komunikat z odpowiedzią dla metody ListConversionSources.

Pola
conversion_sources[]

ConversionSource

Lista źródeł konwersji.
next_page_token

string

Token, który posłuży do pobrania następnej strony wyników.

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 na potrzeby miejsca docelowego w Merchant Center.
display_name

string

Wymagane. Wyświetlana nazwa miejsca docelowego określona przez sprzedawcę. Jest to nazwa, która identyfikuje źródło konwersji w interfejsie użytkownika Merchant Center. Limit wynosi 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 dla metody UndeleteConversionSource.

Pola
name

string

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

UpdateConversionSourceRequest

Komunikat żądania dla 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 aktualizowanych pól.