ConversionAction

轉換動作。

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

無法變更。轉換動作的資源名稱。轉換動作資源名稱的格式為：

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 中，主要 ForGoal 在建立「update」作業後只能設為 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

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

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

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

列舉
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

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

GoogleAnalytics4Settings

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

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

string

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

string

僅供輸出。GA4 資源名稱。
propertyId

string (int64 format)

僅供輸出。Google Analytics (分析) 4 資源的 ID。