報告

總覽

本頁列出可使用 GoogleAdsService.SearchStreamGoogleAdsService.Search 在 Google Ads API 中查詢的資源。資源名稱會連結至各自的頁面。每個頁面都會顯示下列清單:

  • 可與資源在同一個 SELECT 子句中使用的構件 (資源、區隔或指標)
  • 這些屬性的欄位如果在這些資源欄位的相同 SELECT 和 WHERE 子句中,就不會區隔指標

顯示在這些清單之後的表格,其中包含資源欄位、區隔和指標,可以加入搜尋查詢時,如果在 FROM 子句中指定這項資源。 每個名稱都會連結至包含其中繼資料的資料表:

  • category
  • data type
  • type URL
  • filterable
  • selectable
  • sortable
  • repeated
可篩選
此列表示欄位是否可在 GAQL 查詢的 WHERE 子句條件中使用。
可選取
此列表示是否可在 GAQL 查詢的 SELECT 子句中指定欄位。
可排序
此列表示欄位是否可排序並用於 GAQL 查詢的 ORDER BY 子句。
重複
此列表示欄位是否重複,應以清單的形式處理。

報表範例

所有資源的清單

資源類型
協助工具出價策略 代表客戶擁有和共用的 BidStrategies 檢視畫面。與 BidStrategy 不同,這項資源除了由客戶擁有的策略外,還包括客戶管理員所擁有的策略,以及與這位客戶共用的策略。這項資源不提供指標,而且只會顯示一部分的 BidStrategy 屬性。
account_budget 帳戶層級預算。它中包含預算本身的相關資訊,以及最近核准的預算變更和待審核的變更提案。待審核的變更提案 (如果有的話) 請見 'pending_proposal'[這項資源是透過 AccountBudgetProposal 變換,無法直接變換。預算在某個時間點最多只能有一個待處理的提案。系統會讀取待處理資料。通過審核後,預算可能會經過調整,例如調整抵免額。調整在 'Approved'和 'adjusted'之間形成差異;字段,在其他方面都相同。
account_budget_proposal 帳戶層級預算提案。所有以「'提議&#39」開頭的欄位,不一定不一定會直接套用。例如,提議的支出上限可在套用申請之前進行調整。如果 'suggest'請注意,提案類型 (proposal_type) 會變更必填欄位,但哪些欄位必須留空。
account_link [帳戶連結] 代表 Google Ads 帳戶與其他帳戶之間的資料共用連結
ad_group [廣告群組] 廣告群組。
ad_group_ad [廣告群組] 廣告群組廣告。
ad_group_ad_asset_combination_view 查看廣告群組廣告素材資源組合的檢視畫面。回應式搜尋廣告僅支援 AdAdAssetCombinationView 的回應式搜尋廣告,日後預計還會支援更多廣告類型。
ad_group_ad_asset_view AdGroupAd 與「資產」之間的連結。目前,AppAdAssetView 僅支援 AppAds。
ad_group_ad_label 廣告群組廣告與標籤之間的關係。
ad_group_asset 廣告群組與資產之間的連結。
ad_group_audience_view 廣告群組目標對象檢視畫面。包含多媒體廣告聯播網和 YouTube 聯播網廣告的興趣和再行銷名單成效資料,以及在目標對象層級匯總的搜尋廣告再行銷名單。
ad_group_bid_modifier 代表廣告群組出價調節係數。
ad_group_criterion 廣告群組條件。
ad_group_criterion_customizer AA 層級相關 CustomrAttribute 的自訂參數值。
ad_group_criterion_label 廣告群組條件與標籤之間的關係。
ad_group_criterion_simulation 廣告群組條件模擬。以下詳細說明廣告管道類型、條件類型、模擬類型和模擬修改方法。飯店 BODY 模擬作業從第 5 版開始。1. 多媒體 - KEYWORD - 單次點擊出價_ - UNIFORM 2. 搜尋 - KEYWORD -CPC_BID - UNIFORM 3. SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM 4. HOTEL - LISTING_GROUP - CPC_BID - UNIFORM 5. HOTEL - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
ad_group_customizer 廣告群組層級相關 CustomrAttribute 的自訂參數值。
ad_group_extension_setting 廣告群組額外資訊設定。
ad_group_feed 廣告群組資訊提供。
ad_group_label 廣告群組與標籤之間的關係。
ad_group_simulation 廣告群組模擬。以下詳細說明廣告管道類型、模擬類型和模擬修改方法。1. 搜尋 - 單次點擊出價 - 預設值 2. 搜尋 - 單次點擊出價 - UNIFORM 3. 搜尋 - TARGET_CPA - UNIFORM 4. 搜尋 - TARGET_ROAS - UNIFORM 5. 多媒體 - 單次點擊出價 - 預設值 6. 多媒體 - 單次點擊出價 - 統一 7. 多媒體 - TARGET_CPA - UNIFORM
ad_parameter 這個廣告參數可用來更新廣告任何文字行 (包括網址) 中的數值 (例如價格或廣告空間層級)。每個廣告群組條件最多可有兩個 AdParameters。(參數為參數_index = 1 及參數參數 = 2)。廣告中的參數會參照「{param#:value}」格式的預留位置。例如:「{param1:$17}」
ad_Schedule_view 廣告時段設定檢視畫面會根據「廣告時段設定」條件,大致列出廣告活動的成效。
age_range_view 年齡層檢視畫面。
資產 素材資源是廣告的其中一個部分,可由多個廣告共用。它可以是圖片 (ImageAsset)、影片 (YouTube) 等等。素材資源無法變更,而且無法移除。如要停止放送素材資源,請將該資產從使用該實體的實體中移除。
asset_field_type_view 素材資源欄位類型檢視畫面。這個資料檢視使用素材資源做為額外資訊時,會回報每個素材資源欄位類型的非高估指標。
asset_group [資產群組] 素材資源群組。AssetGroupAsset 可用於將素材資源連結到素材資源群組。AssetGroupSignal 可用來將信號與素材資源群組建立關聯。
asset_group_asset 屬性 AssetGroupAsset 是資產與資產群組之間的連結。加入 AssetGroupAsset 即可將素材資源連結至素材資源群組。
asset_group_listing_group_filter AssetGroupListingGroupFilter 表示素材資源群組中的商家資訊群組篩選器樹狀節點。
asset_group_product_group_view 素材資源群組的產品群組檢視畫面。
asset_group_signal 屬性 AssetGroupSignal 代表素材資源群組中的信號。信號存在,即表示有最高成效廣告活動最有可能完成轉換。最高成效廣告活動會根據信號尋找意願相近或更強烈的新使用者,爭取在搜尋聯播網、多媒體廣告聯播網和影片聯播網上的轉換。
asset_set 屬性 代表素材資源集合的素材資源組合。使用 AssetSetAsset 將資產連結至資產集。
asset_set_asset 屬性 AssetSetAsset 是資產與資產集之間的連結。加入 AssetSetAsset 會連結資產與資產集。
目標對象 目標對像是有效的指定目標選項,可讓您找出不同區隔屬性 (例如詳細客層和興趣相似目標對象) 來建立目標對象區隔,建立代表目標區隔部分的目標對象。
batch_job 以非同步方式處理的變化版本清單。使用者是變更部分。變異本身無法讀取,而工作結果只能透過 BatchJobService.ListBatchJobResults 讀取。
bidding_data_exclusion 代表出價資料排除項目。請參閱「資料排除」一節:https://support.google.com/google-ads/answer/10370710
bidding_seasonality_adjustment 代表出價季節性調整。請參閱「季節性調整簡介」一節:https://support.google.com/google-ads/answer/10369906
Bidding_strategy 出價策略。
bidding_strategy_simulation 出價策略模擬。以下詳細說明瞭模擬類型和模擬修改方法。1. TARGET_CPA - UNIFORM 2. TARGET_ROAS - UNIFORM
billing_setup 將付款帳戶和廣告客戶建立關聯的帳單設定。帳單設定僅限特定廣告客戶使用。
call_view 通話瀏覽,其中包含來電專用廣告或來電額外資訊的來電追蹤資料。
campaign (廣告活動) 廣告活動。
campaign_asset [廣告活動素材資源] 廣告活動和資產之間的連結。
campaign_asset_set CampaignAssetSet 是廣告活動與素材資源集之間的連結。加入 CampaignAssetSet 即可將素材資源組合連結至廣告活動。
campaign_audience_view 廣告活動目標對象檢視畫面。包含多媒體廣告聯播網和 YouTube 聯播網廣告的興趣和再行銷名單成效資料,以及按廣告活動和目標對象條件匯總的搜尋廣告再行銷名單。此資料檢視只包含在廣告活動層級附加的目標對象。
campaign_bid_modifier 代表只能在廣告活動層級修改的出價條件。
campaign_budget 廣告活動預算。
campaign_conversion_goal [廣告活動轉換目標] 指定廣告活動的可出價設定,僅適用於所有符合指定類別和來源的轉換動作。
campaign_criterion 廣告活動條件。
campaign_criterion_simulation 廣告活動條件模擬。以下詳細說明廣告管道類型、條件編號、模擬類型和模擬修改方法的組合。1. 搜索 - 30000,30001,30002 - BID_MODIFIER - UNIFORM 2. 多媒體 - 30001 - BID_MODIFIER - UNIFORM
campaign_customizer 廣告活動層級相關自訂工具屬性的自訂參數值。
campaign_draft 廣告活動草稿。
campaign_experiment [廣告活動實驗] 這項 A/B 實驗會比較基礎廣告活動 (控制組) 和該廣告活動 (變化版本) 的成效差異。
campaign_extension_setting 廣告活動額外資訊設定。
campaign_feed 廣告活動資訊提供。
campaign_group [廣告活動群組] 廣告活動群組。
campaign_label 代表廣告活動與標籤之間的關係。
campaign_shared_set CampaignSharedSets 可用來管理與廣告活動相關的共用組合。
campaign_simulation 廣告活動模擬。以下詳細說明廣告管道類型、模擬類型和模擬修改方法。搜尋 - 單次點擊出價_ - 關鍵字搜尋 - 單次點擊出價_ - 有效搜尋 - TARGET_CPA - SCALING 搜尋 - TARGET_ROAS - UNIFORM SEARCH - TARGET_IMPRESSION_SHARE - UNIFORM 搜尋 - 目標單次客戶開發出價 - 廣告預算
carrier_Constant 可在廣告活動指定目標中使用的貨運公司條件。
變更事件 說明特定資源類型傳回資源的精細變更。會顯示過去 30 天內由外部使用者 (包括外部使用者,以及可對外顯示的內部使用者) 透過 UI、API 和新版編輯器所做的變更。變更會顯示變更前欄位的舊值,以及變更後變更後的新值。ChangeEvent 最多可能需要 3 分鐘,才能反映新的變更。
變更狀態 說明傳回資源的狀態。變更狀態最多可能需要 3 分鐘,才會反映新的變更。
click_view 點擊檢視,提供各個點擊層級所彙整的指標,包含有效點擊和無效點擊。針對非搜尋廣告活動,metric.clicks 代表有效和無效互動的次數。包含 ClickView 的查詢必須設定篩選器,將結果範圍限制在一天內,且可要求搜尋在要求之前的 90 天內。
組合目標對象 請針對包含不同目標對象的合併目標對象說明一項資源。
conversion_action 轉換動作。
conversion_custom_variable 轉換自訂變數 請參閱「關於轉換自訂變數」一文:https://support.google.com/google-ads/answer/9964350
conversion_goal_campaign_config 廣告活動的轉換目標設定。
轉換價值 轉換價值規則
conversion_value_rule_set 轉換價值規則組合
currency_Constant 貨幣常數。
自訂目標對象 自訂目標對象。這是依興趣區分的使用者名單。
custom_conversion_goal (自訂轉換目標) 可將任意轉換動作設為可出價的自訂轉換目標。
custom_interest 自訂興趣。這是依興趣區分的使用者名單。
客戶 客戶。
customer_asset 客戶與資產之間的連結。
customer_client 指定客戶與客戶之間的連結。只有客戶經理客戶可以使用 ClientClient。所有直接和間接客戶客戶都會納入其中,以及管理員本身。
customer_client_link 代表客戶連結關係。
customer_conversion_goal [客戶轉換目標] 出價與對照組的轉換動作可出價控制。
customer_customizer 客戶層級相關 CustomrAttribute 的自訂參數值。
customer_extension_setting 客戶額外資訊設定。
customer_feed 客戶資訊提供。
customer_label 代表客戶與標籤之間的關係。這位客戶可能無法存取所有附加於該標籤的標籤。如果使用 login-customer-id 增加權限,可能會傳回其他 CustomerLabel。
customer_manager_link [客戶管理員連結] 代表客戶經理連結關係。
customer_negative_criterion 客戶層級排除項目的排除條件。
customer_user_access 代表單一使用者對單一客戶的權限。
customer_user_access_invitation 代表此客戶帳戶上的新使用者的邀請。
customizer_attribute 自訂參數屬性。使用 CustomerCustomizer、CampaignCustomr、AdGroupCustomizer 或 BODY 客製化 r 來連結自訂參數屬性,並分別在客戶、廣告活動、廣告群組或廣告群組條件層級設定其值。
detail_placement_view 以廣告群組和網址或 YouTube 影片匯總指標的資料檢視。
detailed_demographic 詳細客層:根據特定興趣所屬的產業,根據長期生活資料觸及使用者。
display_keyword_view 多媒體廣告關鍵字檢視畫面。
distance_view 這個距離檢視畫面會顯示使用者與廣告客戶地點額外資訊之間的匯總指標。每個 Distancebucket 皆包含指定距離中的所有曝光,而單一曝光會納入所有 Distancebuckets 的指標 (包括使用者的距離)。
domain_category [網域類別] 透過檢索網域而自動產生的類別。如果廣告活動使用 DynamicSearchAdsSetting,系統就會為網域產生網域類別。您可以使用 WebpageConditionInfo 指定類別。詳情請參閱:https://support.google.com/google-ads/answer/2471185
dynamic_search_ads_search_term_view 動態搜尋廣告搜尋字詞檢視畫面。
expanded_landing_page_view 到達網頁檢視,包含在展開的最終到達網址層級匯總的指標。
實驗 Google Ads 實驗可讓使用者實驗對多個廣告活動的變更、比較成效,以及套用有效的變更。
experiment_arm Google Ads 實驗可讓使用者實驗對多個廣告活動的變更、比較成效,以及套用有效的變更。
extension_feed_item 額外資訊動態饋給項目。
動態饋給 動態饋給。
feed_item 動態饋給項目。
feed_item_set 代表一組資訊提供項目。這組動態饋給可用於特定動態饋給項目功能,舉例來說,您可在客戶動態饋給、CampaignFeed 和 AdGroupFeed 的比對函式中參照這個組合。
feed_item_set_link 代表 FeedItem 與 FeedItemSet 之間的連結。
feed_item_target 動態饋給項目目標。
feed_mapping 動態饋給對應。
feed_placeholder_view 資訊提供預留位置檢視。
gender_view [性別檢視] 性別檢視模式。
geo_target_常數 指定地理區域常數。
geographic_view 地理位置檢視。「地理區域檢視」會納入在國家/地區層級匯總的所有指標 (每個國家/地區一列)。報表會回報使用者實際位置或感興趣的區域的指標。如有使用其他區隔欄位,則每個國家/地區可能會有多個資料列。
group_placement_view 群組刊登位置檢視畫面。
hotel_group_view 飯店群組檢視畫面。
hotel_performance_view 飯店成效檢視畫面。
hotel_reconciliation 飯店對帳。當中包含從飯店訂房取得的轉換資訊,以與廣告客戶記錄核對。在透過大量上傳功能計費之前,這些列可能會更新或取消。
income_range_view 收入範圍檢視。
keyword_plan 「關鍵字規劃工具」已儲存的關鍵字企劃書數量上限:10000 個。一旦達到上限,你就可以移除方案。
keyword_plan_ad_group 「關鍵字規劃工具」廣告群組。每個企劃書的關鍵字企劃書廣告群組數量上限:200 個。
keyword_plan_ad_group_keyword 「關鍵字規劃工具」廣告群組關鍵字。每個企劃書的關鍵字企劃書關鍵字數量上限:10000 個。
keyword_plan_campaign 「關鍵字規劃工具」廣告活動。每個企劃書的關鍵字企劃書廣告活動數量上限:1.
keyword_plan_campaign_keyword 「關鍵字規劃工具」廣告活動關鍵字。廣告活動關鍵字僅支援排除關鍵字。
keyword_theme_Constant 智慧廣告活動關鍵字主題常數。
keyword_view 關鍵字檢視。
label 標籤。
landing_page_view 到達網頁檢視,顯示未展開的最終到達網址層級指標。
language_常數 語言。
lead_form_submission_data 待開發客戶表單提交的資料。
life_event 人生大事:以特定興趣為指定目標的產業,鎖定適逢人生重要里程碑時觸及他們。
location_view 地區檢視會根據地區條件來匯總廣告活動的成效摘要。
managed_placement_view 自選刊登位置檢視。
media_file 媒體檔案。
mobile_app_category_常數 行動應用程式類別常數。
mobile_device_Constant 一個行動裝置。
離線使用者資料工作 這份工作含有離線訪客資料的離線使用者資料,或是非同步處理的使用者名單成員。無法讀取上傳的資料,而且只能透過 GoogleAdsService.Search/SearchStream 讀取工作處理結果。
Operating_system_version_Constant 行動作業系統版本或某些版本,視 operator_type 而定。https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms 中可用的行動平台清單
paid_organic_search_term_view 付費隨機搜尋字詞檢視可讓您查看各廣告和搜尋聯播網上的搜尋統計資料,並於廣告群組層級針對搜尋字詞進行匯總。
parental_status_view 父母檢視模式。
product_bidding_category_常數 產品出價類別。
product_group_view 產品群組檢視。
recommendation 建議。
無再行銷價值 再行銷動作。用來收集產品編號與訪客造訪網頁類型 (產品網頁、購物車網頁、購買網頁、一般網站造訪等) 的 JavaScript 程式碼片段。
search_term_view 搜尋字詞檢視畫面,顯示廣告群組層級各搜尋字詞的指標。
shared_criterion 屬於共用組合的條件。
shared_set 「共用組合」功能可用來共用多個廣告活動中的條件排除條件。
shopping_performance_view [購物成效] 購物成效檢視畫面。提供多種購物廣告活動統計資料的匯總。Merchant Center 中的產品維度值 (例如品牌、類別、自訂屬性、產品狀況和產品類型) 會反映每個維度在截至對應事件發生的日期和時間。
smart_campaign_search_term_view 智慧廣告活動搜尋字詞檢視畫面。
smart_campaign_setting 智慧廣告活動相關設定。
third_party_app_analytics_link [第三方應用程式連結] 資料共用連結,可將第三方應用程式分析匯入 Google Ads 客戶。
topic_常數 您可以利用主題,根據刊登位置所屬的類別,指定或排除 Google 多媒體廣告聯播網上的刊登位置 (例如「寵物與動物/寵物/狗」)。
topic_view 主題檢視畫面。
user_interest 使用者興趣:要指定的特定興趣類別。
<使用者清單> 使用者名單。這是客戶指定的使用者名單。
user_location_view 使用者位置檢視。「使用者位置檢視」會納入在國家/地區層級匯總的所有指標 (每個國家/地區一列)。報表會以指定目標或非目標位置,記錄使用者實際實際位置的指標。如有使用其他區隔欄位,則每個國家/地區可能會有多個資料列。
影片 影片。
webpage_view 網頁瀏覽。