版本資訊

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_條件 (ad_group_criterion_effective_label) 之間的關聯中繼資料。

v0 (2024-10-07)

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

新增指標

• cross_device_conversions_by_conversion_date：依轉換日期計算的跨裝置轉換次數。
• cross_device_conversions_value_by_conversion_date：依轉換日期計算的跨裝置轉換價值總和。
• general_invalid_click_rate：從點擊總數 (篩除的點擊次數 + 未篩除的點擊次數) 中篩除一般無效點擊的百分比。
• general_invalid_clicks：一般無效點擊次數。

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

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

• 帳戶
• 廣告
• AdGroup
• AdGroupTarget
• 廣告主
• BidStrategy
• 廣告活動
• 關鍵字
• ProductAdvertised

新欄位

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

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

新資源

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

v0 (2024-08-23)

本次更新中，「Custom Column」中繼資料會新增 renderType 欄位。

請參閱 CustomColumnRenderType 詳細資料。

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

請務必更新用戶端程式庫，充分運用這些新欄位。

v0 (2024-08-01)

更新項目包括每小時區隔和數個新欄位

每小時區隔

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

已將 start_time 新增至 customer_manager_link 資源

詳情請參閱 customer_manager_link.start_time

將 MULTIMEDIA_AD 新增至 ad_group_ad.ad.type

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

在 campaign.advertising_channel_type 中加入社交廣告活動類型，並將 SOCIAL_FACEBOOK_TRACKING_ONLY 子類型加進 campaign.advertising_channel_sub_type

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

開始支援 average_quality_score

詳情請參閱指標

v0 (2024-04-18)

這項更新包含「無障礙出價策略」資源

無障礙出價策略

代表客戶擁有且與客戶分享的出價策略檢視畫面。與「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 資源詳細資料。

標籤

請參閱label 資源詳細資料。

v0 (2022-12-05)

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

廣告群組

請參閱 ad_group 資源詳細資料。

出價

請參閱 bidding_strategy 資源詳細資料。

廣告活動

查看廣告活動資源詳細資料。

轉換動作

請參閱 conversion_action 資源詳細資料。

客戶

請參閱 customer 資源詳細資料。

關鍵字

請參閱 keyword_view 資源詳細資料。

產品分類

請參閱 product_group_view 資源詳細資料。

SearchAds360FieldService

• SearchAds360FieldService 提供所有可查詢欄位的目錄。這些欄位上的中繼資料包含說明、類型，以及與其他欄位的相容性。瞭解詳情。

SearchAds360Service

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

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

• 您也可以使用 SearchAds360Service 為下列資源擷取曝光次數和點擊次數等指標：

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

• SearchAds360Service 可依據欄位 (例如日期欄位) 進行區隔。瞭解詳情。