Search Ads 360 報表轉換

本文說明如何轉換 Search Ads 360 的報表。

如要查看使用舊版 Search Ads 360 Reporting API 的 Search Ads 360 報表轉換,請參閱「Search Ads 360 報表轉換 (已淘汰)」。

Search Ads 360 報表的表格對應

當您的 Search Ads 360 報表移轉至 BigQuery 時,報表會轉換成下列 BigQuery 資料表和檢視表。在 BigQuery 中檢視資料表和檢視表時,customer_id 的值是您的 Search Ads 360 客戶 ID。

ad_group

ad_group

表格:
p_sa_AdGroup_customer_id
p_sa_AdGroupConversionActionAndDeviceStats_customer_id
p_sa_AdGroupDeviceStats_customer_id
p_sa_AdGroupStats_customer_id
觀看次數:
sa_AdGroup_customer_id
sa_AdGroupConversionActionAndDeviceStats_customer_id
sa_AdGroupDeviceStats_customer_id
sa_AdGroupStats_customer_id

ad_group_ad

ad_group_ad

表格:
p_sa_Ad_customer_id
p_sa_AdConversionActionAndDeviceStats_customer_id
p_sa_AdDeviceStats_customer_id
觀看次數:
a_Ad_customer_id
sa_AdConversionActionAndDeviceStats_customer_id
sa_AdDeviceStats_customer_id

ad_group_asset

ad_group_asset

表格:
p_sa_AdGroupAssetStats_customer_id
p_sa_AdGroupConversionActionAndAssetStats_customer_id
觀看次數:
sa_AdGroupAssetStats_customer_id
sa_AdGroupConversionActionAndAssetStats_customer_id

ad_group_audience_view

ad_group_audience_view

表格:
p_sa_AdGroupAudienceConversionActionAndDeviceStats_customer_id
p_sa_AdGroupAudienceDeviceStats_customer_id
觀看次數:
sa_AdGroupAudienceConversionActionAndDeviceStats_customer_id
sa_AdGroupAudienceDeviceStats_customer_id

ad_group_criterion

ad_group_criterion

表格:
p_sa_AdGroupCriterion_customer_id
p_sa_NegativeAdGroupCriterion_customer_id
p_sa_NegativeAdGroupKeyword_customer_id
觀看次數:
sa_AdGroupCriterion_customer_id
sa_NegativeAdGroupCriterion_customer_id
sa_NegativeAdGroupKeyword_customer_id

ad_group_label

ad_group_label

表格:
p_sa_AdGroupLabel_customer_id
觀看次數:
sa_AdGroupLabel_customer_id

age_range_view

age_range_view

表格:
p_sa_AgeRangeConversionActionAndDeviceStats_customer_id
p_sa_AgeRangeDeviceStats_customer_id
觀看次數:
sa_AgeRangeConversionActionAndDeviceStats_customer_id
sa_AgeRangeDeviceStats_customer_id

資產

asset

表格:
p_sa_Asset_customer_id
觀看次數:
sa_Asset_customer_id

asset_set_asset

asset_set_asset

表格:
p_sa_AccountConversionActionAndAssetStats_customer_id
p_sa_AssetSetStats_customer_id
觀看次數:
sa_AccountConversionActionAndAssetStats_customer_id
sa_AssetSetStats_customer_id

bidding_strategy

bidding_strategy

表格:
p_sa_BidStrategy_customer_id
p_sa_BidStrategyStats_customer_id
觀看次數:
sa_BidStrategy_customer_id
sa_BidStrategyStats_customer_id

廣告活動

廣告活動

表格:
p_sa_Campaign_customer_id
p_sa_CampaignConversionActionAndDeviceStats_customer_id
p_sa_CampaignDeviceStats_customer_id
p_sa_CampaignStats_customer_id
觀看次數:
sa_Campaign_customer_id
sa_CampaignConversionActionAndDeviceStats_customer_id
sa_CampaignDeviceStats_customer_id
sa_CampaignStats_customer_id

campaign_asset

campaign_asset

表格:
p_sa_CampaignAssetStats_customer_id
p_sa_CampaignConversionActionAndAssetStats_customer_id
觀看次數:
sa_CampaignAssetStats_customer_id
sa_CampaignConversionActionAndAssetStats_customer_id

campaign_audience_view

campaign_audience_view

表格:
p_sa_CampaignAudienceConversionActionAndDeviceStats_customer_id
p_sa_CampaignAudienceDeviceStats_customer_id
觀看次數:
sa_CampaignAudienceConversionActionAndDeviceStats_customer_id
sa_CampaignAudienceDeviceStats_customer_id

campaign_criterion

campaign_criterion

表格:
p_sa_CampaignCriterion_customer_id
p_sa_NegativeCampaignCriterion_customer_id
p_sa_NegativeCampaignKeyword_customer_id
觀看次數:
sa_CampaignCriterion_customer_id
sa_NegativeCampaignCriterion_customer_id
sa_NegativeCampaignKeyword_customer_id

campaign_label

campaign_label

表格:
p_sa_CampaignLabel_customer_id
觀看次數:
sa_CampaignLabel_customer_id

cart_data_sales_view

cart_data_sales_view

表格:
p_sa_CartDataSalesStats_customer_id
觀看次數:
sa_CartDataSalesStats_customer_id

轉換

轉換

表格:
p_sa_Conversion_customer_id
觀看次數:
sa_Conversion_customer_id

conversion_action

conversion_action

表格:
p_sa_ConversionAction_customer_id
觀看次數:
sa_ConversionAction_customer_id

客戶

客戶

表格:
p_sa_Account_customer_id
p_sa_AccountConversionActionAndDeviceStats_customer_id
p_sa_AccountDeviceStats_customer_id
p_sa_AccountStats_customer_id
觀看次數:
sa_Account_customer_id
sa_AccountConversionActionAndDeviceStats_customer_id
sa_AccountDeviceStats_customer_id
sa_AccountStats_customer_id

customer_asset

customer_asset

表格:
p_sa_AccountAssetStats_customer_id
觀看次數:
sa_AccountAssetStats_customer_id

gender_view

gender_view

表格:
p_sa_GenderConversionActionAndDeviceStats_customer_id
p_sa_GenderDeviceStats_customer_id
觀看次數:
sa_GenderConversionActionAndDeviceStats_customer_id
sa_GenderDeviceStats_customer_id

keyword_view

keyword_view

表格:
p_sa_Keyword_customer_id
p_sa_KeywordConversionActionAndDeviceStats_customer_id
p_sa_KeywordDeviceStats_customer_id
p_sa_KeywordStats_customer_id
觀看次數:
sa_Keyword_customer_id
sa_KeywordConversionActionAndDeviceStats_customer_id
sa_KeywordDeviceStats_customer_id
sa_KeywordStats_customer_id

location_view

location_view

表格:
p_sa_LocationConversionActionAndDeviceStats_customer_id
p_sa_LocationDeviceStats_customer_id
觀看次數:
sa_LocationConversionActionAndDeviceStats_customer_id
sa_LocationDeviceStats_customer_id

product_group_view

product_group_view

表格:
p_sa_ProductGroup_customer_id
p_sa_ProductGroupStats_customer_id
觀看次數:
sa_ProductGroup_customer_id
sa_ProductGroupStats_customer_id

shopping_performance_view

shopping_performance_view

表格:
p_sa_ProductAdvertised_customer_id
p_sa_ProductAdvertisedConversionActionAndDeviceStats_customer_id
p_sa_ProductAdvertisedDeviceStats_customer_id
觀看次數:
sa_ProductAdvertised_customer_id
sa_ProductAdvertisedConversionActionAndDeviceStats_customer_id
sa_ProductAdvertisedDeviceStats_customer_id

拜訪

造訪

表格:
p_sa_Visit_customer_id
觀看次數:
sa_Visit_customer_id

webpage_view

webpage_view

表格:
p_sa_WebpageConversionActionAndDeviceStats_customer_id
p_sa_WebpageDeviceStats_customer_id
觀看次數:
sa_WebpageConversionActionAndDeviceStats_customer_id
sa_WebpageDeviceStats_customer_id

Search Ads 360 報表的資料欄詳細資料

Search Ads 360 移轉作業建立的 BigQuery 資料表是由下列資料欄 (欄位) 組成:

Search Ads 360 表格名稱:帳戶

Search Ads 360 API 資源:customer

Search Ads 360 欄位名稱說明
customer_account_level 客戶的帳戶層級:管理員、副管理員、助理管理員或服務帳戶。
customer_account_type 引擎帳戶類型。例如:Google Ads、Microsoft Advertising、Yahoo Japan、百度、Facebook、Engine Track。
customer_creation_time 這個顧客的建立時間戳記。時間戳記採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss」。
customer_currency_code 帳戶使用的幣別。系統支援 ISO 4217 標準中的部分貨幣代碼。
customer_descriptive_name 選填,可重複的客戶說明名稱。
customer_manager_descriptive_name 管理員的描述性名稱。
customer_sub_manager_descriptive_name 副管理員的描述性名稱。
customer_associate_manager_descriptive_name 副理的描述性名稱。
customer_engine_id 外部引擎帳戶中的帳戶 ID。
customer_id 顧客 ID。
customer_manager_id 管理員的客戶 ID。
customer_sub_manager_id 副管理員的客戶 ID。
customer_associate_manager_id 關聯管理員的客戶 ID。
customer_last_modified_time 上次修改這個客戶的日期和時間。日期時間採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
customer_status 顧客狀態。
customer_time_zone 顧客的當地時區 ID。

Search Ads 360 表格名稱:AccountAssetStats

Search Ads 360 API 資源:customer_asset

Search Ads 360 欄位名稱說明
customer_asset_asset 這是必要旗標,不可變更。與客戶連結的資產。
customer_id 顧客 ID。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_average_cpm 平均千次曝光出價。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17

Search Ads 360 表格名稱:AccountConversionActionAndAssetStats

Search Ads 360 API 資源:asset_set_asset

Search Ads 360 欄位名稱說明
asset_set_asset_asset 不可變更。這個素材資源組合素材資源連結的素材資源。
asset_set_asset_asset_set 不可變更。這個素材資源組合素材資源連結的素材資源組合。
customer_id 顧客 ID。
metrics_all_conversions 轉換總次數。包括所有轉換,不論 include_in_conversions_metric 的值為何。
metrics_all_conversions_value 所有轉換的價值。
metrics_cross_device_conversions 顧客在某裝置上點按廣告,然後使用其他裝置或瀏覽器完成轉換。「所有轉換」欄已納入跨裝置轉換。
metrics_cross_device_conversions_value 跨裝置轉換價值的總和。
segments.conversion_action_name 轉換動作名稱。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17

