轉換動作類別

本指南列出您可使用 Google Ads API 建立的各種轉換動作，並說明這些動作如何對應至 Google Ads 網頁介面。

離線轉換

離線轉換有助於追蹤實體管道發生的轉換事件，例如在辦公室、商家所在地點或透過電話發生的轉換。

下表列出 Google Ads 網頁介面中每個「來源」適用的對等 ConversionActionType API 參數，以及各個特定轉換動作類型的文件連結：

轉換動作類型 Google Ads 來源 API 設定指南
UPLOAD_CLICKS 追蹤點擊帶來的轉換和待開發客戶強化轉換 使用 Data Manager API
UPLOAD_CALLS 追蹤來電所帶來的轉換 匯入來電轉換指南
STORE_SALES 追蹤商店銷售轉換 匯入商店銷售轉換指南

線上 (網站) 轉換

網站轉換可追蹤網站動作，例如線上銷售、連結點擊、網頁瀏覽和註冊。

如要追蹤網站上的轉換，您必須建立ConversionAction，並將ConversionActionType設為 WEBPAGE，然後在網站的轉換頁面中加入稱為「代碼」的程式碼片段。

ConversionAction 包含多種網站轉換，API 會根據每個 ConversionAction 的 tag_snippets 欄位中列出的每個 TagSnippet 的 type 欄位，區分這些轉換。

TagSnippet 提供追蹤程式碼，您必須在網站中加入這段程式碼，才能追蹤轉換動作。網站和電話號碼點擊轉換需要 event_snippet， 應放置在表示轉換動作的網頁上，例如結帳確認或待開發客戶表單提交頁面，以及 global_site_tag， 必須安裝在網站的每個網頁上。您可以使用 ConversionActionService 擷取這兩項屬性。如要進一步瞭解如何標記網頁，請前往說明中心。

下表列出 Google Ads 網頁介面中每個「來源」適用的對等 API 參數：

追蹤程式碼類型 Google Ads 來源
WEBPAGE 網站、網站 (Google Analytics 4)
WEBPAGE_ONCLICK 網站、網站 (Google Analytics 4)
CLICK_TO_CALL 電話號碼點擊

應用程式轉換

應用程式轉換可讓您追蹤 Google Play 商店帶來的行動應用程式安裝次數或應用程式內購次數。

下表列出 Google Ads 網頁介面中每個「來源」適用的對等 ConversionActionType API 參數：

轉換動作類型 Google Ads 來源
GOOGLE_PLAY_DOWNLOAD Google Play > 安裝次數
GOOGLE_PLAY_IN_APP_PURCHASE Google Play > 應用程式內購

如要使用 Google Analytics 4 資源或第三方應用程式數據分析追蹤其他行動應用程式動作，請參閱「其他轉換動作類型」。

來電轉換

來電轉換追蹤可追蹤廣告轉接來電、撥打網站上電話號碼的來電，以及行動版網站上電話號碼的點擊次數。

下表列出 Google Ads 網頁介面中每個「來源」適用的對等 ConversionActionType API 參數：

轉換動作類型 Google Ads 來源
AD_CALL 來電額外資訊或來電專用廣告所獲得的來電
WEBSITE_CALL 您網站上的電話號碼所獲得的來電
CLICK_TO_CALL 您行動網站上電話號碼獲得的點擊

AD_CALL

在 Google Ads 網頁介面中，轉換動作會顯示為「廣告來電」AD_CALL轉換。建立 AD_CALL 轉換動作後，請在建立 CallAsset 時，於 call_conversion_action 欄位中指定轉換動作的資源名稱。電話資產可讓您直接在廣告中顯示電話號碼。

只要通話長度超過指定的持續時間，系統就會將來電當做轉換記下。 預設值為 60 秒。

WEBSITE_CALL

WEBSITE_CALL 在 Google Ads 網頁介面中，轉換動作會顯示為「網站來電」轉換。

與 AD_CALL 不同，這個追蹤程式需要在網站上加入 event_snippet 和 global_site_tag，才能擷取動態 Google 轉接號碼，用於追蹤網站上列出的電話號碼。此外，您必須設定電話素材資源，並在客戶、廣告活動或廣告群組層級連結。

CLICK_TO_CALL

CLICK_TO_CALL 在 Google Ads 網頁介面中，轉換動作會顯示為「行動版網站電話號碼獲得的點擊次數」轉換。

CLICK_TO_CALL 類型與AD_CALL 類型不同，因為前者不會追蹤實際的來電次數，而是CLICK_TO_CALL只 追蹤行動裝置上電話號碼的點擊次數。如果您無法使用 Google 轉接號碼追蹤電話，這項功能就非常實用。

強化轉換

強化轉換功能會將電子郵件地址、姓名、住家地址和電話號碼等第一方轉換資料，加入現有的轉換代碼，藉此提升轉換評估的準確度。

下表列出各項強化轉換類型適用的對等 API 參數：

轉換動作類型 強化轉換類型 API 設定指南
UPLOAD_CLICKS 待開發客戶強化轉換
改善網站待開發客戶或訪客離線交易評估準確度		 使用 Data Manager API
WEBPAGE 網站強化轉換
提升線上轉換評估準確度 		API 設定指南

其他轉換動作類型

Google Ads API 會在報表中提供其他類型的轉換動作， 但可能會限制或禁止建立或修改這些動作。

SKAdNetwork 轉換

如果您放送 iOS 應用程式廣告活動，並已導入 SKAdNetwork，可以使用下列資源，在 Customer 和 Campaign 層級存取 Google 收到的 SKAdNetwork 資料：

