Package google.shopping.merchant.conversions.v1beta

索引

• ConversionSourcesService (介面)
• AttributionSettings (訊息)
• AttributionSettings.AttributionModel (列舉)
• AttributionSettings.ConversionType (訊息)
• ConversionSource (訊息)
• ConversionSource.Controller (列舉)
• ConversionSource.State (列舉)
• CreateConversionSourceRequest (訊息)
• DeleteConversionSourceRequest (訊息)
• GetConversionSourceRequest (訊息)
• GoogleAnalyticsLink (訊息)
• ListConversionSourcesRequest (訊息)
• ListConversionSourcesResponse (訊息)
• MerchantCenterDestination (訊息)
• UndeleteConversionSourceRequest (訊息)
• UpdateConversionSourceRequest (訊息)

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 只能是下列其中一項：
google_analytics_link	GoogleAnalyticsLink 不可變動。轉換來源類型為「連結至 Google Analytics 資源」。
merchant_center_destination	MerchantCenterDestination 轉換來源類型為「Merchant Center Tag Destination」。

控制器

控制轉換來源的實體。

列舉
CONTROLLER_UNSPECIFIED	預設值。此值未使用。
MERCHANT	由擁有轉換來源的商家控管。
YOUTUBE_AFFILIATES	由 YouTube 聯盟計畫控制。

州

代表轉換來源的狀態。

列舉
STATE_UNSPECIFIED	轉換來源處於未指定狀態。
ACTIVE	轉換來源運作正常。
ARCHIVED	轉換來源在過去 30 天內已封存，目前無法使用。可使用 undelete 方法還原。
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}

GoogleAnalyticsLink

你可以使用「Google Analytics 連結」來源，將現有 Google Analytics 資源中的轉換資料，傳送至已連結的 Merchant Center 帳戶。

欄位
property_id	int64 必要欄位。不可變動。商家連結的 Google Analytics 資源 ID。
attribution_settings	AttributionSettings 僅供輸出。已連結 Google Analytics 資源的歸因設定。
property	string 僅供輸出。商家連結的 Google Analytics 資源名稱。

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 Destination」來源，透過 Google 代碼將線上商店的轉換事件直接傳送至建立來源的 Merchant Center 帳戶。

欄位
destination	string 僅供輸出。Merchant Center Destination 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 選用設定。要更新的欄位清單。