版本資訊

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_viewshopping_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 metric.all_conversions_value_by_conversion_date - metric.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 (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

將 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 資源詳細資料。

客戶

請參閱客戶資源詳細資料。

關鍵字

請參閱 keyword_view 資源詳細資料。

產品分類

請參閱 product_group_view 資源詳細資料。

SearchAds360FieldService

SearchAds360Service

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

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

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

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

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