注意：您正在查看 API 的 REST 介面說明文件。我們的官方用戶端程式庫支援 gRPC。詳情請參閱 REST 簡介。

本頁面由 Cloud Translation API 翻譯而成。

ConversionAction

JSON 表示法
ConversionActionStatus
ConversionActionType
ValueSettings
- JSON 表示法
ConversionActionCountingType
AttributionModelSettings
- JSON 表示法
AttributionModel
DataDrivenModelStatus
FirebaseSettings
- JSON 表示法
ThirdPartyAppAnalyticsSettings
- JSON 表示法
GoogleAnalytics4Settings
- JSON 表示法

轉換動作。

JSON 表示法

JSON 表示法
{ "resourceName": string, "status": enum (`ConversionActionStatus`), "type": enum (`ConversionActionType`), "origin": enum (`ConversionOrigin`), "category": enum (`ConversionActionCategory`), "valueSettings": { object (`ValueSettings`) }, "countingType": enum (`ConversionActionCountingType`), "attributionModelSettings": { object (`AttributionModelSettings`) }, "tagSnippets": [ { object (`TagSnippet`) } ], "mobileAppVendor": enum (`MobileAppVendor`), "firebaseSettings": { object (`FirebaseSettings`) }, "thirdPartyAppAnalyticsSettings": { object (`ThirdPartyAppAnalyticsSettings`) }, "googleAnalytics4Settings": { object (`GoogleAnalytics4Settings`) }, "id": string, "name": string, "primaryForGoal": boolean, "ownerCustomer": string, "includeInConversionsMetric": boolean, "clickThroughLookbackWindowDays": string, "viewThroughLookbackWindowDays": string, "phoneCallDurationSeconds": string, "appId": string }

