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

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