Search Ads 360 表格名稱:AccountConversionActionAndDeviceStats

Search Ads 360 API 資源:customer

Search Ads 360 欄位名稱說明
customer_engine_id 外部引擎帳戶中的帳戶 ID。
customer_id 顧客 ID。
metrics_all_conversions 轉換總次數。包括所有轉換,不論 include_in_conversions_metric 的值為何。
metrics_all_conversions_value 所有轉換的價值。
metrics_cross_device_conversions 顧客在某裝置上點按廣告,然後使用其他裝置或瀏覽器完成轉換。「所有轉換」欄已納入跨裝置轉換。
metrics_cross_device_conversions_value 跨裝置轉換價值的總和。
segments.conversion_action_name 轉換動作名稱。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:AccountDeviceStats

Search Ads 360 API 資源:customer

Search Ads 360 欄位名稱說明
customer_engine_id 外部引擎帳戶中的帳戶 ID。
customer_id 顧客 ID。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_average_cpm 平均千次曝光出價。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_view_through_conversions 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後卻在您的網站上完成轉換,就會計為瀏覽後轉換。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
metrics_visits Search Ads 360 成功記錄並轉送至廣告主到達網頁的點擊次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:AccountStats

Search Ads 360 API 資源:customer

Search Ads 360 欄位名稱說明
customer_engine_id 外部引擎帳戶中的帳戶 ID。
customer_id 顧客 ID。
metrics_content_budget_lost_impression_share 廣告符合在搜尋聯播網上顯示的資格,但因預算過低而未顯示的次數百分比 (估計值)。注意:搜尋預算錯失的曝光比重會以 0 到 0.9 的範圍回報。任何大於 0.9 的值都會回報為 0.9001。
metrics_content_impression_share 將您在多媒體廣告聯播網上獲得的曝光次數,除以預估可獲得的曝光次數後所得出的百分比。注意:內容曝光比重的報表範圍為 0.1 到 1。如果值低於 0.1,系統會回報為 0.0999。
metrics_content_rank_lost_impression_share 廣告因為廣告評級偏低,而錯失多媒體廣告聯播網曝光次數的預估百分比。注意:內容排名錯失的曝光比重會回報在 0 到 0.9 的範圍內。任何大於 0.9 的值都會回報為 0.9001。
metrics_historical_quality_score 歷來品質分數。
metrics_search_budget_lost_impression_share 廣告符合在搜尋聯播網上顯示的資格,但因預算過低而未顯示的次數百分比 (估計值)。注意:搜尋預算錯失的曝光比重會以 0 到 0.9 的範圍回報。任何大於 0.9 的值都會回報為 0.9001。
metrics_search_impression_share 此欄是將您在搜尋聯播網上獲得的曝光次數,除以預估可獲得的曝光次數後,所得到的百分比。注意:搜尋曝光比重的報表範圍為 0.1 至 1。如果值低於 0.1,系統會回報為 0.0999。
metrics_search_rank_lost_impression_share 廣告因為廣告評級偏低,而錯失搜尋聯播網曝光次數的預估百分比。注意:搜尋聯播網錯失的曝光比重 (排名) 的回報範圍為 0 到 0.9。任何大於 0.9 的值都會回報為 0.9001。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17

Search Ads 360 表格名稱:廣告

Search Ads 360 API 資源:ad_group_ad

Search Ads 360 欄位名稱說明
ad_group_ad_ad_display_url 部分廣告格式的廣告說明中顯示的網址。
ad_group_ad_ad_expanded_dynamic_search_ad_description1 廣告說明的第一行。
ad_group_ad_ad_expanded_dynamic_search_ad_description2 廣告說明的第二行。
ad_group_ad_ad_expanded_text_ad_description1 廣告說明的第一行。
ad_group_ad_ad_expanded_text_ad_description2 廣告說明的第二行。
ad_group_ad_ad_expanded_text_ad_headline 廣告標題。
ad_group_ad_ad_expanded_text_ad_headline2 廣告的第二個標題。
ad_group_ad_ad_expanded_text_ad_headline3 廣告的第三個標題。
ad_group_ad_ad_final_urls 廣告在所有跨網域重新導向後可能連到的最終到達網址清單。
ad_group_ad_ad_id 廣告的 ID。
ad_group_ad_ad_name 廣告的名稱。這項資訊僅用於識別廣告。這個名稱不必是專屬名稱,也不會影響放送的廣告。目前只有 DisplayUploadAd、ImageAd、ShoppingComparisonListingAd 和 VideoAd 支援名稱欄位。
ad_group_ad_ad_text_ad_description1 廣告說明的第一行。
ad_group_ad_ad_text_ad_description2 廣告說明的第二行。
ad_group_ad_ad_text_ad_headline 廣告標題。
ad_group_ad_ad_type 廣告類型。
ad_group_ad_creation_time 建立這個廣告群組廣告的時間戳記。日期時間採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
ad_group_ad_engine_id 外部引擎帳戶中的廣告 ID。這個欄位僅適用於 Search Ads 360 帳戶。例如:Yahoo Japan、Microsoft、百度。如為非 Search Ads 360 實體,請改用「ad_group_ad.ad.id」。
ad_group_ad_engine_status 外部引擎帳戶中廣告的額外狀態。可能狀態 (視外部帳戶類型而定) 包括有效、符合資格、待審查。
ad_group_ad_labels 附加至這個廣告群組廣告的標籤資源名稱。
ad_group_ad_last_modified_time 上次修改這個廣告群組廣告的日期和時間。日期時間採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
ad_group_ad_status 廣告的狀態。
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。

Search Ads 360 表格名稱:AdConversionActionAndDeviceStats

Search Ads 360 API 資源:ad_group_ad

Search Ads 360 欄位名稱說明
ad_group_ad_ad_id 廣告的 ID。
ad_group_ad_engine_id 外部引擎帳戶中的廣告 ID。這個欄位僅適用於 Search Ads 360 帳戶。例如:Yahoo Japan、Microsoft、百度。如為非 Search Ads 360 實體,請改用「ad_group_ad.ad.id」。
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_all_conversions 轉換總次數。包括所有轉換,不論 include_in_conversions_metric 的值為何。
metrics_all_conversions_by_conversion_date 轉換總次數。包括所有轉換,不論 include_in_conversions_metric 的值為何。如果選取這個資料欄和日期,日期資料欄中的值就是轉換日期。如要進一步瞭解 by_conversion_date 欄,請參閱「關於『所有轉換』欄」一文。
metrics_all_conversions_value 所有轉換的價值。
metrics_all_conversions_value_by_conversion_date 所有轉換的價值。如果選取這個資料欄和日期,日期資料欄中的值就是轉換日期。如要進一步瞭解 by_conversion_date 欄,請參閱「關於『所有轉換』欄」一文。
metrics_cross_device_conversions 顧客在某裝置上點按廣告,然後使用其他裝置或瀏覽器完成轉換。「所有轉換」欄已納入跨裝置轉換。
metrics_cross_device_conversions_by_conversion_date 依轉換日期計算的跨裝置轉換次數。如要進一步瞭解 by_conversion_date 欄,請參閱「關於『所有轉換』欄」一文。
metrics_cross_device_conversions_value 跨裝置轉換價值的總和。
metrics_cross_device_conversions_value_by_conversion_date 依轉換日期計算的跨裝置轉換價值總和。如要進一步瞭解 by_conversion_date 欄,請參閱「關於『所有轉換』欄」一文。
segments.conversion_action_name 轉換動作名稱。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:AdDeviceStats

Search Ads 360 API 資源:ad_group_ad

Search Ads 360 欄位名稱說明
ad_group_ad_ad_id 廣告的 ID。
ad_group_ad_engine_id 外部引擎帳戶中的廣告 ID。這個欄位僅適用於 Search Ads 360 帳戶。例如:Yahoo Japan、Microsoft、百度。如為非 Search Ads 360 實體,請改用「ad_group_ad.ad.id」。
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_average_cpm 平均千次曝光出價。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_view_through_conversions 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後卻在您的網站上完成轉換,就會計為瀏覽後轉換。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
metrics_visits Search Ads 360 成功記錄並轉送至廣告主到達網頁的點擊次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:AdGroup

Search Ads 360 API 資源:ad_group

Search Ads 360 欄位名稱說明
ad_group_bid_modifier_bid_modifier 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。PreferredContent 的範圍為 1.0 至 6.0。使用 0 即可選擇不使用裝置類型。
ad_group_bid_modifier_device_type 裝置的類型。
ad_group_cpc_bid_micros 最高單次點擊出價。
ad_group_creation_time 這個廣告群組的建立時間戳記。時間戳記採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss」。
ad_group_end_date 廣告群組停止放送廣告的日期。根據預設,廣告群組會在廣告群組結束日期結束。如果設定這個欄位,廣告群組會在客戶時區的指定日期結束時停止放送。這個欄位僅適用於 Microsoft Advertising 和 Facebook 閘道帳戶。格式:YYYY-MM-DD 範例:2019-03-14
ad_group_engine_id 外部引擎帳戶中的廣告群組 ID。這個欄位僅適用於非 Google Ads 帳戶。例如:Yahoo Japan、Microsoft、百度。如果是 Google Ads 實體,請改用「ad_group.id」。
ad_group_engine_status 廣告群組的引擎狀態。
ad_group_id 廣告群組的 ID。
ad_group_labels 附加至這個廣告群組的標籤資源名稱。
ad_group_language_code 廣告群組中廣告和關鍵字的語言。這個欄位僅適用於 Microsoft Advertising 帳戶。
ad_group_last_modified_time 這個廣告群組上次修改的日期時間。日期時間採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
ad_group_name 廣告群組的名稱。建立新廣告群組時,這個欄位為必填,且不得為空白。長度不得超過 255 個 UTF-8 全形字元。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。
ad_group_start_date 這個廣告群組開始放送廣告的日期。根據預設,廣告群組會立即開始放送,或在廣告群組的開始日期開始放送 (以較晚者為準)。如果設定這個欄位,廣告群組會在客戶時區中指定日期的開頭開始放送。這個欄位僅適用於 Microsoft Advertising 和 Facebook 閘道帳戶。格式:YYYY-MM-DD 範例:2019-03-14
ad_group_status 廣告群組的狀態。
ad_group_targeting_setting_target_restrictions 限制廣告活動或廣告群組觸及範圍的指定維度設定。
bidding_strategy_id 出價策略的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。

Search Ads 360 表格名稱:AdGroupAssetStats

Search Ads 360 API 資源:ad_group_asset