{
  "resourceName": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "origin": enum (ConversionOrigin),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "countingType": enum (ConversionActionCountingType),
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "tagSnippets": [
    {
      object (TagSnippet)
    }
  ],
  "mobileAppVendor": enum (MobileAppVendor),
  "firebaseSettings": {
    object (FirebaseSettings)
  },
  "thirdPartyAppAnalyticsSettings": {
    object (ThirdPartyAppAnalyticsSettings)
  },
  "googleAnalytics4Settings": {
    object (GoogleAnalytics4Settings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "viewThroughLookbackWindowDays": string,
  "phoneCallDurationSeconds": string,
  "appId": string
}

欄位
`resourceName`	`string` 不可變動。轉換動作的資源名稱。轉換動作資源名稱的格式如下： `customers/{customerId}/conversionActions/{conversion_action_id}`
`status`	`enum (ConversionActionStatus)` 這個轉換動作在轉換事件累積的狀態。
`type`	`enum (ConversionActionType)` 不可變動。這個轉換動作的類型。
`origin`	`enum (ConversionOrigin)` 僅供輸出。這個轉換動作的轉換來源。
`category`	`enum (ConversionActionCategory)` 這個轉換動作記錄的轉換類別。
`valueSettings`	`object (ValueSettings)` 與此轉換動作相關轉換事件價值相關的設定。
`countingType`	`enum (ConversionActionCountingType)` 如何計算轉換動作的轉換事件。
`attributionModelSettings`	`object (AttributionModelSettings)` 與這個轉換動作歸因模式相關的設定。
`tagSnippets[]`	`object (TagSnippet)` 僅供輸出。用於追蹤轉換的程式碼片段。
`mobileAppVendor`	`enum (MobileAppVendor)` 僅供輸出。應用程式轉換動作的行動應用程式供應商。
`firebaseSettings`	`object (FirebaseSettings)` 僅供輸出。Firebase 轉換類型的 Firebase 設定。
`thirdPartyAppAnalyticsSettings`	`object (ThirdPartyAppAnalyticsSettings)` 僅供輸出。第三方轉換類型的第三方應用程式分析設定。
`googleAnalytics4Settings`	`object (GoogleAnalytics4Settings)` 僅供輸出。Google Analytics (分析) 4 轉換類型的 Google Analytics (分析) 4 設定。
`id`	`string (int64 format)` 僅供輸出。轉換動作的 ID。
`name`	`string` 轉換動作的名稱。此為必填欄位，不可空白。
`primaryForGoal`	`boolean` 如果轉換動作的 primaryForGoal 位元為 false，則無論客戶轉換目標或廣告活動目標為何，轉換動作皆無法設為可出價。不過，自訂轉換目標不會遵循 primaryForGoal，因此即使廣告活動的自訂轉換目標設為 primaryForGoal = false，則該轉換動作仍可出價。如果沒有設定，primaryForGoal 預設為 True。在 V9 中，您只有在透過「update」作業建立後，才能將 primaryForGoal 設為 false，因為未宣告為選用。
`ownerCustomer`	`string` 僅供輸出。轉換動作擁有者客戶的資源名稱。如果這是系統定義的轉換動作，則為空值。
`includeInConversionsMetric`	`boolean` 這個轉換動作是否應納入「轉換」指標中。
`clickThroughLookbackWindowDays`	`string (int64 format)` 從一次互動 (例如點擊) 到轉換事件之間，可能經過的天數上限。
`viewThroughLookbackWindowDays`	`string (int64 format)` 從曝光到完成轉換，且沒有互動經過的天數上限。
`phoneCallDurationSeconds`	`string (int64 format)` 這是指轉換動作記錄轉換的通話時間長度 (以秒為單位)。值必須介於 0 到 10000 (含) 之間。
`appId`	`string` 應用程式轉換動作的應用程式 ID。

ConversionActionStatus

轉換動作的可能狀態。

列舉
`UNSPECIFIED`	未指定。
`UNKNOWN`	僅用於傳回值。代表這個版本未知的值。
`ENABLED`	系統會記錄轉換。
`REMOVED`	系統不會記錄轉換。
`HIDDEN`	系統不會記錄轉換，轉換動作也不會顯示在使用者介面中。

ConversionActionType

可能的轉換動作類型。

列舉
`UNSPECIFIED`	未指定。
`UNKNOWN`	僅用於傳回值。代表這個版本未知的值。
`AD_CALL`	使用者按下廣告的來電額外資訊時產生的轉換。
`CLICK_TO_CALL`	行動裝置使用者點選電話號碼時發生的轉換。
`GOOGLE_PLAY_DOWNLOAD`	使用者從 Google Play 商店下載行動應用程式時發生的轉換。
`GOOGLE_PLAY_IN_APP_PURCHASE`	使用者透過 Android 帳款服務在應用程式內消費時發生的轉換。
`UPLOAD_CALLS`	由廣告客戶追蹤並上傳的來電轉換。
`UPLOAD_CLICKS`	由廣告客戶追蹤並透過歸因點擊上傳的轉換。
`WEBPAGE`	網頁上發生的轉換。
`WEBSITE_CALL`	使用者從廣告客戶的網站撥打動態產生的電話號碼時，所發生的轉換。
`STORE_SALES_DIRECT_UPLOAD`	商店銷售轉換是根據第一方或第三方商家資料所上傳的。只有許可清單上的客戶可以使用商店銷售直接上傳類型。
`STORE_SALES`	根據上傳的第三方或第三方商家資料，和/或透過付款網路中的卡片在店內購物產生的商店銷售轉換。只有許可清單上的客戶可以使用商店銷售類型。唯讀。
`FIREBASE_ANDROID_FIRST_OPEN`	透過 Firebase 追蹤的 Android 應用程式初次開啟轉換。
`FIREBASE_ANDROID_IN_APP_PURCHASE`	透過 Firebase 追蹤 Android 應用程式購物轉換。
`FIREBASE_ANDROID_CUSTOM`	透過 Firebase 追蹤的 Android 應用程式自訂轉換。
`FIREBASE_IOS_FIRST_OPEN`	透過 Firebase 追蹤的 iOS 應用程式初次開啟轉換。
`FIREBASE_IOS_IN_APP_PURCHASE`	透過 Firebase 追蹤的 iOS 應用程式購物轉換。
`FIREBASE_IOS_CUSTOM`	透過 Firebase 追蹤的 iOS 應用程式自訂轉換。
`THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN`	透過第三方應用程式數據分析追蹤的 Android 應用程式初次開啟轉換。
`THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE`	透過第三方應用程式數據分析追蹤的 Android 應用程式購物轉換。
`THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM`	透過第三方應用程式數據分析追蹤的 Android 應用程式自訂轉換。
`THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN`	透過第三方應用程式數據分析追蹤的 iOS 應用程式初次開啟轉換。
`THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE`	透過第三方應用程式數據分析追蹤的 iOS 應用程式購物轉換。
`THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM`	透過第三方應用程式數據分析追蹤的 iOS 應用程式自訂轉換。
`ANDROID_APP_PRE_REGISTRATION`	使用者從 Google Play 商店預先註冊行動應用程式時產生的轉換。唯讀。
`ANDROID_INSTALLS_ALL_OTHER_APPS`	追蹤轉換：追蹤所有 Google Play 下載次數，但未由應用程式特定類型的追蹤。唯讀。
`FLOODLIGHT_ACTION`	Floodlight 活動會計算使用者在看到或點擊廣告客戶的廣告後，造訪特定網頁的次數。唯讀。
`FLOODLIGHT_TRANSACTION`	用於追蹤銷售次數或商品銷量的 Floodlight 活動。也能夠擷取每筆銷售的總金額。唯讀。
`GOOGLE_HOSTED`	與廣告互動後，追蹤來自 Google 產品和服務的本地動作的轉換。唯讀。
`LEAD_FORM_SUBMIT`	使用者提交待開發客戶表單時，系統記錄的轉換次數。唯讀。
`SALESFORCE`	來自 Salesforce 的轉換。唯讀。
`SEARCH_ADS_360`	從 Search Ads 360 Floodlight 資料匯入的轉換。唯讀。
`SMART_CAMPAIGN_AD_CLICKS_TO_CALL`	使用智慧廣告活動自訂條件時，智慧廣告活動中的來電轉換，但未設定來電追蹤。唯讀。
`SMART_CAMPAIGN_MAP_CLICKS_TO_CALL`	使用者在 Google 地圖中點選通話元素。僅限智慧廣告活動。唯讀。
`SMART_CAMPAIGN_MAP_DIRECTIONS`	使用者在 Google 地圖中要求前往商家所在地點的路線。僅限智慧廣告活動。唯讀。
`SMART_CAMPAIGN_TRACKED_CALLS`	使用智慧廣告活動自訂條件的智慧廣告活動廣告，所發生的來電轉換。唯讀。
`STORE_VISITS`	使用者造訪廣告客戶的零售商店所產生的轉換。唯讀。
`WEBPAGE_CODELESS`	根據網站事件 (例如提交表單或載入網頁) 建立的轉換，不需使用個別程式碼的事件程式碼片段。唯讀。
`UNIVERSAL_ANALYTICS_GOAL`	來自已連結通用 Analytics (分析) 目標的轉換。
`UNIVERSAL_ANALYTICS_TRANSACTION`	來自已連結通用 Analytics (分析) 交易的轉換。
`GOOGLE_ANALYTICS_4_CUSTOM`	來自已連結 Google Analytics (分析) 4 自訂事件轉換的轉換。
`GOOGLE_ANALYTICS_4_PURCHASE`	來自已連結 Google Analytics (分析) 4 購物轉換的轉換。

ValueSettings

與此轉換動作相關轉換事件價值相關的設定。

JSON 表示法
{ "defaultValue": number, "defaultCurrencyCode": string, "alwaysUseDefaultValue": boolean }

欄位

欄位
`defaultValue`	`number` 這個轉換動作的轉換事件傳送的價值無效、不允許或遺漏，或這項轉換動作已設為一律使用預設值時，要使用的價值。
`defaultCurrencyCode`	`string` 傳送此轉換動作轉換事件時，或包含無效或缺少貨幣代碼，或是這個轉換動作設為一律使用預設值時，要使用的貨幣代碼。
`alwaysUseDefaultValue`	`boolean` 控制是否要使用預設價值和預設貨幣代碼，取代這項轉換動作的轉換事件指定的價值和貨幣代碼。

defaultValue

number

這個轉換動作的轉換事件傳送的價值無效、不允許或遺漏，或這項轉換動作已設為一律使用預設值時，要使用的價值。

defaultCurrencyCode

string

傳送此轉換動作轉換事件時，或包含無效或缺少貨幣代碼，或是這個轉換動作設為一律使用預設值時，要使用的貨幣代碼。

alwaysUseDefaultValue

boolean

控制是否要使用預設價值和預設貨幣代碼，取代這項轉換動作的轉換事件指定的價值和貨幣代碼。

ConversionActionCountingType

表示這項動作的轉換計算方式。詳情請參閱 https://support.google.com/google-ads/answer/3438531。

列舉
`UNSPECIFIED`	未指定。
`UNKNOWN`	僅用於傳回值。代表這個版本未知的值。
`ONE_PER_CLICK`	每次點擊只計算一次轉換。
`MANY_PER_CLICK`	計算每次點擊的所有轉換次數。

AttributionModelSettings

與這個轉換動作歸因模式相關的設定。

JSON 表示法
{ "attributionModel": enum (`AttributionModel`), "dataDrivenModelStatus": enum (`DataDrivenModelStatus`) }

欄位

欄位
`attributionModel`	`enum (AttributionModel)` 這個轉換動作的歸因模式類型。
`dataDrivenModelStatus`	`enum (DataDrivenModelStatus)` 僅供輸出。轉換動作的以數據為準歸因模式狀態。

attributionModel

enum (AttributionModel)

這個轉換動作的歸因模式類型。

dataDrivenModelStatus

enum (DataDrivenModelStatus)

僅供輸出。轉換動作的以數據為準歸因模式狀態。

AttributionModel

這個歸因模式說明如何將特定轉換的功勞分配給許多先前的互動。

列舉
`UNSPECIFIED`	未指定。
`UNKNOWN`	僅用於傳回值。代表這個版本未知的值。
`EXTERNAL`	使用外部歸因模式。
`GOOGLE_ADS_LAST_CLICK`	將所有轉換功勞歸給最終點擊。
`GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK`	使用 Google 搜尋歸因，將所有轉換功勞歸給促成的最初點擊。
`GOOGLE_SEARCH_ATTRIBUTION_LINEAR`	使用 Google 搜尋歸因模式，將轉換功勞平均分配給所有的點擊。
`GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY`	使用 Google 搜尋歸因分析，將某次轉換的功勞平均歸給較近期的點擊 (半衰期為 1 週)。
`GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED`	這種模式會將某次轉換的 40% 功勞歸給最初和最終點擊。剩下 20% 則會平均分配給所有其他點擊。系統會使用 Google 搜尋歸因。
`GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN`	靈活的模式會運用機器學習技術，根據 Google 搜尋歸因分析，決定點擊功勞的適當分配方式。

DataDrivenModelStatus

列舉資料導向模式的狀態。

列舉
`UNSPECIFIED`	未指定。
`UNKNOWN`	僅用於傳回值。代表這個版本未知的值。
`AVAILABLE`	可用的以數據為準模式。
`STALE`	以數據為準模式已過時。已至少 7 天未更新。仍在使用中，但如果超過 30 天未更新，就會失效。
`EXPIRED`	以數據為準模式已過期。該帳戶已超過 30 天沒有更新，因此無法使用。這通常是因為最近 30 天內的事件數量沒有達到要求。
`NEVER_GENERATED`	系統從未產生以數據為準模式最常見的原因是 30 天內沒有任何事件數量達到要求。

FirebaseSettings

Firebase 轉換動作的相關設定。

JSON 表示法
{ "propertyId": string, "propertyName": string, "eventName": string, "projectId": string }

欄位
`propertyId`	`string (int64 format)` 僅供輸出。轉換的 Google Analytics (分析) 資源 ID。
`propertyName`	`string` 僅供輸出。轉換的 Google Analytics (分析) 資源名稱。
`eventName`	`string` 僅供輸出。Firebase 轉換的事件名稱。
`projectId`	`string` 僅供輸出。轉換的 Firebase 專案 ID。

ThirdPartyAppAnalyticsSettings

第三方應用程式數據分析轉換動作的相關設定。

JSON 表示法
{ "providerName": string, "eventName": string }

欄位

欄位
`providerName`	`string` 僅供輸出。第三方應用程式分析供應商的名稱。
`eventName`	`string` 僅供輸出。第三方應用程式數據分析轉換的事件名稱。

providerName

string

僅供輸出。第三方應用程式分析供應商的名稱。

eventName

string

僅供輸出。第三方應用程式數據分析轉換的事件名稱。

GoogleAnalytics4Settings

Google Analytics (分析) 4 轉換動作的相關設定。

JSON 表示法
{ "eventName": string, "propertyName": string, "propertyId": string }

欄位

欄位
`eventName`	`string` 僅供輸出。GA4 事件的名稱。
`propertyName`	`string` 僅供輸出。GA4 資源名稱。
`propertyId`	`string (int64 format)` 僅供輸出。GA4 資源的 ID。

eventName

string

僅供輸出。GA4 事件的名稱。

propertyName

string

僅供輸出。GA4 資源名稱。

propertyId

string (int64 format)

僅供輸出。GA4 資源的 ID。