報告

總覽

本頁面列出可使用 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 屬性。
帳戶預算 帳戶層級預算。其中包含預算本身的資訊、最近核准的預算變更,以及建議的待核准變更。待核准的變更項目 (如果有的話) 列載於 ##99pending_proposal'。如需預算的有效詳細資料,請參閱前置字元「##9; approved_'」、「'adjusted_&#39」的欄位。由於部分有效的詳細資料可能與使用者原先要求的內容不同 (例如支出上限),因此這些差異會以「#39;proposed_'」、「#39; approved_'」和「##99adjusted_'」欄位而設計。這項資源是透過 AccountBudgetProposal 變更,無法直接變更。預算在任何時間點都最多只能有一項待處理的提案。系統會透過 pending_proposal 讀取。獲得核准後,預算可能會經過調整,例如調整抵免額。調整項會在 ' approved' 和 ##9;adjusted' 欄位之間建立差異。
account_ budget_proposal 帳戶層級預算提案。前置字串為「##9;poseposed&#39」的所有欄位;不一定會直接套用。舉例來說,建議的支出上限會在申請套用前進行調整。如果 'proposed' 欄位有 ' approved'請注意,提案類型 (proposal_type) 會變更必填欄位,哪些欄位留空。
account_link [帳戶連結] 代表 Google Ads 帳戶與其他帳戶之間的資料共用連結
廣告群組 廣告群組。
ad_group_ad [廣告群組群組] 廣告群組廣告。
ad_group_ad_asset_combination_view 呈現廣告群組廣告素材資源組合的使用情形。目前我們僅支援回應式搜尋廣告的 groupAdAssetCombinationView,日後預計還會支援更多廣告類型。
ad_group_ad_asset_view AdAd 和一項素材資源之間的連結。目前只有 AppAdView 適用於 AdsAdAsset。
ad_group_ad_label 廣告群組廣告和標籤之間的關係。
ad_group_asset 廣告群組與素材資源之間的連結。
ad_group_audience_view [廣告群組目標對象檢視畫面] 廣告群組目標對象檢視畫面。包括多媒體廣告聯播網和 YouTube 聯播網中廣告興趣與再行銷名單的成效資料,以及目標對象層級匯總的搜尋廣告再行銷名單 (RLSA)。
ad_group_bid_modifier 代表廣告群組出價調節係數。
廣告群組條件 廣告群組條件。
ad_group_criterion_customizer 或 YAML 層級相關 CustomrrAttribute 的自訂參數值。
ad_group_criterion_label 廣告群組條件和標籤之間的關係。
AD_group_criterion_simulation 廣告群組條件模擬。以下詳細說明廣告管道類型、條件類型、模擬類型和模擬修改方法的組合。從 Android 5 版本開始的 Hotel "/> 模擬作業。1. 多媒體 - 關鍵字 - 單次點擊出價_出價 - 統一 2。搜尋 - 關鍵字 - 單次點擊出價_出價 - UNIFORM 3。SHOPPING - LISTING_GROUP - 單次點擊出價_ - 統一 4。飯店 - LISTING_GROUP - 單次點擊出價_出價 - 統一 5。飯店 - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
ad_group_customizer 廣告群組層級相關 CustomrAttribute 的自訂參數值。
ad_group_extension_setting 廣告群組額外資訊設定。
ad_group_feed 廣告群組動態饋給。
ad_group_label 廣告群組與標籤之間的關係。
ad_group_simulation 廣告群組模擬。以下詳細說明廣告管道類型、模擬類型和模擬修改方法的組合。1. 搜尋 - CPC_BID - DEFAULT 2。搜尋 - 單次點擊出價_出價 - UNIFORM 3。搜尋 - TARGET_CPA - UNIFORM 4。搜尋 - TARGET_ROAS - UNIFORM 5. 多媒體 - 單次點擊出價 - 預設 6。多媒體 - 單次點擊出價_出價 - 統一 7。多媒體 - TARGET_CPA - UNIFORM
ad_parameter (廣告參數) 廣告參數是用來更新廣告任何文字行 (包括網址) 中的數值 (例如價格或廣告空間層級)。每個廣告群組條件最多可包含兩個 AdParameters 條件。(一個參數為 parameter_index = 1,另一個參數為 parameter_index = 2)。在廣告中,系統會使用「quot;{param#:value}」格式的預留位置引用參數。例如:{param1:$17}"
廣告時間表 廣告時段設定檢視畫面會根據 AdSchedule 條件匯總廣告活動的成效。
年齡層範圍 年齡層檢視畫面。
資產 素材資源是廣告的一部分,可由多個廣告共用。可以是圖片 (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 以非同步方式處理的 Variant 清單。變化版本由使用者上傳。這些片段本身無法判讀,而工作結果只能透過 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 - 統一 2. TARGET_ROAS - 統一
billing_setup 可連結付款帳戶和廣告客戶的帳單設定。個別廣告客戶專屬的帳單設定。
_view_view 來電報表,內含來電專用廣告或來電額外資訊的來電追蹤資料。
廣告活動 廣告活動。
campaign_asset (廣告活動素材資源) 廣告活動與資產之間的連結。
campaign_asset_set (廣告活動素材資源組合) CampaignAssetSet 是廣告活動與素材資源組合之間的連結。新增 CampaignAssetSet 會連結素材資源組合與廣告活動。
campaign_audience_view 廣告活動目標對象檢視畫面。包括多媒體廣告聯播網和 YouTube 聯播網上興趣和再行銷名單的成效資料,以及按廣告活動和目標對象條件匯總的搜尋廣告再行銷名單 (RLSA)。這項資料檢視只會納入廣告活動層級附加的目標對象。
campaign_bid_modifier 代表可在廣告活動層級修改的可出價條件。
campaign_預算 廣告活動預算。
廣告活動轉換目標 為特定廣告活動的所有出價設定,且僅適用於具有相符類別和來源的轉換動作。
campaign_criterion 廣告活動條件。
campaign_criterion_simulation 廣告活動條件模擬。以下詳細說明廣告管道類型、條件 ID、模擬類型和模擬修改方法的組合。1. 搜尋 - 30000,30001,30002 - BID_MODIFIER - UNIFORM 2。多媒體 - 30001 - BID_MODIFIER - UNIFORM
campaign_customizer 廣告活動層級相關 CustomrAttribute 的自訂參數值。
campaign_draft 廣告活動草稿。
campaign_experiment (廣告活動實驗) 這項 A/B 實驗會比較基礎廣告活動 (控制組) 和該廣告活動變化形式 (實驗) 的成效。
campaign_extension_setting 廣告活動額外資訊設定。
campaign_feed 廣告活動動態饋給。
campaign_group (廣告活動群組) 廣告活動群組。
campaign_label 代表廣告活動與標籤之間的關係。
campaign_shared_set CampaignSharedSets 可用於管理與廣告活動相關的共用組合。
廣告活動_模擬 廣告活動模擬。以下詳細說明廣告管道類型、模擬類型和模擬修改方法的組合。搜尋 - 單次點擊出價_ - UNIFORM SEARCH - CPC_BID - SCALING SEARCH - TARGET_CPA - UNIFORM SEARCH - TARGET_CPA - SCALING SEARCH - TARGET_ROAS - UNIFORM SEARCH - TARGET_IMPRESSION - UN FORM - 轉接 - 廣告轉接器 - 為廣告轉接訊息
carrier_常數 可在廣告活動指定目標中使用的貨運公司條件。
變更事件 說明特定資源類型傳回資源的精細變更。系統會顯示過去 30 天內外部使用者 (包括外部使用者和可對外顯示的內部使用者) UI、API 和新版編輯器所做的變更。這項變更會顯示變更前變更欄位的舊值,以及變更後後方的新值。ChangeEvent 最多可能要過 3 分鐘才會反映新的變更。
變更狀態 說明傳回資源的狀態。ChangeStatus 最多可能需要 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 轉換價值規則
conversion_value_rule_set 轉換價值規則組合
currency_常數 貨幣常數。
自訂目標對象 自訂目標對象。這是依興趣區分的使用者名單。
自訂轉換目標 可自訂任意轉換動作的自訂轉換目標。
自訂興趣 自訂興趣。這是依興趣區分的使用者名單。
客戶 客戶。
customer_asset 客戶與資產之間的連結。
customer_client 指定客戶與客戶客戶的連結。CustomerClients 僅供管理員客戶使用。其中涵蓋所有直接和間接客戶,以及管理員本身。
customer_client_link [客戶用戶端連結] 代表客戶連結關係。
customer_conversion_goal 具有相符類別和來源的轉換動作的可出價控制項。
customer_customizer 客戶層級相關 CustomrAttribute 的自訂參數值。
customer_extension_setting 客戶額外資訊設定。
customer_feed 客戶動態饋給。
customer_label 代表客戶與標籤之間的關係。這位客戶可能無法存取與其附加的所有標籤。使用 login-customer-id 增加權限可能會傳回其他 CustomerLabels。
customer_manager_link 代表客戶與管理員的連結關係。
customer_excluded_criterion 排除客戶層級的排除條件。
customer_user_access 代表單一使用者允許單一客戶的權限。
customer_user_access_invitation 代表此客戶帳戶上的新使用者邀請。
customr_attribute [自訂屬性] 自訂參數屬性。使用 CustomerCustomizer、CampaignCustomizer、GroupCustomizer 或 PERCENTAGECustomizer 可連結自訂參數屬性,並分別在客戶、廣告活動、廣告群組或廣告群組條件層級設定其值。
detail_placement_view 按廣告群組、網址或 YouTube 影片匯總指標的檢視畫面。
detailed_demographic 詳細客層:以興趣為依據的指定產業,可讓您根據長期生活資料觸及使用者。
display_keyword_view 多媒體廣告關鍵字瀏覽。
distance_view 距離使用者指標的匯總指標資料,以及使用者與廣告客戶地點額外資訊之間的距離。每個 DistanceBucket 都會包含距離內的所有曝光,而單一曝光會包含所有包含使用者距離的 DistanceBucket 的指標。
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 代表一組動態饋給項目。這組集合可在特定動態饋給項目功能之間使用及分享。舉例來說,您可以在 CustomerFeed、CampaignFeed 和 groupFeed 的比對函式中參照該集合。
feed_item_set_link 代表 FeedItem 和 FeedItemSet 之間的連結。
feed_item_target 動態饋給項目目標。
feed_mapping 動態饋給對應。
feed_placeholder_view 動態饋給預留位置檢視畫面。
gender_view 性別檢視畫面。
geo_target_常數 指定地理區域常數。
geo_view 地理區域檢視。「地理區域檢視」會列出在國家/地區層級匯總的所有指標,每個國家/地區各佔一列。報表會回報使用者的實際位置或感興趣的區域指標。如有使用其他區隔欄位,則每個國家/地區可能會有多個資料列。
group_placement_view 群組刊登位置檢視畫面。
hotel_group_view 飯店群組檢視畫面。
hotel_performance_view 飯店成效檢視畫面。
hotel_reconciliation 飯店對帳。其中包含飯店預訂的轉換資訊,以便與廣告客戶記錄保持一致。會透過「大量上傳」的帳單功能更新或取消這些資料列。
收入範圍檢視 收入範圍檢視畫面。
keyword_plan 關鍵字規劃工具。已儲存的關鍵字企劃書上限:10000 個。如果已達到上限,則可移除方案。
keyword_plan_ad_group 關鍵字規劃工具廣告群組。每個企劃書的關鍵字企劃書廣告群組數量上限:200 個。
keyword_plan_ad_group_keyword 關鍵字企劃書廣告群組關鍵字。每個企劃書的關鍵字企劃書數量上限:10000 個。
keyword_plan_campaign 關鍵字企劃書廣告活動。每個企劃書的關鍵字企劃書廣告活動數量上限:1.
keyword_plan_campaign_keyword 關鍵字企劃書廣告活動關鍵字。廣告活動關鍵字僅支援排除關鍵字。
keyword_theme_常數 智慧廣告活動關鍵字常數。
keyword_view 關鍵字檢視畫面。
標籤 標籤。
landing_page_view 到達網頁檢視,顯示未展開的最終到達網址層級指標。
語言常數 一種語言。
lead_form_submission_data 待開發客戶表單提交的資料。
人生大事 人生大事:以特定興趣為依據的產業,可讓您在適逢人生重要里程碑時觸及使用者。
「location_view」 「地區檢視」會依地區條件列出廣告活動的成效。
managed_placement_view 自選刊登位置檢視畫面。
media_file 媒體檔案。
mobile_app_category_常數 行動應用程式類別常數。
mobile_device_常數 行動裝置常數。
Offline_user_data_job 這份工作含有親臨門市訪客的離線使用者資料,或是會以非同步方式處理的使用者名單成員。上傳的資料無法讀取,而工作處理結果只能透過 GoogleAdsService.Search/SearchStream 讀取。
operating_system_version_常數 取決於 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_regular 產品出價類別。
product_group_view 查看產品群組。
recommendation 建議。
再行銷_動作 再行銷動作。這組 JavaScript 程式碼會收集廣告客戶網站上的產品 ID 和網頁類型 (產品頁面、購物車頁面、購買頁面、一般網站造訪)。
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 客戶。
主題_常數 指定主題,即可根據刊登位置所屬的類別,指定或排除 Google 多媒體廣告聯播網中的刊登位置 (例如「寵物與動物、寵物/寵物/狗」)。
主題_觀看 主題檢視畫面。
使用者興趣 使用者興趣:要指定的特定產業別。
<使用者名單> 使用者名單。這是客戶可以指定的使用者名單。
user_location_view 使用者位置檢視畫面。「使用者位置檢視」包含在國家/地區層級匯總的所有指標,每個國家/地區各佔一列。報表會根據指定或未指定地區的使用者,回報使用者實際位置的指標。如有使用其他區隔欄位,則每個國家/地區可能會有多個資料列。
影片 影片。
網頁頁面 網頁瀏覽。