報表欄位 說明
metrics.sk_ad_network_installs Apple 回報的安裝次數。這項指標只能依segments.sk_ad_network_conversion_value和日期相關區隔的任意組合進行區隔。
metrics.sk_ad_network_total_conversions 轉換總數，包括 Apple 提供的安裝次數和其他類型轉換次數。這項指標只能依 SKAdNetwork 相關區隔和日期相關區隔進行區隔。
segments.sk_ad_network_ad_event_type 特定轉換發生的事件類型。
segments.sk_ad_network_attribution_credit 特定轉換的歸因方式。
segments.sk_ad_network_fine_conversion_value

Apple 記錄的轉換價值。這個區隔只能套用至 metrics.sk_ad_network_installs、metrics.sk_ad_network_total_conversions 指標，且只能與日期相關區隔合併使用。

如果 Apple 傳回 0 值，系統就會傳回 0 值，否則會傳回其他值。請檢查 欄位是否存在，以區分這兩種情況。
segments.sk_ad_network_coarse_conversion_value 單一轉換的粗略價值。
segments.sk_ad_network_postback_sequence_index 特定轉換的回傳順序位置。
segments.sk_ad_network_source_app.sk_ad_network_source_app_id 廣告所在的應用程式 ID，該廣告帶來了 iOS Store Kit Ad Network 安裝。
segments.sk_ad_network_source_domain 帶來 iOS Store Kit Ad Network 安裝的廣告所在的網站。空值表示這個區隔不適用 (例如非 iOS 廣告活動)，或 Apple 傳送的任何回傳中都沒有這個區隔。
segments.sk_ad_network_source_type 帶來 iOS Store Kit Ad Network 安裝的廣告來源類型。空值表示這個區隔不適用 (例如非 iOS 廣告活動)，或 Apple 傳送的任何回傳中都沒有來源網域或來源應用程式。
segments.sk_ad_network_user_type 產生特定轉換的使用者類型。
segments.sk_ad_network_redistributed_fine_conversion_value 這個區隔中的轉換價值包含重新分配給轉換價值的空值。這個區隔代表 Apple 傳回的觀察到的精細轉換價值，以及 Google 模擬的空值總和。
segments.sk_ad_network_version 使用的 iOS Store Kit Ad Network API 版本。

Google Analytics

已連結 Google Analytics 資源的轉換會具有下列其中一個type值：

  • Google Analytics 4 資源轉換：

    • GOOGLE_ANALYTICS_4_CUSTOM
    • GOOGLE_ANALYTICS_4_PURCHASE

    您也可以從 google_analytics_4_settings 欄位擷取 GA4 資源 ID、資源名稱和事件名稱。

您可以對 GA4 資源轉換進行下列變更：

  • 將 GA4 資源中的轉換匯入 Google Ads 帳戶，方法是將 status 欄位從 HIDDEN 修改為 ENABLED。
  • 修改 primary_for_goal 和 category 欄位，指出這項轉換動作對 Google Ads 出價和報表的影響。
  • 更新 name 或 value_settings。
  • 使用 remove 作業從 Google Ads 帳戶中移除轉換。

如果嘗試修改匯入的 GA4 轉換的其他屬性，或是匯入的通用 Analytics 轉換的任何屬性，都會導致MUTATE_NOT_ALLOWED錯誤。您只能透過 Google Ads 使用者介面進行這些變更。

Firebase 和第三方應用程式數據分析

如要匯入第三方應用程式數據分析或 Firebase 轉換，請使用 ConversionActionService 的 mutate 方法，將 ConversionAction 的 status 從 HIDDEN 變更為 ENABLED。系統不支援更新這些轉換動作的 app_id。

  • FIREBASE_ANDROID_FIRST_OPEN
  • FIREBASE_ANDROID_IN_APP_PURCHASE
  • FIREBASE_ANDROID_CUSTOM
  • FIREBASE_IOS_FIRST_OPEN
  • FIREBASE_IOS_IN_APP_PURCHASE
  • FIREBASE_IOS_CUSTOM
  • THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN
  • THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE
  • THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM
  • THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN
  • THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE
  • THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM

商店銷售：匯入至轉換動作並產生報表

雖然您無法使用 Google Ads API 建立 STORE_SALES 或 STORE_SALES_DIRECT_UPLOAD 轉換動作，但 API 支援匯入商店銷售交易。

  • STORE_SALES
  • STORE_SALES_DIRECT_UPLOAD

唯讀轉換動作類型

Google Ads API 中的下列轉換動作類型為唯讀，僅供報表用途。

  • ANDROID_APP_PRE_REGISTRATION
  • ANDROID_INSTALLS_ALL_OTHER_APPS
  • FLOODLIGHT_ACTION
  • FLOODLIGHT_TRANSACTION
  • GOOGLE_HOSTED
  • LEAD_FORM_SUBMIT
  • SALESFORCE
  • SEARCH_ADS_360
  • SMART_CAMPAIGN_AD_CLICKS_TO_CALL
  • SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
  • SMART_CAMPAIGN_MAP_DIRECTIONS
  • SMART_CAMPAIGN_TRACKED_CALLS
  • STORE_VISITS
  • WEBPAGE_CODELESS

不明

如果 Google Ads 帳戶包含其他類型的轉換動作，查詢和報表可能會傳回 ConversionAction.type 為 UNKNOWN 的轉換動作。API 不支援管理這些轉換動作，但會在報表中傳回這些動作，以便提供 metrics.conversions 和 metrics.conversions_value 等重要轉換指標的完整結果。

上一頁
總覽
下一頁
開始使用轉換