Search Ads 360 欄位名稱說明
ad_group_asset_ad_group 這是必要旗標,不可變更。素材資源連結的廣告群組。
ad_group_asset_asset 這是必要旗標,不可變更。連結至廣告群組的素材資源。
ad_group_engine_id 外部引擎帳戶中的廣告群組 ID。這個欄位僅適用於非 Google Ads 帳戶。例如:Yahoo Japan、Microsoft、百度。如果是 Google Ads 實體,請改用「ad_group.id」。
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_average_cpm 平均千次曝光出價。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17

Search Ads 360 表格名稱:AdGroupAudienceConversionActionAndDeviceStats

Search Ads 360 API 資源:ad_group_audience_view

Search Ads 360 欄位名稱說明
ad_group_criterion_age_range_type 年齡層類型。
ad_group_criterion_bid_modifier 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援調節係數。
ad_group_criterion_cpc_bid_micros 單次點擊出價。
ad_group_criterion_criterion_id 指定條件的 ID。
ad_group_criterion_gender_type 性別類型。
ad_group_criterion_location_geo_target_constant 地理目標常數資源名稱。
ad_group_criterion_user_list_user_list 使用者名單資源名稱。
ad_group_criterion_webpage_conditions 網頁指定目標的條件或邏輯運算式。評估網頁指定目標時,系統會將網頁指定目標條件清單以 AND 運算子連結。如果條件清單為空白,表示廣告活動網站的所有網頁都會成為指定目標。建立作業必須填寫這個欄位,更新作業則不得填寫。
ad_group_criterion_webpage_coverage_percentage 網站條件涵蓋率百分比。這是根據廣告群組和廣告活動中的網站目標、排除網站目標和排除關鍵字,計算出的網站涵蓋率百分比。舉例來說,如果涵蓋範圍傳回 1,表示涵蓋範圍為 100%。
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_cross_device_conversions 顧客在某裝置上點按廣告,然後使用其他裝置或瀏覽器完成轉換。「所有轉換」欄已納入跨裝置轉換。
metrics_cross_device_conversions_value 跨裝置轉換價值的總和。
segments.conversion_action_name 轉換動作名稱。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17。
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:AdGroupAudienceDeviceStats

Search Ads 360 API 資源:ad_group_audience_view

Search Ads 360 欄位名稱說明
ad_group_criterion_age_range_type 年齡層類型。
ad_group_criterion_bid_modifier 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援調節係數。
ad_group_criterion_cpc_bid_micros 單次點擊出價。
ad_group_criterion_criterion_id 指定條件的 ID。
ad_group_criterion_gender_type 性別類型。
ad_group_criterion_location_geo_target_constant 地理目標常數資源名稱。
ad_group_criterion_user_list_user_list 使用者名單資源名稱。
ad_group_criterion_webpage_conditions 網頁指定目標的條件或邏輯運算式。評估網頁指定目標時,系統會將網頁指定目標條件清單以 AND 運算子連結。如果條件清單為空白,表示廣告活動網站的所有網頁都會成為指定目標。建立作業必須填寫這個欄位,更新作業則不得填寫。
ad_group_criterion_webpage_coverage_percentage 網站條件涵蓋率百分比。這是根據廣告群組和廣告活動中的網站目標、排除網站目標和排除關鍵字,計算出的網站涵蓋率百分比。舉例來說,如果涵蓋範圍傳回 1,表示涵蓋範圍為 100%。
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_average_cpm 平均千次曝光出價。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_view_through_conversions 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後卻在您的網站上完成轉換,就會計為瀏覽後轉換。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:AdGroupConversionActionAndAssetStats

Search Ads 360 API 資源:ad_group_asset

Search Ads 360 欄位名稱說明
ad_group_asset_ad_group 這是必要旗標,不可變更。素材資源連結的廣告群組。
ad_group_asset_asset 這是必要旗標,不可變更。連結至廣告群組的素材資源。
ad_group_engine_id 外部引擎帳戶中的廣告群組 ID。這個欄位僅適用於非 Google Ads 帳戶。例如:Yahoo Japan、Microsoft、百度。如果是 Google Ads 實體,請改用「ad_group.id」。
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_all_conversions 轉換總次數。包括所有轉換,不論 include_in_conversions_metric 的值為何。
metrics_all_conversions_value 所有轉換的價值。
metrics_cross_device_conversions 顧客在某裝置上點按廣告,然後使用其他裝置或瀏覽器完成轉換。「所有轉換」欄已納入跨裝置轉換。
metrics_cross_device_conversions_value 跨裝置轉換價值的總和。
segments.conversion_action_name 轉換動作名稱。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2018-04-17

Search Ads 360 表格名稱:AdGroupConversionActionAndDeviceStats

Search Ads 360 API 資源:ad_group

Search Ads 360 欄位名稱說明
ad_group_engine_id 僅供輸出。外部引擎帳戶中的廣告群組 ID。這個欄位僅適用於非 Google Ads 帳戶。例如:Yahoo Japan、Microsoft、百度。如果是 Google Ads 實體,請改用「ad_group.id」。
ad_group_id 僅供輸出。廣告群組的 ID。
bidding_strategy_id 僅供輸出。出價策略的 ID。
campaign_id 僅供輸出。廣告活動的 ID。
customer_id 僅供輸出。顧客 ID。
metrics_all_conversions 轉換總次數。包括所有轉換,不論 include_in_conversions_metric 的值為何。
metrics_all_conversions_value 所有轉換的價值。
metrics_cross_device_conversions 顧客在某裝置上點按廣告,然後使用其他裝置或瀏覽器完成轉換。「所有轉換」欄已納入跨裝置轉換。
metrics_cross_device_conversions_value 跨裝置轉換價值的總和。
segments.conversion_action_name 轉換動作名稱。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:AdGroupCriterion

Search Ads 360 API 資源:ad_group_criterion

Search Ads 360 欄位名稱說明
ad_group_criterion_age_range_type 年齡層類型。
ad_group_criterion_bid_modifier 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援調節係數。
ad_group_criterion_cpc_bid_micros 單次點擊出價。
ad_group_criterion_creation_time 這個廣告群組條件的建立時間戳記。時間戳記採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss」。
ad_group_criterion_criterion_id 指定條件的 ID。
ad_group_criterion_gender_type 性別類型。
ad_group_criterion_last_modified_time 上次修改這個廣告群組條件的日期時間。日期時間採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
ad_group_criterion_location_geo_target_constant 地理目標常數資源名稱。
ad_group_criterion_status 條件的狀態。這是由用戶端設定的廣告群組條件實體狀態。注意:使用者介面報表可能會納入其他資訊,影響條件是否符合放送資格。在某些情況下,即使透過 API 移除條件,該條件在使用者介面中仍可能顯示為已啟用。舉例來說,除非排除,否則廣告活動預設會向所有年齡層的使用者顯示。由於這些年齡層有資格觀看廣告,使用者介面會將每個年齡層顯示為「已啟用」;但由於未新增任何正向條件,AdGroupCriterion.status 會顯示「已移除」。
ad_group_criterion_type 條件類型。
ad_group_criterion_user_list_user_list 使用者名單資源名稱。
ad_group_criterion_webpage_conditions 網頁指定目標的條件或邏輯運算式。評估網頁指定目標時,系統會將網頁指定目標條件清單以 AND 運算子連結。如果條件清單為空白,表示廣告活動網站的所有網頁都會成為指定目標。建立作業必須填寫這個欄位,更新作業則不得填寫。
ad_group_criterion_webpage_coverage_percentage 網站條件涵蓋率百分比。這是根據廣告群組和廣告活動中的網站目標、排除網站目標和排除關鍵字,計算出的網站涵蓋率百分比。舉例來說,如果涵蓋範圍傳回 1,表示涵蓋範圍為 100%。
ad_group_id 廣告群組的 ID。
ad_group_name 廣告群組的名稱。建立新廣告群組時,這個欄位為必填,且不得為空白。長度不得超過 255 個 UTF-8 全形字元。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。
ad_group_status 廣告群組的狀態。
campaign_id 廣告活動的 ID。
campaign_name 廣告活動名稱。建立新廣告活動時,這個欄位為必填,且不得為空白。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。
campaign_status 廣告活動的狀態。
customer_account_type 引擎帳戶類型。例如:Google Ads、Microsoft Advertising、Yahoo Japan、百度、Facebook、Engine Track。
customer_descriptive_name 選填,可重複的客戶說明名稱。
customer_id 顧客 ID。

Search Ads 360 表格名稱:AdGroupDeviceStats

Search Ads 360 API 資源:ad_group

Search Ads 360 欄位名稱說明
ad_group_engine_id 外部引擎帳戶中的廣告群組 ID。這個欄位僅適用於非 Google Ads 帳戶。例如:Yahoo Japan、Microsoft、百度。如果是 Google Ads 實體,請改用「ad_group.id」。
ad_group_id 廣告群組的 ID。
bidding_strategy_id 出價策略的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_average_cpm 平均千次曝光出價。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_view_through_conversions 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後卻在您的網站上完成轉換,就會計為瀏覽後轉換。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
metrics_visits Search Ads 360 成功記錄並轉送至廣告主到達網頁的點擊次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:AdGroupLabel

Search Ads 360 API 資源:ad_group_label

Search Ads 360 欄位名稱說明
ad_group_label_ad_group 標籤附加的廣告群組。
ad_group_label_label 指派給廣告群組的標籤。
ad_group_label_owner_customer_id 擁有標籤的客戶 ID。
ad_group_label_resource_name 廣告群組標籤的資源名稱。廣告群組標籤資源名稱的格式為:customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。

Search Ads 360 表格名稱:AdGroupStats

Search Ads 360 API 資源:ad_group

Search Ads 360 欄位名稱說明
ad_group_engine_id 外部引擎帳戶中的廣告群組 ID。這個欄位僅適用於非 Google Ads 帳戶。例如:Yahoo Japan、Microsoft、百度。如果是 Google Ads 實體,請改用「ad_group.id」。
ad_group_id 廣告群組的 ID。
bidding_strategy_id 出價策略的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_content_impression_share 將您在多媒體廣告聯播網上獲得的曝光次數,除以預估可獲得的曝光次數後所得出的百分比。注意:內容曝光比重的報表範圍為 0.1 到 1。如果值低於 0.1,系統會回報為 0.0999。
metrics_content_rank_lost_impression_share 廣告因為廣告評級偏低,而錯失多媒體廣告聯播網曝光次數的預估百分比。注意:內容排名錯失的曝光比重會回報在 0 到 0.9 的範圍內。任何大於 0.9 的值都會回報為 0.9001。
metrics_historical_quality_score 歷來品質分數。
metrics_search_impression_share 此欄是將您在搜尋聯播網上獲得的曝光次數,除以預估可獲得的曝光次數後,所得到的百分比。注意:搜尋曝光比重的報表範圍為 0.1 至 1。如果值低於 0.1,系統會回報為 0.0999。
metrics_search_rank_lost_impression_share 廣告因為廣告評級偏低,而錯失搜尋聯播網曝光次數的預估百分比。注意:搜尋聯播網錯失的曝光比重 (排名) 的回報範圍為 0 到 0.9。任何大於 0.9 的值都會回報為 0.9001。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17。

