版本資訊

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 年 6 月 12 日)

這項更新包含客戶資源的新欄位。 請務必更新用戶端程式庫，充分運用這些變更。

新欄位

我們正在新增

有助於瀏覽 Search Ads 360 帳戶階層。

v0 (2025 年 1 月 21 日)

這項更新包含設定 MCC 擴展的新參數。

擴大「我的客戶中心」

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

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

v0 (2024 年 11 月 8 日)

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

新欄位

我們正在新增 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 月 7 日)

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

已新增指標

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 年 8 月 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。

已將 MULTIMEDIA_AD 新增至 ad_group_ad.ad.type

現在可以選取指標和區隔，搭配使用 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)

本次更新包含可存取的出價策略資源

可存取的出價策略

代表客戶擁有及與客戶共用的 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 年 8 月 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 年 5 月 15 日)

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

廣告群組廣告

請參閱 ad_group_ad 資源詳細資料。

v0 (2023 年 4 月 6 日)

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

廣告群組目標對象檢視畫面

請參閱 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 月 5 日)

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 可依欄位 (例如日期欄位) 區隔。瞭解詳情。