版本資訊

v0 (2026-11-09)

新區隔

我們將新增下列區隔：

v0 (2026-08-01)

新欄位

我們將在 ad 和 asset 資源中新增 synthetic_content_info，以及支援的 SyntheticContentInfo 訊息、SyntheticContentAttestationStatus 和 SyntheticContentSource 列舉。

v0 (2026-03-10)

新區隔

我們將新增下列區隔：

v0 (2025-12-05)

新指標

查詢 campaign 資源時，現在可使用下列指標：

我們將新增下列「透過購物車資料回報的轉換」(CwCD) 指標：

新區隔

現在可以在查詢中指定郵遞區號區隔。詳情請參閱 segments.geo_target_postal_code。

v0 (2025-11-10)

新網址欄位

我們正在新增

UserLocationView 的新指標

查詢 user_location_view 資源時，現在可使用下列指標：

更正資源名稱

下列有效標籤資源的資源名稱模式已修正為使用 owner_customer_id，確保其中包含擁有標籤的客戶 ID：

  • CampaignEffectiveLabel
  • AdGroupEffectiveLabel
  • CriterionEffectiveLabel (位於 AdGroupCriterionEffectiveLabel)
  • AdGroupAdEffectiveLabel

範例：CampaignEffectiveLabel 的模式從 customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} 變更為 customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}。

v0 (2025-06-12)

這項更新包含客戶資源的新欄位。請務必更新用戶端程式庫，才能充分運用所有異動。

新欄位

我們正在新增

，協助您瀏覽 Search Ads 360 帳戶階層。

v0 (2025-01-21)

這項更新包含用於設定 MCC 擴充的新參數。

MCC 擴充

查詢 bidding_strategy 時，您現在可以在 PARAMETERS 部分設定布林值 (enable_mcc_expansion)。

啟用這項參數後，系統會在回應中傳回根層級為 customer_id 的帳戶階層中所有帳戶的資料。

v0 (2024-11-08)

本次更新包含新欄位和新資源。請務必更新用戶端程式庫，才能充分運用這些異動。

新欄位

我們將新增 ad_group_ad.effective_labels 和 ad_group_criterion.effective_labels。

有效標籤是指沿用或直接指派的標籤。

新的資源

使用者位置檢視

與地理區隔搭配使用，可取得區域、都會區和城市相關指標。

查看 user_location_view 資源詳細資料。

與新的 effective_labels 欄位相關，有 2 個新資源會保留有效標籤與 ad_group_ad (ad_group_ad_effective_label) 或 ad_group_criterion (ad_group_criterion_effective_label) 之間關聯的中繼資料。

v0 (2024-10-07)

本次更新包含新指標、資源、欄位和一些新的對應定義。請務必更新用戶端程式庫，才能充分運用所有異動。

已新增指標

cross_device_conversions_by_conversion_date 和 cross_device_conversions_value_by_conversion_date 與下列資源相容：ad_group_ad、ad_group_audience_view、ad_group、bidding_strategy、campaign、customer、campaign_audience_view、keyword_view 和 shopping_performance_view。

重新定義欄位對應

部分舊版報表的 dfaActions、dfaActionsCrossEnv、dfaRevenue、dfaRevenueCrossEnv、dfaTransactions、dfaTransactionsCrossEnv 欄位對應關係已變更。

欄位 先前 新定義
dfaActions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaActionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date
dfaRevenue metrics.all_conversions_value - metrics.cross_device_conversions_value metrics.all_conversions_value_by_conversion_date - metrics.cross_device_conversions_value_by_conversion_date
dfaRevenueCrossEnv metrics.all_conversions_value metrics.all_conversions_value_by_conversion_date
dfaTransactions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaTransactionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date

已變更欄位對應的舊版報表清單

新欄位

我們將新增 campaign.effective_labels 和 ad_group.effective_labels。

有效標籤是指沿用或直接指派的標籤。

新的資源

與新的 effective_labels 欄位相關，新資源會保留有效標籤與廣告活動 (campaign_effective_label) 或廣告群組 (ad_group_effective_label) 之間關聯的中繼資料。

v0 (2024-08-23)

本次更新中，自訂欄中繼資料新增了 renderType 欄位。

請參閱 CustomColumnRenderType 詳細資料。

campaign_label、ad_group_label、ad_group_ad_label 和 ad_group_criterion_label 資源新增了 owner_customer_id 欄位。

請務必更新用戶端程式庫，才能使用這些新欄位。

v0 (2024-08-01)

本次更新包括每小時區隔和多個新欄位

每小時區隔

現在可以在查詢中指定每小時區隔。詳情請參閱 segments.hour。

詳情請參閱 customer_manager_link.start_time

在 ad_group_ad.ad.type 中新增 MULTIMEDIA_AD

現在可選取 MULTIMEDIA_AD 類型的指標和區隔。這個版本不支援查詢多媒體專屬屬性。

在 campaign.advertising_channel_type 中新增 SOCIAL 廣告活動類型，並在 campaign.advertising_channel_sub_type 中新增 SOCIAL_FACEBOOK_TRACKING_ONLY 子類型

