Google Ads 報表轉換
本文說明如何轉換 Google Ads (舊稱 Google AdWords) 報表。
Google Ads 報表的資料表對應
Google Ads 報表移轉至 BigQuery 時,會轉換成下列 BigQuery 資料表和檢視表。
您在 BigQuery 中檢視資料表和檢視表時,customer_id 的值即為您的 Google Ads 客戶 ID。
| AdWords 報表 (已淘汰) | BigQuery AdWords 資料表 | Google Ads 表格 | Google Ads API 資源 (v21.0.0) | BigQuery 檢視區塊 |
|---|---|---|---|---|
| 帳戶成效報表 |
p_Customer_customer_id p_HourlyAccountConversionStats_customer_id p_AccountConversionStats_customer_id p_HourlyAccountStats_customer_id p_AccountNonClickStats_customer_id p_AccountBasicStats_customer_id p_AccountStats_customer_id |
p_ads_Customer_customer_id p_ads_HourlyAccountConversionStats_customer_id p_ads_AccountConversionStats_customer_id p_ads_HourlyAccountStats_customer_id p_ads_AccountNonClickStats_customer_id p_ads_AccountBasicStats_customer_id p_ads_AccountStats_customer_id |
顧客 |
Customer_customer_id HourlyAccountConversionStats_customer_id AccountConversionStats_customer_id HourlyAccountStats_customer_id AccountNonClickStats_customer_id AccountBasicStats_customer_id AccountStats_customer_id |
| 廣告成效報表 |
p_AdBasicStats_customer_id p_AdCrossDeviceStats_customer_id p_AdConversionStats_customer_id p_AdStats_customer_id p_AdCrossDeviceConversionStats_customer_id p_Ad_customer_id |
p_ads_AdBasicStats_customer_id p_ads_AdCrossDeviceStats_customer_id p_ads_AdConversionStats_customer_id p_ads_AdStats_customer_id p_ads_AdCrossDeviceConversionStats_customer_id p_ads_Ad_customer_id |
廣告群組廣告 |
AdBasicStats_customer_id AdCrossDeviceStats_customer_id AdConversionStats_customer_id AdStats_customer_id AdCrossDeviceConversionStats_customer_id Ad_customer_id |
| 廣告群組成效報表 |
p_AdGroupStats_customer_id p_AdGroupBasicStats_customer_id p_AdGroupCrossDeviceStats_customer_id p_HourlyAdGroupConversionStats_customer_id p_HourlyAdGroupStats_customer_id p_AdGroupConversionStats_customer_id p_AdGroupCrossDeviceConversionStats_customer_id p_AdGroup_customer_id |
p_ads_AdGroupStats_customer_id p_ads_AdGroupBasicStats_customer_id p_ads_AdGroupCrossDeviceStats_customer_id p_ads_HourlyAdGroupConversionStats_customer_id p_ads_HourlyAdGroupStats_customer_id p_ads_AdGroupConversionStats_customer_id p_ads_AdGroupCrossDeviceConversionStats_customer_id p_ads_AdGroup_customer_id |
廣告群組 |
AdGroupStats_customer_id AdGroupBasicStats_customer_id AdGroupCrossDeviceStats_customer_id HourlyAdGroupConversionStats_customer_id HourlyAdGroupStats_customer_id AdGroupConversionStats_customer_id AdGroupCrossDeviceConversionStats_customer_id AdGroup_customer_id |
| 年齡層成效報表 |
p_AgeRange_customer_id p_AgeRangeBasicStats_customer_id p_AgeRangeStats_customer_id p_AgeRangeConversionStats_customer_id p_AgeRangeNonClickStats_customer_id |
p_ads_AgeRange_customer_id p_ads_AgeRangeBasicStats_customer_id p_ads_AgeRangeStats_customer_id p_ads_AgeRangeConversionStats_customer_id p_ads_AgeRangeNonClickStats_customer_id |
年齡層檢視畫面 |
AgeRange_customer_id AgeRangeBasicStats_customer_id AgeRangeStats_customer_id AgeRangeConversionStats_customer_id AgeRangeNonClickStats_customer_id |
| 目標對象成效報表 |
p_Audience_customer_id p_AudienceConversionStats_customer_id p_AudienceNonClickStats_customer_id p_AudienceBasicStats_customer_id p_AudienceStats_customer_id |
NULLNULLNULLNULLNULL
|
廣告群組目標對象檢視畫面 廣告活動目標對象檢視畫面 |
Audience_customer_id AudienceConversionStats_customer_id AudienceNonClickStats_customer_id AudienceBasicStats_customer_id AudienceStats_customer_id |
| 出價目標成效報表 |
p_BidGoal_customer_id p_BidGoalStats_customer_id p_HourlyBidGoalStats_customer_id p_BidGoalConversionStats_customer_id |
p_ads_BidGoal_customer_id p_ads_BidGoalStats_customer_id p_ads_HourlyBidGoalStats_customer_id p_ads_BidGoalConversionStats_customer_id |
出價策略 |
BidGoal_customer_id BidGoalStats_customer_id HourlyBidGoalStats_customer_id BidGoalConversionStats_customer_id |
| 預算成效報表 |
p_Budget_customer_id p_BudgetStats_customer_id |
p_ads_Budget_customer_id p_ads_BudgetStats_customer_id |
廣告活動預算 |
Budget_customer_id BudgetStats_customer_id |
| 廣告活動指定地區報表 |
p_CampaignLocationTargetStats_customer_id p_LocationBasedCampaignCriterion_customer_id |
p_ads_CampaignLocationTargetStats_customer_id p_ads_LocationBasedCampaignCriterion_customer_id |
位置檢視畫面 |
CampaignLocationTargetStats_customer_id LocationBasedCampaignCriterion_customer_id |
| 廣告活動成效報表 |
p_Campaign_customer_id p_CampaignBasicStats_customer_id p_CampaignConversionStats_customer_id p_CampaignCrossDeviceStats_customer_id p_HourlyCampaignConversionStats_customer_id p_CampaignStats_customer_id p_HourlyCampaignStats_customer_id p_CampaignCrossDeviceConversionStats_customer_id p_CampaignCookieStats_customer_id |
p_ads_Campaign_customer_id p_ads_CampaignBasicStats_customer_id p_ads_CampaignConversionStats_customer_id p_ads_CampaignCrossDeviceStats_customer_id p_ads_HourlyCampaignConversionStats_customer_id p_ads_CampaignStats_customer_id p_ads_HourlyCampaignStats_customer_id p_ads_CampaignCrossDeviceConversionStats_customer_id p_ads_CampaignCookieStats_customer_id |
廣告活動 |
Campaign_customer_id CampaignBasicStats_customer_id CampaignConversionStats_customer_id CampaignCrossDeviceStats_customer_id HourlyCampaignConversionStats_customer_id CampaignStats_customer_id HourlyCampaignStats_customer_id CampaignCrossDeviceConversionStats_customer_id CampaignCookieStats_customer_id |
| 按一下「成效報表」 | p_ClickStats_customer_id | p_ads_ClickStats_customer_id | 按一下「查看」 | ClickStats_customer_id |
| 條件成效報表 |
p_Criteria_customer_id p_CriteriaBasicStats_customer_id p_CriteriaStats_customer_id p_CriteriaConversionStats_customer_id p_CriteriaNonClickStats_customer_id |
NULLNULLNULLNULLNULL
|
Criteria_customer_id CriteriaBasicStats_customer_id CriteriaStats_customer_id CriteriaConversionStats_customer_id CriteriaNonClickStats_customer_id |
|
| 性別成效報表 |
p_Gender_customer_id p_GenderBasicStats_customer_id p_GenderStats_customer_id p_GenderConversionStats_customer_id p_GenderNonClickStats_customer_id |
p_ads_Gender_customer_id p_ads_GenderBasicStats_customer_id p_ads_GenderStats_customer_id p_ads_GenderConversionStats_customer_id p_ads_GenderNonClickStats_customer_id |
性別檢視畫面 |
Gender_customer_id GenderBasicStats_customer_id GenderStats_customer_id GenderConversionStats_customer_id GenderNonClickStats_customer_id |
| 地理區域成效報表 |
p_GeoConversionStats_customer_id p_GeoStats_customer_id |
p_ads_GeoConversionStats_customer_id p_ads_GeoStats_customer_id |
地理區域檢視畫面 |
GeoConversionStats_customer_id GeoStats_customer_id |
| 關鍵字成效報表 |
p_Keyword_customer_id p_KeywordBasicStats_customer_id p_KeywordCrossDeviceStats_customer_id p_KeywordStats_customer_id p_KeywordCrossDeviceConversionStats_customer_id p_KeywordConversionStats_customer_id |
p_ads_Keyword_customer_id p_ads_KeywordBasicStats_customer_id p_ads_KeywordCrossDeviceStats_customer_id p_ads_KeywordStats_customer_id p_ads_KeywordCrossDeviceConversionStats_customer_id p_ads_KeywordConversionStats_customer_id |
關鍵字檢視畫面 |
Keyword_customer_id KeywordBasicStats_customer_id KeywordCrossDeviceStats_customer_id KeywordStats_customer_id KeywordCrossDeviceConversionStats_customer_id KeywordConversionStats_customer_id |
| 付費隨機查詢報表 | p_PaidOrganicStats_customer_id | p_ads_PaidOrganicStats_customer_id | 付費自然搜尋字詞檢視畫面 | PaidOrganicStats_customer_id |
| 家長狀態成效報表 |
p_ParentalStatus_customer_id p_ParentalStatusBasicStats_customer_id p_ParentalStatusStats_customer_id p_ParentalStatusConversionStats_customer_id p_ParentalStatusNonClickStats_customer_id |
p_ads_ParentalStatus_customer_id p_ads_ParentalStatusBasicStats_customer_id p_ads_ParentalStatusStats_customer_id p_ads_ParentalStatusConversionStats_customer_id p_ads_ParentalStatusNonClickStats_customer_id |
家長狀態檢視畫面 |
ParentalStatus_customer_id ParentalStatusBasicStats_customer_id ParentalStatusStats_customer_id ParentalStatusConversionStats_customer_id ParentalStatusNonClickStats_customer_id |
| 刊登位置成效報表 |
p_PlacementBasicStats_customer_id p_PlacementNonClickStats_customer_id p_PlacementStats_customer_id p_Placement_customer_id p_PlacementConversionStats_customer_id |
p_ads_PlacementBasicStats_customer_id p_ads_PlacementNonClickStats_customer_id p_ads_PlacementStats_customer_id p_ads_Placement_customer_id p_ads_PlacementConversionStats_customer_id |
受管理刊登位置檢視畫面 |
PlacementBasicStats_customer_id PlacementNonClickStats_customer_id PlacementStats_customer_id Placement_customer_id PlacementConversionStats_customer_id |
| 搜尋查詢成效報表 |
p_SearchQueryStats_customer_id p_SearchQueryConversionStats_customer_id |
p_ads_SearchQueryStats_customer_id p_ads_SearchQueryConversionStats_customer_id |
搜尋字詞檢視畫面 |
SearchQueryStats_customer_id SearchQueryConversionStats_customer_id |
| 購物成效報表 |
p_ShoppingProductConversionStats_customer_id p_ShoppingProductStats_customer_id |
p_ads_ShoppingProductConversionStats_customer_id p_ads_ShoppingProductStats_customer_id |
購物成效檢視畫面 |
ShoppingProductConversionStats_customer_id ShoppingProductStats_customer_id |
| 影片成效報表 |
p_VideoBasicStats_customer_id p_VideoConversionStats_customer_id p_VideoStats_customer_id p_Video_customer_id p_VideoNonClickStats_customer_id |
p_ads_VideoBasicStats_customer_id p_ads_VideoConversionStats_customer_id p_ads_VideoStats_customer_id p_ads_Video_customer_id p_ads_VideoNonClickStats_customer_id |
影片 |
VideoBasicStats_customer_id VideoConversionStats_customer_id VideoStats_customer_id Video_customer_id VideoNonClickStats_customer_id |
| AdGroupBidModifier | 廣告群組出價調節係數 | |||
| AdGroupAdLabel | 廣告群組廣告標籤 | |||
| CampaignLabel | 廣告活動標籤 | |||
| CampaignCriterion | 廣告活動條件 | |||
| AdGroupLabel | 廣告群組標籤 | |||
|
AdGroupAudience AdGroupAudienceStats AdGroupAudienceConversionStats AdGroupAudienceNonClickStats AdGroupAudienceBasicStats |
廣告群組目標對象檢視畫面 | |||
| Assets (available if Pmax data is enabled) | 資產 | |||
| AssetGroup (available if Pmax data is enabled) | 素材資源群組 | |||
| AssetGroupAsset (available if Pmax data is enabled) | 素材資源群組素材資源 | |||
| AssetGroupSignal (available if Pmax data is enabled) | 素材資源群組信號 | |||
| AssetGroupProductGroupStats (available if Pmax data is enabled) | AssetGroupProductGroupStats | |||
| CampaignAssetStats (available if Pmax data is enabled) | CampaignAssetStats |
Google Ads 報表的資料欄對應
Google Ads 移轉作業建立的 BigQuery 資料表是由下列資料欄 (欄位) 組成:
Google Ads 資料表名稱:AccountBasicStats
Google Ads API 資源: customer
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | ViewThroughConversions |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如: 2018-04-17。 | 日期 |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_slot | 廣告位置。 | 運算單元 |
Google Ads 資料表名稱:AccountConversionStats
Google Ads API 資源: customer
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如: 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_slot | 廣告位置。 | 運算單元 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:AccountNonClickStats
Google Ads API 資源: customer
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。 | AllConversionRate |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_average_cpe | 您為每次廣告參與支付的平均金額。計算方式是將所有廣告參與的總費用除以廣告參與總次數。 | AverageCpe |
| metrics_average_cpv | 每當有人觀看廣告時,您需要支付的平均金額。平均單次收視出價的計算方式,是將所有廣告觀看的總費用除以觀看次數。 | AverageCpv |
| metrics_content_budget_lost_impression_share | 廣告符合在多媒體廣告聯播網上顯示的資格,但因為預算過低而錯失顯示機會的預估百分比。注意:內容預算錯失的曝光比重會回報在 0 到 0.9 的範圍內。任何大於 0.9 的值都會回報為 0.9001。 | ContentBudgetLostImpressionShare |
| metrics_content_impression_share | 將您在多媒體廣告聯播網上獲得的曝光次數,除以預估可獲得的曝光次數後所得出的百分比。注意: 內容曝光比重的範圍為 0.1 至 1。任何低於 0.1 的值都會回報為 0.0999。 | ContentImpressionShare |
| metrics_content_rank_lost_impression_share | 廣告因為廣告評級偏低,而錯失多媒體廣告聯播網曝光次數的預估百分比。注意:內容排名錯失的曝光比重會回報在 0 到 0.9 的範圍內。任何高於 0.9 的值都會回報為 0.9001。 | ContentRankLostImpressionShare |
| metrics_cost_per_all_conversions | 廣告互動費用除以所有轉換次數。 | CostPerAllConversion |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_engagement_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為廣告展開次數除以廣告顯示次數。 | EngagementRate |
| metrics_engagements | 互動次數。「參與」是指觀眾展開燈箱廣告。此外,日後其他廣告類型也可能會支援參與度指標。 | 參與 |
| metrics_invalid_click_rate | 報表統計期內,從點擊總數 (已篩除的點擊次數 + 未篩除的點擊次數) 中篩除的點擊次數百分比。 | InvalidClickRate |
| metrics_invalid_clicks | Google 認為不合理的點擊次數,不會向您收費。 | InvalidClicks |
| metrics_search_budget_lost_impression_share | 廣告符合在搜尋聯播網上顯示的資格,但因預算過低而未顯示的次數百分比 (估計值)。注意:搜尋聯播網因預算而錯失的曝光比重會以 0 到 0.9 的範圍回報。任何大於 0.9 的值都會回報為 0.9001。 | SearchBudgetLostImpressionShare |
| metrics_search_exact_match_impression_share | 這是將廣告在搜尋聯播網上實際獲得的曝光次數,除以與您關鍵字完全相符或近似變體的搜尋字詞所帶來的預估廣告曝光次數後得出的百分比,與關鍵字比對類型無關。注意:搜尋聯播網完全比對曝光比重會以 0.1 到 1 的範圍回報。低於 0.1 的值會回報為 0.0999。 | SearchExactMatchImpressionShare |
| metrics_search_impression_share | 將您在搜尋聯播網上獲得的曝光次數,除以預估可獲得的曝光次數後所得出的百分比。注意:搜尋曝光比重的範圍為 0.1 至 1。低於 0.1 的值會回報為 0.0999。 | SearchImpressionShare |
| metrics_search_rank_lost_impression_share | 廣告因為廣告評級偏低,而錯失搜尋聯播網曝光次數的預估百分比。注意:搜尋聯播網錯失的曝光比重 (排名) 範圍為 0 到 0.9。任何高於 0.9 的值都會回報為 0.9001。 | SearchRankLostImpressionShare |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_video_view_rate | TrueView 影片廣告獲得的觀看次數除以曝光次數,TrueView 隨播廣告縮圖的曝光次數也包含在內。 | VideoViewRate |
| metrics_video_views | 影片廣告的觀看次數。 | VideoViews |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如: 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:AccountStats
Google Ads API 資源: customer
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可視曝光次數 (`active_view_impressions`) 的平均費用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可評估點擊次數除以 Active View 可視曝光次數。 這項指標只會針對多媒體廣告聯播網回報。 | ActiveViewCtr |
| metrics_active_view_impressions | 這項指標可評估廣告在多媒體廣告聯播網網站上顯示的頻率。 | ActiveViewImpressions |
| metrics_active_view_measurability | 可由 Active View 評估的曝光次數,除以放送的曝光次數所得的比例。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | 您獲得的曝光中,可透過 Active View 評估的曝光費用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 廣告在刊登位置中顯示的次數,且顯示位置必須能讓使用者看到廣告。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 在啟用 Active View 的網站上,廣告曝光可視次數 (可視曝光) 占可評估曝光次數的百分比。 | ActiveViewViewability |
| metrics_average_cost | 您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。 | AverageCost |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_average_cpm | 平均千次曝光出價。 | AverageCpm |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionRate |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interaction_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 | InteractionRate |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如: 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:廣告
Google Ads API 資源: ad_group_ad
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_ad_ad_added_by_google_ads | 指出這則廣告是否由 Google Ads 自動新增,而非由使用者新增。舉例來說,系統可能會根據現有廣告的成效,自動建立新廣告建議。 | 自動 |
| ad_group_ad_ad_app_ad_descriptions | 說明的文字素材資源清單。廣告放送時,系統會從這份清單中選取說明。 | UniversalAppAdDescriptions |
| ad_group_ad_ad_app_ad_headlines | 廣告標題的文字素材資源清單。從這個清單中選取廣告放送的廣告標題。 | UniversalAppAdHeadlines |
| ad_group_ad_ad_app_ad_html5_media_bundles | 可與廣告搭配使用的媒體組合素材資源清單。 | UniversalAppAdHtml5MediaBundles |
| ad_group_ad_ad_app_ad_images | 可能會與廣告一起顯示的圖片素材資源清單。 | UniversalAppAdImages |
| ad_group_ad_ad_app_ad_mandatory_ad_text | 選填的文字素材資源,指定後,廣告放送時一律會顯示。 | UniversalAppAdMandatoryAdText |
| ad_group_ad_ad_app_ad_youtube_videos | 可能會與廣告一起顯示的 YouTube 影片素材資源清單。 | UniversalAppAdYouTubeVideos |
| ad_group_ad_ad_call_ad_phone_number | 廣告中的電話號碼。 | CallOnlyPhoneNumber |
| ad_group_ad_ad_device_preference | 廣告的裝置偏好設定。您只能指定行動裝置的偏好設定。設定這項偏好設定後,廣告在行動裝置上顯示時,會優先於其他廣告。廣告仍可顯示在其他類型的裝置上。舉例來說,如果沒有其他可放送的廣告,如果未指定 (沒有裝置偏好設定),系統會指定所有裝置。只有部分廣告類型支援這項功能。 | |
| ad_group_ad_ad_display_url | 部分廣告格式的廣告說明中顯示的網址。 | DisplayUrl |
| ad_group_ad_ad_expanded_dynamic_search_ad_description | 廣告說明。 | |
| ad_group_ad_ad_expanded_dynamic_search_ad_description2 | 廣告的第二行說明。 | ExpandedDynamicSearchCreativeDescription2 |
| ad_group_ad_ad_expanded_text_ad_description | 廣告說明。 | |
| ad_group_ad_ad_expanded_text_ad_description2 | 廣告的第二行說明。 | ExpandedTextAdDescription2 |
| ad_group_ad_ad_expanded_text_ad_headline_part1 | 廣告標題的第一部分。 | HeadlinePart1 |
| ad_group_ad_ad_expanded_text_ad_headline_part2 | 廣告標題的第二部分。 | HeadlinePart2 |
| ad_group_ad_ad_expanded_text_ad_headline_part3 | 廣告標題的第三部分。 | ExpandedTextAdHeadlinePart3 |
| ad_group_ad_ad_expanded_text_ad_path1 | 可與廣告顯示網址一併顯示的文字。 | Path1 |
| ad_group_ad_ad_expanded_text_ad_path2 | 可顯示在廣告顯示網址旁邊的額外文字。 | Path2 |
| ad_group_ad_ad_final_app_urls | 如果使用者已安裝特定應用程式,系統會使用這份清單中的最終應用程式網址。 | CreativeFinalAppUrls |
| ad_group_ad_ad_final_mobile_urls | 廣告在所有跨網域重新導向後,可能的最終行動版網址清單。 | CreativeFinalMobileUrls |
| ad_group_ad_ad_final_urls | 廣告在所有跨網域重新導向後可能連到的最終到達網址清單。 | CreativeFinalUrls |
| ad_group_ad_ad_group | 廣告所屬的廣告群組。 | |
| ad_group_ad_ad_id | 廣告的 ID。 | CreativeId |
| ad_group_ad_ad_image_ad_image_url | 原尺寸圖片的網址。 | ImageAdUrl |
| ad_group_ad_ad_image_ad_mime_type | 圖片的 MIME 類型。 | ImageCreativeMimeType |
| ad_group_ad_ad_image_ad_name | 圖片名稱。如果圖片是從 MediaFile 建立,則為 MediaFile 的名稱。如果圖片是從位元組建立,這個欄位會是空白。 | ImageCreativeName |
| ad_group_ad_ad_image_ad_pixel_height | 完整尺寸圖片的高度 (以像素為單位)。 | ImageCreativeImageHeight |
| ad_group_ad_ad_image_ad_pixel_width | 原尺寸圖片的寬度 (以像素為單位)。 | ImageCreativeImageWidth |
| ad_group_ad_ad_legacy_responsive_display_ad_accent_color | 廣告的強調色 (十六進位)。例如,#ffffff 代表白色。如果設定了 main_color 和 accent_color 其中一個,則另一個也必須設定。 | AccentColor |
| ad_group_ad_ad_legacy_responsive_display_ad_allow_flexible_color | 廣告主同意允許彈性顏色。如果為 true,廣告可能會視需要以不同顏色放送。如果為 false,廣告會以指定顏色或中性色放送。預設值為 true。如果未設定 main_color 和 accent_color,則必須為 true。 | AllowFlexibleColor |
| ad_group_ad_ad_legacy_responsive_display_ad_business_name | 廣告中的商家名稱。 | BusinessName |
| ad_group_ad_ad_legacy_responsive_display_ad_call_to_action_text | 廣告的行動號召文字。 | CallToActionText |
| ad_group_ad_ad_legacy_responsive_display_ad_description | 廣告說明。 | 說明 |
| ad_group_ad_ad_legacy_responsive_display_ad_format_setting | 指定廣告放送的格式。預設值為 ALL_FORMATS。 | FormatSetting |
| ad_group_ad_ad_legacy_responsive_display_ad_logo_image | 廣告中使用的標誌圖片的 MediaFile 資源名稱。 | EnhancedDisplayCreativeLandscapeLogoImageMediaId |
| ad_group_ad_ad_legacy_responsive_display_ad_long_headline | 廣告標題的長版。 | LongHeadline |
| ad_group_ad_ad_legacy_responsive_display_ad_main_color | 廣告的主要顏色 (十六進位)。例如,#ffffff 代表白色。如果設定了 main_color 和 accent_color 其中一個,則另一個也必須設定。 | MainColor |
| ad_group_ad_ad_legacy_responsive_display_ad_marketing_image | 廣告中使用的行銷圖片的 MediaFile 資源名稱。 | EnhancedDisplayCreativeMarketingImageMediaId |
| ad_group_ad_ad_legacy_responsive_display_ad_price_prefix | 價格前置字元。例如「最低只要」。 | PricePrefix |
| ad_group_ad_ad_legacy_responsive_display_ad_promo_text | 用於動態格式回應式廣告的宣傳文字。例如「免運費兩天到貨」。 | PromoText |
| ad_group_ad_ad_legacy_responsive_display_ad_short_headline | 廣告標題的簡短版本。 | ShortHeadline |
| ad_group_ad_ad_legacy_responsive_display_ad_square_logo_image | 廣告中使用的正方形標誌圖片的 MediaFile 資源名稱。 | EnhancedDisplayCreativeLogoImageMediaId |
| ad_group_ad_ad_legacy_responsive_display_ad_square_marketing_image | 廣告中使用的正方形行銷圖片的 MediaFile 資源名稱。 | EnhancedDisplayCreativeMarketingImageSquareMediaId |
| ad_group_ad_ad_responsive_display_ad_accent_color | 廣告的強調色 (十六進位)。例如,#ffffff 代表白色。 如果設定了 main_color 和 accent_color 其中一個,則另一個也必須設定。 | MultiAssetResponsiveDisplayAdAccentColor |
| ad_group_ad_ad_responsive_display_ad_business_name | 廣告主或品牌名稱。顯示寬度上限為 25。 | MultiAssetResponsiveDisplayAdBusinessName |
| ad_group_ad_ad_responsive_display_ad_call_to_action_text | 廣告的行動號召文字。顯示寬度上限為 30。 | MultiAssetResponsiveDisplayAdCallToActionText |
| ad_group_ad_ad_responsive_display_ad_descriptions | 廣告的說明文字。長度上限為 90 個半形字元。至少可指定 1 則廣告標題,最多可指定 5 則。 | MultiAssetResponsiveDisplayAdDescriptions |
| ad_group_ad_ad_responsive_display_ad_format_setting | 指定廣告放送的格式。預設值為 ALL_FORMATS。 | MultiAssetResponsiveDisplayAdFormatSetting |
| ad_group_ad_ad_responsive_display_ad_headlines | 廣告的簡短格式廣告標題。長度上限為 30 個字元。至少可指定 1 則廣告標題,最多可指定 5 則。 | MultiAssetResponsiveDisplayAdHeadlines |
| ad_group_ad_ad_responsive_display_ad_logo_images | 要在廣告中使用的標誌圖片。有效圖片類型為 GIF、JPEG 和 PNG。最小尺寸為 512x128,長寬比必須為 4:1 (+-1%)。 與 square_logo_images 合計最多 5 張。 | MultiAssetResponsiveDisplayAdLandscapeLogoImages |
| ad_group_ad_ad_responsive_display_ad_long_headline | 長格式廣告標題 (必填)。長度上限為 90 個半形字元。 | MultiAssetResponsiveDisplayAdLongHeadline |
| ad_group_ad_ad_responsive_display_ad_main_color | 廣告的主要顏色 (十六進位)。例如,#ffffff 代表白色。如果設定了 main_color 和 accent_color 其中一個,則另一個也必須設定。 | MultiAssetResponsiveDisplayAdMainColor |
| ad_group_ad_ad_responsive_display_ad_marketing_images | 要在廣告中使用的行銷圖片。有效圖片類型為 GIF、JPEG 和 PNG。最低尺寸為 600x314,長寬比必須為 1.91:1 (±1%)。至少須提供一張行銷圖片。與 square_marketing_images 合計最多 15 張。 | MultiAssetResponsiveDisplayAdMarketingImages |
| ad_group_ad_ad_responsive_display_ad_price_prefix | 價格前置字元。例如「最低只要」。 | MultiAssetResponsiveDisplayAdDynamicSettingsPricePrefix |
| ad_group_ad_ad_responsive_display_ad_promo_text | 用於動態格式回應式廣告的宣傳文字。例如「免運費兩天到貨」。 | MultiAssetResponsiveDisplayAdDynamicSettingsPromoText |
| ad_group_ad_ad_responsive_display_ad_square_logo_images | 要在廣告中使用的正方形標誌圖片。有效圖片類型為 GIF、JPEG 和 PNG。大小下限為 128x128,顯示比例必須為 1:1 (+/-1%)。與 square_logo_images 合計最多 5 張。 | MultiAssetResponsiveDisplayAdLogoImages |
| ad_group_ad_ad_responsive_display_ad_square_marketing_images | 要在廣告中使用的正方形行銷圖片。有效的圖片類型為 GIF、 JPEG 和 PNG。最小尺寸為 300x300,長寬比必須為 1:1 (+-1%)。請至少提供一張正方形行銷圖片。與行銷圖片合併計算後,最多 15 張。 | MultiAssetResponsiveDisplayAdSquareMarketingImages |
| ad_group_ad_ad_responsive_display_ad_youtube_videos | 廣告的選用 YouTube 影片。最多可指定 5 部影片。 | MultiAssetResponsiveDisplayAdYouTubeVideos |
| ad_group_ad_ad_responsive_search_ad_descriptions | 說明的文字素材資源清單。廣告放送時,系統會從這份清單中選取說明。 | ResponsiveSearchAdDescriptions |
| ad_group_ad_ad_responsive_search_ad_headlines | 廣告標題的文字素材資源清單。廣告放送時,系統會從這個清單中選取廣告標題。 | ResponsiveSearchAdHeadlines |
| ad_group_ad_ad_responsive_search_ad_path1 | 文字的第一部分,可能會附加至廣告中顯示的網址。 | ResponsiveSearchAdPath1 |
| ad_group_ad_ad_responsive_search_ad_path2 | 第二部分文字,可能會附加在廣告中顯示的網址後方。只有在設定 path1 時,才能設定這個欄位。 | ResponsiveSearchAdPath2 |
| ad_group_ad_ad_strength | 這個廣告群組廣告的整體廣告優異度。 | AdStrengthInfo |
| ad_group_ad_ad_system_managed_resource_source | 如果這個廣告是由系統管理,這個欄位會指出來源。 這是唯讀欄位。 | SystemManagedEntitySource |
| ad_group_ad_ad_text_ad_description1 | 廣告內容描述的第一行。 | Description1 |
| ad_group_ad_ad_text_ad_description2 | 廣告說明的第二行。 | Description2 |
| ad_group_ad_ad_text_ad_headline | 廣告標題。 | 標題 |
| ad_group_ad_ad_tracking_url_template | 用於建構追蹤網址的網址範本。 | CreativeTrackingUrlTemplate |
| ad_group_ad_ad_type | 廣告類型。 | AdType |
| ad_group_ad_ad_url_custom_parameters | 可用於取代 `tracking_url_template`、`final_urls` 或 `mobile_final_urls` 中自訂參數標記的對應清單。如要變動,請使用網址自訂參數作業。 | CreativeUrlCustomParameters |
| ad_group_ad_status | 廣告的狀態。 | 狀態 |
| ad_group_id | 僅供輸出。廣告群組 ID。 | AdGroupId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
Google Ads 表格名稱:AdBasicStats
Google Ads API 資源: ad_group_ad
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_ad_ad_group | 廣告所屬的廣告群組。 | |
| ad_group_ad_ad_id | 廣告的 ID。 | CreativeId |
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_id | 僅供輸出。廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | ViewThroughConversions |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_slot | 廣告位置。 | 運算單元 |
Google Ads 表格名稱:AdConversionStats
Google Ads API 資源: ad_group_ad
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_ad_ad_group | 廣告所屬的廣告群組。 | |
| ad_group_ad_ad_id | 廣告的 ID。 | CreativeId |
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_id | 僅供輸出。廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_slot | 廣告位置。 | 運算單元 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:AdCrossDeviceConversionStats
Google Ads API 資源: ad_group_ad
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_ad_ad_group | 廣告所屬的廣告群組。 | |
| ad_group_ad_ad_id | 廣告的 ID。 | CreativeId |
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_id | 僅供輸出。廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:AdCrossDeviceStats
Google Ads API 資源: ad_group_ad
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_ad_ad_group | 廣告所屬的廣告群組。 | |
| ad_group_ad_ad_id | 廣告的 ID。 | CreativeId |
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_id | 僅供輸出。廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_absolute_top_impression_percentage | 廣告顯示於自然搜尋結果上方第一則廣告的百分比。 | AbsoluteTopImpressionPercentage |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。 | AllConversionRate |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_average_cpe | 您為每次廣告參與支付的平均金額。計算方式是將所有廣告參與的總費用除以廣告參與總次數。 | AverageCpe |
| metrics_average_cpv | 每當有人觀看廣告時,您需要支付的平均金額。平均單次收視出價的計算方式,是將所有廣告觀看的總費用除以觀看次數。 | AverageCpv |
| metrics_average_page_views | 每個工作階段的平均網頁瀏覽量。 | AveragePageviews |
| metrics_average_time_on_site | 所有工作階段的總持續時間 (以秒為單位) 除以工作階段數。已從 Google Analytics 匯入。 | AverageTimeOnSite |
| metrics_bounce_rate | 使用者點擊後只造訪網站上單一網頁的百分比。已從 Google Analytics 匯入。 | BounceRate |
| metrics_cost_per_all_conversions | 廣告互動費用除以所有轉換次數。 | CostPerAllConversion |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_engagement_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為廣告展開次數除以廣告顯示次數。 | EngagementRate |
| metrics_engagements | 互動次數。「參與」是指觀眾展開燈箱廣告。此外,日後其他廣告類型也可能會支援參與度指標。 | 參與 |
| metrics_percent_new_visitors | 首次工作階段的百分比 (來自從未造訪過您網站的使用者)。已從 Google Analytics 匯入。 | PercentNewVisitors |
| metrics_top_impression_percentage | 廣告曝光顯示於自然搜尋結果上方任一處的百分比。 | TopImpressionPercentage |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_video_quartile_p100_rate | 觀眾看完影片的曝光次數百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 觀眾觀看影片 25% 的曝光次數百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 觀眾觀看影片 50% 的曝光次數百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 觀眾觀看影片 75% 的曝光次數百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 影片廣告獲得的觀看次數除以曝光次數,TrueView 隨播廣告縮圖的曝光次數也包含在內。 | VideoViewRate |
| metrics_video_views | 影片廣告的觀看次數。 | VideoViews |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:AdGroup
Google Ads API 資源: ad_group
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_ad_rotation_mode | 廣告群組的廣告輪播模式。 | AdRotationMode |
| ad_group_cpc_bid_micros | 最高單次點擊出價。 | CpcBid |
| ad_group_cpm_bid_micros | 最高千次可視曝光出價。 | CpmBidStr |
| ad_group_cpv_bid_micros | 單次收視出價。 | CpvBid |
| ad_group_display_custom_bid_dimension | 廣告主可指定要針對哪個指定維度設定絕對出價。這項功能僅適用於只指定多媒體廣告聯播網,而非搜尋聯播網的廣告活動。 | ContentBidCriterionTypeGroup |
| ad_group_effective_target_cpa_micros | 有效目標單次動作出價 (單次動作出價)。這是唯讀欄位。 | TargetCpa |
| ad_group_effective_target_cpa_source | 有效目標單次動作出價的來源。這是唯讀欄位。 | TargetCpaBidSource |
| ad_group_effective_target_roas | 有效目標廣告投資報酬率。這是唯讀欄位。 | EffectiveTargetRoas |
| ad_group_effective_target_roas_source | 有效目標廣告投資報酬率的來源。這是唯讀欄位。 | EffectiveTargetRoasSource |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| ad_group_name | 廣告群組的名稱。建立新廣告群組時,這個欄位為必填,且不得為空白。長度不得超過 255 個 UTF-8 全形字元。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 | AdGroupName |
| ad_group_status | 廣告群組的狀態。 | AdGroupStatus |
| ad_group_tracking_url_template | 用於建構追蹤網址的網址範本。 | TrackingUrlTemplate |
| ad_group_type | 廣告群組類型。 | AdGroupType |
| ad_group_url_custom_parameters | 用於取代 `tracking_url_template`、`final_urls` 或 `mobile_final_urls` 中自訂參數標記的對應清單。 | UrlCustomParameters |
| campaign_bidding_strategy | 廣告活動採用的組合出價策略。 | BiddingStrategyId |
| campaign_bidding_strategy_type | 出價策略類型。您可以設定出價計畫來建立標準出價策略,也可以設定 `bidding_strategy` 欄位來建立組合出價策略。這個欄位為唯讀。 | BiddingStrategyType |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| campaign_manual_cpc_enhanced_cpc_enabled | 是否要根據轉換最佳化工具資料調整出價。 | EnhancedCpcEnabled |
| campaign_percent_cpc_enhanced_cpc_enabled | 根據轉換可能性,在每次競價中調高或調低出價。個別出價可能會超過 cpc_bid_ceiling_micros,但廣告活動的平均出價金額不應超過此值。 | |
| customer_id | 顧客 ID。 | ExternalCustomerId |
Google Ads 表格名稱:AdGroupAdLabel
Google Ads API 資源: ad_group_ad_label
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_ad_label_ad_group_ad | 標籤附加的廣告群組廣告。 | |
| ad_group_ad_label_label | 指派給廣告群組廣告的標籤。 | |
| ad_group_ad_label_resource_name | 廣告群組廣告標籤的資源名稱。廣告群組廣告標籤資源名稱的格式為:`customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}` | |
| ad_group_id | 廣告群組 ID。 | |
| ad_group_name | 廣告群組的名稱。建立新廣告群組時,這個欄位為必填,且不得為空白。長度不得超過 255 個 UTF-8 全形字元。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 | |
| label_id | 標籤的 ID。僅供檢視。 | |
| label_name | 標籤名稱。建立新標籤時,這個欄位為必填,且不得為空白。字串長度應介於 1 至 80 個半形字元之間 (含首尾)。 | |
| label_resource_name | 資源名稱。標籤資源名稱的格式為: `customers/{customer_id}/labels/{label_id}` |
Google Ads 資料表名稱:AdGroupAudience
Google Ads API 資源: ad_group_audience_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | |
| ad_group_campaign | 廣告群組所屬的廣告活動。 | |
| ad_group_criterion_bid_modifier | 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援修飾符。 | |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | |
| ad_group_criterion_effective_cpc_bid_micros | 有效單次點擊出價。 | |
| ad_group_criterion_effective_cpc_bid_source | 有效單次點擊出價的來源。 | |
| ad_group_criterion_effective_cpm_bid_micros | 有效千次可視曝光出價。 | |
| ad_group_criterion_effective_cpm_bid_source | 有效千次曝光出價的來源。 | |
| ad_group_criterion_final_mobile_urls | 所有跨網域重新導向後,可能的最終行動版網址清單。 | |
| ad_group_criterion_final_urls | 廣告在所有跨網域重新導向後可能連到的最終到達網址清單。 | |
| ad_group_criterion_keyword_text | 關鍵字文字 (最多 80 個字元和 10 個字)。 | |
| ad_group_criterion_status | 條件的狀態。 | |
| ad_group_id | 廣告群組 ID。 | |
| ad_group_targeting_setting_target_restrictions | 限制廣告活動或廣告群組觸及範圍的指定維度設定。 | |
| ad_group_tracking_url_template | 用於建構追蹤網址的網址範本。 | |
| ad_group_url_custom_parameters | 用於取代 `tracking_url_template`、`final_urls` 或 `mobile_final_urls` 中自訂參數標記的對應清單。 | |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | |
| campaign_bidding_strategy | 廣告活動採用的組合出價策略。 | |
| customer_id | 顧客 ID。 |
Google Ads 資料表名稱:AdGroupAudienceBasicStats
Google Ads API 資源: ad_group_audience_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | |
| ad_group_campaign | 廣告群組所屬的廣告活動。 | |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | |
| ad_group_id | 廣告群組 ID。 | |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | |
| customer_id | 顧客 ID。 | |
| metrics_clicks | 點擊次數。 | |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | |
| segments_ad_network_type | 廣告聯播網類型。 | |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | |
| segments_device | 指標適用的裝置。 | |
| segments_slot | 廣告位置。 |
Google Ads 資料表名稱:AdGroupAudienceConversionStats
Google Ads API 資源: ad_group_audience_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | |
| ad_group_campaign | 廣告群組所屬的廣告活動。 | |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | |
| ad_group_id | 廣告群組 ID。 | |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | |
| customer_id | 顧客 ID。 | |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_all_conversions_value | 所有轉換的總價值。 | |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | |
| segments_ad_network_type | 廣告聯播網類型。 | |
| segments_conversion_action | 轉換動作的資源名稱。 | |
| segments_conversion_action_category | 轉換動作類別。 | |
| segments_conversion_action_name | 轉換動作名稱。 | |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | |
| segments_device | 指標適用的裝置。 | |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | |
| segments_year | 年份,格式為 yyyy。 |
Google Ads 資料表名稱:AdGroupAudienceNonClickStats
Google Ads API 資源: ad_group_audience_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | |
| ad_group_campaign | 廣告群組所屬的廣告活動。 | |
| ad_group_id | 廣告群組 ID。 | |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | |
| customer_id | 顧客 ID。 | |
| metrics_average_cpe | 您為每次廣告參與支付的平均金額。計算方式是將所有廣告參與的總費用除以廣告參與總次數。 | |
| metrics_average_cpv | 每當有人觀看廣告時,您需要支付的平均金額。平均單次收視出價的計算方式,是將所有廣告觀看的總費用除以觀看次數。 | |
| metrics_engagement_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為廣告展開次數除以廣告顯示次數。 | |
| metrics_engagements | 互動次數。「參與」是指觀眾展開燈箱廣告。此外,日後其他廣告類型也可能會支援參與度指標。 | |
| metrics_video_view_rate | TrueView 影片廣告獲得的觀看次數除以曝光次數,TrueView 隨播廣告縮圖的曝光次數也包含在內。 | |
| metrics_video_views | 影片廣告的觀看次數。 | |
| segments_ad_network_type | 廣告聯播網類型。 | |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | |
| segments_device | 指標適用的裝置。 | |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | |
| segments_year | 年份,格式為 yyyy。 |
Google Ads 資料表名稱:AdGroupAudienceStats
Google Ads API 資源: ad_group_audience_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | |
| ad_group_campaign | 廣告群組所屬的廣告活動。 | |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | |
| ad_group_id | 廣告群組 ID。 | |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | |
| customer_id | 顧客 ID。 | |
| metrics_active_view_cpm | 可視曝光次數 (`active_view_impressions`) 的平均費用。 | |
| metrics_active_view_ctr | Active View 可評估點擊次數除以 Active View 可視曝光次數。 這項指標只會針對多媒體廣告聯播網回報。 | |
| metrics_active_view_impressions | 這項指標可評估廣告在多媒體廣告聯播網網站上顯示的頻率。 | |
| metrics_active_view_measurability | 可由 Active View 評估的曝光次數,除以放送的曝光次數所得的比例。 | |
| metrics_active_view_measurable_cost_micros | 您獲得的曝光中,可透過 Active View 評估的曝光費用。 | |
| metrics_active_view_measurable_impressions | 廣告在刊登位置中顯示的次數,且顯示位置必須能讓使用者看到廣告。 | |
| metrics_active_view_viewability | 在啟用 Active View 的網站上,廣告曝光可視次數 (可視曝光) 占可評估曝光次數的百分比。 | |
| metrics_all_conversions_from_interactions_rate | 所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。 | |
| metrics_average_cost | 您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。 | |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | |
| metrics_average_cpm | 平均千次曝光出價。 | |
| metrics_clicks | 點擊次數。 | |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | |
| metrics_cost_per_all_conversions | 廣告互動費用除以所有轉換次數。 | |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | |
| metrics_gmail_forwards | 廣告以訊息形式轉寄給其他人的次數。 | |
| metrics_gmail_saves | 使用者將 Gmail 廣告儲存到收件匣的次數。 | |
| metrics_gmail_secondary_clicks | Gmail 廣告展開後,使用者點擊到達網頁的次數。 | |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | |
| metrics_interaction_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 | |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| segments_ad_network_type | 廣告聯播網類型。 | |
| segments_click_type | 點擊類型。 | |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | |
| segments_device | 指標適用的裝置。 | |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | |
| segments_year | 年份,格式為 yyyy。 |
Google Ads 資料表名稱:AdGroupBasicStats
Google Ads API 資源: ad_group
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | ViewThroughConversions |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_slot | 廣告位置。 | 運算單元 |
Google Ads 表格名稱:AdGroupBidModifier
Google Ads API 資源: ad_group_bid_modifier
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_bid_modifier_ad_group | 這個條件所屬的廣告群組。 | |
| ad_group_bid_modifier_base_ad_group | 建立這個草稿或試驗廣告群組出價調節係數時所用的基礎廣告群組。如果 ad_group 是基礎廣告群組,這個欄位會等於 ad_group。如果廣告群組是在草稿或試用廣告活動中建立,且沒有對應的基礎廣告群組,則這個欄位為空值。這個欄位為唯讀。 | |
| ad_group_bid_modifier_bid_modifier | 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。PreferredContent 的範圍為 1.0 至 6.0。使用 0 即可停用裝置類型。 | |
| ad_group_bid_modifier_bid_modifier_source | 出價調節係數來源。 | |
| ad_group_bid_modifier_criterion_id | 要修改出價的條件 ID。系統會忽略變動中的這個欄位。 | |
| ad_group_bid_modifier_device_type | 裝置的類型。 | |
| ad_group_bid_modifier_resource_name | 廣告群組出價調節係數的資源名稱。廣告群組出價調節係數 資源名稱的格式為: `customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}` | |
| ad_group_id | 廣告群組 ID。 | |
| ad_group_name | 廣告群組的名稱。建立新廣告群組時,這個欄位為必填,且不得為空白。長度不得超過 255 個 UTF-8 全形字元。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 |
Google Ads 資料表名稱:AdGroupConversionStats
Google Ads API 資源: ad_group
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_slot | 廣告位置。 | 運算單元 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:AdGroupCriterion
Google Ads API 資源: ad_group_criterion
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_criterion_ad_group | 條件所屬的廣告群組。 | |
| ad_group_criterion_bid_modifier | 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援修飾符。 | |
| ad_group_criterion_cpc_bid_micros | 單次點擊出價。 | |
| ad_group_criterion_cpm_bid_micros | 千次可視曝光出價。 | |
| ad_group_criterion_cpv_bid_micros | 單次點擊出價。 | |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | |
| ad_group_criterion_display_name | 條件的顯示名稱。系統會忽略變動中的這個欄位。 | |
| ad_group_criterion_negative | 是否要指定 (`false`) 或排除 (`true`) 條件。 | |
| ad_group_criterion_status | 條件的狀態。 | |
| ad_group_criterion_type | 條件類型。 | |
| ad_group_id | 廣告群組 ID。 | |
| ad_group_name | 廣告群組的名稱。建立新廣告群組時,這個欄位為必填,且不得為空白。長度不得超過 255 個 UTF-8 全形字元。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 |
Google Ads 資料表名稱:AdGroupCriterionLabel
Google Ads API 資源: ad_group_criterion_label
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | |
| ad_group_criterion_label_ad_group_criterion | 標籤附加的廣告群組條件。 | |
| ad_group_criterion_label_label | 指派給廣告群組條件的標籤。 | |
| ad_group_criterion_label_resource_name | 廣告群組條件標籤的資源名稱。廣告群組條件標籤資源名稱的格式為: `customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}` | |
| label_id | 標籤的 ID。僅供檢視。 | |
| label_name | 標籤名稱。建立新標籤時,這個欄位為必填,且不得為空白。字串長度應介於 1 至 80 個半形字元之間 (含首尾)。 | |
| label_resource_name | 資源名稱。標籤資源名稱的格式為: `customers/{customer_id}/labels/{label_id}` |
Google Ads 資料表名稱:AdGroupCrossDeviceConversionStats
Google Ads API 資源: ad_group
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:AdGroupCrossDeviceStats
Google Ads API 資源: ad_group
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_absolute_top_impression_percentage | 廣告顯示於自然搜尋結果上方第一則廣告的百分比。 | AbsoluteTopImpressionPercentage |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。 | AllConversionRate |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_average_cpe | 您為每次廣告參與支付的平均金額。計算方式是將所有廣告參與的總費用除以廣告參與總次數。 | AverageCpe |
| metrics_average_cpv | 每當有人觀看廣告時,您需要支付的平均金額。平均單次收視出價的計算方式,是將所有廣告觀看的總費用除以觀看次數。 | AverageCpv |
| metrics_average_page_views | 每個工作階段的平均網頁瀏覽量。 | AveragePageviews |
| metrics_average_time_on_site | 所有工作階段的總持續時間 (以秒為單位) 除以工作階段數。已從 Google Analytics 匯入。 | AverageTimeOnSite |
| metrics_bounce_rate | 使用者點擊後只造訪網站上單一網頁的百分比。已從 Google Analytics 匯入。 | BounceRate |
| metrics_content_impression_share | 將您在多媒體廣告聯播網上獲得的曝光次數,除以預估可獲得的曝光次數後所得出的百分比。注意: 內容曝光比重的範圍為 0.1 至 1。任何低於 0.1 的值都會回報為 0.0999。 | ContentImpressionShare |
| metrics_content_rank_lost_impression_share | 廣告因為廣告評級偏低,而錯失多媒體廣告聯播網曝光次數的預估百分比。注意:內容排名錯失的曝光比重會回報在 0 到 0.9 的範圍內。任何高於 0.9 的值都會回報為 0.9001。 | ContentRankLostImpressionShare |
| metrics_cost_per_all_conversions | 廣告互動費用除以所有轉換次數。 | CostPerAllConversion |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_engagement_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為廣告展開次數除以廣告顯示次數。 | EngagementRate |
| metrics_engagements | 互動次數。「參與」是指觀眾展開燈箱廣告。此外,日後其他廣告類型也可能會支援參與度指標。 | 參與 |
| metrics_percent_new_visitors | 首次工作階段的百分比 (來自從未造訪過您網站的使用者)。已從 Google Analytics 匯入。 | PercentNewVisitors |
| metrics_phone_calls | 離線電話通話次數。 | NumOfflineInteractions |
| metrics_phone_impressions | 離線電話曝光次數。 | NumOfflineImpressions |
| metrics_phone_through_rate | 獲得的通話次數 (phone_calls) 除以電話號碼顯示次數 (phone_impressions)。 | OfflineInteractionRate |
| metrics_relative_ctr | 您的點閱率除以在顯示您廣告的網站上,所有廣告主的平均點閱率。評估您的廣告在多媒體廣告聯播網網站上的成效,與相同網站上的其他廣告相比如何。 | RelativeCtr |
| metrics_search_absolute_top_impression_share | 有多少百分比的購物或搜尋廣告曝光位於最顯眼的購物廣告刊登位置。詳情請參閱 https://support.google.com/google-ads/answer/7501826。低於 0.1 的值會回報為 0.0999。 | SearchAbsoluteTopImpressionShare |
| metrics_search_budget_lost_absolute_top_impression_share | 這項預估值表示廣告有多常因為預算偏低,而無法成為自然搜尋結果上方顯示的第一則廣告。注意:搜尋聯播網錯失的絕對頂端曝光比重 (預算) 的回報範圍為 0 到 0.9。任何大於 0.9 的值都會回報為 0.9001。 | SearchBudgetLostAbsoluteTopImpressionShare |
| metrics_search_budget_lost_top_impression_share | 這項指標會估算廣告因預算偏低,而無法顯示於自然搜尋結果上方任一位置的頻率。注意:搜尋聯播網錯失的頂端曝光比重 (預算) 的報表範圍為 0 到 0.9。任何大於 0.9 的值都會回報為 0.9001。 | SearchBudgetLostTopImpressionShare |
| metrics_search_exact_match_impression_share | 這是將廣告在搜尋聯播網上實際獲得的曝光次數,除以與您關鍵字完全相符或近似變體的搜尋字詞所帶來的預估廣告曝光次數後得出的百分比,與關鍵字比對類型無關。注意:搜尋聯播網完全比對曝光比重會以 0.1 到 1 的範圍回報。低於 0.1 的值會回報為 0.0999。 | SearchExactMatchImpressionShare |
| metrics_search_impression_share | 將您在搜尋聯播網上獲得的曝光次數,除以預估可獲得的曝光次數後所得出的百分比。注意:搜尋曝光比重的範圍為 0.1 至 1。低於 0.1 的值會回報為 0.0999。 | SearchImpressionShare |
| metrics_search_rank_lost_absolute_top_impression_share | 這項估算值代表廣告有多常因為廣告評級不佳,而無法在自然搜尋結果上方顯示為第一則廣告。注意:搜尋聯播網錯失的絕對頂端曝光比重 (評級) 的回報範圍為 0 到 0.9。任何大於 0.9 的值都會回報為 0.9001。 | SearchRankLostAbsoluteTopImpressionShare |
| metrics_search_rank_lost_impression_share | 廣告因為廣告評級偏低,而錯失搜尋聯播網曝光次數的預估百分比。注意:搜尋聯播網錯失的曝光比重 (排名) 範圍為 0 到 0.9。任何高於 0.9 的值都會回報為 0.9001。 | SearchRankLostImpressionShare |
| metrics_search_rank_lost_top_impression_share | 這項數字估算的是廣告因為廣告評級不佳,而無法顯示於自然搜尋結果上方任一位置的頻率。注意:搜尋排名錯失的頂端曝光比重會以 0 到 0.9 的範圍回報。任何大於 0.9 的值都會回報為 0.9001。 | SearchRankLostTopImpressionShare |
| metrics_search_top_impression_share | 相較於廣告預估有資格在頂端位置獲得的曝光次數,廣告在頂端位置 (自然搜尋結果上方的任一位置) 實際獲得的曝光次數。注意:搜尋聯播網頂端曝光比重的範圍為 0.1 到 1。低於 0.1 的值會回報為 0.0999。 | SearchTopImpressionShare |
| metrics_top_impression_percentage | 廣告曝光顯示於自然搜尋結果上方任一處的百分比。 | TopImpressionPercentage |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_video_quartile_p100_rate | 觀眾看完影片的曝光次數百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 觀眾觀看影片 25% 的曝光次數百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 觀眾觀看影片 50% 的曝光次數百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 觀眾觀看影片 75% 的曝光次數百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 影片廣告獲得的觀看次數除以曝光次數,TrueView 隨播廣告縮圖的曝光次數也包含在內。 | VideoViewRate |
| metrics_video_views | 影片廣告的觀看次數。 | VideoViews |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:AdGroupLabel
Google Ads API 資源: ad_group_label
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_id | 廣告群組 ID。 | |
| ad_group_label_ad_group | 標籤所附加的廣告群組。 | |
| ad_group_label_label | 指派給廣告群組的標籤。 | |
| ad_group_label_resource_name | 廣告群組標籤的資源名稱。廣告群組標籤資源名稱的格式為: `customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}` | |
| ad_group_name | 廣告群組的名稱。建立新廣告群組時,這個欄位為必填,且不得為空白。長度不得超過 255 個 UTF-8 全形字元。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 | |
| label_id | 標籤的 ID。僅供檢視。 | |
| label_name | 標籤名稱。建立新標籤時,這個欄位為必填,且不得為空白。字串長度應介於 1 至 80 個半形字元之間 (含首尾)。 | |
| label_resource_name | 資源名稱。標籤資源名稱的格式為: `customers/{customer_id}/labels/{label_id}` |
Google Ads 資料表名稱:AdGroupStats
Google Ads API 資源: ad_group
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可視曝光次數 (`active_view_impressions`) 的平均費用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可評估點擊次數除以 Active View 可視曝光次數。 這項指標只會針對多媒體廣告聯播網回報。 | ActiveViewCtr |
| metrics_active_view_impressions | 這項指標可評估廣告在多媒體廣告聯播網網站上顯示的頻率。 | ActiveViewImpressions |
| metrics_active_view_measurability | 可由 Active View 評估的曝光次數,除以放送的曝光次數所得的比例。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | 您獲得的曝光中,可透過 Active View 評估的曝光費用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 廣告在刊登位置中顯示的次數,且顯示位置必須能讓使用者看到廣告。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 在啟用 Active View 的網站上,廣告曝光可視次數 (可視曝光) 占可評估曝光次數的百分比。 | ActiveViewViewability |
| metrics_average_cost | 您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。 | AverageCost |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_average_cpm | 平均千次曝光出價。 | AverageCpm |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionRate |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_cost_per_current_model_attributed_conversion | 廣告互動費用除以目前模式歸因的轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerCurrentModelAttributedConversion |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_current_model_attributed_conversions | 顯示您選取的歸因模式套用至歷來轉換資料的結果。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CurrentModelAttributedConversions |
| metrics_current_model_attributed_conversions_value | 目前模式歸因轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CurrentModelAttributedConversionValue |
| metrics_gmail_forwards | 廣告以訊息形式轉寄給其他人的次數。 | GmailForwards |
| metrics_gmail_saves | 使用者將 Gmail 廣告儲存到收件匣的次數。 | GmailSaves |
| metrics_gmail_secondary_clicks | Gmail 廣告展開後,使用者點擊到達網頁的次數。 | GmailSecondaryClicks |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interaction_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 | InteractionRate |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| metrics_value_per_current_model_attributed_conversion | 目前模式歸因轉換的價值除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerCurrentModelAttributedConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:AdStats
Google Ads API 資源: ad_group_ad
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_ad_ad_group | 廣告所屬的廣告群組。 | |
| ad_group_ad_ad_id | 廣告的 ID。 | CreativeId |
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_id | 僅供輸出。廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可視曝光次數 (`active_view_impressions`) 的平均費用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可評估點擊次數除以 Active View 可視曝光次數。 這項指標只會針對多媒體廣告聯播網回報。 | ActiveViewCtr |
| metrics_active_view_impressions | 這項指標可評估廣告在多媒體廣告聯播網網站上顯示的頻率。 | ActiveViewImpressions |
| metrics_active_view_measurability | 可由 Active View 評估的曝光次數,除以放送的曝光次數所得的比例。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | 您獲得的曝光中,可透過 Active View 評估的曝光費用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 廣告在刊登位置中顯示的次數,且顯示位置必須能讓使用者看到廣告。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 在啟用 Active View 的網站上,廣告曝光可視次數 (可視曝光) 占可評估曝光次數的百分比。 | ActiveViewViewability |
| metrics_average_cost | 您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。 | AverageCost |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_average_cpm | 平均千次曝光出價。 | AverageCpm |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionRate |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_cost_per_current_model_attributed_conversion | 廣告互動費用除以目前模式歸因的轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerCurrentModelAttributedConversion |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_current_model_attributed_conversions | 顯示您選取的歸因模式套用至歷來轉換資料的結果。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CurrentModelAttributedConversions |
| metrics_gmail_forwards | 廣告以訊息形式轉寄給其他人的次數。 | GmailForwards |
| metrics_gmail_saves | 使用者將 Gmail 廣告儲存到收件匣的次數。 | GmailSaves |
| metrics_gmail_secondary_clicks | Gmail 廣告展開後,使用者點擊到達網頁的次數。 | GmailSecondaryClicks |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interaction_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 | InteractionRate |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| metrics_value_per_current_model_attributed_conversion | 目前模式歸因轉換的價值除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerCurrentModelAttributedConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:AgeRange
Google Ads API 資源: age_range_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_age_range_type | 年齡層類型。 | 條件 |
| ad_group_criterion_bid_modifier | 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援修飾符。 | BidModifier |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_criterion_effective_cpc_bid_micros | 有效單次點擊出價。 | CpcBid |
| ad_group_criterion_effective_cpc_bid_source | 有效單次點擊出價的來源。 | CpcBidSource |
| ad_group_criterion_effective_cpm_bid_micros | 有效千次可視曝光出價。 | CpmBidStr |
| ad_group_criterion_effective_cpm_bid_source | 有效千次曝光出價的來源。 | CpmBidSource |
| ad_group_criterion_final_mobile_urls | 所有跨網域重新導向後,可能的最終行動版網址清單。 | FinalMobileUrls |
| ad_group_criterion_final_urls | 廣告在所有跨網域重新導向後可能連到的最終到達網址清單。 | FinalUrls |
| ad_group_criterion_negative | 是否要指定 (`false`) 或排除 (`true`) 條件。這個欄位無法變更。如要將準則從正面改為負面,請先移除再重新新增。 | IsNegative |
| ad_group_criterion_status | 條件的狀態。 | 狀態 |
| ad_group_criterion_tracking_url_template | 用於建構追蹤網址的網址範本。 | TrackingUrlTemplate |
| ad_group_criterion_url_custom_parameters | 用於取代 `tracking_url_template`、`final_urls` 或 `mobile_final_urls` 中自訂參數標記的對應清單。 | UrlCustomParameters |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| ad_group_targeting_setting_target_restrictions | 限制廣告活動或廣告群組觸及範圍的指定維度設定。 | |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_bidding_strategy | 廣告活動採用的組合出價策略。 | BiddingStrategyId |
| campaign_bidding_strategy_type | 出價策略類型。您可以設定出價計畫來建立標準出價策略,也可以設定 `bidding_strategy` 欄位來建立組合出價策略。這個欄位為唯讀。 | BiddingStrategyType |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
Google Ads 表格名稱:AgeRangeBasicStats
Google Ads API 資源: age_range_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_active_view_impressions | 這項指標可評估廣告在多媒體廣告聯播網網站上顯示的頻率。 | ActiveViewImpressions |
| metrics_active_view_measurability | 可由 Active View 評估的曝光次數,除以放送的曝光次數所得的比例。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | 您獲得的曝光中,可透過 Active View 評估的曝光費用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 廣告在刊登位置中顯示的次數,且顯示位置必須能讓使用者看到廣告。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 在啟用 Active View 的網站上,廣告曝光可視次數 (可視曝光) 占可評估曝光次數的百分比。 | ActiveViewViewability |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | ViewThroughConversions |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_device | 指標適用的裝置。 | 裝置 |
Google Ads 表格名稱:AgeRangeConversionStats
Google Ads API 資源: age_range_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:AgeRangeNonClickStats
Google Ads API 資源: age_range_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_average_cpe | 您為每次廣告參與支付的平均金額。計算方式是將所有廣告參與的總費用除以廣告參與總次數。 | AverageCpe |
| metrics_average_cpv | 每當有人觀看廣告時,您需要支付的平均金額。平均單次收視出價的計算方式,是將所有廣告觀看的總費用除以觀看次數。 | AverageCpv |
| metrics_engagement_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為廣告展開次數除以廣告顯示次數。 | EngagementRate |
| metrics_engagements | 互動次數。「參與」是指觀眾展開燈箱廣告。此外,日後其他廣告類型也可能會支援參與度指標。 | 參與 |
| metrics_video_quartile_p100_rate | 觀眾看完影片的曝光次數百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 觀眾觀看影片 25% 的曝光次數百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 觀眾觀看影片 50% 的曝光次數百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 觀眾觀看影片 75% 的曝光次數百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 影片廣告獲得的觀看次數除以曝光次數,TrueView 隨播廣告縮圖的曝光次數也包含在內。 | VideoViewRate |
| metrics_video_views | 影片廣告的觀看次數。 | VideoViews |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:AgeRangeStats
Google Ads API 資源: age_range_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可視曝光次數 (`active_view_impressions`) 的平均費用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可評估點擊次數除以 Active View 可視曝光次數。 這項指標只會針對多媒體廣告聯播網回報。 | ActiveViewCtr |
| metrics_active_view_impressions | 這項指標可評估廣告在多媒體廣告聯播網網站上顯示的頻率。 | ActiveViewImpressions |
| metrics_active_view_measurability | 可由 Active View 評估的曝光次數,除以放送的曝光次數所得的比例。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | 您獲得的曝光中,可透過 Active View 評估的曝光費用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 廣告在刊登位置中顯示的次數,且顯示位置必須能讓使用者看到廣告。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 在啟用 Active View 的網站上,廣告曝光可視次數 (可視曝光) 占可評估曝光次數的百分比。 | ActiveViewViewability |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。 | AllConversionRate |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_average_cost | 您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。 | AverageCost |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_average_cpm | 平均千次曝光出價。 | AverageCpm |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionRate |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_all_conversions | 廣告互動費用除以所有轉換次數。 | CostPerAllConversion |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_gmail_forwards | 廣告以訊息形式轉寄給其他人的次數。 | GmailForwards |
| metrics_gmail_saves | 使用者將 Gmail 廣告儲存到收件匣的次數。 | GmailSaves |
| metrics_gmail_secondary_clicks | Gmail 廣告展開後,使用者點擊到達網頁的次數。 | GmailSecondaryClicks |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interaction_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 | InteractionRate |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:素材資源
Google Ads API 資源: asset
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| asset_final_urls | 僅供輸出。資產類型。 | |
| asset_name | 素材資源的選用名稱。 | |
| asset_source | 僅供輸出。資產來源。 | |
| asset_type | 所有跨網域重新導向後可能的最終到達網址清單。 | |
| segments_conversion_action | 轉換動作的資源名稱。 |
Google Ads 表格名稱:AssetGroup
Google Ads API 資源: asset_group
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| asset_group_campaign | 不可變更。這項素材資源群組所屬的廣告活動。已連結至素材資源群組的素材資源。 | |
| asset_group_final_mobile_urls | 所有跨網域重新導向後的最終行動網址清單。在最高成效廣告活動中,網址預設會擴展,除非選擇停用。 | |
| asset_group_final_urls | 所有跨網域重新導向後的最終到達網址清單。在最高成效廣告活動中,系統預設會擴展網址,除非您選擇停用。 | |
| asset_group_id | 僅供輸出。素材資源群組的 ID。 | |
| asset_group_name | 這是必要旗標,素材資源群組名稱。這是必要旗標,長度不得少於 1 個字元,最多不得超過 128 個字元。廣告活動中的名稱不得重複。 | |
| asset_group_status | 素材資源群組的狀態。 |
Google Ads 表格名稱:AssetGroupAsset
Google Ads API 資源: asset_group_asset
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| asset_group_asset_asset | 這個素材資源群組素材資源連結的素材資源。 | |
| asset_group_asset_asset_group | 這個素材資源群組資產連結的素材資源群組。 | |
| asset_group_asset_field_type | 素材資源在素材資源群組中的位置說明。例如:HEADLINE、YOUTUBE_VIDEO。 | |
| asset_group_asset_performance_label | 這個素材資源群組素材資源的成效。 | |
| asset_group_asset_policy_summary_approval_status | 整體核准狀態,系統會根據個別政策主題項目的狀態計算得出。 | |
| asset_group_asset_policy_summary_policy_topic_entries | 政策結果清單。 | |
| asset_group_asset_policy_summary_review_status | 資源在審查程序中的位置。 |
Google Ads 表格名稱:AssetGroupListingGroupFilter
Google Ads API 資源: asset_group_listing_group_filter
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| asset_group_listing_group_filter_asset_group | 這個素材資源群組商家資訊群組篩選器所屬的素材資源群組。 | |
| asset_group_listing_group_filter_case_value_product_bidding_category_id (obsolete - use asset_group_listing_group_filter_case_value_product_category_category_id instead) | 產品出價類別的 ID。這個 ID 等於本文所述的 google_product_category ID: https://support.google.com/merchants/answer/6324436 | |
| asset_group_listing_group_filter_case_value_product_bidding_category_level (obsolete - use asset_group_listing_group_filter_case_value_product_category_level instead) | 指出分類中的類別層級。 | |
| asset_group_listing_group_filter_case_value_product_brand_value | 產品品牌的字串值。 | |
| asset_group_listing_group_filter_case_value_product_channel_channel | 縣市的值。 | |
| asset_group_listing_group_filter_case_value_product_condition_condition | 條件值。 | |
| asset_group_listing_group_filter_case_value_product_custom_attribute_index | 表示自訂屬性的索引。 | |
| asset_group_listing_group_filter_case_value_product_custom_attribute_value | 產品自訂屬性的字串值。 | |
| asset_group_listing_group_filter_case_value_product_item_id_value | ID 的值。 | |
| asset_group_listing_group_filter_case_value_product_type_level | 類型層級。 | |
| asset_group_listing_group_filter_case_value_product_type_value | 類型的值。 | |
| asset_group_listing_group_filter_id | ListingGroupFilter 的 ID。 | |
| asset_group_listing_group_filter_parent_listing_group_filter | 父項商品目錄群組細分的資源名稱。根商家資訊群組篩選器節點的空值。 | |
| asset_group_listing_group_filter_type | 商家資訊群組篩選器節點的類型。 | |
| asset_group_listing_group_filter_vertical (obsolete - use asset_group_listing_group_filter_listing_source instead) | 代表目前節點樹狀結構的垂直項目。同一樹狀結構中的所有節點都必須屬於同一個垂直產業。 |
Google Ads 資料表名稱:AssetGroupProductGroupStats
Google Ads API 資源: asset_group_product_group_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| asset_group_product_group_view_asset_group | 與商家資訊群組篩選器相關聯的素材資源群組。 | |
| asset_group_product_group_view_asset_group_listing_group_filter | 素材資源群組商家資訊群組篩選器的資源名稱。 | |
| asset_group_product_group_view_resource_name | 素材資源群組產品群組檢視的資源名稱。素材資源群組 產品群組檢視資源名稱的格式為: customers/{customer_id}/assetGroupProductGroupViews/{asset_group_id}~{listing_group_filter_id} | |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | |
| metrics_average_cpm | 平均千次曝光出價。 | |
| metrics_clicks | 點擊次數。 | |
| metrics_conversions | 轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。 | |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。 | |
| metrics_conversions_value | 轉換價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。 | |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。 | |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | |
| segments_ad_network_type | 廣告聯播網類型。 | |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | |
| segments_device | 指標適用的裝置。 | |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | |
| segments_year | 年份,格式為 yyyy。 |
Google Ads 表格名稱:AssetGroupSignal
Google Ads API 資源: asset_group_signal
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| asset_group_signal_asset_group | 這個素材資源群組信號所屬的素材資源群組。 | |
| asset_group_signal_audience_audience | 目標對象資源名稱。 | |
| asset_group_signal_resource_name | 素材資源群組信號的資源名稱。素材資源群組信號資源名稱的格式為:customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id} |
Google Ads 表格名稱:目標對象
Google Ads API 資源: audience
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| audience_description | 這組目標對象的說明。 | |
| audience_dimensions | 指定目標對象組成的正數維度。 | |
| audience_exclusion_dimension | 指定目標對象組成的負向維度。 | |
| audience_id | 目標對象 ID。 | |
| audience_name | 目標對象名稱。所有目標對象的 ID 不得重複。長度至少須為 1 個字元,最多不得超過 255 個字元。 | |
| audience_status | 這個目標對象的狀態。指出目標對象是否已啟用或移除。 |
Google Ads 表格名稱:BidGoal
Google Ads API 資源: bidding_strategy
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| bidding_strategy_id | 出價策略的 ID。 | BidStrategyID |
| bidding_strategy_name | 出價策略的名稱。帳戶中的所有出價策略都必須有不同的名稱。這個字串的長度應介於 1 到 255 個 UTF-8 位元組之間 (含首尾),且經過修剪。 | 名稱 |
| bidding_strategy_status | 出價策略的狀態。這是唯讀欄位。 | 狀態 |
| bidding_strategy_target_cpa_cpc_bid_ceiling_micros | 出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。 | TargetCpaMaxCpcBidCeiling |
| bidding_strategy_target_cpa_cpc_bid_floor_micros | 出價策略可設定的最低出價。這項限制適用於策略管理的所有關鍵字。 | TargetCpaMaxCpcBidFloor |
| bidding_strategy_target_cpa_target_cpa_micros | 平均單次動作出價目標。這個目標應大於或等於帳戶幣別的最低計費單位。 | TargetCpa |
| bidding_strategy_target_roas_cpc_bid_ceiling_micros | 出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。 | TargetRoasBidCeiling |
| bidding_strategy_target_roas_cpc_bid_floor_micros | 出價策略可設定的最低出價。這項限制適用於策略管理的所有關鍵字。 | TargetRoasBidFloor |
| bidding_strategy_target_roas_target_roas | 這是必要旗標,每單位支出所要達成的收益 (根據轉換資料)。值必須介於 0.01 至 1000.0 之間 (含)。 | TargetRoas |
| bidding_strategy_target_spend_cpc_bid_ceiling_micros | 出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。 | TargetSpendBidCeiling |
| bidding_strategy_target_spend_target_spend_micros | 盡量爭取點擊的支出目標。目標支出出價者會嘗試支出這個值或自然節流支出金額中較小的值。如未指定,系統會將預算做為支出目標。 | TargetSpendSpendTarget |
| bidding_strategy_type | 出價策略類型。設定出價計畫,建立出價策略。這是唯讀欄位。 | 類型 |
| customer_descriptive_name | 選填,客戶的說明名稱 (可重複)。 | AccountDescriptiveName |
| customer_id | 顧客 ID。 | ExternalCustomerId |
Google Ads 表格名稱:BidGoalConversionStats
Google Ads API 資源: bidding_strategy
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| bidding_strategy_campaign_count | 附加至這項出價策略的廣告活動數量。這個欄位為唯讀。 | CampaignCount |
| bidding_strategy_id | 出價策略的 ID。 | BidStrategyID |
| bidding_strategy_non_removed_campaign_count | 附加至這項出價策略的未移除廣告活動數量。 這是唯讀欄位。 | NonRemovedCampaignCount |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | ViewThroughConversions |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:BidGoalStats
Google Ads API 資源: bidding_strategy
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| bidding_strategy_campaign_count | 附加至這項出價策略的廣告活動數量。這個欄位為唯讀。 | CampaignCount |
| bidding_strategy_id | 出價策略的 ID。 | BidStrategyID |
| bidding_strategy_non_removed_campaign_count | 附加至這項出價策略的未移除廣告活動數量。 這是唯讀欄位。 | NonRemovedCampaignCount |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_all_conversions_from_interactions_rate | 所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。 | |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_average_cpm | 平均千次曝光出價。 | AverageCpm |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionRate |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_all_conversions | 廣告互動費用除以所有轉換次數。 | |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:預算
Google Ads API 資源: campaign_budget
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_budget_amount_micros | 預算金額,以帳戶的當地幣別表示。金額以微量單位指定,一百萬微量單位等於一貨幣單位。每月支出上限為這個金額的 30.4 倍。 | 金額 |
| campaign_budget_delivery_method | 放送方式會決定廣告活動預算的支出速度。如果建立作業中未指定,則預設為 STANDARD。 | DeliveryMethod |
| campaign_budget_explicitly_shared | 指出預算是否明確共用。如果建立作業中未指定,則預設值為 true。如果為 true,表示預算的建立目的是要與一或多個廣告活動共用。如果為 false,則建立預算時,只打算用於單一廣告活動。預算的名稱和狀態會與廣告活動的名稱和狀態保持同步。嘗試與第二個廣告活動共用預算會導致錯誤。非共用預算可以變成明確共用預算。 這項作業也必須為預算指派名稱。共用廣告活動預算永遠無法改為非共用。 | IsBudgetExplicitlyShared |
| campaign_budget_has_recommended_budget | 指出這個廣告活動預算是否有建議預算。 這是唯讀欄位。 | HasRecommendedBudget |
| campaign_budget_id | 廣告活動預算 ID。廣告活動預算會使用 CampaignBudgetService 建立作業建立,並指派預算 ID。A 預算 ID 可在不同廣告活動之間共用;系統會在不同廣告活動之間分配廣告活動預算,以獲得最佳成效。 | BudgetId |
| campaign_budget_name | 廣告活動預算的名稱。透過 CampaignBudgetService 建立廣告活動預算時,每個明確共用的廣告活動預算都必須有非空值、非空白的名稱。如果廣告活動預算並未明確共用,系統會根據附加廣告活動的名稱命名。這個字串的長度必須介於 1 到 255 個 UTF-8 位元組之間 (含首尾),且經過修剪。 | BudgetName |
| campaign_budget_period | 支出預算的時間範圍。如果未指定,預設值為 DAILY。 | 期間 |
| campaign_budget_recommended_budget_amount_micros | 建議預算金額。如果沒有任何建議,系統會將此值設為預算金額。金額以微量單位表示,一百萬微量單位等於一貨幣單位。這是唯讀欄位。 | RecommendedBudgetAmount |
| campaign_budget_reference_count | 目前使用預算的廣告活動數量。這個欄位為唯讀。 | BudgetReferenceCount |
| campaign_budget_status | 這個廣告活動預算的狀態。這是唯讀欄位。 | BudgetStatus |
| campaign_budget_total_amount_micros | 預算總金額,以帳戶使用的當地幣別計算。 金額以微量單位指定,一百萬微量單位等於一貨幣單位。 | TotalAmount |
| customer_descriptive_name | 選填,客戶的說明名稱 (可重複)。 | AccountDescriptiveName |
| customer_id | 顧客 ID。 | ExternalCustomerId |
Google Ads 資料表名稱:BudgetStats
Google Ads API 資源: campaign_budget
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_budget_id | 廣告活動預算 ID。廣告活動預算會使用 CampaignBudgetService 建立作業建立,並指派預算 ID。不同廣告活動可以共用預算 ID,系統會將廣告活動預算分配給不同廣告活動,以獲得最佳成效。 | BudgetId |
| campaign_budget_recommended_budget_estimated_change_weekly_clicks | 套用建議預算後,每週點擊次數的預估變化。這是唯讀欄位。 | RecommendedBudgetEstimatedChangeInWeeklyClicks |
| campaign_budget_recommended_budget_estimated_change_weekly_cost_micros | 套用建議預算後,每週費用的預估變化 (以微元為單位)。一百萬等於一個貨幣單位。這個欄位為唯讀。 | RecommendedBudgetEstimatedChangeInWeeklyCost |
| campaign_budget_recommended_budget_estimated_change_weekly_interactions | 套用建議預算後,每週互動次數的預估變化。這是唯讀欄位。 | RecommendedBudgetEstimatedChangeInWeeklyInteractions |
| campaign_budget_recommended_budget_estimated_change_weekly_views | 套用建議預算後,每週觀看次數的預估變化。 這是唯讀欄位。 | RecommendedBudgetEstimatedChangeInWeeklyViews |
| campaign_id | 廣告活動的 ID。 | AssociatedCampaignId |
| campaign_name | 廣告活動名稱。建立新廣告活動時,這個欄位為必填,且不得為空白。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 | AssociatedCampaignName |
| campaign_status | 廣告活動的狀態。新增廣告活動時,狀態預設為「已啟用」。 | AssociatedCampaignStatus |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。 | AllConversionRate |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_average_cost | 您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。 | AverageCost |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_average_cpe | 您為每次廣告參與支付的平均金額。計算方式是將所有廣告參與的總費用除以廣告參與總次數。 | AverageCpe |
| metrics_average_cpm | 平均千次曝光出價。 | AverageCpm |
| metrics_average_cpv | 每當有人觀看廣告時,您需要支付的平均金額。平均單次收視出價的計算方式,是將所有廣告觀看的總費用除以觀看次數。 | AverageCpv |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionRate |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_all_conversions | 廣告互動費用除以所有轉換次數。 | CostPerAllConversion |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_engagement_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為廣告展開次數除以廣告顯示次數。 | EngagementRate |
| metrics_engagements | 互動次數。「參與」是指觀眾展開燈箱廣告。此外,日後其他廣告類型也可能會支援參與度指標。 | 參與 |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interaction_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 | InteractionRate |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| metrics_video_view_rate | TrueView 影片廣告獲得的觀看次數除以曝光次數,TrueView 隨播廣告縮圖的曝光次數也包含在內。 | VideoViewRate |
| metrics_video_views | 影片廣告的觀看次數。 | VideoViews |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | ViewThroughConversions |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 |
Google Ads 表格名稱:廣告活動
Google Ads API 資源: campaign
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| bidding_strategy_name | 出價策略的名稱。帳戶中的所有出價策略都必須有不同的名稱。這個字串的長度應介於 1 到 255 個 UTF-8 位元組之間 (含首尾),且經過修剪。 | BiddingStrategyName |
| campaign_advertising_channel_sub_type | 可選用,用於精確指定 `advertising_channel_type`,必須是父項管道類型的有效子類型。只能在建立廣告活動時設定。廣告活動建立完成後,即無法變更這個欄位。 | AdvertisingChannelSubType |
| campaign_advertising_channel_type | 廣告活動中廣告的主要放送目標。您可以在 `network_settings` 中調整指定目標選項。建立新廣告活動時,這個欄位為必填,且不得為空白。只能在建立廣告活動時設定。廣告活動建立完成後,就無法變更這個欄位。 | AdvertisingChannelType |
| campaign_bidding_strategy | 廣告活動採用的組合出價策略。 | BiddingStrategyId |
| campaign_bidding_strategy_type | 出價策略類型。您可以設定出價計畫來建立標準出價策略,也可以設定 `bidding_strategy` 欄位來建立組合出價策略。這個欄位為唯讀。 | BiddingStrategyType |
| campaign_budget_amount_micros | 預算金額,以帳戶的當地幣別表示。金額以微量單位指定,一百萬微量單位等於一貨幣單位。每月支出上限為這個金額的 30.4 倍。 | 金額 |
| campaign_budget_explicitly_shared | 指出預算是否明確共用。如果建立作業中未指定,則預設值為 true。如果為 true,表示預算的建立目的是要與一或多個廣告活動共用。如果為 false,則建立預算時,只打算用於單一廣告活動。預算的名稱和狀態會與廣告活動的名稱和狀態保持同步。嘗試與第二個廣告活動共用預算會導致錯誤。非共用預算可以變成明確共用預算。 這項作業也必須為預算指派名稱。共用廣告活動預算永遠無法改為非共用。 | IsBudgetExplicitlyShared |
| campaign_budget_has_recommended_budget | 指出這個廣告活動預算是否有建議預算。 這是唯讀欄位。 | HasRecommendedBudget |
| campaign_budget_period | 支出預算的時間範圍。如果未指定,預設值為 DAILY。 | 期間 |
| campaign_budget_recommended_budget_amount_micros | 建議預算金額。如果沒有任何建議,系統會將此值設為預算金額。金額以微量單位表示,一百萬微量單位等於一貨幣單位。這是唯讀欄位。 | RecommendedBudgetAmount |
| campaign_budget_total_amount_micros | 預算總金額,以帳戶使用的當地幣別計算。 金額以微量單位指定,一百萬微量單位等於一貨幣單位。 | TotalAmount |
| campaign_campaign_budget | 廣告活動的預算。 | BudgetId |
| campaign_end_date | 廣告活動結束日期。這個欄位不得用於 WHERE 子句。 | EndDate |
| campaign_experiment_type | 廣告活動類型:一般、草稿或實驗。 | CampaignTrialType |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| campaign_manual_cpc_enhanced_cpc_enabled | 是否要根據轉換最佳化工具資料調整出價。 | EnhancedCpcEnabled |
| campaign_maximize_conversion_value_target_roas | 目標廣告投資報酬率選項。如果已設定,出價策略會盡量提高收益,同時將目標廣告投資報酬率設為平均值。如果目標廣告投資報酬率設得太高,出價策略可能無法用完預算。如未設定目標廣告投資報酬率,出價策略會盡可能提高預算的廣告投資報酬率。 | MaximizeConversionValueTargetRoas |
| campaign_name | 廣告活動名稱。建立新廣告活動時,這個欄位為必填,且不得為空白。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 | CampaignName |
| campaign_percent_cpc_enhanced_cpc_enabled | 根據轉換可能性,在每次競價中調高或調低出價。個別出價可能會超過 cpc_bid_ceiling_micros,但廣告活動的平均出價金額不應超過此值。 | |
| campaign_serving_status | 廣告活動的廣告放送狀態。 | ServingStatus |
| campaign_start_date | 廣告活動的開始日期。這個欄位不得用於 WHERE 子句。 | StartDate |
| campaign_status | 廣告活動的狀態。新增廣告活動時,狀態預設為「已啟用」。 | CampaignStatus |
| campaign_tracking_url_template | 用於建構追蹤網址的網址範本。 | TrackingUrlTemplate |
| campaign_url_custom_parameters | 用於取代 `tracking_url_template`、`final_urls` 或 `mobile_final_urls` 中自訂參數標記的對應清單。 | UrlCustomParameters |
| customer_id | 顧客 ID。 | ExternalCustomerId |
Google Ads 表格名稱:CampaignAssetStats
Google Ads API 資源: campaign_asset
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_asset_asset | 連結至廣告活動的素材資源。 | |
| campaign_asset_campaign | 素材資源連結的廣告活動。 | |
| campaign_asset_field_type | 資產在連結廣告活動中扮演的角色。 | |
| campaign_asset_resource_name | 廣告活動資產的資源名稱。CampaignAsset 資源名稱的格式如下: customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type} | |
| campaign_asset_source | 廣告活動素材資源連結的來源。 | |
| campaign_asset_status | 廣告活動素材資源的狀態。 | |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | |
| metrics_average_cpe | 您為每次廣告參與支付的平均金額。計算方式是將所有廣告參與的總費用除以廣告參與總次數。 | |
| metrics_average_cpm | 平均千次曝光出價。 | |
| metrics_average_cpv | 每當有人觀看廣告時,您需要支付的平均金額。平均單次收視出價的計算方式,是將所有廣告觀看的總費用除以觀看次數。 | |
| metrics_clicks | 點擊次數。 | |
| metrics_conversions | 轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。 | |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。 | |
| metrics_conversions_value | 轉換價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。 | |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略,系統會調整出價策略來爭取這些轉換。 | |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | |
| metrics_top_impression_percentage | 廣告顯示於自然搜尋結果上方第一則廣告的百分比。 | |
| segments_ad_network_type | 廣告聯播網類型。 | |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | |
| segments_device | 指標適用的裝置。 | |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | |
| segments_year | 年份,格式為 yyyy。 |
Google Ads 表格名稱:CampaignAudience
Google Ads API 資源: campaign_audience_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | |
| campaign_criterion_bid_modifier | 廣告活動採用的組合出價策略。 | |
| campaign_criterion_criterion_id | 僅供輸出。指定條件的 ID。系統會在變動期間忽略這個欄位。 | |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 |
Google Ads 表格名稱:CampaignAudienceBasicStats
Google Ads API 資源: campaign_audience_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | |
| campaign_criterion_criterion_id | 僅供輸出。指定條件的 ID。系統會在變動期間忽略這個欄位。 | |
| customer_id | 顧客 ID。 | |
| metrics_clicks | 點擊次數。 | |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | |
| segments_ad_network_type | 廣告聯播網類型。 | |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | |
| segments_device | 指標適用的裝置。 | |
| segments_slot | 廣告位置。 |
Google Ads 表格名稱:CampaignAudienceConversionStats
Google Ads API 資源: campaign_audience_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | |
| campaign_criterion_criterion_id | 僅供輸出。指定條件的 ID。系統會在變動期間忽略這個欄位。 | |
| customer_id | 顧客 ID。 | |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_all_conversions_value | 所有轉換的總價值。 | |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | |
| segments_ad_network_type | 廣告聯播網類型。 | |
| segments_conversion_action | 轉換動作的資源名稱。 | |
| segments_conversion_action_category | 轉換動作類別。 | |
| segments_conversion_action_name | 轉換動作名稱。 | |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | |
| segments_device | 指標適用的裝置。 | |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | |
| segments_year | 年份,格式為 yyyy。 |
Google Ads 表格名稱:CampaignAudienceNonClickStats
Google Ads API 資源: campaign_audience_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | |
| customer_id | 顧客 ID。 | |
| metrics_average_cpe | 您為每次廣告參與支付的平均金額。計算方式是將所有廣告參與的總費用除以廣告參與總次數。 | |
| metrics_average_cpv | 每當有人觀看廣告時,您需要支付的平均金額。平均單次收視出價的計算方式,是將所有廣告觀看的總費用除以觀看次數。 | |
| metrics_engagement_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為廣告展開次數除以廣告顯示次數。 | |
| metrics_engagements | 互動次數。「參與」是指觀眾展開燈箱廣告。此外,日後其他廣告類型也可能會支援參與度指標。 | |
| metrics_video_view_rate | TrueView 影片廣告獲得的觀看次數除以曝光次數,TrueView 隨播廣告縮圖的曝光次數也包含在內。 | |
| metrics_video_views | 影片廣告的觀看次數。 | |
| segments_ad_network_type | 廣告聯播網類型。 | |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | |
| segments_device | 指標適用的裝置。 | |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | |
| segments_year | 年份,格式為 yyyy。 |
Google Ads 表格名稱:CampaignAudienceStats
Google Ads API 資源: campaign_audience_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | |
| campaign_criterion_criterion_id | 僅供輸出。指定條件的 ID。系統會在變動期間忽略這個欄位。 | |
| customer_id | 顧客 ID。 | |
| metrics_active_view_cpm | 可視曝光次數 (`active_view_impressions`) 的平均費用。 | |
| metrics_active_view_ctr | Active View 可評估點擊次數除以 Active View 可視曝光次數。 這項指標只會針對多媒體廣告聯播網回報。 | |
| metrics_active_view_impressions | 這項指標可評估廣告在多媒體廣告聯播網網站上顯示的頻率。 | |
| metrics_active_view_measurability | 可由 Active View 評估的曝光次數,除以放送的曝光次數所得的比例。 | |
| metrics_active_view_measurable_cost_micros | 您獲得的曝光中,可透過 Active View 評估的曝光費用。 | |
| metrics_active_view_measurable_impressions | 廣告在刊登位置中顯示的次數,且顯示位置必須能讓使用者看到廣告。 | |
| metrics_active_view_viewability | 在啟用 Active View 的網站上,廣告曝光可視次數 (可視曝光) 占可評估曝光次數的百分比。 | |
| metrics_all_conversions_from_interactions_rate | 所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。 | |
| metrics_average_cost | 您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。 | |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | |
| metrics_average_cpm | 平均千次曝光出價。 | |
| metrics_clicks | 點擊次數。 | |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | |
| metrics_cost_per_all_conversions | 廣告互動費用除以所有轉換次數。 | |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | |
| metrics_gmail_forwards | 廣告以訊息形式轉寄給其他人的次數。 | |
| metrics_gmail_saves | 使用者將 Gmail 廣告儲存到收件匣的次數。 | |
| metrics_gmail_secondary_clicks | Gmail 廣告展開後,使用者點擊到達網頁的次數。 | |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | |
| metrics_interaction_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 | |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| segments_ad_network_type | 廣告聯播網類型。 | |
| segments_click_type | 點擊類型。 | |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | |
| segments_device | 指標適用的裝置。 | |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | |
| segments_year | 年份,格式為 yyyy。 |
Google Ads 資料表名稱:CampaignBasicStats
Google Ads API 資源: campaign
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | ViewThroughConversions |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_slot | 廣告位置。 | 運算單元 |
Google Ads 表格名稱:CampaignConversionStats
Google Ads API 資源: campaign
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_conversion_attribution_event_type | 轉換歸因事件類型。 | ConversionAttributionEventType |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_slot | 廣告位置。 | 運算單元 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:CampaignCookieStats
Google Ads API 資源: campaign
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_absolute_top_impression_percentage | 廣告顯示於自然搜尋結果上方第一則廣告的百分比。 | AbsoluteTopImpressionPercentage |
| metrics_search_budget_lost_absolute_top_impression_share | 這項預估值表示廣告有多常因為預算偏低,而無法成為自然搜尋結果上方顯示的第一則廣告。注意:搜尋聯播網錯失的絕對頂端曝光比重 (預算) 的回報範圍為 0 到 0.9。任何大於 0.9 的值都會回報為 0.9001。 | SearchBudgetLostAbsoluteTopImpressionShare |
| metrics_search_budget_lost_top_impression_share | 這項指標會估算廣告因預算偏低,而無法顯示於自然搜尋結果上方任一位置的頻率。注意:搜尋聯播網錯失的頂端曝光比重 (預算) 的報表範圍為 0 到 0.9。任何大於 0.9 的值都會回報為 0.9001。 | SearchBudgetLostTopImpressionShare |
| metrics_search_rank_lost_absolute_top_impression_share | 這項估算值代表廣告有多常因為廣告評級不佳,而無法在自然搜尋結果上方顯示為第一則廣告。注意:搜尋聯播網錯失的絕對頂端曝光比重 (評級) 的回報範圍為 0 到 0.9。任何大於 0.9 的值都會回報為 0.9001。 | SearchRankLostAbsoluteTopImpressionShare |
| metrics_search_rank_lost_top_impression_share | 這項數字估算的是廣告因為廣告評級不佳,而無法顯示於自然搜尋結果上方任一位置的頻率。注意:搜尋排名錯失的頂端曝光比重會以 0 到 0.9 的範圍回報。任何大於 0.9 的值都會回報為 0.9001。 | SearchRankLostTopImpressionShare |
| metrics_search_top_impression_share | 相較於廣告預估有資格在頂端位置獲得的曝光次數,廣告在頂端位置 (自然搜尋結果上方的任一位置) 實際獲得的曝光次數。注意:搜尋聯播網頂端曝光比重的範圍為 0.1 到 1。低於 0.1 的值會回報為 0.0999。 | SearchTopImpressionShare |
| metrics_top_impression_percentage | 廣告曝光顯示於自然搜尋結果上方任一處的百分比。 | TopImpressionPercentage |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
Google Ads 表格名稱:CampaignCriterion
Google Ads API 資源: campaign_criterion
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_criterion_bid_modifier | 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援修飾符。使用 0 即可選擇不使用裝置類型。 | |
| campaign_criterion_campaign | 條件所屬的廣告活動。 | |
| campaign_criterion_criterion_id | 指定條件的 ID。系統會在變動期間忽略這個欄位。 | |
| campaign_criterion_device_type | 裝置的類型。 | |
| campaign_criterion_display_name | 條件的顯示名稱。系統會忽略變動中的這個欄位。 | |
| campaign_criterion_negative | 是否要指定 (`false`) 或排除 (`true`) 條件。 | |
| campaign_criterion_status | 條件的狀態。 | |
| campaign_criterion_type | 條件類型。 | |
| campaign_id | 廣告活動的 ID。 | |
| campaign_name | 廣告活動名稱。建立新廣告活動時,這個欄位為必填,且不得為空白。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 |
Google Ads 資料表名稱:CampaignCrossDeviceConversionStats
Google Ads API 資源: campaign
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_conversion_attribution_event_type | 轉換歸因事件類型。 | ConversionAttributionEventType |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:CampaignCrossDeviceStats
Google Ads API 資源: campaign
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_absolute_top_impression_percentage | 廣告顯示於自然搜尋結果上方第一則廣告的百分比。 | AbsoluteTopImpressionPercentage |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。 | AllConversionRate |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_average_cpe | 您為每次廣告參與支付的平均金額。計算方式是將所有廣告參與的總費用除以廣告參與總次數。 | AverageCpe |
| metrics_average_cpv | 每當有人觀看廣告時,您需要支付的平均金額。平均單次收視出價的計算方式,是將所有廣告觀看的總費用除以觀看次數。 | AverageCpv |
| metrics_average_page_views | 每個工作階段的平均網頁瀏覽量。 | AveragePageviews |
| metrics_average_time_on_site | 所有工作階段的總持續時間 (以秒為單位) 除以工作階段數。已從 Google Analytics 匯入。 | AverageTimeOnSite |
| metrics_bounce_rate | 使用者點擊後只造訪網站上單一網頁的百分比。已從 Google Analytics 匯入。 | BounceRate |
| metrics_content_budget_lost_impression_share | 廣告符合在多媒體廣告聯播網上顯示的資格,但因為預算過低而錯失顯示機會的預估百分比。注意:內容預算錯失的曝光比重會回報在 0 到 0.9 的範圍內。任何大於 0.9 的值都會回報為 0.9001。 | ContentBudgetLostImpressionShare |
| metrics_content_impression_share | 將您在多媒體廣告聯播網上獲得的曝光次數,除以預估可獲得的曝光次數後所得出的百分比。注意: 內容曝光比重的範圍為 0.1 至 1。任何低於 0.1 的值都會回報為 0.0999。 | ContentImpressionShare |
| metrics_content_rank_lost_impression_share | 廣告因為廣告評級偏低,而錯失多媒體廣告聯播網曝光次數的預估百分比。注意:內容排名錯失的曝光比重會回報在 0 到 0.9 的範圍內。任何高於 0.9 的值都會回報為 0.9001。 | ContentRankLostImpressionShare |
| metrics_cost_per_all_conversions | 廣告互動費用除以所有轉換次數。 | CostPerAllConversion |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_engagement_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為廣告展開次數除以廣告顯示次數。 | EngagementRate |
| metrics_engagements | 互動次數。「參與」是指觀眾展開燈箱廣告。此外,日後其他廣告類型也可能會支援參與度指標。 | 參與 |
| metrics_invalid_click_rate | 報表統計期內,從點擊總數 (已篩除的點擊次數 + 未篩除的點擊次數) 中篩除的點擊次數百分比。 | InvalidClickRate |
| metrics_invalid_clicks | Google 認為不合理的點擊次數,不會向您收費。 | InvalidClicks |
| metrics_percent_new_visitors | 首次工作階段的百分比 (來自從未造訪過您網站的使用者)。已從 Google Analytics 匯入。 | PercentNewVisitors |
| metrics_phone_calls | 離線電話通話次數。 | NumOfflineInteractions |
| metrics_phone_impressions | 離線電話曝光次數。 | NumOfflineImpressions |
| metrics_phone_through_rate | 獲得的通話次數 (phone_calls) 除以電話號碼顯示次數 (phone_impressions)。 | OfflineInteractionRate |
| metrics_relative_ctr | 您的點閱率除以在顯示您廣告的網站上,所有廣告主的平均點閱率。評估您的廣告在多媒體廣告聯播網網站上的成效,與相同網站上的其他廣告相比如何。 | RelativeCtr |
| metrics_search_absolute_top_impression_share | 有多少百分比的購物或搜尋廣告曝光位於最顯眼的購物廣告刊登位置。詳情請參閱 https://support.google.com/google-ads/answer/7501826。低於 0.1 的值會回報為 0.0999。 | SearchAbsoluteTopImpressionShare |
| metrics_search_budget_lost_absolute_top_impression_share | 這項預估值表示廣告有多常因為預算偏低,而無法成為自然搜尋結果上方顯示的第一則廣告。注意:搜尋聯播網錯失的絕對頂端曝光比重 (預算) 的回報範圍為 0 到 0.9。任何大於 0.9 的值都會回報為 0.9001。 | SearchBudgetLostAbsoluteTopImpressionShare |
| metrics_search_budget_lost_impression_share | 廣告符合在搜尋聯播網上顯示的資格,但因預算過低而未顯示的次數百分比 (估計值)。注意:搜尋聯播網因預算而錯失的曝光比重會以 0 到 0.9 的範圍回報。任何大於 0.9 的值都會回報為 0.9001。 | SearchBudgetLostImpressionShare |
| metrics_search_budget_lost_top_impression_share | 這項指標會估算廣告因預算偏低,而無法顯示於自然搜尋結果上方任一位置的頻率。注意:搜尋聯播網錯失的頂端曝光比重 (預算) 的報表範圍為 0 到 0.9。任何大於 0.9 的值都會回報為 0.9001。 | SearchBudgetLostTopImpressionShare |
| metrics_search_click_share | 將廣告在搜尋聯播網上實際獲得的點擊次數,除以預估最高點擊次數後所得出的百分比。注意:搜尋點擊比重的範圍為 0.1 到 1。低於 0.1 的值會回報為 0.0999。 | SearchClickShare |
| metrics_search_exact_match_impression_share | 這是將廣告在搜尋聯播網上實際獲得的曝光次數,除以與您關鍵字完全相符或近似變體的搜尋字詞所帶來的預估廣告曝光次數後得出的百分比,與關鍵字比對類型無關。注意:搜尋聯播網完全比對曝光比重會以 0.1 到 1 的範圍回報。低於 0.1 的值會回報為 0.0999。 | SearchExactMatchImpressionShare |
| metrics_search_impression_share | 將您在搜尋聯播網上獲得的曝光次數,除以預估可獲得的曝光次數後所得出的百分比。注意:搜尋曝光比重的範圍為 0.1 至 1。低於 0.1 的值會回報為 0.0999。 | SearchImpressionShare |
| metrics_search_rank_lost_absolute_top_impression_share | 這項估算值代表廣告有多常因為廣告評級不佳,而無法在自然搜尋結果上方顯示為第一則廣告。注意:搜尋聯播網錯失的絕對頂端曝光比重 (評級) 的回報範圍為 0 到 0.9。任何大於 0.9 的值都會回報為 0.9001。 | SearchRankLostAbsoluteTopImpressionShare |
| metrics_search_rank_lost_impression_share | 廣告因為廣告評級偏低,而錯失搜尋聯播網曝光次數的預估百分比。注意:搜尋聯播網錯失的曝光比重 (排名) 範圍為 0 到 0.9。任何高於 0.9 的值都會回報為 0.9001。 | SearchRankLostImpressionShare |
| metrics_search_rank_lost_top_impression_share | 這項數字估算的是廣告因為廣告評級不佳,而無法顯示於自然搜尋結果上方任一位置的頻率。注意:搜尋排名錯失的頂端曝光比重會以 0 到 0.9 的範圍回報。任何大於 0.9 的值都會回報為 0.9001。 | SearchRankLostTopImpressionShare |
| metrics_search_top_impression_share | 相較於廣告預估有資格在頂端位置獲得的曝光次數,廣告在頂端位置 (自然搜尋結果上方的任一位置) 實際獲得的曝光次數。注意:搜尋聯播網頂端曝光比重的範圍為 0.1 到 1。低於 0.1 的值會回報為 0.0999。 | SearchTopImpressionShare |
| metrics_top_impression_percentage | 廣告曝光顯示於自然搜尋結果上方任一處的百分比。 | TopImpressionPercentage |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_video_quartile_p100_rate | 觀眾看完影片的曝光次數百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 觀眾觀看影片 25% 的曝光次數百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 觀眾觀看影片 50% 的曝光次數百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 觀眾觀看影片 75% 的曝光次數百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 影片廣告獲得的觀看次數除以曝光次數,TrueView 隨播廣告縮圖的曝光次數也包含在內。 | VideoViewRate |
| metrics_video_views | 影片廣告的觀看次數。 | VideoViews |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:CampaignLabel
Google Ads API 資源: campaign_label
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_id | 廣告活動的 ID。 | |
| campaign_label_campaign | 附加標籤的廣告活動。 | |
| campaign_label_label | 指派給廣告活動的標籤。 | |
| campaign_label_resource_name | 資源名稱。廣告活動標籤資源名稱的格式為: `customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}` | |
| campaign_name | 廣告活動名稱。建立新廣告活動時,這個欄位為必填,且不得為空白。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 | |
| label_id | 標籤的 ID。僅供檢視。 | |
| label_name | 標籤名稱。建立新標籤時,這個欄位為必填,且不得為空白。字串長度應介於 1 至 80 個半形字元之間 (含首尾)。 | |
| label_resource_name | 資源名稱。標籤資源名稱的格式為: `customers/{customer_id}/labels/{label_id}` |
Google Ads 資料表名稱:CampaignLocationTargetStats
Google Ads API 資源: location_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_criterion_criterion_id | 指定條件的 ID。系統會在變動期間忽略這個欄位。 | CriterionId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。 | AllConversionRate |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_average_cost | 您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。 | AverageCost |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_average_cpe | 您為每次廣告參與支付的平均金額。計算方式是將所有廣告參與的總費用除以廣告參與總次數。 | AverageCpe |
| metrics_average_cpm | 平均千次曝光出價。 | AverageCpm |
| metrics_average_cpv | 每當有人觀看廣告時,您需要支付的平均金額。平均單次收視出價的計算方式,是將所有廣告觀看的總費用除以觀看次數。 | AverageCpv |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionRate |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_all_conversions | 廣告互動費用除以所有轉換次數。 | CostPerAllConversion |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_engagement_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為廣告展開次數除以廣告顯示次數。 | EngagementRate |
| metrics_engagements | 互動次數。「參與」是指觀眾展開燈箱廣告。此外,日後其他廣告類型也可能會支援參與度指標。 | 參與 |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interaction_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 | InteractionRate |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| metrics_video_view_rate | TrueView 影片廣告獲得的觀看次數除以曝光次數,TrueView 隨播廣告縮圖的曝光次數也包含在內。 | VideoViewRate |
| metrics_video_views | 影片廣告的觀看次數。 | VideoViews |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | ViewThroughConversions |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:CampaignStats
Google Ads API 資源: campaign
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可視曝光次數 (`active_view_impressions`) 的平均費用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可評估點擊次數除以 Active View 可視曝光次數。 這項指標只會針對多媒體廣告聯播網回報。 | ActiveViewCtr |
| metrics_active_view_impressions | 這項指標可評估廣告在多媒體廣告聯播網網站上顯示的頻率。 | ActiveViewImpressions |
| metrics_active_view_measurability | 可由 Active View 評估的曝光次數,除以放送的曝光次數所得的比例。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | 您獲得的曝光中,可透過 Active View 評估的曝光費用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 廣告在刊登位置中顯示的次數,且顯示位置必須能讓使用者看到廣告。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 在啟用 Active View 的網站上,廣告曝光可視次數 (可視曝光) 占可評估曝光次數的百分比。 | ActiveViewViewability |
| metrics_average_cost | 您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。 | AverageCost |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_average_cpm | 平均千次曝光出價。 | AverageCpm |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionRate |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_cost_per_current_model_attributed_conversion | 廣告互動費用除以目前模式歸因的轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerCurrentModelAttributedConversion |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_current_model_attributed_conversions | 顯示您選取的歸因模式套用至歷來轉換資料的結果。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CurrentModelAttributedConversions |
| metrics_current_model_attributed_conversions_value | 目前模式歸因轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CurrentModelAttributedConversionValue |
| metrics_gmail_forwards | 廣告以訊息形式轉寄給其他人的次數。 | GmailForwards |
| metrics_gmail_saves | 使用者將 Gmail 廣告儲存到收件匣的次數。 | GmailSaves |
| metrics_gmail_secondary_clicks | Gmail 廣告展開後,使用者點擊到達網頁的次數。 | GmailSecondaryClicks |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interaction_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 | InteractionRate |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| metrics_value_per_current_model_attributed_conversion | 目前模式歸因轉換的價值除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerCurrentModelAttributedConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:ClickStats
Google Ads API 資源: click_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| ad_group_status | 廣告群組的狀態。 | |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| click_view_ad_group_ad | 相關聯的廣告。 | CreativeId |
| click_view_area_of_interest_city | 與曝光相關聯的城市位置條件。 | AoiCityCriteriaId |
| click_view_area_of_interest_country | 與曝光相關聯的國家/地區位置條件。 | AoiCountryCriteriaId |
| click_view_area_of_interest_metro | 與曝光相關聯的都會區指定條件。 | AoiMetroCriteriaId |
| click_view_area_of_interest_most_specific | 與曝光相關聯的最明確地區條件。 | AoiMostSpecificTargetId |
| click_view_area_of_interest_region | 與曝光相關聯的區域位置條件。 | AoiRegionCriteriaId |
| click_view_gclid | Google 點擊 ID。 | GclId |
| click_view_keyword | 相關聯的關鍵字 (如有),且點擊對應至「搜尋」管道。 | CriteriaId |
| click_view_keyword_info_match_type | 關鍵字的比對類型。 | KeywordMatchType |
| click_view_keyword_info_text | 關鍵字文字 (最多 80 個字元和 10 個字)。 | CriteriaParameters |
| click_view_location_of_presence_city | 與曝光相關聯的城市位置條件。 | LopCityCriteriaId |
| click_view_location_of_presence_country | 與曝光相關聯的國家/地區位置條件。 | LopCountryCriteriaId |
| click_view_location_of_presence_metro | 與曝光相關聯的都會區指定條件。 | LopMetroCriteriaId |
| click_view_location_of_presence_most_specific | 與曝光相關聯的最明確地區條件。 | LopMostSpecificTargetId |
| click_view_location_of_presence_region | 與曝光相關聯的區域位置條件。 | LopRegionCriteriaId |
| click_view_page_number | 刊登廣告的搜尋結果頁碼。 | 頁面 |
| customer_descriptive_name | 選填,客戶的說明名稱 (可重複)。 | AccountDescriptiveName |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_slot | 廣告位置。 | 運算單元 |
Google Ads 表格名稱:Customer
Google Ads API 資源: customer
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| customer_auto_tagging_enabled | 是否為客戶啟用自動標記功能。 | IsAutoTaggingEnabled |
| customer_currency_code | 帳戶使用的幣別。系統支援 ISO 4217 標準的部分貨幣代碼。 | AccountCurrencyCode |
| customer_descriptive_name | 選填,客戶的說明名稱 (可重複)。 | AccountDescriptiveName、CustomerDescriptiveName |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| customer_manager | 顧客是否為管理員。 | CanManageClients |
| customer_test_account | 顧客是否為測試帳戶。 | IsTestAccount |
| customer_time_zone | 顧客的當地時區 ID。 | AccountTimeZone |
Google Ads 資料表名稱:DisplayVideoAutomaticPlacementsStats
Google Ads API 資源: group_placement_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_id | 廣告群組 ID。 | |
| ad_group_name | 廣告群組的名稱。建立新廣告群組時,這個欄位為必填,且不得為空白。長度不得超過 255 個 UTF-8 全形字元。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 | |
| campaign_id | 廣告活動的 ID。 | |
| campaign_name | 廣告活動名稱。建立新廣告活動時,這個欄位為必填,且不得為空白。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 | |
| customer_id | 顧客 ID。 | |
| group_placement_view_placement | 群組層級的自動刊登位置字串,例如網域、行動應用程式 ID 或 YouTube 頻道 ID。 | |
| group_placement_view_placement_type | 刊登位置類型。例如網站、YouTube 頻道、行動應用程式。 | |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | |
| metrics_average_cpm | 平均千次曝光出價。 | |
| metrics_average_cpv | 每當有人觀看廣告時,您需要支付的平均金額。平均單次收視出價的計算方式,是將所有廣告觀看的總費用除以觀看次數。 | |
| metrics_clicks | 點擊次數。 | |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | |
| metrics_video_view_rate | TrueView 影片廣告獲得的觀看次數除以曝光次數,TrueView 隨播廣告縮圖的曝光次數也包含在內。 | |
| metrics_video_views | 影片廣告的觀看次數。 | |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | |
| segments_year | 年份,格式為 yyyy。 |
Google Ads 表格名稱:DisplayVideoKeywordStats
Google Ads API 資源: display_keyword_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_criterion_keyword_text | 關鍵字文字 (最多 80 個字元和 10 個字)。 | |
| ad_group_id | 廣告群組 ID。 | |
| ad_group_name | 廣告群組的名稱。建立新廣告群組時,這個欄位為必填,且不得為空白。長度不得超過 255 個 UTF-8 全形字元。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 | |
| campaign_advertising_channel_sub_type | 可選用,用於精確指定 `advertising_channel_type`,必須是父項管道類型的有效子類型。只能在建立廣告活動時設定。廣告活動建立完成後,即無法變更這個欄位。 | |
| campaign_bidding_strategy_type | 出價策略類型。您可以設定出價計畫來建立標準出價策略,也可以設定 `bidding_strategy` 欄位來建立組合出價策略。這個欄位為唯讀。 | |
| campaign_id | 廣告活動的 ID。 | |
| campaign_name | 廣告活動名稱。建立新廣告活動時,這個欄位為必填,且不得為空白。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 | |
| customer_id | 顧客 ID。 | |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | |
| metrics_average_cpm | 平均千次曝光出價。 | |
| metrics_average_cpv | 每當有人觀看廣告時,您需要支付的平均金額。平均單次收視出價的計算方式,是將所有廣告觀看的總費用除以觀看次數。 | |
| metrics_clicks | 點擊次數。 | |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | |
| metrics_interaction_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 | |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | |
| segments_year | 年份,格式為 yyyy。 |
Google Ads 資料表名稱:DisplayVideoTopicStats
Google Ads API 資源: topic_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_criterion_status | 條件的狀態。 | |
| ad_group_criterion_topic_path | 要指定或排除的類別。陣列中的每個後續元素都會說明更具體的子類別。舉例來說,「寵物與動物」、「寵物」、「狗」代表「寵物與動物/寵物/狗」類別。 | |
| ad_group_id | 廣告群組 ID。 | |
| ad_group_name | 廣告群組的名稱。建立新廣告群組時,這個欄位為必填,且不得為空白。長度不得超過 255 個 UTF-8 全形字元。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 | |
| campaign_id | 廣告活動的 ID。 | |
| campaign_name | 廣告活動名稱。建立新廣告活動時,這個欄位為必填,且不得為空白。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 | |
| customer_id | 顧客 ID。 | |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | |
| metrics_average_cpm | 平均千次曝光出價。 | |
| metrics_clicks | 點擊次數。 | |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | |
| segments_year | 年份,格式為 yyyy。 |
Google Ads 表格名稱:性別
Google Ads API 資源: gender_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_bid_modifier | 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援修飾符。 | BidModifier |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_criterion_effective_cpc_bid_micros | 有效單次點擊出價。 | CpcBid |
| ad_group_criterion_effective_cpc_bid_source | 有效單次點擊出價的來源。 | CpcBidSource |
| ad_group_criterion_effective_cpm_bid_micros | 有效千次可視曝光出價。 | CpmBidStr |
| ad_group_criterion_effective_cpm_bid_source | 有效千次曝光出價的來源。 | CpmBidSource |
| ad_group_criterion_final_mobile_urls | 所有跨網域重新導向後,可能的最終行動版網址清單。 | FinalMobileUrls |
| ad_group_criterion_final_urls | 廣告在所有跨網域重新導向後可能連到的最終到達網址清單。 | FinalUrls |
| ad_group_criterion_gender_type | 性別類型。 | 條件 |
| ad_group_criterion_negative | 是否要指定 (`false`) 或排除 (`true`) 條件。這個欄位無法變更。如要將準則從正面改為負面,請先移除再重新新增。 | IsNegative |
| ad_group_criterion_status | 條件的狀態。 | 狀態 |
| ad_group_criterion_tracking_url_template | 用於建構追蹤網址的網址範本。 | TrackingUrlTemplate |
| ad_group_criterion_url_custom_parameters | 用於取代 `tracking_url_template`、`final_urls` 或 `mobile_final_urls` 中自訂參數標記的對應清單。 | UrlCustomParameters |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| ad_group_targeting_setting_target_restrictions | 限制廣告活動或廣告群組觸及範圍的指定維度設定。 | |
| bidding_strategy_name | 出價策略的名稱。帳戶中的所有出價策略都必須有不同的名稱。這個字串的長度應介於 1 到 255 個 UTF-8 位元組之間 (含首尾),且經過修剪。 | BiddingStrategyName |
| bidding_strategy_type | 出價策略類型。設定出價計畫,建立出價策略。這是唯讀欄位。 | BiddingStrategyType |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_bidding_strategy | 廣告活動採用的組合出價策略。 | BiddingStrategyId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
Google Ads 資料表名稱:GenderBasicStats
Google Ads API 資源: gender_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_active_view_impressions | 這項指標可評估廣告在多媒體廣告聯播網網站上顯示的頻率。 | ActiveViewImpressions |
| metrics_active_view_measurability | 可由 Active View 評估的曝光次數,除以放送的曝光次數所得的比例。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | 您獲得的曝光中,可透過 Active View 評估的曝光費用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 廣告在刊登位置中顯示的次數,且顯示位置必須能讓使用者看到廣告。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 在啟用 Active View 的網站上,廣告曝光可視次數 (可視曝光) 占可評估曝光次數的百分比。 | ActiveViewViewability |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | ViewThroughConversions |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_device | 指標適用的裝置。 | 裝置 |
Google Ads 表格名稱:GenderConversionStats
Google Ads API 資源: gender_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:GenderNonClickStats
Google Ads API 資源: gender_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_average_cpe | 您為每次廣告參與支付的平均金額。計算方式是將所有廣告參與的總費用除以廣告參與總次數。 | AverageCpe |
| metrics_average_cpv | 每當有人觀看廣告時,您需要支付的平均金額。平均單次收視出價的計算方式,是將所有廣告觀看的總費用除以觀看次數。 | AverageCpv |
| metrics_engagement_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為廣告展開次數除以廣告顯示次數。 | EngagementRate |
| metrics_engagements | 互動次數。「參與」是指觀眾展開燈箱廣告。此外,日後其他廣告類型也可能會支援參與度指標。 | 參與 |
| metrics_video_quartile_p100_rate | 觀眾看完影片的曝光次數百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 觀眾觀看影片 25% 的曝光次數百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 觀眾觀看影片 50% 的曝光次數百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 觀眾觀看影片 75% 的曝光次數百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 影片廣告獲得的觀看次數除以曝光次數,TrueView 隨播廣告縮圖的曝光次數也包含在內。 | VideoViewRate |
| metrics_video_views | 影片廣告的觀看次數。 | VideoViews |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:GenderStats
Google Ads API 資源: gender_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可視曝光次數 (`active_view_impressions`) 的平均費用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可評估點擊次數除以 Active View 可視曝光次數。 這項指標只會針對多媒體廣告聯播網回報。 | ActiveViewCtr |
| metrics_active_view_impressions | 這項指標可評估廣告在多媒體廣告聯播網網站上顯示的頻率。 | ActiveViewImpressions |
| metrics_active_view_measurability | 可由 Active View 評估的曝光次數,除以放送的曝光次數所得的比例。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | 您獲得的曝光中,可透過 Active View 評估的曝光費用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 廣告在刊登位置中顯示的次數,且顯示位置必須能讓使用者看到廣告。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 在啟用 Active View 的網站上,廣告曝光可視次數 (可視曝光) 占可評估曝光次數的百分比。 | ActiveViewViewability |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。 | AllConversionRate |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_average_cost | 您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。 | AverageCost |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_average_cpm | 平均千次曝光出價。 | AverageCpm |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionRate |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_all_conversions | 廣告互動費用除以所有轉換次數。 | CostPerAllConversion |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_gmail_forwards | 廣告以訊息形式轉寄給其他人的次數。 | GmailForwards |
| metrics_gmail_saves | 使用者將 Gmail 廣告儲存到收件匣的次數。 | GmailSaves |
| metrics_gmail_secondary_clicks | Gmail 廣告展開後,使用者點擊到達網頁的次數。 | GmailSecondaryClicks |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interaction_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 | InteractionRate |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:GeoConversionStats
Google Ads API 資源: geographic_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| ad_group_name | 廣告群組的名稱。建立新廣告群組時,這個欄位為必填,且不得為空白。長度不得超過 255 個 UTF-8 全形字元。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 | AdGroupName |
| ad_group_status | 廣告群組的狀態。 | AdGroupStatus |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| campaign_status | 廣告活動的狀態。新增廣告活動時,狀態預設為「已啟用」。 | |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| geographic_view_country_criterion_id | 國家/地區的條件 ID。 | CountryCriteriaId |
| geographic_view_location_type | 廣告活動的指定地理區域類型。 | LocationType |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | ViewThroughConversions |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_geo_target_most_specific_location | 代表最明確位置的地理目標常數資源名稱。 | MostSpecificCriteriaId |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:GeoStats
Google Ads API 資源: geographic_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| ad_group_name | 廣告群組的名稱。建立新廣告群組時,這個欄位為必填,且不得為空白。長度不得超過 255 個 UTF-8 全形字元。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 | AdGroupName |
| ad_group_status | 廣告群組的狀態。 | AdGroupStatus |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| campaign_status | 廣告活動的狀態。新增廣告活動時,狀態預設為「已啟用」。 | |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| geographic_view_country_criterion_id | 國家/地區的條件 ID。 | CountryCriteriaId |
| geographic_view_location_type | 廣告活動的指定地理區域類型。 | LocationType |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。 | AllConversionRate |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_average_cost | 您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。 | AverageCost |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_average_cpm | 平均千次曝光出價。 | AverageCpm |
| metrics_average_cpv | 每當有人觀看廣告時,您需要支付的平均金額。平均單次收視出價的計算方式,是將所有廣告觀看的總費用除以觀看次數。 | AverageCpv |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionRate |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_all_conversions | 廣告互動費用除以所有轉換次數。 | CostPerAllConversion |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interaction_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 | InteractionRate |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| metrics_video_view_rate | TrueView 影片廣告獲得的觀看次數除以曝光次數,TrueView 隨播廣告縮圖的曝光次數也包含在內。 | VideoViewRate |
| metrics_video_views | 影片廣告的觀看次數。 | VideoViews |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | ViewThroughConversions |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_geo_target_most_specific_location | 代表最明確位置的地理目標常數資源名稱。 | MostSpecificCriteriaId |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:HourlyAccountConversionStats
Google Ads API 資源: customer
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_hour | 一天中的小時數,介於 0 到 23 之間 (含 0 和 23)。 | HourOfDay |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:HourlyAccountStats
Google Ads API 資源: customer
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可視曝光次數 (`active_view_impressions`) 的平均費用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可評估點擊次數除以 Active View 可視曝光次數。 這項指標只會針對多媒體廣告聯播網回報。 | ActiveViewCtr |
| metrics_active_view_impressions | 這項指標可評估廣告在多媒體廣告聯播網網站上顯示的頻率。 | ActiveViewImpressions |
| metrics_active_view_measurability | 可由 Active View 評估的曝光次數,除以放送的曝光次數所得的比例。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | 您獲得的曝光中,可透過 Active View 評估的曝光費用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 廣告在刊登位置中顯示的次數,且顯示位置必須能讓使用者看到廣告。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 在啟用 Active View 的網站上,廣告曝光可視次數 (可視曝光) 占可評估曝光次數的百分比。 | ActiveViewViewability |
| metrics_average_cost | 您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。 | AverageCost |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_average_cpm | 平均千次曝光出價。 | AverageCpm |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionRate |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interaction_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 | InteractionRate |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_hour | 一天中的小時數,介於 0 到 23 之間 (含 0 和 23)。 | HourOfDay |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:HourlyAdGroupConversionStats
Google Ads API 資源: ad_group
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_hour | 一天中的小時數,介於 0 到 23 之間 (含 0 和 23)。 | HourOfDay |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:HourlyAdGroupStats
Google Ads API 資源: ad_group
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可視曝光次數 (`active_view_impressions`) 的平均費用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可評估點擊次數除以 Active View 可視曝光次數。 這項指標只會針對多媒體廣告聯播網回報。 | ActiveViewCtr |
| metrics_active_view_impressions | 這項指標可評估廣告在多媒體廣告聯播網網站上顯示的頻率。 | ActiveViewImpressions |
| metrics_active_view_measurability | 可由 Active View 評估的曝光次數,除以放送的曝光次數所得的比例。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | 您獲得的曝光中,可透過 Active View 評估的曝光費用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 廣告在刊登位置中顯示的次數,且顯示位置必須能讓使用者看到廣告。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 在啟用 Active View 的網站上,廣告曝光可視次數 (可視曝光) 占可評估曝光次數的百分比。 | ActiveViewViewability |
| metrics_average_cost | 您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。 | AverageCost |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_average_cpm | 平均千次曝光出價。 | AverageCpm |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionRate |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interaction_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 | InteractionRate |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_hour | 一天中的小時數,介於 0 到 23 之間 (含 0 和 23)。 | HourOfDay |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:HourlyBidGoalStats
Google Ads API 資源: bidding_strategy
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| bidding_strategy_campaign_count | 附加至這項出價策略的廣告活動數量。這個欄位為唯讀。 | CampaignCount |
| bidding_strategy_id | 出價策略的 ID。 | BidStrategyID |
| bidding_strategy_non_removed_campaign_count | 附加至這項出價策略的未移除廣告活動數量。 這是唯讀欄位。 | NonRemovedCampaignCount |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_average_cpm | 平均千次曝光出價。 | AverageCpm |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionRate |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_hour | 一天中的小時數,介於 0 到 23 之間 (含 0 和 23)。 | HourOfDay |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:HourlyCampaignConversionStats
Google Ads API 資源: campaign
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_hour | 一天中的小時數,介於 0 到 23 之間 (含 0 和 23)。 | HourOfDay |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:HourlyCampaignStats
Google Ads API 資源: campaign
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可視曝光次數 (`active_view_impressions`) 的平均費用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可評估點擊次數除以 Active View 可視曝光次數。 這項指標只會針對多媒體廣告聯播網回報。 | ActiveViewCtr |
| metrics_active_view_impressions | 這項指標可評估廣告在多媒體廣告聯播網網站上顯示的頻率。 | ActiveViewImpressions |
| metrics_active_view_measurability | 可由 Active View 評估的曝光次數,除以放送的曝光次數所得的比例。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | 您獲得的曝光中,可透過 Active View 評估的曝光費用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 廣告在刊登位置中顯示的次數,且顯示位置必須能讓使用者看到廣告。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 在啟用 Active View 的網站上,廣告曝光可視次數 (可視曝光) 占可評估曝光次數的百分比。 | ActiveViewViewability |
| metrics_average_cost | 您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。 | AverageCost |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_average_cpm | 平均千次曝光出價。 | AverageCpm |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionRate |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interaction_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 | InteractionRate |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_hour | 一天中的小時數,介於 0 到 23 之間 (含 0 和 23)。 | HourOfDay |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:關鍵字
Google Ads API 資源: keyword_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_criterion_approval_status | 條件的核准狀態。 | ApprovalStatus |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_criterion_effective_cpc_bid_micros | 有效單次點擊出價。 | CpcBid |
| ad_group_criterion_effective_cpc_bid_source | 有效單次點擊出價的來源。 | CpcBidSource |
| ad_group_criterion_effective_cpm_bid_micros | 有效千次可視曝光出價。 | CpmBidStr |
| ad_group_criterion_final_mobile_urls | 所有跨網域重新導向後,可能的最終行動版網址清單。 | FinalMobileUrls |
| ad_group_criterion_final_url_suffix | 網址範本,用於將參數附加至最終到達網址。 | FinalUrlSuffix |
| ad_group_criterion_final_urls | 廣告在所有跨網域重新導向後可能連到的最終到達網址清單。 | FinalUrls |
| ad_group_criterion_keyword_match_type | 關鍵字的比對類型。 | KeywordMatchType |
| ad_group_criterion_keyword_text | 關鍵字文字 (最多 80 個字元和 10 個字)。 | 條件 |
| ad_group_criterion_negative | 是否要指定 (`false`) 或排除 (`true`) 條件。這個欄位無法變更。如要將準則從正面改為負面,請先移除再重新新增。 | IsNegative |
| ad_group_criterion_position_estimates_estimated_add_clicks_at_first_position_cpc | 預估值:將關鍵字出價改為 first_position_cpc_micros 中的值後,每週可望獲得的點擊次數。 | EstimatedAddClicksAtFirstPositionCpc |
| ad_group_criterion_position_estimates_estimated_add_cost_at_first_position_cpc | 預估將關鍵字出價改為 first_position_cpc_micros 中的值後,每週費用可能出現的價差。 | EstimatedAddCostAtFirstPositionCpc |
| ad_group_criterion_position_estimates_first_page_cpc_micros | 預估廣告顯示在搜尋結果第一頁所需的單次點擊出價。 | FirstPageCpc |
| ad_group_criterion_position_estimates_first_position_cpc_micros | 預估廣告顯示在搜尋結果第一頁頂端最高排序所需的單次點擊出價。 | FirstPositionCpc |
| ad_group_criterion_position_estimates_top_of_page_cpc_micros | 預估廣告顯示在搜尋結果第一頁頂端所需的單次點擊出價。 | TopOfPageCpc |
| ad_group_criterion_quality_info_creative_quality_score | 廣告與其他廣告主相比的成效。 | CreativeQualityScore |
| ad_group_criterion_quality_info_post_click_quality_score | 到達網頁的品質分數。 | PostClickQualityScore |
| ad_group_criterion_quality_info_quality_score | 品質分數。如果 Google 沒有足夠資訊來判斷值,可能就不會填入這個欄位。 | QualityScore |
| ad_group_criterion_quality_info_search_predicted_ctr | 與其他廣告主相比的點擊率。 | SearchPredictedCtr |
| ad_group_criterion_status | 條件的狀態。 | 狀態 |
| ad_group_criterion_system_serving_status | 條件的放送狀態。 | SystemServingStatus |
| ad_group_criterion_topic_topic_constant | 主題常數資源名稱。 | VerticalId |
| ad_group_criterion_tracking_url_template | 用於建構追蹤網址的網址範本。 | TrackingUrlTemplate |
| ad_group_criterion_url_custom_parameters | 用於取代 `tracking_url_template`、`final_urls` 或 `mobile_final_urls` 中自訂參數標記的對應清單。 | UrlCustomParameters |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_bidding_strategy | 廣告活動採用的組合出價策略。 | BiddingStrategyId |
| campaign_bidding_strategy_type | 出價策略類型。您可以設定出價計畫來建立標準出價策略,也可以設定 `bidding_strategy` 欄位來建立組合出價策略。這個欄位為唯讀。 | BiddingStrategyType |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| campaign_manual_cpc_enhanced_cpc_enabled | 是否要根據轉換最佳化工具資料調整出價。 | EnhancedCpcEnabled |
| campaign_percent_cpc_enhanced_cpc_enabled | 根據轉換可能性,在每次競價中調高或調低出價。個別出價可能會超過 cpc_bid_ceiling_micros,但廣告活動的平均出價金額不應超過此值。 | |
| customer_id | 顧客 ID。 | ExternalCustomerId |
Google Ads 資料表名稱:KeywordBasicStats
Google Ads API 資源: keyword_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | ViewThroughConversions |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_slot | 廣告位置。 | 運算單元 |
Google Ads 表格名稱:KeywordConversionStats
Google Ads API 資源: keyword_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_slot | 廣告位置。 | 運算單元 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:KeywordCrossDeviceConversionStats
Google Ads API 資源: keyword_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:KeywordCrossDeviceStats
Google Ads API 資源: keyword_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_absolute_top_impression_percentage | 廣告顯示於自然搜尋結果上方第一則廣告的百分比。 | AbsoluteTopImpressionPercentage |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。 | AllConversionRate |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_average_cpe | 您為每次廣告參與支付的平均金額。計算方式是將所有廣告參與的總費用除以廣告參與總次數。 | AverageCpe |
| metrics_average_cpv | 每當有人觀看廣告時,您需要支付的平均金額。平均單次收視出價的計算方式,是將所有廣告觀看的總費用除以觀看次數。 | AverageCpv |
| metrics_average_page_views | 每個工作階段的平均網頁瀏覽量。 | AveragePageviews |
| metrics_average_time_on_site | 所有工作階段的總持續時間 (以秒為單位) 除以工作階段數。已從 Google Analytics 匯入。 | AverageTimeOnSite |
| metrics_bounce_rate | 使用者點擊後只造訪網站上單一網頁的百分比。已從 Google Analytics 匯入。 | BounceRate |
| metrics_cost_per_all_conversions | 廣告互動費用除以所有轉換次數。 | CostPerAllConversion |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_engagement_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為廣告展開次數除以廣告顯示次數。 | EngagementRate |
| metrics_engagements | 互動次數。「參與」是指觀眾展開燈箱廣告。此外,日後其他廣告類型也可能會支援參與度指標。 | 參與 |
| metrics_percent_new_visitors | 首次工作階段的百分比 (來自從未造訪過您網站的使用者)。已從 Google Analytics 匯入。 | PercentNewVisitors |
| metrics_search_absolute_top_impression_share | 有多少百分比的購物或搜尋廣告曝光位於最顯眼的購物廣告刊登位置。詳情請參閱 https://support.google.com/google-ads/answer/7501826。低於 0.1 的值會回報為 0.0999。 | SearchAbsoluteTopImpressionShare |
| metrics_search_budget_lost_absolute_top_impression_share | 這項預估值表示廣告有多常因為預算偏低,而無法成為自然搜尋結果上方顯示的第一則廣告。注意:搜尋聯播網錯失的絕對頂端曝光比重 (預算) 的回報範圍為 0 到 0.9。任何大於 0.9 的值都會回報為 0.9001。 | SearchBudgetLostAbsoluteTopImpressionShare |
| metrics_search_budget_lost_top_impression_share | 這項指標會估算廣告因預算偏低,而無法顯示於自然搜尋結果上方任一位置的頻率。注意:搜尋聯播網錯失的頂端曝光比重 (預算) 的報表範圍為 0 到 0.9。任何大於 0.9 的值都會回報為 0.9001。 | SearchBudgetLostTopImpressionShare |
| metrics_search_exact_match_impression_share | 這是將廣告在搜尋聯播網上實際獲得的曝光次數,除以與您關鍵字完全相符或近似變體的搜尋字詞所帶來的預估廣告曝光次數後得出的百分比,與關鍵字比對類型無關。注意:搜尋聯播網完全比對曝光比重會以 0.1 到 1 的範圍回報。低於 0.1 的值會回報為 0.0999。 | SearchExactMatchImpressionShare |
| metrics_search_impression_share | 將您在搜尋聯播網上獲得的曝光次數,除以預估可獲得的曝光次數後所得出的百分比。注意:搜尋曝光比重的範圍為 0.1 至 1。低於 0.1 的值會回報為 0.0999。 | SearchImpressionShare |
| metrics_search_rank_lost_absolute_top_impression_share | 這項估算值代表廣告有多常因為廣告評級不佳,而無法在自然搜尋結果上方顯示為第一則廣告。注意:搜尋聯播網錯失的絕對頂端曝光比重 (評級) 的回報範圍為 0 到 0.9。任何大於 0.9 的值都會回報為 0.9001。 | SearchRankLostAbsoluteTopImpressionShare |
| metrics_search_rank_lost_impression_share | 廣告因為廣告評級偏低,而錯失搜尋聯播網曝光次數的預估百分比。注意:搜尋聯播網錯失的曝光比重 (排名) 範圍為 0 到 0.9。任何高於 0.9 的值都會回報為 0.9001。 | SearchRankLostImpressionShare |
| metrics_search_rank_lost_top_impression_share | 這項數字估算的是廣告因為廣告評級不佳,而無法顯示於自然搜尋結果上方任一位置的頻率。注意:搜尋排名錯失的頂端曝光比重會以 0 到 0.9 的範圍回報。任何大於 0.9 的值都會回報為 0.9001。 | SearchRankLostTopImpressionShare |
| metrics_search_top_impression_share | 相較於廣告預估有資格在頂端位置獲得的曝光次數,廣告在頂端位置 (自然搜尋結果上方的任一位置) 實際獲得的曝光次數。注意:搜尋聯播網頂端曝光比重的範圍為 0.1 到 1。低於 0.1 的值會回報為 0.0999。 | SearchTopImpressionShare |
| metrics_top_impression_percentage | 廣告曝光顯示於自然搜尋結果上方任一處的百分比。 | TopImpressionPercentage |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_video_quartile_p100_rate | 觀眾看完影片的曝光次數百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 觀眾觀看影片 25% 的曝光次數百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 觀眾觀看影片 50% 的曝光次數百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 觀眾觀看影片 75% 的曝光次數百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 影片廣告獲得的觀看次數除以曝光次數,TrueView 隨播廣告縮圖的曝光次數也包含在內。 | VideoViewRate |
| metrics_video_views | 影片廣告的觀看次數。 | VideoViews |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:KeywordStats
Google Ads API 資源: keyword_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可視曝光次數 (`active_view_impressions`) 的平均費用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可評估點擊次數除以 Active View 可視曝光次數。 這項指標只會針對多媒體廣告聯播網回報。 | ActiveViewCtr |
| metrics_active_view_impressions | 這項指標可評估廣告在多媒體廣告聯播網網站上顯示的頻率。 | ActiveViewImpressions |
| metrics_active_view_measurability | 可由 Active View 評估的曝光次數,除以放送的曝光次數所得的比例。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | 您獲得的曝光中,可透過 Active View 評估的曝光費用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 廣告在刊登位置中顯示的次數,且顯示位置必須能讓使用者看到廣告。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 在啟用 Active View 的網站上,廣告曝光可視次數 (可視曝光) 占可評估曝光次數的百分比。 | ActiveViewViewability |
| metrics_average_cost | 您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。 | AverageCost |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_average_cpm | 平均千次曝光出價。 | AverageCpm |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionRate |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_cost_per_current_model_attributed_conversion | 廣告互動費用除以目前模式歸因的轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerCurrentModelAttributedConversion |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_current_model_attributed_conversions | 顯示您選取的歸因模式套用至歷來轉換資料的結果。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CurrentModelAttributedConversions |
| metrics_current_model_attributed_conversions_value | 目前模式歸因轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CurrentModelAttributedConversionValue |
| metrics_gmail_forwards | 廣告以訊息形式轉寄給其他人的次數。 | GmailForwards |
| metrics_gmail_saves | 使用者將 Gmail 廣告儲存到收件匣的次數。 | GmailSaves |
| metrics_gmail_secondary_clicks | Gmail 廣告展開後,使用者點擊到達網頁的次數。 | GmailSecondaryClicks |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interaction_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 | InteractionRate |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| metrics_value_per_current_model_attributed_conversion | 目前模式歸因轉換的價值除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerCurrentModelAttributedConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:LandingPageStats
Google Ads API 資源: landing_page_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_name | 廣告群組的名稱。建立新廣告群組時,這個欄位為必填,且不得為空白。長度不得超過 255 個 UTF-8 全形字元。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 | |
| ad_group_status | 廣告群組的狀態。 | |
| campaign_name | 廣告活動名稱。建立新廣告活動時,這個欄位為必填,且不得為空白。不得包含任何空值 (代碼點 0x0)、NL 換行 (代碼點 0xA) 或回車字元 (代碼點 0xD)。 | |
| customer_id | 顧客 ID。 | |
| landing_page_view_unexpanded_final_url | 廣告主指定的最終到達網址。 | |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | |
| metrics_clicks | 點擊次數。 | |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | |
| metrics_mobile_friendly_clicks_percentage | 點擊行動廣告後連到的網頁中,經判定為「行動裝置友善」的網頁所佔的比例。 | |
| metrics_speed_score | 這項指標用來評估行動廣告在點擊後的網頁載入速度。 分數的範圍從 1 到 10,10 代表速度最快。 | |
| metrics_valid_accelerated_mobile_pages_clicks_percentage | 點擊連往 Accelerated Mobile Pages (AMP) 到達網頁的廣告後,有多少百分比的點擊實際連到有效的 AMP 網頁。 | |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | |
| segments_year | 年份,格式為 yyyy。 |
Google Ads 資料表名稱:LocationBasedCampaignCriterion
Google Ads API 資源: location_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| campaign_criterion_bid_modifier | 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援修飾符。使用 0 即可選擇不使用裝置類型。 | BidModifier |
| campaign_criterion_criterion_id | 指定條件的 ID。系統會在變動期間忽略這個欄位。 | CriterionId |
| campaign_criterion_negative | 是否要指定 (`false`) 或排除 (`true`) 條件。 | IsNegative |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
Google Ads 表格名稱:LocationsDistanceStats
Google Ads API 資源: distance_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| customer_id | 顧客 ID。 | |
| distance_view_distance_bucket | 使用者與地點額外資訊的距離群組。 | |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | |
| metrics_clicks | 點擊次數。 | |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | |
| segments_year | 年份,格式為 yyyy。 |
Google Ads 資料表名稱:LocationsUserLocationsStats
Google Ads API 資源: user_location_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| customer_id | 顧客 ID。 | |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | |
| metrics_clicks | 點擊次數。 | |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | |
| segments_geo_target_city | 代表城市的地理區域目標常數資源名稱。 | |
| segments_geo_target_most_specific_location | 代表最明確位置的地理目標常數資源名稱。 | |
| segments_geo_target_region | 代表區域的地理位置目標常數資源名稱。 | |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | |
| segments_year | 年份,格式為 yyyy。 | |
| user_location_view_country_criterion_id | 國家/地區的條件 ID。 | |
| user_location_view_targeting_location | 目標位置。 |
Google Ads 表格名稱:PaidOrganicStats
Google Ads API 資源: paid_organic_search_term_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_combined_clicks | 廣告或網站在無付費結果中的刊登資訊獲得的點擊次數。詳情請參閱說明頁面: https://support.google.com/google-ads/answer/3097241。 | CombinedAdsOrganicClicks |
| metrics_combined_clicks_per_query | 廣告或網站在免費搜尋結果中的產品資訊獲得的點擊次數 (combined_clicks),除以 combined_queries。詳情請參閱說明頁面:https://support.google.com/google-ads/answer/3097241。 | CombinedAdsOrganicClicksPerQuery |
| metrics_combined_queries | 在非付費結果中顯示您網站網頁,或顯示您其中一個文字廣告的搜尋次數。詳情請參閱說明頁面: https://support.google.com/google-ads/answer/3097241。 | CombinedAdsOrganicQueries |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_organic_clicks | 使用者在特定查詢的無付費結果中,點擊您網站資訊的次數。詳情請參閱說明頁面: https://support.google.com/google-ads/answer/3097241。 | OrganicClicks |
| metrics_organic_clicks_per_query | 使用者點擊無付費結果中網站資訊的次數 (organic_clicks),除以顯示網站網頁的總搜尋次數 (organic_queries)。詳情請參閱說明頁面: https://support.google.com/google-ads/answer/3097241。 | OrganicClicksPerQuery |
| metrics_organic_impressions | 網站在非付費搜尋結果中的資訊數量。詳情請參閱說明頁面:https://support.google.com/google-ads/answer/3097241。 | OrganicImpressions |
| metrics_organic_impressions_per_query | 網站網頁顯示在免費搜尋結果中的次數 (organic_impressions),除以免費搜尋結果中顯示網站資訊的搜尋次數 (organic_queries)。詳情請參閱說明頁面:https://support.google.com/google-ads/answer/3097241。 | OrganicImpressionsPerQuery |
| metrics_organic_queries | 在無付費結果中顯示你網站產品資訊的搜尋總次數。詳情請參閱說明頁面: https://support.google.com/google-ads/answer/3097241。 | OrganicQueries |
| paid_organic_search_term_view_search_term | 搜尋字詞。 | SearchQuery |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_search_engine_results_page_type | 搜尋引擎結果網頁的類型。 | SerpType |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:ParentalStatus
Google Ads API 資源: parental_status_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_criterion_effective_cpc_bid_micros | 有效單次點擊出價。 | CpcBid |
| ad_group_criterion_effective_cpc_bid_source | 有效單次點擊出價的來源。 | CpcBidSource |
| ad_group_criterion_effective_cpm_bid_micros | 有效千次可視曝光出價。 | CpmBidStr |
| ad_group_criterion_effective_cpm_bid_source | 有效千次曝光出價的來源。 | CpmBidSource |
| ad_group_criterion_final_mobile_urls | 所有跨網域重新導向後,可能的最終行動版網址清單。 | FinalMobileUrls |
| ad_group_criterion_final_urls | 廣告在所有跨網域重新導向後可能連到的最終到達網址清單。 | FinalUrls |
| ad_group_criterion_negative | 是否要指定 (`false`) 或排除 (`true`) 條件。這個欄位無法變更。如要將準則從正面改為負面,請先移除再重新新增。 | IsNegative |
| ad_group_criterion_parental_status_type | 家長狀態類型。 | 條件 |
| ad_group_criterion_status | 條件的狀態。 | 狀態 |
| ad_group_criterion_tracking_url_template | 用於建構追蹤網址的網址範本。 | TrackingUrlTemplate |
| ad_group_criterion_url_custom_parameters | 用於取代 `tracking_url_template`、`final_urls` 或 `mobile_final_urls` 中自訂參數標記的對應清單。 | UrlCustomParameters |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| ad_group_targeting_setting_target_restrictions | 限制廣告活動或廣告群組觸及範圍的指定維度設定。 | |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_bidding_strategy | 廣告活動採用的組合出價策略。 | BiddingStrategyId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
Google Ads 資料表名稱:ParentalStatusBasicStats
Google Ads API 資源: parental_status_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_active_view_impressions | 這項指標可評估廣告在多媒體廣告聯播網網站上顯示的頻率。 | ActiveViewImpressions |
| metrics_active_view_measurability | 可由 Active View 評估的曝光次數,除以放送的曝光次數所得的比例。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | 您獲得的曝光中,可透過 Active View 評估的曝光費用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 廣告在刊登位置中顯示的次數,且顯示位置必須能讓使用者看到廣告。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 在啟用 Active View 的網站上,廣告曝光可視次數 (可視曝光) 占可評估曝光次數的百分比。 | ActiveViewViewability |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | ViewThroughConversions |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_device | 指標適用的裝置。 | 裝置 |
Google Ads 表格名稱:ParentalStatusConversionStats
Google Ads API 資源: parental_status_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:ParentalStatusNonClickStats
Google Ads API 資源: parental_status_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_average_cpe | 您為每次廣告參與支付的平均金額。計算方式是將所有廣告參與的總費用除以廣告參與總次數。 | AverageCpe |
| metrics_average_cpv | 每當有人觀看廣告時,您需要支付的平均金額。平均單次收視出價的計算方式,是將所有廣告觀看的總費用除以觀看次數。 | AverageCpv |
| metrics_engagement_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為廣告展開次數除以廣告顯示次數。 | EngagementRate |
| metrics_engagements | 互動次數。「參與」是指觀眾展開燈箱廣告。此外,日後其他廣告類型也可能會支援參與度指標。 | 參與 |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | |
| metrics_video_quartile_p100_rate | 觀眾看完影片的曝光次數百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 觀眾觀看影片 25% 的曝光次數百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 觀眾觀看影片 50% 的曝光次數百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 觀眾觀看影片 75% 的曝光次數百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 影片廣告獲得的觀看次數除以曝光次數,TrueView 隨播廣告縮圖的曝光次數也包含在內。 | VideoViewRate |
| metrics_video_views | 影片廣告的觀看次數。 | VideoViews |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:ParentalStatusStats
Google Ads API 資源: parental_status_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可視曝光次數 (`active_view_impressions`) 的平均費用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可評估點擊次數除以 Active View 可視曝光次數。 這項指標只會針對多媒體廣告聯播網回報。 | ActiveViewCtr |
| metrics_active_view_impressions | 這項指標可評估廣告在多媒體廣告聯播網網站上顯示的頻率。 | ActiveViewImpressions |
| metrics_active_view_measurability | 可由 Active View 評估的曝光次數,除以放送的曝光次數所得的比例。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | 您獲得的曝光中,可透過 Active View 評估的曝光費用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 廣告在刊登位置中顯示的次數,且顯示位置必須能讓使用者看到廣告。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 在啟用 Active View 的網站上,廣告曝光可視次數 (可視曝光) 占可評估曝光次數的百分比。 | ActiveViewViewability |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。 | AllConversionRate |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_average_cost | 您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。 | AverageCost |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_average_cpm | 平均千次曝光出價。 | AverageCpm |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionRate |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_all_conversions | 廣告互動費用除以所有轉換次數。 | CostPerAllConversion |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_gmail_forwards | 廣告以訊息形式轉寄給其他人的次數。 | GmailForwards |
| metrics_gmail_saves | 使用者將 Gmail 廣告儲存到收件匣的次數。 | GmailSaves |
| metrics_gmail_secondary_clicks | Gmail 廣告展開後,使用者點擊到達網頁的次數。 | GmailSecondaryClicks |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interaction_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 | InteractionRate |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:刊登位置
Google Ads API 資源: managed_placement_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_bid_modifier | 條件相符時的出價調節係數。修飾符必須介於 0.1 到 10.0 之間。大多數可指定條件類型都支援修飾符。 | BidModifier |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_criterion_effective_cpc_bid_micros | 有效單次點擊出價。 | CpcBid |
| ad_group_criterion_effective_cpc_bid_source | 有效單次點擊出價的來源。 | CpcBidSource |
| ad_group_criterion_effective_cpm_bid_micros | 有效千次可視曝光出價。 | CpmBidStr |
| ad_group_criterion_effective_cpm_bid_source | 有效千次曝光出價的來源。 | CpmBidSource |
| ad_group_criterion_final_mobile_urls | 所有跨網域重新導向後,可能的最終行動版網址清單。 | FinalMobileUrls |
| ad_group_criterion_final_urls | 廣告在所有跨網域重新導向後可能連到的最終到達網址清單。 | FinalUrls |
| ad_group_criterion_negative | 是否要指定 (`false`) 或排除 (`true`) 條件。這個欄位無法變更。如要將準則從正面改為負面,請先移除再重新新增。 | IsNegative |
| ad_group_criterion_placement_url | 刊登位置的網址。例如「\"http://www.domain.com\"」。 | 條件 |
| ad_group_criterion_status | 條件的狀態。 | 狀態 |
| ad_group_criterion_tracking_url_template | 用於建構追蹤網址的網址範本。 | TrackingUrlTemplate |
| ad_group_criterion_url_custom_parameters | 用於取代 `tracking_url_template`、`final_urls` 或 `mobile_final_urls` 中自訂參數標記的對應清單。 | UrlCustomParameters |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| ad_group_targeting_setting_target_restrictions | 限制廣告活動或廣告群組觸及範圍的指定維度設定。 | |
| bidding_strategy_name | 出價策略的名稱。帳戶中的所有出價策略都必須有不同的名稱。這個字串的長度應介於 1 到 255 個 UTF-8 位元組之間 (含首尾),且經過修剪。 | BiddingStrategyName |
| bidding_strategy_type | 出價策略類型。設定出價計畫,建立出價策略。這是唯讀欄位。 | BiddingStrategyType |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_bidding_strategy | 廣告活動採用的組合出價策略。 | BiddingStrategyId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
Google Ads 資料表名稱:PlacementBasicStats
Google Ads API 資源: managed_placement_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_active_view_impressions | 這項指標可評估廣告在多媒體廣告聯播網網站上顯示的頻率。 | ActiveViewImpressions |
| metrics_active_view_measurability | 可由 Active View 評估的曝光次數,除以放送的曝光次數所得的比例。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | 您獲得的曝光中,可透過 Active View 評估的曝光費用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 廣告在刊登位置中顯示的次數,且顯示位置必須能讓使用者看到廣告。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 在啟用 Active View 的網站上,廣告曝光可視次數 (可視曝光) 占可評估曝光次數的百分比。 | ActiveViewViewability |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | ViewThroughConversions |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_device | 指標適用的裝置。 | 裝置 |
Google Ads 表格名稱:PlacementConversionStats
Google Ads API 資源: managed_placement_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:PlacementNonClickStats
Google Ads API 資源: managed_placement_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_average_cpe | 您為每次廣告參與支付的平均金額。計算方式是將所有廣告參與的總費用除以廣告參與總次數。 | AverageCpe |
| metrics_average_cpv | 每當有人觀看廣告時,您需要支付的平均金額。平均單次收視出價的計算方式,是將所有廣告觀看的總費用除以觀看次數。 | AverageCpv |
| metrics_engagement_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為廣告展開次數除以廣告顯示次數。 | EngagementRate |
| metrics_engagements | 互動次數。「參與」是指觀眾展開燈箱廣告。此外,日後其他廣告類型也可能會支援參與度指標。 | 參與 |
| metrics_video_quartile_p100_rate | 觀眾看完影片的曝光次數百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 觀眾觀看影片 25% 的曝光次數百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 觀眾觀看影片 50% 的曝光次數百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 觀眾觀看影片 75% 的曝光次數百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 影片廣告獲得的觀看次數除以曝光次數,TrueView 隨播廣告縮圖的曝光次數也包含在內。 | VideoViewRate |
| metrics_video_views | 影片廣告的觀看次數。 | VideoViews |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:PlacementStats
Google Ads API 資源: managed_placement_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_base_ad_group | 如果是草稿或實驗廣告群組,這個欄位是建立廣告群組時所用的基礎廣告群組資源名稱。如果草稿或實驗廣告群組沒有基礎廣告群組,這個欄位就會是空值。如果是基礎廣告群組,這個欄位會等於廣告群組資源名稱。 這是唯讀欄位。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | CriterionId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_base_campaign | 草稿或實驗廣告活動的基礎廣告活動資源名稱。 如果是基本廣告活動,這個值會等於 `resource_name`。這個欄位為唯讀。 | BaseCampaignId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可視曝光次數 (`active_view_impressions`) 的平均費用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可評估點擊次數除以 Active View 可視曝光次數。 這項指標只會針對多媒體廣告聯播網回報。 | ActiveViewCtr |
| metrics_active_view_impressions | 這項指標可評估廣告在多媒體廣告聯播網網站上顯示的頻率。 | ActiveViewImpressions |
| metrics_active_view_measurability | 可由 Active View 評估的曝光次數,除以放送的曝光次數所得的比例。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | 您獲得的曝光中,可透過 Active View 評估的曝光費用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 廣告在刊登位置中顯示的次數,且顯示位置必須能讓使用者看到廣告。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 在啟用 Active View 的網站上,廣告曝光可視次數 (可視曝光) 占可評估曝光次數的百分比。 | ActiveViewViewability |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。 | AllConversionRate、ConversionRate |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_average_cost | 您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。 | AverageCost |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_average_cpm | 平均千次曝光出價。 | AverageCpm |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_all_conversions | 廣告互動費用除以所有轉換次數。 | CostPerAllConversion |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_gmail_forwards | 廣告以訊息形式轉寄給其他人的次數。 | GmailForwards |
| metrics_gmail_saves | 使用者將 Gmail 廣告儲存到收件匣的次數。 | GmailSaves |
| metrics_gmail_secondary_clicks | Gmail 廣告展開後,使用者點擊到達網頁的次數。 | GmailSecondaryClicks |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interaction_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 | InteractionRate |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:ProductGroupStats
Google Ads API 資源: product_group_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_criterion_cpc_bid_micros | 單次點擊出價。 | |
| ad_group_criterion_criterion_id | 指定條件的 ID。如果是變動,系統會忽略這個欄位。 | |
| ad_group_criterion_display_name | 條件的顯示名稱。系統會忽略變動中的這個欄位。 | |
| ad_group_criterion_listing_group_case_value_product_bidding_category_id (obsolete - use ad_group_criterion_listing_group_case_value_product_category_category_id instead) | 產品出價類別的 ID。這個 ID 等於本文所述的 google_product_category ID: https://support.google.com/merchants/answer/6324436 | |
| ad_group_criterion_listing_group_case_value_product_bidding_category_level (obsolete - use ad_group_criterion_listing_group_case_value_product_category_level instead) | 產品出價類別的層級。 | |
| ad_group_criterion_listing_group_case_value_product_brand_value | 產品品牌的字串值。 | |
| ad_group_criterion_listing_group_case_value_product_channel_channel | 縣市的值。 | |
| ad_group_criterion_listing_group_case_value_product_channel_exclusivity_channel_exclusivity | 供應情形的值。 | |
| ad_group_criterion_listing_group_case_value_product_condition_condition | 條件值。 | |
| ad_group_criterion_listing_group_case_value_product_custom_attribute_index | 表示自訂屬性的索引。 | |
| ad_group_criterion_listing_group_case_value_product_custom_attribute_value | 產品自訂屬性的字串值。 | |
| ad_group_criterion_listing_group_case_value_product_item_id_value | ID 的值。 | |
| ad_group_criterion_listing_group_case_value_product_type_level | 類型層級。 | |
| ad_group_criterion_listing_group_case_value_product_type_value | 類型的值。 | |
| ad_group_criterion_status | 條件的狀態。 | |
| ad_group_id | 廣告群組 ID。 | |
| campaign_id | 廣告活動的 ID。 | |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | |
| metrics_average_cpm | 平均千次曝光出價。 | |
| metrics_clicks | 點擊次數。 | |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | |
| product_group_view_resource_name | 產品群組檢視畫面的資源名稱。產品群組檢視畫面資源名稱的格式為: customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id} | |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | |
| segments_year | 年份,格式為 yyyy。 |
Google Ads 資料表名稱:SearchQueryConversionStats
Google Ads API 資源: search_term_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_ad_ad_id | 廣告的 ID。 | CreativeId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cross_device_conversions | 顧客在某個裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換已納入 all_conversions。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | ViewThroughConversions |
| search_term_view_search_term | 搜尋字詞。 | 查詢 |
| search_term_view_status | 指出搜尋字詞是否為指定或排除的關鍵字。 | QueryTargetingStatus |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_search_term_match_type | 觸發廣告的關鍵字比對類型,包括變體。 | QueryMatchTypeWithVariant |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 資料表名稱:SearchQueryStats
Google Ads API 資源: search_term_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_ad_ad_id | 廣告的 ID。 | CreativeId |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_absolute_top_impression_percentage | 廣告顯示於自然搜尋結果上方第一則廣告的百分比。 | AbsoluteTopImpressionPercentage |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。 | AllConversionRate |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_average_cost | 您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。 | AverageCost |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_average_cpe | 您為每次廣告參與支付的平均金額。計算方式是將所有廣告參與的總費用除以廣告參與總次數。 | AverageCpe |
| metrics_average_cpm | 平均千次曝光出價。 | AverageCpm |
| metrics_average_cpv | 每當有人觀看廣告時,您需要支付的平均金額。平均單次收視出價的計算方式,是將所有廣告觀看的總費用除以觀看次數。 | AverageCpv |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionRate |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_all_conversions | 廣告互動費用除以所有轉換次數。 | CostPerAllConversion |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_cross_device_conversions | 顧客在某個裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換已納入 all_conversions。 | CrossDeviceConversions |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_engagement_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為廣告展開次數除以廣告顯示次數。 | EngagementRate |
| metrics_engagements | 互動次數。「參與」是指觀眾展開燈箱廣告。此外,日後其他廣告類型也可能會支援參與度指標。 | 參與 |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_interaction_event_types | 可付費和免費互動的類型。 | InteractionTypes |
| metrics_interaction_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。 | InteractionRate |
| metrics_interactions | 互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作,例如文字和購物廣告的「點擊」,以及影片廣告的「觀看」等。 | 互動 |
| metrics_top_impression_percentage | 廣告曝光顯示於自然搜尋結果上方任一處的百分比。 | TopImpressionPercentage |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| metrics_video_quartile_p100_rate | 觀眾看完影片的曝光次數百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 觀眾觀看影片 25% 的曝光次數百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 觀眾觀看影片 50% 的曝光次數百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 觀眾觀看影片 75% 的曝光次數百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 影片廣告獲得的觀看次數除以曝光次數,TrueView 隨播廣告縮圖的曝光次數也包含在內。 | VideoViewRate |
| metrics_video_views | 影片廣告的觀看次數。 | VideoViews |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | ViewThroughConversions |
| search_term_view_search_term | 搜尋字詞。 | 查詢 |
| search_term_view_status | 指出搜尋字詞是否為指定或排除的關鍵字。 | QueryTargetingStatus |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如: 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_search_term_match_type | 觸發廣告的關鍵字比對類型,包括變體。 | QueryMatchTypeWithVariant |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:ShoppingProductConversionStats
Google Ads API 資源: shopping_performance_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| campaign_status | 廣告活動的狀態。新增廣告活動時,狀態預設為「已啟用」。 | |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_product_aggregator_id | 產品的匯總工具 ID。 | AggregatorId |
| segments_product_bidding_category_level1 (obsolete - use segments_product_category_level1 instead) | 產品的競價類別 (第 1 層)。 | CategoryL1 |
| segments_product_bidding_category_level2 (obsolete - use segments_product_category_level2 instead) | 產品的競價類別 (第 2 層)。 | CategoryL2 |
| segments_product_bidding_category_level3 (obsolete - use segments_product_category_level3 instead) | 產品的競價類別 (第 3 層)。 | CategoryL3 |
| segments_product_bidding_category_level4 (obsolete - use segments_product_category_level4 instead) | 產品的競價類別 (第 4 層)。 | CategoryL4 |
| segments_product_bidding_category_level5 (obsolete - use segments_product_category_level5 instead) | 產品的競價類別 (第 5 級)。 | CategoryL5 |
| segments_product_category_level1 | 產品的類別 (第 1 層)。 | CategoryL1 |
| segments_product_category_level2 | 產品的類別 (第 2 層)。 | CategoryL2 |
| segments_product_category_level3 | 產品類別 (第 3 層)。 | CategoryL3 |
| segments_product_category_level4 | 產品的類別 (第 4 層)。 | CategoryL4 |
| segments_product_category_level5 | 產品的類別 (第 5 層)。 | CategoryL5 |
| segments_product_brand | 產品品牌。 | 品牌 |
| segments_product_channel | 產品管道。 | 管道 |
| segments_product_channel_exclusivity | 產品的管道獨佔性。 | ChannelExclusivity |
| segments_product_condition | 產品狀況。 | ProductCondition |
| segments_product_country | 產品銷售國家/地區的地理目標常數資源名稱。 | CountryCriteriaId |
| segments_product_custom_attribute0 | 產品的自訂屬性 0。 | CustomAttribute0 |
| segments_product_custom_attribute1 | 產品的自訂屬性 1。 | CustomAttribute1 |
| segments_product_custom_attribute2 | 產品的自訂屬性 2。 | CustomAttribute2 |
| segments_product_custom_attribute3 | 產品的自訂屬性 3。 | CustomAttribute3 |
| segments_product_custom_attribute4 | 產品的自訂屬性 4。 | CustomAttribute4 |
| segments_product_item_id | 產品的商品 ID。 | OfferId |
| segments_product_language | 產品語言的語言常數資源名稱。 | LanguageCriteriaId |
| segments_product_merchant_id | 產品的商家 ID。 | MerchantId |
| segments_product_store_id | 產品的商店 ID。 | StoreId |
| segments_product_type_l1 | 產品類型 (第 1 層)。 | ProductTypeL1 |
| segments_product_type_l2 | 產品類型 (第 2 層)。 | ProductTypeL2 |
| segments_product_type_l3 | 產品類型 (第 3 層)。 | ProductTypeL3 |
| segments_product_type_l4 | 產品類型 (第 4 層)。 | ProductTypeL4 |
| segments_product_type_l5 | 產品類型 (第 5 層)。 | ProductTypeL5 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:ShoppingProductStats
Google Ads API 資源: shopping_performance_view
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| campaign_status | 廣告活動的狀態。新增廣告活動時,狀態預設為「已啟用」。 | |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。 | AllConversionRate |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_average_cpc | 所有點擊的總費用除以獲得的點擊總次數。 | AverageCpc |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_from_interactions_rate | 互動帶來的轉換次數除以廣告互動次數 (例如文字廣告的點擊次數或影片廣告的觀看次數)。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionRate |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_all_conversions | 廣告互動費用除以所有轉換次數。 | CostPerAllConversion |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_search_absolute_top_impression_share | 有多少百分比的購物或搜尋廣告曝光位於最顯眼的購物廣告刊登位置。詳情請參閱 https://support.google.com/google-ads/answer/7501826。低於 0.1 的值會回報為 0.0999。 | SearchAbsoluteTopImpressionShare |
| metrics_search_click_share | 將廣告在搜尋聯播網上實際獲得的點擊次數,除以預估最高點擊次數後所得出的百分比。注意:搜尋點擊比重的範圍為 0.1 到 1。低於 0.1 的值會回報為 0.0999。 | SearchClickShare |
| metrics_search_impression_share | 將您在搜尋聯播網上獲得的曝光次數,除以預估可獲得的曝光次數後所得出的百分比。注意:搜尋曝光比重的範圍為 0.1 至 1。低於 0.1 的值會回報為 0.0999。 | SearchImpressionShare |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_value_per_conversion | 轉換價值除以轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ValuePerConversion |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如: 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_product_aggregator_id | 產品的匯總工具 ID。 | AggregatorId |
| segments_product_bidding_category_level1 (obsolete - use segments_product_category_level1 instead) | 產品的競價類別 (第 1 層)。 | CategoryL1 |
| segments_product_bidding_category_level2 (obsolete - use segments_product_category_level2 instead) | 產品的競價類別 (第 2 層)。 | CategoryL2 |
| segments_product_bidding_category_level3 (obsolete - use segments_product_category_level3 instead) | 產品的競價類別 (第 3 層)。 | CategoryL3 |
| segments_product_bidding_category_level4 (obsolete - use segments_product_category_level4 instead) | 產品的競價類別 (第 4 層)。 | CategoryL4 |
| segments_product_bidding_category_level5 (obsolete - use segments_product_category_level5 instead) | 產品的競價類別 (第 5 級)。 | CategoryL5 |
| segments_product_category_level1 | 產品的類別 (第 1 層)。 | CategoryL1 |
| segments_product_category_level2 | 產品的類別 (第 2 層)。 | CategoryL2 |
| segments_product_category_level3 | 產品類別 (第 3 層)。 | CategoryL3 |
| segments_product_category_level4 | 產品的類別 (第 4 層)。 | CategoryL4 |
| segments_product_category_level5 | 產品的類別 (第 5 層)。 | CategoryL5 |
| segments_product_brand | 產品品牌。 | 品牌 |
| segments_product_channel | 產品管道。 | 管道 |
| segments_product_channel_exclusivity | 產品的管道獨佔性。 | ChannelExclusivity |
| segments_product_condition | 產品狀況。 | ProductCondition |
| segments_product_country | 產品銷售國家/地區的地理目標常數資源名稱。 | CountryCriteriaId |
| segments_product_custom_attribute0 | 產品的自訂屬性 0。 | CustomAttribute0 |
| segments_product_custom_attribute1 | 產品的自訂屬性 1。 | CustomAttribute1 |
| segments_product_custom_attribute2 | 產品的自訂屬性 2。 | CustomAttribute2 |
| segments_product_custom_attribute3 | 產品的自訂屬性 3。 | CustomAttribute3 |
| segments_product_custom_attribute4 | 產品的自訂屬性 4。 | CustomAttribute4 |
| segments_product_item_id | 產品的商品 ID。 | OfferId |
| segments_product_language | 產品語言的語言常數資源名稱。 | LanguageCriteriaId |
| segments_product_merchant_id | 產品的商家 ID。 | MerchantId |
| segments_product_type_l1 | 產品類型 (第 1 層)。 | ProductTypeL1 |
| segments_product_type_l2 | 產品類型 (第 2 層)。 | ProductTypeL2 |
| segments_product_type_l3 | 產品類型 (第 3 層)。 | ProductTypeL3 |
| segments_product_type_l4 | 產品類型 (第 4 層)。 | ProductTypeL4 |
| segments_product_type_l5 | 產品類型 (第 5 層)。 | ProductTypeL5 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
Google Ads 表格名稱:影片
Google Ads API 資源: video
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_ad_status | 廣告的狀態。 | |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| video_duration_millis | 影片長度 (以毫秒為單位)。 | VideoDuration |
| video_id | 影片的 ID。 | VideoId |
| video_title | 影片標題。 | VideoTitle |
Google Ads 表格名稱:VideoBasicStats
Google Ads API 資源: video
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_ad_ad_id | 廣告的 ID。 | CreativeId |
| ad_group_ad_status | 廣告的狀態。 | CreativeStatus |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| metrics_view_through_conversions | 瀏覽後轉換總次數。如果顧客看到圖片或多媒體廣告,但未與其他廣告互動 (例如點擊),之後在您的網站上完成轉換,就會計為瀏覽後轉換。 | ViewThroughConversions |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_device | 指標適用的裝置。 | 裝置 |
| video_channel_id | 影片的擁有者頻道 ID。 | VideoChannelId |
| video_id | 影片的 ID。 | VideoId |
Google Ads 表格名稱:VideoConversionStats
Google Ads API 資源: video
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_ad_ad_id | 廣告的 ID。 | CreativeId |
| ad_group_ad_status | 廣告的狀態。 | CreativeStatus |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_conversion_action | 轉換動作的資源名稱。 | ConversionTrackerId |
| segments_conversion_action_category | 轉換動作類別。 | ConversionCategoryName |
| segments_conversion_action_name | 轉換動作名稱。 | ConversionTypeName |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
| video_channel_id | 影片的擁有者頻道 ID。 | VideoChannelId |
| video_id | 影片的 ID。 | VideoId |
Google Ads 表格名稱:VideoNonClickStats
Google Ads API 資源: video
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_ad_ad_id | 廣告的 ID。 | CreativeId |
| ad_group_ad_status | 廣告的狀態。 | |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_all_conversions | 轉換總次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。 | AllConversionRate |
| metrics_all_conversions_value | 所有轉換的總價值。 | AllConversionValue |
| metrics_average_cpv | 每當有人觀看廣告時,您需要支付的平均金額。平均單次收視出價的計算方式,是將所有廣告觀看的總費用除以觀看次數。 | AverageCpv |
| metrics_cost_per_all_conversions | 廣告互動費用除以所有轉換次數。 | CostPerAllConversion |
| metrics_cross_device_conversions | 顧客在某裝置上點選 Google Ads 廣告,然後在其他裝置或瀏覽器上完成轉換。跨裝置轉換 已納入 all_conversions。 | CrossDeviceConversions |
| metrics_engagement_rate | 使用者看到廣告後與廣告互動的頻率。計算方式為廣告展開次數除以廣告顯示次數。 | EngagementRate |
| metrics_engagements | 互動次數。「參與」是指觀眾展開燈箱廣告。此外,日後其他廣告類型也可能會支援參與度指標。 | 參與 |
| metrics_value_per_all_conversions | 所有轉換的價值除以所有轉換的次數。 | ValuePerAllConversion |
| metrics_video_quartile_p100_rate | 觀眾看完影片的曝光次數百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 觀眾觀看影片 25% 的曝光次數百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 觀眾觀看影片 50% 的曝光次數百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 觀眾觀看影片 75% 的曝光次數百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 影片廣告獲得的觀看次數除以曝光次數,TrueView 隨播廣告縮圖的曝光次數也包含在內。 | VideoViewRate |
| metrics_video_views | 影片廣告的觀看次數。 | VideoViews |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
| video_channel_id | 影片的擁有者頻道 ID。 | VideoChannelId |
| video_id | 影片的 ID。 | VideoId |
Google Ads 表格名稱:VideoStats
Google Ads API 資源: video
| Google Ads 欄位名稱 | 說明 | AdWords 對應欄位名稱 |
|---|---|---|
| ad_group_ad_ad_id | 廣告的 ID。 | CreativeId |
| ad_group_ad_status | 廣告的狀態。 | CreativeStatus |
| ad_group_id | 廣告群組 ID。 | AdGroupId |
| campaign_id | 廣告活動的 ID。 | CampaignId |
| customer_id | 顧客 ID。 | ExternalCustomerId |
| metrics_all_conversions_from_interactions_rate | 所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。 | ConversionRate |
| metrics_average_cpm | 平均千次曝光出價。 | AverageCpm |
| metrics_clicks | 點擊次數。 | 點擊次數 |
| metrics_conversions | 轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | 轉換次數 |
| metrics_conversions_value | 轉換的總價值。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。 | ConversionValue |
| metrics_cost_micros | 這段期間內,單次點擊出價和千次曝光出價的費用總和。 | 費用 |
| metrics_cost_per_conversion | 廣告互動費用除以轉換次數。僅包含 include_in_conversions_metric 屬性設為 true 的轉換動作。 | CostPerConversion |
| metrics_ctr | 廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。 | Ctr |
| metrics_impressions | 廣告顯示在 Google 聯播網搜尋結果網頁或網站上的次數。 | 曝光次數 |
| segments_ad_network_type | 廣告聯播網類型。 | AdNetworkType2 |
| segments_click_type | 點擊類型。 | ClickType |
| segments_date | 指標適用的日期,格式為 yyyy-MM-dd。例如: 2018-04-17。 | 日期 |
| segments_day_of_week | 星期幾。例如「MONDAY」。 | DayOfWeek |
| segments_device | 指標適用的裝置。 | 裝置 |
| segments_month | 月份,以當月第一天的日期表示。格式為 yyyy-MM-dd。 | 月 |
| segments_quarter | 以季的第一天日期表示的季。以曆年為季度。舉例來說,2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。 | 季度 |
| segments_week | 週一到週日為一週,以週一的日期表示。格式為 yyyy-MM-dd。 | 週 |
| segments_year | 年份,格式為 yyyy。 | 年 |
| video_channel_id | 影片的擁有者頻道 ID。 | VideoChannelId |
| video_id | 影片的 ID。 | VideoId |
Google Ads 比對表
Google Ads 對照表只包含屬性欄位 (包含設定或其他固定資料的欄位),且專供使用者查詢帳戶結構資訊。如果您使用重新整理時間範圍或排定回填作業,系統不會更新相符資料表快照。
以下列出 Google Ads 轉移中的比對表:
- 廣告
- 廣告群組
- AdGroupAudience
- AdGroupBidModifier
- AdGroupAdLabel
- AdGroupCriterion
- AdGroupCriterionLabel
- AdGroupLabel
- 年齡層
- 資產
- AssetGroup
- AssetGroupAsset
- AssetGroupListingGroupFilter
- AssetGroupSignal
- 目標對象
- 出價目標
- 預算
- 廣告活動
- CampaignAudience
- CampaignCriterion
- CampaignLabel
- 客戶
- 性別
- 關鍵字
- 以地點為準的廣告活動條件
- 家長狀態
- 刊登位置
- 影片