Package google.shopping.merchant.conversions.v1beta

索引

ConversionSourcesService

用於管理商家帳戶轉換來源的服務。

CreateConversionSource

rpc CreateConversionSource(CreateConversionSourceRequest) returns (ConversionSource)

建立新的轉換來源。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
DeleteConversionSource

rpc DeleteConversionSource(DeleteConversionSourceRequest) returns (Empty)

封存現有的轉換來源。如果轉換來源是 Merchant Center 目的地，可以在 30 天內還原。如果轉換來源是 Google Analytics (分析) 連結，系統會立即刪除。如要還原，請建立新來源。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
GetConversionSource

rpc GetConversionSource(GetConversionSourceRequest) returns (ConversionSource)

擷取轉換來源。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
ListConversionSources

rpc ListConversionSources(ListConversionSourcesRequest) returns (ListConversionSourcesResponse)

擷取呼叫者可存取的轉換來源清單。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
UndeleteConversionSource

rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource)

重新啟用已封存的轉換來源。僅適用於 Merchant Center 目的地轉換來源。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
UpdateConversionSource

rpc UpdateConversionSource(UpdateConversionSourceRequest) returns (ConversionSource)

更新現有轉換來源的資訊。僅適用於 Merchant Center 目的地轉換來源。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

AttributionSettings

代表收到歸因前資料的轉換來源歸因分析設定。

欄位
attribution_lookback_window_days

int32

必要欄位。這個來源用於歸因的回溯期 (以天為單位)。支援的值為 7、30、40。
attribution_model

AttributionModel

必要欄位。歸因模式。
conversion_type[]

ConversionType

不可變動。未排序的清單。列出可分類轉換事件的各種轉換類型。如果建立時這份名單為空白，系統會自動建立標準「購買」類型。

AttributionModel

這個來源使用的歸因模式。我們支援 Google Analytics (分析) 4 提供的相同模式組合，詳情請參閱：https://support.google.com/analytics/answer/10596866。

列舉
ATTRIBUTION_MODEL_UNSPECIFIED 未指定的模型。
CROSS_CHANNEL_LAST_CLICK 跨管道最終點擊模式。
ADS_PREFERRED_LAST_CLICK 優先計入 Google Ads 最終點擊模式。
CROSS_CHANNEL_DATA_DRIVEN 跨管道以數據為準模式。
CROSS_CHANNEL_FIRST_CLICK 跨管道最初點擊模式：
CROSS_CHANNEL_LINEAR 跨管道線性模式。
CROSS_CHANNEL_POSITION_BASED 跨管道根據排序模式。
CROSS_CHANNEL_TIME_DECAY 跨管道時間衰減模式。

ConversionType

代表轉換事件類型的訊息

欄位
name

string

僅供輸出。轉換事件名稱，由客戶回報。
report

bool

僅供輸出。指明該類型是否應納入 Merchant Center 報表的選項。

ConversionSource

代表商家帳戶擁有的轉換來源。一個商家帳戶最多可有 200 個轉換來源。

欄位
name

string

僅供輸出。ID。建立新的 ConversionSource 時由 Content API 產生。格式：[a-z]{4}:.+ 冒號前的四個字元代表對話來源的類型。冒號後方的內容代表該類型內轉換來源的 ID。兩個不同轉換來源的 ID 可能在不同的類型中相同。支援下列類型的前置字元：- galk:適用於 GoogleAnalyticsLink 來源。- mcdn：適用於 MerchantCenterDestination 來源。
state

State

僅供輸出。這個轉換來源的目前狀態。無法透過 API 編輯。
expire_time

Timestamp

僅供輸出。已封存的轉換來源何時會遭到永久刪除，且無法再取消刪除。
controller

Controller

僅供輸出。轉換來源的控管者。
聯集欄位 source_data。必要欄位。每種不同來源專屬的轉換來源資料。source_data 只能是下列其中一項：
merchant_center_destination

MerchantCenterDestination

「Merchant Center 代碼目的地」類型的轉換來源。

控制器

控制轉換來源的實體。

列舉
CONTROLLER_UNSPECIFIED 預設值。未使用這個值。
MERCHANT 由轉換來源的擁有者控管。
YOUTUBE_AFFILIATES 由 YouTube 聯盟計畫控管。

狀態

代表轉換來源的狀態。

列舉
STATE_UNSPECIFIED 轉換來源未指定狀態。
ACTIVE 轉換來源可完全正常運作。
ARCHIVED 轉換來源在過去 30 天內已封存，目前無法正常運作。可使用取消刪除方法還原。
PENDING 轉換來源建立作業已開始，但尚未完成。

CreateConversionSourceRequest

CreateConversionSource 方法的要求訊息。

欄位
parent

string

必要欄位。擁有新轉換來源的商家帳戶。格式：accounts/{account}
conversion_source

ConversionSource

必要欄位。轉換來源說明。系統會在建立時自動指派新 ID。

DeleteConversionSourceRequest

DeleteConversionSource 方法的要求訊息。

欄位
name

string

必要欄位。要刪除的轉換來源名稱。格式：accounts/{account}/conversionSources/{conversion_source}

GetConversionSourceRequest

GetConversionSource 方法的要求訊息。

欄位
name

string

必要欄位。要擷取的轉換來源名稱，格式：accounts/{account}/conversionsources/{conversion_source}

ListConversionSourcesRequest

ListConversionSources 方法的要求訊息。

欄位
parent

string

必要欄位。擁有轉換來源集合的商家帳戶。格式：accounts/{account}
page_size

int32

選用設定。在單一網頁中傳回的轉換來源數量上限。如未指定 page_size，系統會使用 100 做為預設值。最大值為 200。系統會將超過 200 的值強制轉換為 200。無論分頁為何，共傳回最多 200 個轉換來源。
page_token

string

選用設定。頁面符記。
show_deleted

bool

選用設定。顯示已刪除 (已封存) 選項。

ListConversionSourcesResponse

ListConversionSources 方法的回應訊息。

欄位
conversion_sources[]

ConversionSource

轉換來源清單。
next_page_token

string

要用於擷取下一個結果頁面的權杖。

MerchantCenterDestination

「Merchant Center 目的地」來源可使用 Google 代碼，將網路商店的轉換事件直接傳送至建立來源的 Merchant Center 帳戶。

欄位
destination

string

僅供輸出。Merchant Center 目的地 ID。
attribution_settings

AttributionSettings

必要欄位。Merchant Center 目的地使用的歸因設定。
display_name

string

必要欄位。商家指定的目的地顯示名稱。這個名稱可用來在 Merchant Center 使用者介面中識別轉換來源。上限為 64 個半形字元。
currency_code

string

必要欄位。三字母貨幣代碼 (ISO 4217)。貨幣代碼會定義系統要以哪種幣別記錄傳送至這個目的地的轉換資料，以供 Merchant Center 回報。

UndeleteConversionSourceRequest

UndeleteConversionSource 方法的要求訊息。

欄位
name

string

必要欄位。要取消刪除的轉換來源名稱。格式：accounts/{account}/conversionSources/{conversion_source}

UpdateConversionSourceRequest

UpdateConversionSource 方法的要求訊息。

欄位
conversion_source

ConversionSource

必要欄位。新版轉換來源資料。格式：accounts/{account}/conversionSources/{conversion_source}
update_mask

FieldMask

必要欄位。要更新的欄位清單。