Search Ads 360 表格名稱:AgeRangeConversionActionAndDeviceStats

Search Ads 360 API 資源:age_range_view

Search Ads 360 欄位名稱說明
ad_group_criterion_age_range_type 年齡層類型。
ad_group_criterion_bid_modifier 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援調節係數。
ad_group_criterion_cpc_bid_micros 單次點擊出價。
ad_group_criterion_criterion_id 指定條件的 ID。
ad_group_criterion_gender_type 性別類型。
ad_group_criterion_location_geo_target_constant 地理目標常數資源名稱。
ad_group_criterion_user_list_user_list 使用者名單資源名稱。
ad_group_criterion_webpage_conditions 網頁指定目標的條件或邏輯運算式。評估網頁指定目標時,系統會將網頁指定目標條件清單以 AND 運算子連結。如果條件清單為空白,表示廣告活動網站的所有網頁都會成為指定目標。建立作業必須填寫這個欄位,更新作業則不得填寫。
ad_group_criterion_webpage_coverage_percentage 網站條件涵蓋率百分比。這是根據廣告群組和廣告活動中的網站目標、排除網站目標和排除關鍵字,計算出的網站涵蓋率百分比。舉例來說,如果涵蓋範圍傳回 1,表示涵蓋範圍為 100%。
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_cross_device_conversions 顧客在某裝置上點按廣告,然後使用其他裝置或瀏覽器完成轉換。「所有轉換」欄已納入跨裝置轉換。
metrics_cross_device_conversions_value 跨裝置轉換價值的總和。
segments.conversion_action_name 轉換動作名稱。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:AgeRangeDeviceStats

Search Ads 360 API 資源:age_range_view

Search Ads 360 欄位名稱說明
ad_group_criterion_age_range_type 年齡層類型。
ad_group_criterion_bid_modifier 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援調節係數。
ad_group_criterion_cpc_bid_micros 單次點擊出價。
ad_group_criterion_criterion_id 指定條件的 ID。
ad_group_criterion_gender_type 性別類型。
ad_group_criterion_location_geo_target_constant 地理目標常數資源名稱。
ad_group_criterion_user_list_user_list 使用者名單資源名稱。
ad_group_criterion_webpage_conditions 網頁指定目標的條件或邏輯運算式。評估網頁指定目標時,系統會將網頁指定目標條件清單以 AND 運算子連結。如果條件清單為空白,表示廣告活動網站的所有網頁都會成為指定目標。建立作業必須填寫這個欄位,更新作業則不得填寫。
ad_group_criterion_webpage_coverage_percentage 網站條件涵蓋率百分比。這是根據廣告群組和廣告活動中的網站目標、排除網站目標和排除關鍵字,計算出的網站涵蓋率百分比。舉例來說,如果涵蓋範圍傳回 1,表示涵蓋範圍為 100%。
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_average_cpm 平均千次曝光出價。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_view_through_conversions 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後卻在您的網站上完成轉換,就會計為瀏覽後轉換。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:資產

Search Ads 360 API 資源:asset

Search Ads 360 欄位名稱說明
asset_creation_time 這項資產的建立時間戳記。時間戳記採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss」。
asset_engine_status 資產的引擎狀態。
asset_final_urls 所有跨網域重新導向後可能的最終到達網址清單。
asset_id 資產的 ID。
asset_last_modified_time 這項資產的上次修改日期和時間。日期時間採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
asset_sitelink_asset.description1 網站連結說明的第一行。如要設定,長度應介於 1 至 35 之間 (含首尾),且必須同時設定 description2。
asset_sitelink_asset.description2 網站連結的第二行說明。如要設定,長度應介於 1 到 35 之間 (含首尾),且必須同時設定 description1。
asset_sitelink_asset_link_text 網站連結的網址顯示文字。這個字串的長度應介於 1 到 25 個字元之間 (含首尾)。
asset_status 資產狀態。
asset_tracking_url_template 用於建構追蹤網址的網址範本。
customer_id 顧客 ID。

Search Ads 360 表格名稱:AssetSetStats

Search Ads 360 API 資源:asset_set_asset

Search Ads 360 欄位名稱說明
asset_set_asset_asset 不可變更。這個素材資源組合素材資源連結的素材資源。
asset_set_asset_asset_set 不可變更。這個素材資源組合素材資源連結的素材資源組合。
customer_id 顧客 ID。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_average_cpm 平均千次曝光出價。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17

Search Ads 360 表格名稱:BidStrategy

Search Ads 360 API 資源:bidding_strategy

Search Ads 360 欄位名稱說明
bidding_strategy_id 出價策略的 ID。
bidding_strategy_name 出價策略的名稱。帳戶中的所有出價策略都必須有不同的名稱。這個字串的長度應介於 1 到 255 個 UTF-8 位元組之間 (含首尾),且經過修剪。
bidding_strategy_status 出價策略的狀態。
bidding_strategy_target_cpa_cpc_bid_ceiling_micros 出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。這項設定僅適用於組合出價策略。
bidding_strategy_target_cpa_cpc_bid_floor_micros 出價策略可設定的最低出價限制。這項限制適用於策略管理的所有關鍵字。這項設定僅適用於組合出價策略。
bidding_strategy_target_cpa_target_cpa_micros 平均單次動作出價目標。這個目標應大於或等於帳戶幣別的最低計費單位。
bidding_strategy_target_impression_share_cpc_bid_ceiling_micros 自動出價系統可指定的最高單次點擊出價。這是廣告主輸入的必填欄位,用於設定上限,並在當地微區域中指定。
bidding_strategy_target_outrank_share_cpc_bid_ceiling_micros 出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。
bidding_strategy_target_roas_cpc_bid_ceiling_micros 出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。這項設定僅適用於組合出價策略。
bidding_strategy_target_roas_cpc_bid_floor_micros 出價策略可設定的最低出價限制。這項限制適用於策略管理的所有關鍵字。這項設定僅適用於組合出價策略。
bidding_strategy_target_roas_target_roas 根據轉換資料計算,每單位支出的收益。值必須介於 0.01 至 1000.0 之間 (含)。
bidding_strategy_target_spend_cpc_bid_ceiling_micros 出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。
bidding_strategy_target_spend_target_spend_micros 盡量爭取點擊的支出目標。出價工具會盡量花費這個值或自然節流支出金額中較小的金額。如未指定,系統會將預算做為支出目標。這個欄位已淘汰,不應再使用。
segments_conversion_action 轉換動作的資源名稱。

Search Ads 360 表格名稱:BidStrategyStats

Search Ads 360 API 資源:bidding_strategy

Search Ads 360 欄位名稱說明
bidding_strategy_id 出價策略的 ID。
metrics_all_conversions 轉換總次數。包括所有轉換,不論 include_in_conversions_metric 的值為何。
metrics_all_conversions_by_conversion_date 轉換總次數。包括所有轉換,不論 include_in_conversions_metric 的值為何。如果選取這個資料欄和日期,日期資料欄中的值就是轉換日期。如要進一步瞭解 by_conversion_date 欄,請參閱「關於『所有轉換』欄」一文。
metrics_all_conversions_value 所有轉換的價值。
metrics_all_conversions_value_by_conversion_date 所有轉換的價值。如果選取這個資料欄和日期,日期資料欄中的值就是轉換日期。如要進一步瞭解 by_conversion_date 欄,請參閱「關於『所有轉換』欄」一文。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_average_cpm 平均千次曝光出價。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_view_through_conversions 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後卻在您的網站上完成轉換,就會計為瀏覽後轉換。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_cross_device_conversions 顧客在某裝置上點按廣告,然後使用其他裝置或瀏覽器完成轉換。「所有轉換」欄已納入跨裝置轉換。
metrics_cross_device_conversions_by_conversion_date 依轉換日期計算的跨裝置轉換次數。如要進一步瞭解 by_conversion_date 欄,請參閱「關於『所有轉換』欄」一文。
metrics_cross_device_conversions_value 跨裝置轉換價值的總和。
metrics_cross_device_conversions_value_by_conversion_date 依轉換日期計算的跨裝置轉換價值總和。如要進一步瞭解 by_conversion_date 欄,請參閱「關於『所有轉換』欄」一文。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17

Search Ads 360 表格名稱:廣告活動

Search Ads 360 API 資源:campaign

Search Ads 360 欄位名稱說明
accessible_bidding_strategy_id 出價策略的 ID。
accessible_bidding_strategy_name 出價策略的名稱。
bidding_strategy_id 出價策略的 ID。
bidding_strategy_name 出價策略的名稱。帳戶中的所有出價策略都必須有不同的名稱。這個字串的長度應介於 1 到 255 個 UTF-8 位元組之間 (含首尾),且經過修剪。
campaign_advertising_channel_sub_type 廣告管道類型可選填的精細程度。必須是上層管道類型的有效子類型。只能在建立廣告活動時設定。廣告活動建立完成後,就無法變更這個欄位。
campaign_advertising_channel_type 廣告活動中廣告的主要放送目標。您可以在 network_settings 中調整指定目標選項。建立新廣告活動時,這個欄位為必填,且不得為空白。只能在建立廣告活動時設定。廣告活動建立完成後,就無法變更這個欄位。
campaign_bidding_strategy_type 出價策略類型。您可以設定出價計畫來建立標準出價策略,也可以設定 bidding_strategy 欄位來建立組合出價策略。這是唯讀欄位。
campaign_budget_amount_micros 預算金額,以帳戶的當地幣別表示。金額以微量單位指定,一百萬微量單位等於一貨幣單位。每月支出上限為這個金額的 30.4 倍。
campaign_budget_delivery_method 放送方式會決定廣告活動預算的支出速度。如果建立作業中未指定,則預設為 STANDARD。
campaign_budget_period 支出預算的時間範圍。如果未指定,預設值為 DAILY。
campaign_creation_time 這個廣告活動的建立時間戳記。時間戳記採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss」。
campaign_end_date 廣告活動的最後一天,以 YYYY-MM-DD 格式顯示,並採用放送廣告所在時區的時間。建立時,預設為 2037 年 12 月 30 日,表示廣告活動會無限期放送。如要將現有廣告活動設為無限期放送,請將這個欄位設為 2037 年 12 月 30 日。
campaign_engine_id 外部引擎帳戶中的廣告活動 ID。這個欄位僅適用於非 Google Ads 帳戶。例如:Yahoo Japan、Microsoft、百度。如果是 Google Ads 實體,請改用「campaign.id」。
campaign_id 廣告活動的 ID。
campaign_labels 附加至這個廣告活動的標籤資源名稱。
campaign_last_modified_time 上次修改這個廣告活動的日期和時間。日期時間採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
campaign_name 廣告活動名稱。建立新廣告活動時,這個欄位為必填,且不得為空白。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。
campaign_network_settings_target_content_network 廣告是否會在 Google 多媒體廣告聯播網的指定刊登位置放送。刊登位置是使用刊登位置條件指定。
campaign_network_settings_target_google_search 是否要與 google.com 搜尋結果一起放送廣告。
campaign_network_settings_target_partner_search_network 廣告是否會在 Google 合作夥伴聯播網上放送。這項功能僅適用於特定 Google 合作夥伴帳戶。
campaign_network_settings_target_search_network 廣告是否會在 Google 搜尋聯播網的合作夥伴網站上放送 (target_google_search 也必須為 true)。
campaign_start_date 廣告活動開始放送的日期,格式為 YYYY-MM-DD,時區為客戶時區。
campaign_status 廣告活動的狀態。
customer_id 顧客 ID。

