總覽
本頁面列出可使用 GoogleAdsService.SearchStream
或 GoogleAdsService.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;proposed_'」、「#39; approved_'」和「##99adjusted_'」欄位而設計。這項資源是透過 AccountBudgetProposal 變更,無法直接變更。預算在任何時間點都最多只能有一項待處理的提案。系統會透過 pending_proposal 讀取。獲得核准後,預算可能會經過調整,例如調整抵免額。調整項會在 ' approved' 和 ##9;adjusted' 欄位之間建立差異。 |
account_ budget_proposal | 帳戶層級預算提案。前置字串為「##9;poseposed'」的所有欄位;不一定會直接套用。舉例來說,建議的支出上限會在申請套用前進行調整。如果 '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 | 使用者位置檢視畫面。「使用者位置檢視」包含在國家/地區層級匯總的所有指標,每個國家/地區各佔一列。報表會根據指定或未指定地區的使用者,回報使用者實際位置的指標。如有使用其他區隔欄位,則每個國家/地區可能會有多個資料列。 |
影片 | 影片。 |
網頁頁面 | 網頁瀏覽。 |