REST Resource: accounts.conversionSources

資源：ConversionSource

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

JSON 表示法 
{
  "name": string,
  "state": enum (State),
  "expireTime": string,
  "controller": enum (Controller),

  // Union field source_data can be only one of the following:
  "googleAnalyticsLink": {
    object (GoogleAnalyticsLink)
  },
  "merchantCenterDestination": {
    object (MerchantCenterDestination)
  }
  // End of list of possible types for union field source_data.
}
欄位
name

string

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

enum (State)

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

string (Timestamp format)

僅供輸出。封存的轉換來源永久刪除，無法再還原的時間。
controller

enum (Controller)

僅供輸出。轉換來源的控制器。
聯集欄位 source_data。必要欄位。轉換來源資料，適用於各類型來源。source_data 只能是下列其中一項：
merchantCenterDestination

object (MerchantCenterDestination)

轉換來源類型為「Merchant Center Tag Destination」。

AttributionSettings

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

JSON 表示法 
{
  "attributionLookbackWindowDays": integer,
  "attributionModel": enum (AttributionModel),
  "conversionType": [
    {
      object (ConversionType)
    }
  ]
}
欄位
attributionLookbackWindowDays

integer

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

enum (AttributionModel)

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

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

代表轉換事件類型的訊息

JSON 表示法 
{
  "name": string,
  "report": boolean
}
欄位
name

string

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

boolean

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

MerchantCenterDestination

您可以使用「Merchant Center Destination」來源，透過 Google 代碼將線上商店的轉換事件直接傳送至建立來源的 Merchant Center 帳戶。

JSON 表示法 
{
  "destination": string,
  "attributionSettings": {
    object (AttributionSettings)
  },
  "displayName": string,
  "currencyCode": string
}
欄位
destination

string

僅供輸出。Merchant Center Destination ID。
attributionSettings

object (AttributionSettings)

必要欄位。用於 Merchant Center 目的地的歸因設定。
displayName

string

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

string

必要欄位。由三個字母組成的貨幣代碼 (ISO 4217)。貨幣代碼會定義傳送至這個目的地的轉換資料，在 Merchant Center 中以哪種貨幣回報。

州

代表轉換來源的狀態。

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

控制器

控制轉換來源的實體。

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

方法

create

 建立新的轉換來源。

delete

 封存現有的轉換來源。

get

 擷取轉換來源。

list

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

patch

 更新現有轉換來源的資訊。

undelete

 重新啟用已封存的轉換來源。