Search Ads 360 資料表名稱:CampaignAssetStats

Search Ads 360 API 資源:campaign_asset

Search Ads 360 欄位名稱說明
campaign_asset_asset 不可變更。連結至廣告活動的素材資源。
campaign_asset_campaign 不可變更。素材資源連結的廣告活動。
campaign_engine_id 外部引擎帳戶中的廣告活動 ID。這個欄位僅適用於非 Google Ads 帳戶。例如:Yahoo Japan、Microsoft、百度。如果是 Google Ads 實體,請改用「campaign.id」。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_average_cpm 平均千次曝光出價。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17

Search Ads 360 資料表名稱:CampaignAudienceConversionActionAndDeviceStats

Search Ads 360 API 資源:campaign_audience_view

Search Ads 360 欄位名稱說明
campaign_criterion_criterion_id 指定條件的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_all_conversions 轉換總次數。包括所有轉換,不論 include_in_conversions_metric 的值為何。
metrics_all_conversions_value 所有轉換的價值。
metrics_cross_device_conversions 顧客在某裝置上點按廣告,然後使用其他裝置或瀏覽器完成轉換。「所有轉換」欄已納入跨裝置轉換。
metrics_cross_device_conversions_value 跨裝置轉換價值的總和。
segments.conversion_action_name 轉換動作名稱。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:CampaignAudienceDeviceStats

Search Ads 360 API 資源:campaign_audience_view

Search Ads 360 欄位名稱說明
campaign_criterion_criterion_id 指定條件的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_average_cpm 平均千次曝光出價。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_view_through_conversions 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後卻在您的網站上完成轉換,就會計為瀏覽後轉換。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:CampaignConversionActionAndAssetStats

Search Ads 360 API 資源:campaign_asset

Search Ads 360 欄位名稱說明
ad_group_id 廣告群組的 ID。
campaign_asset_campaign 不可變更。素材資源連結的廣告活動。
campaign_engine_id 外部引擎帳戶中的廣告活動 ID。這個欄位僅適用於非 Google Ads 帳戶。例如:Yahoo Japan、Microsoft、百度。如果是 Google Ads 實體,請改用「campaign.id」。
campaign_id 廣告活動的 ID。
campain_asset_asset 不可變更。連結至廣告活動的素材資源。
customer_id 顧客 ID。
metrics_all_conversions 轉換總次數。包括所有轉換,不論 include_in_conversions_metric 的值為何。
metrics_all_conversions_value 所有轉換的價值。
metrics_cross_device_conversions 顧客在某裝置上點按廣告,然後使用其他裝置或瀏覽器完成轉換。「所有轉換」欄已納入跨裝置轉換。
metrics_cross_device_conversions_value 跨裝置轉換價值的總和。
segments.conversion_action_name 轉換動作名稱。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17

Search Ads 360 資料表名稱:CampaignConversionActionAndDeviceStats

Search Ads 360 API 資源:campaign

Search Ads 360 欄位名稱說明
bidding_strategy_id 出價策略的 ID。
campaign_engine_id 外部引擎帳戶中的廣告活動 ID。這個欄位僅適用於非 Google Ads 帳戶。例如:Yahoo Japan、Microsoft、百度。如果是 Google Ads 實體,請改用「campaign.id」。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_all_conversions 轉換總次數。包括所有轉換,不論 include_in_conversions_metric 的值為何。
metrics_all_conversions_by_conversion_date 轉換總次數。包括所有轉換,不論 include_in_conversions_metric 的值為何。如果選取這個資料欄和日期,日期資料欄中的值就是轉換日期。如要進一步瞭解 by_conversion_date 欄,請參閱「關於『所有轉換』欄」一文。
metrics_all_conversions_value 所有轉換的價值。
metrics_all_conversions_value_by_conversion_date 所有轉換的價值。如果選取這個資料欄和日期,日期資料欄中的值就是轉換日期。如要進一步瞭解 by_conversion_date 欄,請參閱「關於『所有轉換』欄」一文。
metrics_cross_device_conversions 顧客在某裝置上點按廣告,然後使用其他裝置或瀏覽器完成轉換。「所有轉換」欄已納入跨裝置轉換。
metrics_cross_device_conversions_by_conversion_date 依轉換日期計算的跨裝置轉換次數。如要進一步瞭解 by_conversion_date 欄,請參閱「關於『所有轉換』欄」一文。
metrics_cross_device_conversions_value 跨裝置轉換價值的總和。
metrics_cross_device_conversions_value_by_conversion_date 依轉換日期計算的跨裝置轉換價值總和。如要進一步瞭解 by_conversion_date 欄,請參閱「關於『所有轉換』欄」一文。
segments.conversion_action_name 轉換動作名稱。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:CampaignCriterion

Search Ads 360 API 資源:campaign_criterion

Search Ads 360 欄位名稱說明
campaign_criterion_bid_modifier 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援調節係數。
campaign_criterion_criterion_id 指定條件的 ID。
campaign_criterion_last_modified_time 上次修改這個廣告活動條件的時間。日期時間採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
campaign_criterion_location_geo_target_constant 地理目標常數資源名稱。
campaign_criterion_status 條件的狀態。
campaign_criterion_type 條件類型。
campaign_criterion_user_list_user_list 使用者名單資源名稱。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。

Search Ads 360 資料表名稱:CampaignDeviceStats

Search Ads 360 API 資源:campaign

Search Ads 360 欄位名稱說明
bidding_strategy_id 出價策略的 ID。
campaign_engine_id 外部引擎帳戶中的廣告活動 ID。這個欄位僅適用於非 Google Ads 帳戶。例如:Yahoo Japan、Microsoft、百度。如果是 Google Ads 實體,請改用「campaign.id」。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_average_cpm 平均千次曝光出價。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_view_through_conversions 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後卻在您的網站上完成轉換,就會計為瀏覽後轉換。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
metrics_visits Search Ads 360 成功記錄並轉送至廣告主到達網頁的點擊次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:CampaignLabel

Search Ads 360 API 資源:campaign_label

Search Ads 360 欄位名稱說明
campaign_id 廣告活動的 ID。
campaign_label_campaign 附加標籤的廣告活動。
campaign_label_label 指派給廣告活動的標籤。
campaign_label_owner_customer_id 擁有標籤的客戶 ID。
campaign_label_resource_name 資源名稱。廣告活動標籤資源名稱的格式為:customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}
customer_id 顧客 ID。

Search Ads 360 資料表名稱:CampaignStats

Search Ads 360 API 資源:campaign

Search Ads 360 欄位名稱說明
bidding_strategy_id 出價策略的 ID。
campaign_engine_id 外部引擎帳戶中的廣告活動 ID。這個欄位僅適用於非 Google Ads 帳戶。例如:Yahoo Japan、Microsoft、百度。如果是 Google Ads 實體,請改用「campaign.id」。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_all_conversions 轉換總次數。包括所有轉換,不論 include_in_conversions_metric 的值為何。
metrics_all_conversions_value 所有轉換的價值。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_average_cpm 平均千次曝光出價。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_view_through_conversions 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後卻在您的網站上完成轉換,就會計為瀏覽後轉換。
metrics_content_budget_lost_impression_share 廣告符合在搜尋聯播網上顯示的資格,但因預算過低而未顯示的次數百分比 (估計值)。注意:搜尋預算錯失的曝光比重會以 0 到 0.9 的範圍回報。任何大於 0.9 的值都會回報為 0.9001。
metrics_content_impression_share 將您在多媒體廣告聯播網上獲得的曝光次數,除以預估可獲得的曝光次數後所得出的百分比。注意:內容曝光比重的報表範圍為 0.1 到 1。任何低於 0.1 的值都會回報為 0.0999。
metrics_content_rank_lost_impression_share 廣告因為廣告評級偏低,而錯失多媒體廣告聯播網曝光次數的預估百分比。注意:內容排名錯失的曝光比重會回報在 0 到 0.9 的範圍內。任何大於 0.9 的值都會回報為 0.9001。
metrics_conversions 轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_conversions_value 「轉換」欄內所含轉換的轉換價值總和。您為轉換動作輸入價值後,這項指標才能派上用場。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_historical_quality_score 歷來品質分數。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
metrics_search_budget_lost_impression_share 廣告符合在搜尋聯播網上顯示的資格,但因預算過低而未顯示的次數百分比 (估計值)。注意:搜尋預算錯失的曝光比重會以 0 到 0.9 的範圍回報。任何大於 0.9 的值都會回報為 0.9001。
metrics_search_impression_share 此欄是將您在搜尋聯播網上獲得的曝光次數,除以預估可獲得的曝光次數後,所得到的百分比。注意:搜尋曝光比重的報表範圍為 0.1 至 1。如果值低於 0.1,系統會回報為 0.0999。
metrics_search_rank_lost_impression_share 廣告因為廣告評級偏低,而錯失搜尋聯播網曝光次數的預估百分比。注意:搜尋聯播網錯失的曝光比重 (排名) 的回報範圍為 0 到 0.9。任何大於 0.9 的值都會回報為 0.9001。
metrics_visits Search Ads 360 成功記錄並轉送至廣告主到達網頁的點擊次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17

