轉換動作類別

本指南列出可使用 Google Ads API 建立的不同轉換動作類型，並說明這些動作與 Google Ads 網頁介面的對應關係。

選擇合適的轉換動作類型

請按照下列決策路徑，選取正確的轉換動作類型和整合設定指南：

  1. 轉換事件發生在哪裡？

    • 在實體管道 (例如辦公室、商家所在地點或透過電話)：請前往步驟 2。
    • 直接在網站上 (例如網站購物、註冊或提交表單)：請前往步驟 3。
    • 在行動應用程式中：請前往步驟 4。
    • 直接從廣告撥打的電話：使用廣告轉接來電 (AD_CALL) (使用 CallAsset)。
    • 在 Google 適地性產品或服務上 (例如在 Google 地圖上規劃路線、撥打電話或點擊)：請參閱「本地動作轉換 (GOOGLE_HOSTED)」。

  2. 離線轉換：

  3. 線上 (網站) 轉換：

    • 您要追蹤載入網頁 (購買、收據) 還是使用者點擊？
      • 是：使用網站轉換，並將代碼片段設為 WEBPAGE 或 WEBPAGE_ONCLICK。

    • 您是否要追蹤網站上列出的電話號碼所促成的來電？

  4. 行動應用程式轉換：

    • 追蹤 Google Play 商店的安裝或購買次數是否足夠？
      • 是：使用應用程式轉換 (GOOGLE_PLAY_DOWNLOAD 或 GOOGLE_PLAY_IN_APP_PURCHASE)。

    • 您是否使用 Google Analytics (GA4) 或第三方應用程式數據分析工具追蹤應用程式動作？

離線轉換

離線轉換可協助您追蹤在離線環境中發生的轉換事件，例如在辦公室、商家所在地點或透過電話。

下表列出 Google Ads 網頁介面中各個來源對應的 ConversionActionType API 參數，以及各個轉換動作類型的說明文件連結：

轉換動作類型 Google Ads 來源 API 設定指南
UPLOAD_CLICKS 追蹤點擊帶來的轉換和待開發客戶強化轉換 使用 Data Manager API (建議)，或參閱「管理離線點擊轉換」一文，瞭解現有的 Google Ads 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 (GA4))
WEBPAGE_ONCLICK 網站、網站 (Google Analytics (GA4))
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

AD_CALL 轉換動作在 Google Ads 網頁介面中會顯示為廣告來電轉換。建立 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 (建議)，或參閱「管理離線點擊轉換」一文，瞭解現有的 Google Ads API 整合
WEBPAGE 網站強化轉換
改善線上轉換評估準確度 		API 設定指南

其他轉換動作類型

Google Ads API 可在報表中提供其他類型的轉換動作，但可能會限制或禁止建立或修改這些動作。您可以使用 GoogleAdsService 查詢轉換動作及其類型：

SELECT
  conversion_action.id,
  conversion_action.name,
  conversion_action.type,
  conversion_action.origin,
  conversion_action.category,
  conversion_action.status
FROM conversion_action

SKAdNetwork 轉換

如果您放送 iOS 應用程式廣告活動，並已導入 SKAdNetwork，則可使用下列資源，存取 Google 在 Customer 和 Campaign 層級提供的 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 帶來 iOS Store Kit Ad Network 安裝的廣告所在的廣告聯播網 ID。
segments.sk_ad_network_source_domain 帶來 iOS Store Kit Ad Network 安裝的廣告所在的網站。空值表示這個區隔不適用 (例如非 iOS 廣告活動)，或 Apple 傳送的回傳中沒有這個區隔。
segments.sk_ad_network_source_type 帶來 iOS Store Kit 廣告聯播網安裝的廣告所在的來源類型。空值表示這個區隔不適用 (例如非 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 廣告聯播網 API 版本。

Google Analytics

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

  • GA4 資源轉換：

    • 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_APP_AD_IMPRESSION
  • FIREBASE_ANDROID_FIRST_OPEN
  • FIREBASE_ANDROID_IN_APP_PURCHASE
  • FIREBASE_ANDROID_CUSTOM
  • FIREBASE_IOS_APP_AD_IMPRESSION
  • 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 會自動建立本地動作轉換，追蹤使用者與廣告互動後，在 Google 地區型產品和服務 (例如 Google 地圖) 上採取的動作。

在 Google Ads API 中，所有本地動作轉換都是唯讀 ConversionAction 資源，具有下列欄位值：

name (以帳戶語言本地化) 和 category 欄位會識別每個本地動作轉換，如下表所示。「本地動作 - 造訪網站」和「本地動作 - 查看選單」都使用 PAGE_VIEW 類別，在報表中則以 conversion_action.name 或 conversion_action.id 區分。

Google Ads 轉換動作名稱 ConversionAction.category 欄位 說明
點選通話 CONTACT 點選 Google 地區型廣告或服務上的「通話」按鈕。
本地動作 - 取得路線 GET_DIRECTIONS 點選 Google 地區型廣告或服務上的「規劃路線」按鈕。
本地動作 - 造訪網站 PAGE_VIEW 點選 Google 地區型廣告或服務上的網站連結。
本地動作 - 查看選單 PAGE_VIEW 點選 Google 地區型廣告或服務上的選單連結。
本地動作 - 訂購 BEGIN_CHECKOUT 點選 Google 地區型廣告或服務上的「訂購」按鈕。
本地動作 - 其他互動 ENGAGEMENT 使用者與廣告互動後，點選 Google 地區型廣告或服務上其他已追蹤的動作 (例如分享或儲存位置資訊)。

根據預設，所有 GOOGLE_HOSTED 轉換目標都不可出價 (biddable 為 false)。您只能為下列本地動作目標啟用出價：

  • 本地動作 - 規劃路線 (category 為 GET_DIRECTIONS，origin 為 GOOGLE_HOSTED)：
    • 帳戶層級：在 GET_DIRECTIONS 類別和 GOOGLE_HOSTED 來源的 CustomerConversionGoal 資源上，將 biddable 欄位設為 true，或將轉換動作納入 CustomConversionGoal。
    • 廣告活動層級 (僅限最高成效、搜尋和購物廣告活動)：在 GET_DIRECTIONS 類別和 GOOGLE_HOSTED 來源的 CampaignConversionGoal 資源上，將 biddable 欄位設為 true。
  • 點擊撥號 (category 為 CONTACT，origin 為 GOOGLE_HOSTED)：
    • 廣告活動層級 (僅限最高成效廣告活動)：在 CONTACT 類別和 GOOGLE_HOSTED 來源的 CampaignConversionGoal 資源上，將 biddable 欄位設為 true。這個目標不支援使用CustomerConversionGoal進行帳戶層級出價。

所有其他 GOOGLE_HOSTED 類別 (PAGE_VIEW、BEGIN_CHECKOUT 和 ENGAGEMENT) 均不可出價。詳情請參閱「轉換目標」。

唯讀轉換動作類型

下列轉換動作類型在 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 等重要轉換指標的完整結果。

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