現在，您可以使用 SOCIAL 廣告活動類型和 SOCIAL_FACEBOOK_TRACKING_ONLY 子類型，選取指標和區隔。這個版本不支援查詢 SOCIAL 或 SOCIAL_FACEBOOK_TRACKING_ONLY 特定屬性。

新增對 average_quality_score 的支援

查看指標中的詳細資料

v0 (2024-04-18)

這項更新包含 Accessible Bidding Strategy 資源

可用的出價策略

代表客戶擁有及共用的 BiddingStrategies 檢視畫面。與 BiddingStrategy 不同，這項資源除了包含客戶擁有的策略，也包含客戶管理員擁有並與客戶共用的策略。這項資源不提供指標，且僅會顯示 BiddingStrategy 屬性的有限子集。

請參閱 accessible_bidding_strategy 資源詳細資料。

v0 (2024-02-12)

本次更新包含自訂欄和 Floodlight 自訂變數的存取權

自訂欄

現在可以在查詢中指定自訂轉換欄和自訂公式欄。詳情請參閱自訂欄說明文件。

Floodlight 自訂變數

現在可以在查詢中指定 Floodlight 自訂變數，查看 2024 年 1 月 30 日之後的統計資料。詳情請參閱 Floodlight 自訂變數說明文件。

v0 (2023-11-09)

這項更新包含下列資源。 請造訪連結，查看可查詢這些資源的欄位，以及可搭配使用的指標和區隔。

素材資源群組

查看 asset_group 資源詳細資料。

素材資源群組素材資源

查看 asset_group_asset 資源詳細資料。

素材資源群組商家資訊群組篩選器

請參閱 asset_group_listing_group_filter 資源詳細資料。

素材資源群組信號

查看 asset_group_signal 資源詳細資料。

素材資源群組最佳組合檢視畫面

請參閱 asset_group_top_combination_view 資源詳細資料。

購物車資料銷售檢視

查看 cart_data_sales_view 資源詳細資料。

轉換

查看轉換資源詳細資料。

購物成效檢視畫面

請參閱 shopping_performance_view 資源詳細資料。

前往

查看造訪資源詳細資料。

v0 (2023-08-15)

本次更新包含下列資源，以及用於設定指標貨幣換算的新參數。

請造訪連結，查看可查詢這些資源的欄位，以及可搭配使用的指標和區隔。

廣告群組素材資源

查看 ad_group_asset 資源詳細資料。

廣告群組素材資源組合

查看 ad_group_asset_set 素材資源組合詳細資料。

素材資源

請參閱素材資源詳細資料。

素材資源組合

查看 asset_set 素材資源組合詳細資料。

素材資源組合素材資源

查看 asset_set_asset 素材資源組合詳細資料。

廣告活動素材資源

查看 campaign_asset 資源詳細資料。

廣告活動素材資源組合

請參閱 campaign_asset_set 素材資源組合資源詳細資料。

客戶素材資源

查看 customer_asset 資源詳細資料。

客戶素材資源組合

查看 customer_asset_set 素材資源組合詳細資料。

貨幣換算

您可以在「PARAMETERS」部分使用 metrics_currency 指定計算指標時使用的貨幣。

列出可存取的客戶

使用 ListAccessibleCustomers 方法列出所有可存取的帳戶

v0 (2023-05-15)

這項更新包含下列資源。 請造訪連結，查看可查詢這項資源的欄位，以及可搭配使用的指標和區隔。

廣告群組廣告

查看 ad_group_ad 資源詳細資料。

v0 (2023-04-06)

這項更新包含下列資源。 請點選連結，查看每項資源可查詢的欄位，以及可與該資源搭配使用的指標和區隔。

廣告群組目標對象檢視

查看 ad_group_audience_view 資源詳細資料。

廣告群組條件標籤

查看 ad_group_criterion_label 資源詳細資料。

廣告群組標籤

查看 ad_group_label 資源詳細資料。

年齡層檢視

查看 age_range_view 資源詳細資料。

廣告活動條件

查看 campaign_criterion 資源詳細資料。

廣告活動標籤

查看 campaign_label 資源詳細資料

動態搜尋廣告搜尋字詞檢視

查看 dynamic_search_ads_search_term_view 資源詳細資料。

網頁瀏覽

查看 webpage_view 資源詳細資料。

標籤

查看標籤資源詳細資料。

v0 (2022-12-05)

v0 版本包含下列資源和服務。請點選連結，查看每項資源可查詢的欄位，以及可與該資源搭配使用的指標和區隔。

廣告群組

查看 ad_group 資源詳細資料。

出價

查看 bidding_strategy 資源詳細資料。

廣告活動

請參閱廣告活動資源詳細資料。

轉換動作

查看 conversion_action 資源詳細資料。

客戶

查看客戶資源詳細資料。

關鍵字

查看 keyword_view 資源詳細資料。

產品群組

查看 product_group_view 資源詳細資料。

SearchAds360FieldService

SearchAds360Service

  • SearchAds360Service 適用於在單一查詢中擷取多項資源。可查詢的資源包括：

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • 您也可以使用 SearchAds360Service 擷取這些資源的指標，例如曝光次數和點擊次數：

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • SearchAds360Service 可依日期等欄位進行區隔。瞭解詳情。