Search Ads 360 表格名稱:CartDataSalesStats

Search Ads 360 API 資源:cart_data_sales_view

Search Ads 360 欄位名稱說明
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_client_account_cross_sell_gross_profit_micros https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_cross_sell_gross_profit_micros
metrics_client_account_cross_sell_revenue_micros https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_cross_sell_revenue_micros
metrics_client_account_cross_sell_units_sold https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_cross_sell_units_sold
metrics_client_account_lead_gross_profit_micros https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_lead_gross_profit_micros
metrics_client_account_lead_revenue_micros https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_lead_revenue_micros
metrics_client_account_lead_units_sold https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_lead_units_sold
metrics_cross_sell_gross_profit_micros https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.cross_sell_gross_profit_micros
metrics_cross_sell_revenue_micros https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.cross_sell_revenue_micros
metrics_cross_sell_units_sold https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.cross_sell_units_sold
metrics_lead_gross_profit_micros https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.lead_gross_profit_micros
metrics_lead_revenue_micros https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.lead_revenue_micros
metrics_lead_units_sold https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.lead_units_sold
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_product_brand 產品品牌。
segments_product_item_id 產品的商品 ID。
segments_product_sold_brand 售出產品的品牌。
segments_product_sold_item_id 售出產品的商品 ID。
segments_product_sold_title 售出產品的名稱。
segments_product_sold_type_l1 售出產品的類型 (第 1 層)。
segments_product_sold_type_l2 售出產品的類型 (第 2 層)。
segments_product_sold_type_l3 售出產品的類型 (第 3 層)。
segments_product_sold_type_l4 售出產品的類型 (第 4 層)。
segments_product_sold_type_l5 售出產品的類型 (第 5 層)。
segments_product_title 產品名稱。
segments_product_type_l1 產品類型 (第 1 層)。
segments_product_type_l2 產品類型 (第 2 層)。
segments_product_type_l3 產品類型 (第 3 層)。
segments_product_type_l4 產品類型 (第 4 層)。
segments_product_type_l5 產品類型 (第 5 層)。

Search Ads 360 表格名稱:轉換

Search Ads 360 API 資源:conversion

Search Ads 360 欄位名稱說明
ad_group_criterion_criterion_id 指定條件的 ID。
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
conversion_ad_id 廣告 ID。如果值為 0,表示廣告未歸因。
conversion_advertiser_conversion_id 如果是離線轉換,這是廣告主提供的 ID。如果廣告主未指定這類 ID,Search Ads 360 就會自動產生。如果是線上轉換,這個值會等於 ID 欄或 floodlight_order_id 欄,視廣告主的 Floodlight 指示而定。
conversion_attribution_type 轉換歸因對象:造訪或關鍵字 + 廣告。
conversion_click_id 系統會將轉換歸因於某次造訪,並將該次造訪的專屬字串以點擊 ID 網址參數的形式傳遞至到達網頁。
conversion_conversion_date_time 轉換事件的時間戳記。
conversion_conversion_last_modified_date_time 上次修改轉換的時間戳記。
conversion_conversion_quantity 轉換記錄的商品數量,由 qty 網址參數決定。廣告主必須負責以動態方式填入參數 (例如轉換中售出的商品數量),否則系統會預設為 1。
conversion_conversion_revenue_micros 轉換事件的調整後收益 (以微元為單位)。這項金額一律會以放送帳戶的幣別計算。
conversion_conversion_visit_date_time 轉換歸因的造訪時間戳記。
conversion_criterion_id Search Ads 360 條件 ID。值為 0 表示條件未歸因。
conversion_floodlight_order_id 廣告主為轉換提供的 Floodlight 訂單 ID。
conversion_floodlight_original_revenue 與 Floodlight 事件相關聯的原始收益 (以目前報表的貨幣表示),未經 Floodlight 貨幣指示修改。
conversion_id 轉換的 ID
conversion_merchant_id 包含遭點擊產品的 SearchAds360 廣告空間帳戶 ID。在 Search Ads 360 中連結商品目錄帳戶時,系統會產生這組 ID。
conversion_product_channel 獲得點擊的產品銷售通路:線上或店面。
conversion_product_country_code 為內含獲得點擊產品的商品目錄動態饋給註冊的國家/地區 (ISO-3166 格式)。
conversion_product_id 遭點選的產品 ID。
conversion_product_language_code 為內含產品相關資料的 Merchant Center 動態饋給設定的語言 (ISO-639-1)。
conversion_product_store_id 獲得點擊的店面商品目錄廣告中的商店。這組 ID 必須與店面產品動態饋給所使用的商店 ID 相符。
conversion_status 轉換的狀態,可以是「ENABLED」或「REMOVED」。
conversion_visit_id 轉換歸因的 SearchAds360 訪客 ID。
customer_account_type 引擎帳戶類型。例如:Google Ads、Microsoft Advertising、Yahoo Japan、百度、Facebook、Engine Track。
customer_descriptive_name 選填,可重複的客戶說明名稱。
customer_id 顧客 ID。
segments.conversion_action_name 轉換動作名稱。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:ConversionAction

Search Ads 360 API 資源:conversion_action

Search Ads 360 欄位名稱說明
conversion_action_creation_time Floodlight 活動的建立時間戳記,格式為 ISO 8601。
conversion_action_floodlight_settings_activity_group_tag 用於在轉換報表中識別 Floodlight 活動群組的字串。
conversion_action_floodlight_settings_activity_id DoubleClick Campaign Manager (DCM) 中的 Floodlight 活動 ID。
conversion_action_floodlight_settings_activity_tag 用於在轉換報表中識別 Floodlight 活動的字串。
conversion_action_name 轉換動作的名稱。建立新的轉換動作時,這個欄位為必填,且不得為空白。
conversion_action_status 這個轉換動作的轉換事件累積狀態。
conversion_action_type 這個轉換動作的類型。

Search Ads 360 資料表名稱:GenderConversionActionAndDeviceStats

Search Ads 360 API 資源:gender_view

Search Ads 360 欄位名稱說明
ad_group_criterion_age_range_type 年齡層類型。
ad_group_criterion_bid_modifier 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援調節係數。
ad_group_criterion_cpc_bid_micros 單次點擊出價。
ad_group_criterion_criterion_id 指定條件的 ID。
ad_group_criterion_gender_type 性別類型。
ad_group_criterion_location_geo_target_constant 地理目標常數資源名稱。
ad_group_criterion_user_list_user_list 使用者名單資源名稱。
ad_group_criterion_webpage_conditions 網頁指定目標的條件或邏輯運算式。評估網頁指定目標時,系統會將網頁指定目標條件清單以 AND 運算子連結。如果條件清單為空白,表示廣告活動網站的所有網頁都會成為指定目標。建立作業必須填寫這個欄位,更新作業則不得填寫。
ad_group_criterion_webpage_coverage_percentage 網站條件涵蓋率百分比。這是根據廣告群組和廣告活動中的網站目標、排除網站目標和排除關鍵字,計算出的網站涵蓋率百分比。舉例來說,如果涵蓋範圍傳回 1,表示涵蓋範圍為 100%。
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_cross_device_conversions 顧客在某裝置上點按廣告,然後使用其他裝置或瀏覽器完成轉換。「所有轉換」欄已納入跨裝置轉換。
metrics_cross_device_conversions_value 跨裝置轉換價值的總和。
segments.conversion_action_name 轉換動作名稱。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:GenderDeviceStats

Search Ads 360 API 資源:gender_view

Search Ads 360 欄位名稱說明
ad_group_criterion_age_range_type 年齡層類型。
ad_group_criterion_bid_modifier 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援調節係數。
ad_group_criterion_cpc_bid_micros 單次點擊出價。
ad_group_criterion_criterion_id 指定條件的 ID。
ad_group_criterion_gender_type 性別類型。
ad_group_criterion_location_geo_target_constant 地理目標常數資源名稱。
ad_group_criterion_user_list_user_list 使用者名單資源名稱。
ad_group_criterion_webpage_conditions 網頁指定目標的條件或邏輯運算式。評估網頁指定目標時,系統會將網頁指定目標條件清單以 AND 運算子連結。如果條件清單為空白,表示廣告活動網站的所有網頁都會成為指定目標。建立作業必須填寫這個欄位,更新作業則不得填寫。
ad_group_criterion_webpage_coverage_percentage 網站條件涵蓋率百分比。這是根據廣告群組和廣告活動中的網站目標、排除網站目標和排除關鍵字,計算出的網站涵蓋率百分比。舉例來說,如果涵蓋範圍傳回 1,表示涵蓋範圍為 100%。
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_average_cpm 平均千次曝光出價。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_view_through_conversions 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後卻在您的網站上完成轉換,就會計為瀏覽後轉換。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:關鍵字

Search Ads 360 API 資源:keyword_view

Search Ads 360 欄位名稱說明
ad_group_criterion_cpc_bid_micros 單次點擊出價。
ad_group_criterion_creation_time 這個廣告群組條件的建立時間戳記。時間戳記採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss」。
ad_group_criterion_criterion_id 指定條件的 ID。
ad_group_criterion_effective_cpc_bid_micros 有效單次點擊出價。
ad_group_criterion_engine_id 外部引擎帳戶中的廣告群組條件 ID。這個欄位僅適用於 Search Ads 360 帳戶。例如:Yahoo Japan、Microsoft、百度。如果不是 Search Ads 360 實體,請改用「ad_group_criterion.criterion_id」。
ad_group_criterion_engine_status 廣告群組條件的引擎狀態。
ad_group_criterion_final_url_suffix 網址範本,用於將參數附加至最終到達網址。
ad_group_criterion_final_urls 廣告在所有跨網域重新導向後可能連到的最終到達網址清單。
ad_group_criterion_keyword_match_type 關鍵字的比對類型。
ad_group_criterion_keyword_text 關鍵字的文字 (最多 80 個字元和 10 個字)。
ad_group_criterion_labels 附加至這個廣告群組條件的標籤資源名稱。
ad_group_criterion_last_modified_time 上次修改這個廣告群組條件的日期時間。日期時間採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
ad_group_criterion_quality_info_quality_score 品質分數。如果 Google 沒有足夠資訊來判斷值,可能就不會填入這個欄位。
ad_group_criterion_status 條件的狀態。這是由用戶端設定的廣告群組條件實體狀態。注意:使用者介面報表可能會納入其他資訊,影響條件是否符合放送資格。在某些情況下,即使透過 API 移除條件,該條件在使用者介面中仍可能顯示為已啟用。舉例來說,除非排除,否則廣告活動預設會向所有年齡層的使用者顯示。由於這些年齡層有資格觀看廣告,使用者介面會將每個年齡層顯示為「已啟用」;但由於未新增任何正向條件,AdGroupCriterion.status 會顯示「已移除」。
ad_group_criterion_tracking_url_template 用於建構追蹤網址的網址範本。
ad_group_id 廣告群組的 ID。
bidding_strategy_id 出價策略的 ID。
bidding_strategy_target_cpa_cpc_bid_ceiling_micros 出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。這項設定僅適用於組合出價策略。
bidding_strategy_target_cpa_cpc_bid_floor_micros 出價策略可設定的最低出價限制。這項限制適用於策略管理的所有關鍵字。這項設定僅適用於組合出價策略。
bidding_strategy_target_impression_share_cpc_bid_ceiling_micros 自動出價系統可指定的最高單次點擊出價。這是廣告主輸入的必填欄位,用於設定上限,並在當地微區域中指定。
bidding_strategy_target_outrank_share_cpc_bid_ceiling_micros 出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。
bidding_strategy_target_roas_cpc_bid_ceiling_micros 出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。這項設定僅適用於組合出價策略。
bidding_strategy_target_roas_cpc_bid_floor_micros 出價策略可設定的最低出價限制。這項限制適用於策略管理的所有關鍵字。這項設定僅適用於組合出價策略。
bidding_strategy_target_spend_cpc_bid_ceiling_micros 出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。

