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 代碼目的地」類型的轉換來源。

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 目的地」來源可使用 Google 代碼，將網路商店的轉換事件直接傳送到建立來源的 Merchant Center 帳戶。

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

string

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

object (AttributionSettings)

必要欄位。Merchant Center 目的地所使用的歸因分析設定。
displayName

string

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

string

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

州

代表轉換來源的狀態。

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

控制器

控制轉換來源的實體。

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

方法

create

 建立新的轉換來源。

delete

 封存現有的轉換來源。

get

 擷取轉換來源。

list

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

patch

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

undelete

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