Search Ads 360 資料表名稱:KeywordConversionActionAndDeviceStats

Search Ads 360 API 資源:keyword_view

Search Ads 360 欄位名稱說明
ad_group_criterion_criterion_id 指定條件的 ID。
ad_group_criterion_engine_id 外部引擎帳戶中的廣告群組條件 ID。這個欄位僅適用於 Search Ads 360 帳戶。例如:Yahoo Japan、Microsoft、百度。如果不是 Search Ads 360 實體,請改用「ad_group_criterion.criterion_id」。
ad_group_id 廣告群組的 ID。
bidding_strategy_id 出價策略的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_all_conversions 轉換總次數。包括所有轉換,不論 include_in_conversions_metric 的值為何。
metrics_all_conversions_by_conversion_date 轉換總次數。包括所有轉換,不論 include_in_conversions_metric 的值為何。如果選取這個資料欄和日期,日期資料欄中的值就是轉換日期。如要進一步瞭解 by_conversion_date 欄,請參閱「關於『所有轉換』欄」一文。
metrics_all_conversions_value 所有轉換的價值。
metrics_all_conversions_value_by_conversion_date 所有轉換的價值。如果選取這個資料欄和日期,日期資料欄中的值就是轉換日期。如要進一步瞭解 by_conversion_date 欄,請參閱「關於『所有轉換』欄」一文。
metrics_cross_device_conversions 顧客在某裝置上點按廣告,然後使用其他裝置或瀏覽器完成轉換。「所有轉換」欄已納入跨裝置轉換。
metrics_cross_device_conversions_by_conversion_date 依轉換日期計算的跨裝置轉換次數。如要進一步瞭解 by_conversion_date 欄,請參閱「關於『所有轉換』欄」一文。
metrics_cross_device_conversions_value 跨裝置轉換價值的總和。
metrics_cross_device_conversions_value_by_conversion_date 依轉換日期計算的跨裝置轉換價值總和。如要進一步瞭解 by_conversion_date 欄,請參閱「關於『所有轉換』欄」一文。
segments.conversion_action_name 轉換動作名稱。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:KeywordDeviceStats

Search Ads 360 API 資源:keyword_view

Search Ads 360 欄位名稱說明
ad_group_criterion_criterion_id 指定條件的 ID。
ad_group_criterion_engine_id 外部引擎帳戶中的廣告群組條件 ID。這個欄位僅適用於 Search Ads 360 帳戶。例如:Yahoo Japan、Microsoft、百度。如果不是 Search Ads 360 實體,請改用「ad_group_criterion.criterion_id」。
ad_group_id 廣告群組的 ID。
bidding_strategy_id 出價策略的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_average_cpm 平均千次曝光出價。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_view_through_conversions 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後卻在您的網站上完成轉換,就會計為瀏覽後轉換。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
metrics_visits Search Ads 360 成功記錄並轉送至廣告主到達網頁的點擊次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:KeywordStats

Search Ads 360 API 資源:keyword_view

Search Ads 360 欄位名稱說明
ad_group_criterion_criterion_id 指定條件的 ID。
ad_group_id 廣告群組的 ID。
bidding_strategy_id 出價策略的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_historical_quality_score 歷來品質分數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17

Search Ads 360 表格名稱:LocationConversionActionAndDeviceStats

Search Ads 360 API 資源:location_view

Search Ads 360 欄位名稱說明
campaign_criterion_criterion_id 指定條件的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_all_conversions 轉換總次數。包括所有轉換,不論 include_in_conversions_metric 的值為何。
metrics_all_conversions_value 所有轉換的價值。
metrics_cross_device_conversions 顧客在某裝置上點按廣告,然後使用其他裝置或瀏覽器完成轉換。「所有轉換」欄已納入跨裝置轉換。
metrics_cross_device_conversions_value 跨裝置轉換價值的總和。
segments.conversion_action_name 轉換動作名稱。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:LocationDeviceStats

Search Ads 360 API 資源:location_view

Search Ads 360 欄位名稱說明
campaign_criterion_criterion_id 指定條件的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_average_cpm 平均千次曝光出價。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_view_through_conversions 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後卻在您的網站上完成轉換,就會計為瀏覽後轉換。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:NegativeAdGroupCriterion

Search Ads 360 API 資源:ad_group_criterion

Search Ads 360 欄位名稱說明
ad_group_criterion_age_range_type 年齡層類型。
ad_group_criterion_creation_time 這個廣告群組條件的建立時間戳記。時間戳記採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss」。
ad_group_criterion_criterion_id 指定條件的 ID。
ad_group_criterion_gender_type 性別類型。
ad_group_criterion_last_modified_time 上次修改這個廣告群組條件的日期時間。日期時間採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
ad_group_criterion_location_geo_target_constant 地理目標常數資源名稱。
ad_group_criterion_status 條件的狀態。這是由用戶端設定的廣告群組條件實體狀態。注意:使用者介面報表可能會納入其他資訊,影響條件是否符合放送資格。在某些情況下,即使透過 API 移除條件,該條件在使用者介面中仍可能顯示為已啟用。舉例來說,除非排除,否則廣告活動預設會向所有年齡層的使用者顯示。由於這些年齡層有資格觀看廣告,使用者介面會將每個年齡層顯示為「已啟用」;但由於未新增任何正向條件,AdGroupCriterion.status 會顯示「已移除」。
ad_group_criterion_type 條件類型。
ad_group_criterion_user_list_user_list 使用者名單資源名稱。
ad_group_criterion_webpage_conditions 網頁指定目標的條件或邏輯運算式。評估指定目標時,系統會將網頁指定條件清單中的條件以 AND 運算子連結。如果條件清單為空白,表示廣告活動網站的所有網頁都會成為指定目標。建立作業必須填寫這個欄位,更新作業則不得填寫。
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。

Search Ads 360 表格名稱:NegativeAdGroupKeyword

Search Ads 360 API 資源:ad_group_criterion

Search Ads 360 欄位名稱說明
ad_group_criterion_creation_time 這個廣告群組條件的建立時間戳記。時間戳記採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss」。
ad_group_criterion_criterion_id 指定條件的 ID。
ad_group_criterion_keyword_match_type 關鍵字的比對類型。
ad_group_criterion_keyword_text 關鍵字的文字 (最多 80 個字元和 10 個字)。
ad_group_criterion_last_modified_time 上次修改這個廣告群組條件的日期時間。日期時間採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
ad_group_criterion_status 條件的狀態。這是由用戶端設定的廣告群組條件實體狀態。注意:使用者介面報表可能會納入其他資訊,影響條件是否符合放送資格。在某些情況下,即使透過 API 移除條件,該條件在使用者介面中仍可能顯示為已啟用。舉例來說,除非排除,否則廣告活動預設會向所有年齡層的使用者顯示。由於這些年齡層有資格觀看廣告,使用者介面會將每個年齡層顯示為「已啟用」;但由於未新增任何正向條件,AdGroupCriterion.status 會顯示「已移除」。
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。

Search Ads 360 表格名稱:NegativeCampaignCriterion

Search Ads 360 API 資源:campaign_criterion

Search Ads 360 欄位名稱說明
campaign_criterion_age_range_type 年齡層類型。
campaign_criterion_criterion_id 指定條件的 ID。
campaign_criterion_gender_type 性別類型。
campaign_criterion_last_modified_time 上次修改這個廣告活動條件的時間。日期時間採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
campaign_criterion_location_geo_target_constant 地理目標常數資源名稱。
campaign_criterion_status 條件的狀態。
campaign_criterion_type 條件類型。
campaign_criterion_user_list_user_list 使用者名單資源名稱。
campaign_criterion_webpage_conditions 網頁指定目標的條件或邏輯運算式。評估網頁指定目標時,系統會將網頁指定目標條件清單以 AND 運算子連結。如果條件清單為空白,表示廣告活動網站的所有網頁都會成為指定目標。建立作業必須填寫這個欄位,更新作業則不得填寫。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。

Search Ads 360 表格名稱:NegativeCampaignKeyword

Search Ads 360 API 資源:campaign_criterion

Search Ads 360 欄位名稱說明
campaign_criterion_criterion_id 指定條件的 ID。
campaign_criterion_keyword_match_type 關鍵字的比對類型。
campaign_criterion_keyword_text 關鍵字的文字 (最多 80 個字元和 10 個字)。
campaign_criterion_last_modified_time 上次修改這個廣告群組條件的日期時間。日期時間採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
campaign_criterion_status 條件的狀態。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。

Search Ads 360 表格名稱:ProductAdvertised

Search Ads 360 API 資源:shopping_performance_view

Search Ads 360 欄位名稱說明
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_product_bidding_category_level1 產品的競價類別 (第 1 層)。
segments_product_bidding_category_level2 產品的競價類別 (第 2 層)。
segments_product_bidding_category_level3 產品的競價類別 (第 3 層)。
segments_product_bidding_category_level4 產品的競價類別 (第 4 級)。
segments_product_bidding_category_level5 產品的競價類別 (第 5 層)。
segments_product_brand 產品品牌。
segments_product_channel 產品通路。
segments_product_channel_exclusivity 產品的管道獨佔性。
segments_product_condition 產品狀況。
segments_product_country 產品銷售國家/地區的地理區域目標常數資源名稱。
segments_product_custom_attribute0 產品的自訂屬性 0。
segments_product_custom_attribute1 產品的自訂屬性 1。
segments_product_custom_attribute2 產品的自訂屬性 2。
segments_product_custom_attribute3 產品的自訂屬性 3。
segments_product_custom_attribute4 產品的自訂屬性 4。
segments_product_item_id 產品的商品 ID。
segments_product_language 產品語言的語言常數資源名稱。
segments_product_store_id 產品的商店 ID。
segments_product_title 產品名稱。
segments_product_type_l1 產品類型 (第 1 層)。
segments_product_type_l2 產品類型 (第 2 層)。
segments_product_type_l3 產品類型 (第 3 層)。
segments_product_type_l4 產品類型 (第 4 層)。
segments_product_type_l5 產品類型 (第 5 層)。

Search Ads 360 表格名稱:ProductAdvertisedConversionActionAndDeviceStats

Search Ads 360 API 資源:shopping_performance_view

Search Ads 360 欄位名稱說明
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_all_conversions 轉換總次數。包括所有轉換,不論 include_in_conversions_metric 的值為何。
metrics_all_conversions_value 所有轉換的價值。
metrics_cross_device_conversions 顧客在某裝置上點按廣告,然後使用其他裝置或瀏覽器完成轉換。「所有轉換」欄已納入跨裝置轉換。
metrics_cross_device_conversions_value 跨裝置轉換價值的總和。
segments.conversion_action_name 轉換動作名稱。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。
segments_product_item_id 產品的商品 ID。

Search Ads 360 表格名稱:ProductAdvertisedDeviceStats

Search Ads 360 API 資源:shopping_performance_view

Search Ads 360 欄位名稱說明
customer_id 顧客 ID。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。
segments_product_item_id 產品的商品 ID。

Search Ads 360 表格名稱:ProductGroup

Search Ads 360 API 資源:product_group_view

Search Ads 360 欄位名稱說明
ad_group_criterion_cpc_bid_micros 單次點擊出價。
ad_group_criterion_creation_time 僅供輸出。這個廣告群組條件的建立時間戳記。時間戳記採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss」。
ad_group_criterion_criterion_id 僅供輸出。指定條件的 ID。
ad_group_criterion_effective_cpc_bid_micros 僅供輸出。有效單次點擊出價。
ad_group_criterion_engine_status 僅供輸出。廣告群組條件的引擎狀態。
ad_group_criterion_final_urls 廣告在所有跨網域重新導向後可能連到的最終到達網址清單。
ad_group_criterion_last_modified_time 僅供輸出。上次修改這個廣告群組條件的日期時間。日期時間採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss.ssssss」。
ad_group_criterion_listing_group_type 商家資訊群組類型。
ad_group_criterion_status 條件的狀態。這是由用戶端設定的廣告群組條件實體狀態。注意:使用者介面報表可能會納入其他資訊,影響條件是否符合放送資格。在某些情況下,即使透過 API 移除條件,該條件在使用者介面中仍可能顯示為已啟用。舉例來說,除非排除,否則廣告活動預設會向所有年齡層的使用者顯示。由於這些年齡層有資格觀看廣告,使用者介面會將每個年齡層顯示為「已啟用」;但由於未新增任何正向條件,AdGroupCriterion.status 會顯示「已移除」。
ad_group_criterion_tracking_url_template 用於建構追蹤網址的網址範本。
ad_group_id 僅供輸出。廣告群組的 ID。
campaign_id 僅供輸出。廣告活動的 ID。
customer_id 顧客 ID。
product_group_view_resource_name 僅供輸出。產品群組檢視畫面的資源名稱。產品群組檢視畫面資源名稱的格式為:customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

Search Ads 360 表格名稱:ProductGroupStats

Search Ads 360 API 資源:product_group_view

Search Ads 360 欄位名稱說明
ad_group_criterion_criterion_id 僅供輸出。指定條件的 ID。
ad_group_id 僅供輸出。廣告群組的 ID。
campaign_id 僅供輸出。廣告活動的 ID。
customer_id 顧客 ID。
metrics_all_conversions 轉換總次數。包括所有轉換,不論 include_in_conversions_metric 的值為何。
metrics_all_conversions_value 所有轉換的價值。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_average_cpm 平均千次曝光出價。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_view_through_conversions 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後卻在您的網站上完成轉換,就會計為瀏覽後轉換。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_cross_device_conversions 顧客在某裝置上點按廣告,然後使用其他裝置或瀏覽器完成轉換。「所有轉換」欄已納入跨裝置轉換。
metrics_cross_device_conversions_value 跨裝置轉換價值的總和。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17

Search Ads 360 表格名稱:Visit

Search Ads 360 API 資源:造訪

Search Ads 360 欄位名稱說明
ad_group_criterion_criterion_id 指定條件的 ID。
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
customer_account_type 引擎帳戶類型。例如:Google Ads、Microsoft Advertising、Yahoo Japan、百度、Facebook、Engine Track。
customer_descriptive_name 選填,可重複的客戶說明名稱。
customer_id 顧客 ID。
segments_ad_network_type 廣告聯播網類型。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。
visit_ad_id 廣告 ID。如果值為 0,表示廣告未歸因。
visit_click_id 每次造訪的專屬字串,會以點擊 ID 網址參數的形式傳遞至到達網頁。
visit_criterion_id Search Ads 360 關鍵字 ID。如果值為 0,表示關鍵字未歸因。
visit_id 造訪的 ID。
visit_merchant_id 包含遭點擊產品的 Search Ads 360 商品型錄帳戶 ID。在 Search Ads 360 中連結目錄帳戶時,Search Ads 360 會產生這組 ID。
visit_product_channel 獲得點擊的產品銷售通路:線上或店面。
visit_product_country_code 為內含所點選產品的商品目錄動態饋給註冊的國家/地區 (ISO-3166 格式)。
visit_product_id 遭點選的產品 ID。
visit_product_language_code 為內含產品相關資料的 Merchant Center 動態饋給設定的語言 (ISO-639-1)。
visit_product_store_id 獲得點擊的店面商品目錄廣告中的商店。這組 ID 必須與店面產品動態饋給所使用的商店 ID 相符。
visit_visit_date_time 造訪事件的時間戳記。時間戳記採用客戶時區,格式為「yyyy-MM-dd HH:mm:ss」。

Search Ads 360 表格名稱:WebpageConversionActionAndDeviceStats

Search Ads 360 API 資源:webpage_view

Search Ads 360 欄位名稱說明
ad_group_criterion_age_range_type 年齡層類型。
ad_group_criterion_bid_modifier 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援調節係數。
ad_group_criterion_cpc_bid_micros 單次點擊出價。
ad_group_criterion_criterion_id 指定條件的 ID。
ad_group_criterion_gender_type 性別類型。
ad_group_criterion_location_geo_target_constant 地理目標常數資源名稱。
ad_group_criterion_user_list_user_list 使用者名單資源名稱。
ad_group_criterion_webpage_conditions 網頁指定目標的條件或邏輯運算式。評估網頁指定目標時,系統會將網頁指定目標條件清單以 AND 運算子連結。如果條件清單為空白,表示廣告活動網站的所有網頁都會成為指定目標。建立作業必須填寫這個欄位,更新作業則不得填寫。
ad_group_criterion_webpage_coverage_percentage 網站條件涵蓋率百分比。這是根據廣告群組和廣告活動中的網站目標、排除網站目標和排除關鍵字,計算出的網站涵蓋率百分比。舉例來說,如果涵蓋範圍傳回 1,表示涵蓋範圍為 100%。
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_cross_device_conversions 顧客在某裝置上點按廣告,然後使用其他裝置或瀏覽器完成轉換。「所有轉換」欄已納入跨裝置轉換。
metrics_cross_device_conversions_value 跨裝置轉換價值的總和。
segments_conversion_action_name 轉換動作名稱。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 表格名稱:WebpageDeviceStats

Search Ads 360 API 資源:webpage_view

Search Ads 360 欄位名稱說明
ad_group_criterion_age_range_type 年齡層類型。
ad_group_criterion_bid_modifier 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援調節係數。
ad_group_criterion_cpc_bid_micros 單次點擊出價。
ad_group_criterion_criterion_id 指定條件的 ID。
ad_group_criterion_gender_type 性別類型。
ad_group_criterion_location_geo_target_constant 地理目標常數資源名稱。
ad_group_criterion_user_list_user_list 使用者名單資源名稱。
ad_group_criterion_webpage_conditions 網頁指定目標的條件或邏輯運算式。評估網頁指定目標時,系統會將網頁指定目標條件清單以 AND 運算子連結。如果條件清單為空白,表示廣告活動網站的所有網頁都會成為指定目標。建立作業必須填寫這個欄位,更新作業則不得填寫。
ad_group_criterion_webpage_coverage_percentage 網站條件涵蓋率百分比。這是根據廣告群組和廣告活動中的網站目標、排除網站目標和排除關鍵字,計算出的網站涵蓋率百分比。舉例來說,如果涵蓋範圍傳回 1,表示涵蓋範圍為 100%。
ad_group_id 廣告群組的 ID。
campaign_id 廣告活動的 ID。
customer_id 顧客 ID。
metrics_average_cpc 所有點擊的總費用除以獲得的點擊總數。
metrics_average_cpm 平均千次曝光出價。
metrics_clicks 點擊次數。
metrics_client_account_conversions 客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_conversions_value 客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。
metrics_client_account_view_through_conversions 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後卻在您的網站上完成轉換,就會計為瀏覽後轉換。
metrics_cost_micros 這段期間內單次點擊出價和千次曝光出價的費用總和。
metrics_ctr 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。
metrics_impressions 廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。
segments_date 指標適用的日期,格式為 yyyy-MM-dd。例如:2024-04-17
segments_device 指標適用的裝置。

Search Ads 360 比對表

Search Ads 360 比對表只包含屬性欄位 (內含設定或其他固定資料的欄位),且是為使用者查詢帳戶結構資訊而定義。如果您使用重新整理視窗或排定回填作業,系統不會更新比對資料表快照。

以下列出 Search Ads 360 轉移作業中的對應表:

  • 帳戶
  • 廣告
  • 廣告群組
  • AdGroupCriterion
  • 任何ID 對應表
  • 資產
  • BidStrategy
  • 廣告活動
  • CampaignCriterion
  • ConversionAction
  • 關鍵字
  • NegativeAdGroupKeyword
  • NegativeAdGroupCriterion
  • NegativeCampaignKeyword
  • NegativeCampaignCriterion
  • ProductGroup