Google Ads 查询构建工具

交互式 Google Ads 查询语言查询构建器按查询的 FROM 子句中的资源进行整理。要开始构建查询,请从以下列表中选择一项资源:

您还可以使用查询验证器手动输入和验证查询。

所有资源的列表

资源类型
accessibility_bidding_strategy 表示拥有并与客户共享的 BidStrategies 视图。与 BidStrategy 不同,此资源包含客户经理拥有的与客户共享的策略,以及此客户拥有的策略。此资源不提供指标,并且仅会显示有限的几个 BidStrategy 属性。
account_budget 帐号级预算。它包含有关预算本身的信息、最近批准的预算更改以及待批准的更改建议。待批准的更改建议(如有)显示在“待审批的提案”中。有关预算的有效详细信息,可以在以 'approved_', 'adjusted_' 为前缀的字段中找到。由于某些有效细节可能不同于用户最初请求的内容(例如支出限额),因此这些差异可通过 'proposed_'、'approved_' 以及 'adjusted_' 字段进行合并。此资源使用 AccountBudgetProposal 发生变化,无法直接更改。预算在任何给定时间最多只能有一个待处理提案。请仔细阅读待处理提案。批准后,预算可能会调整,例如贷记调整项。所做调整会在 'approved'adjusted' 字段之间产生差异,否则两者完全相同。
account_budget_Proposal 帐号级预算提案。所有前缀为 'proposed' 的字段不一定会直接应用。例如,可在应用之前调整建议的支出限额。如果 &pro3ed&pos=39; 字段有对应的 'approved' 对应项,例如支出限额。请注意,提案类型 (Proposal_type) 可更改哪些是必填字段,哪些字段必须留空。
account_link [帐号链接] 表示 Google Ads 帐号与其他帐号之间的数据共享关联
广告组 广告组。
ad_group_ad [广告组组] 广告组广告。
ad_group_ad_asset_combination_view 广告组广告素材资源组合的数据视图。现在,我们仅支持针对自适应搜索广告使用 AdGroupAdAssetCombinationView,未来还会增加更多广告类型。
ad_group_ad_asset_view AdGroupAd 和 Asset 之间的链接。目前,我们仅为 AppAds 支持 AdGroupAdAssetView。
ad_group_ad_label [广告组组标签] 广告组广告和标签之间的关系。
ad_group_asset 广告组与素材资源之间的关联。
ad_group_audience_view 广告组受众群体视图。包括展示广告网络和 YouTube 网络广告中的兴趣和再营销名单,以及搜索广告再营销名单(汇总到受众群体级别)。
ad_group_bid_modifier 表示广告组出价调节系数。
广告组条件 广告组标准。
广告组_条件_自定义 AdGroupCriterion 级别关联的 CustomrAttribute 的定制工具值。
ad_group_criteria_label 广告组条件与标签之间的关系。
广告组_条件_模拟 广告组条件模拟。下文详细介绍了支持的广告渠道类型、条件类型、模拟类型和模拟修改方法。酒店 AdGroupCriterion 模拟操作(从 V5 开始)。1. 展示广告 - 关键字 - 每次点击费用 - 统一 2. 搜索广告 - 关键字 - 每次点击费用 - 统一 3. 购物 - LISTING_GROUP - CPC_BID - UNIFORM 4. 酒店 - LISTING_GROUP - CPC_BID - UNIFORM 5. 酒店 - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
ad_group_Customizer 广告组一级的相关 CustomrAttribute 的定制工具值。
ad_group_extension_setting 广告组附加信息设置。
ad_group_feed 广告组 Feed。
广告组标签 广告组和标签之间的关系。
广告组_模拟 广告组模拟。下文详细介绍了支持的广告渠道类型、模拟类型和模拟修改方法。1. 搜索 - 每次点击费用出价 - 默认 2. 搜索广告 - 每次点击费用 - 统一 3. 搜索广告 - TARGET_CPA - UNIFORM 4. 搜索 - TARGET_ROAS - UNIFORM 5. 展示广告 - 每次点击费用 - 默认 6. 展示广告 - 每次点击费用 - 统一 7. 展示广告 - TARGET_CPA - UNIFORM
ad_parameter 用于更新广告的任何文本行(包括网址)中的数值(如价格或广告资源级别)的广告参数。每个广告组的条件最多可以有两个 AdParameters。(一个参数为 parameter_index = 1,另一个为 parameter_index = 2)。在广告中,这些参数的格式为 {param#:value}" 占位符。例如:&paramot:{1:17}”
ad_schedule_view 广告投放时间视图按照 AdSchedule 条件汇总了广告系列的效果。
age_range_view [年龄段] 年龄段视图。
资源 素材资源是广告中的一部分,可在多个广告之间共享。它可能是图片 (ImageAsset)、视频 (YouTubeVideoAsset) 等。素材资源是不可变的,无法移除。要停止投放某个素材资源,请从使用该素材资源的实体中移除该素材资源。
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 表示素材资源组中的信号。通过存在信号,您可以了解效果最大化广告系列中最有可能完成转化的用户。效果最大化广告系列会利用此信号在 Google 搜索、展示广告网络、视频等平台寻找具有类似或更强烈意向的新用户。
asset_set 表示一系列资产的资源集。使用 AssetSetAsset 将资源与资源集相关联。
asset_set_asset AssetSetAsset 是资源与资源集之间的关联。添加 AssetSetAsset 会将资源与资源集关联起来。
受众群体 受众群体是一种有效的定位选项,通过此方法,您可以交叉使用各种细分受众群属性(例如详细受众特征和兴趣相似的受众群体),从而创建表示目标细分受众群各个部分的受众群体。
batch_job 异步处理的转变列表。用户上传这些 Mutate。这些转变本身不可读,并且作业结果只能使用 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 - 统一
billing_setup 结算设置,用于将付款帐号与广告客户相关联。特定于一个广告客户的结算设置。
call_view 包含来电广告或附加电话信息通话跟踪数据的来电视图。
广告系列 广告系列。
campaign_asset 广告系列与资产之间的关联。
campaign_asset_set CampaignAssetSet 是广告系列与资源集之间的关联。添加 CampaignAssetSet 会将素材资源集与广告系列相关联。
campaign_audience_view 广告系列受众群体视图。包括按展示广告网络和 YouTube 标准汇总的兴趣和再营销名单数据,以及搜索广告再营销名单(按广告系列和受众群体条件汇总)。此视图仅包含广告系列一级附加的受众群体。
campaign_bid_modifier 表示广告系列一级的仅可修改的出价标准。
campaign_budget 广告系列预算。
campaign_conversion_goal 仅对指定广告系列与类别和来源均相符的所有转化操作使用指定广告系列的可出价设置。
campaign_criteria 广告系列定位条件。
campaign_criteria_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 广告系列 Feed。
广告系列组 广告系列组。
campaign_label [广告系列标签] 表示广告系列和标签之间的关系。
campaign_shared_set CampaignSharedSets 用于管理与广告系列相关联的共享集。
广告系列模拟 广告系列模拟。下文详细介绍了支持的广告渠道类型、模拟类型和模拟修改方法。- 帐单 - 发票 - 发票
carrier_Constant 可在广告系列定位中使用的运营商标准。
更改事件 描述特定资源类型返回的资源的精细更改。系统会显示过去 30 天内由外部用户(包括外部用户和内部用户可以显示的编辑器)通过界面、API 和新版本所做的更改。更改前会显示更改后的旧字段值以及更改后的新值。ChangeEvent 最多可能会延迟 3 分钟才能反映新的更改。
更改状态 描述所返回资源的状态。ChangeStatus 可能会延迟最多 3 分钟才能反映新的更改。
click_view 包含各个点击级别指标的点击视图,包括有效点击和无效点击。对于非搜索广告系列,metrics.clicks 表示有效和无效互动次数。包含 ClickView 的查询必须使用将结果限制为一天的过滤条件,并且可以查询最早可追溯到请求时间之前 90 天的数据。
combined_audience 为包含不同受众群体的组合受众群体描述一项资源。
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_Constant 货币常量。
自定义受众群体 自定义受众群体。这是按兴趣列出的用户。
custom_conversion_goal 可使任意转化操作可出价的自定义转化目标。
自定义兴趣 一种自定义的兴趣。这是按兴趣列出的用户。
客户 客户。
customer_asset 客户与资产之间的关联。
customer_client 指定客户与客户链接。只有经理帐号的客户拥有 CustomerClients。包括直接客户和间接客户以及经理本身。
customer_client_link [客户链接] 表示客户与客户的关联关系。
customer_conversion_goal 针对类别和来源一致的转化操作的可出价性控制。
customer_Customizer 客户级别的关联 CustomrAttribute 的定制工具值。
customer_extension_setting 附加客户信息设置。
customer_feed 客户 Feed。
customer_label [客户标签] 表示客户与标签之间的关系。该客户可能无权访问与其关联的所有标签。使用 login-customer-id 增加权限可能会返回其他 CustomerLabel。
customer_manager_link 表示客户与经理之间的关联。
customer_negative_criteria 排除客户级别的排除条件。
customer_user_access 表示单个用户对单个客户的权限。
customer_user_access_invitation 向此客户帐号中的新用户发出邀请。
customizer_attribute 定制工具属性。使用 CustomerCustomizer、CampaignCustomizer、AdGroupCustomizer 或 AdGroupCriterionCustomizer,分别关联定制工具属性并在客户、广告系列、广告组或广告组条件一级设置其值。
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 项。
信息流 Feed。
feed_item [Feed 商品] Feed 项。
feed_item_set [信息流商品集] 表示一组 Feed 项。该组可用于特定的 Feed 项功能。例如,可以在 CustomerFeed、CampaignFeed 和 AdGroupFeed 的匹配函数中引用此集合。
feed_item_set_link [Feed 商品集链接] 表示 FeedItem 与 FeedItemSet 之间的关联。
feed_item_target [Feed 商品目标] Feed 项定位条件。
feed_mapping Feed 映射。
feed_placeholder_view Feed 占位符视图。
gender_view 性别视图。
geo_target_常量 地理位置定位条件常量。
geographic_view 地理位置视图。地理位置视图包含所有在国家/地区一级汇总的指标,每个国家/地区各占一行。它会报告用户实际所在位置或感兴趣的区域的指标。如果使用了其他细分字段,每个国家/地区可能会有多个行。
group_placement_view 组展示位置视图。
hotel_group_view [酒店组视图] 酒店组视图。
hotel_performance_view 酒店广告效果视图。
hotel_对帐 酒店对帐。它包含酒店预订的转化信息,以便与广告客户记录保持一致。在通过批量上传进行结算之前,这些行可能会更新或取消。
income_range_view 收入范围视图。
关键字方案 关键字规划师方案。已保存的关键字方案数量上限:10000。如果达到上限,则可以移除方案。
keyword_plan_ad_group [关键字方案广告组] 关键字规划师广告组。每个方案的关键字方案广告组数量上限:200。
keyword_plan_ad_group_keyword(关键字方案广告组) 关键字方案中的广告组关键字。每个方案的关键字方案关键字数量上限:10000。
keyword_plan_campaign [关键字方案广告系列] 关键字方案广告系列。每个方案允许的关键字方案广告系列数量上限:1。
keyword_plan_campaign_keyword 关键字方案广告系列关键字。广告系列关键字仅支持否定关键字。
keyword_theme_常量 智能广告系列的关键字主题常量。
keyword_view 关键字视图。
label 标签。
landing_page_view 着陆页指标包含未展开的最终到达网址的指标汇总。
language_Constant 语言。
lead_form_submission_data 潜在客户表单提交的数据。
人生大事 人生大事:要覆盖面临特定人生重大事件的用户这一定位特定兴趣的行业。
location_view [地理位置视图] 营业地点视图会按照地理位置条件汇总广告系列的效果。
managed_placement_view 自选展示位置视图。
media_file 媒体文件。
mobile_app_category_常量 移动应用类别常量。
mobile_device_常量 移动设备常量。
离线用户数据作业 包含将异步处理的实体店光顾用户或用户名单成员用户数据的作业。无法读取上传的数据,并且只能使用 GoogleAdsService.Search/SearchStream 读取作业的处理结果。
operating_system_version_Constant 移动操作系统版本或一系列版本,具体取决于 operator_typehttps://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 [商品组 ID] 产品组视图。
recommendation 建议。
remarketing_action 一项再营销操作。用于收集广告客户网站上产品 ID 和用户访问的网页类型(产品页、购物车页、购买页、一般网站访问)的 JavaScript 代码段。
search_term_view 一个搜索字词视图,其中包含按广告组级别的搜索字词汇总的指标。
shared_criteria 属于共享集的条件。
shared_set SharedSets 用于在多个广告系列之间共享条件排除。
shopping_performance_view 购物效果视图。提供在多个产品维度一级汇总的购物广告系列统计信息。Merchant Center 中的产品维度值(例如品牌、类别、自定义属性、产品条件和产品类型)将反映记录相应事件时每个维度的状态。
smart_campaign_search_term_view 智能广告系列的搜索字词视图。
smart_campaign_setting 用于配置智能广告系列的设置。
third_party_app_analytics_link 一种数据共享连接,允许将第三方应用分析工具导入 Google Ads 客户。
topic_Constant 使用主题,按照展示位置所属的类别(例如,“宠物与动物/动物/宠物/狗”)定位或排除 Google 展示广告网络中的展示位置。
topic_view 主题视图。
用户兴趣 用户兴趣:要定位的特定兴趣类别。
user_list 用户列表。这是客户可能会定位到的用户列表。
user_location_view 用户位置视图。“用户地理位置”视图包含国家/地区层级的所有指标,每个国家/地区各占一行。它会按已定位或未定位的地理位置报告用户实际所在地理位置的指标。如果使用了其他细分字段,每个国家/地区可能会有多个行。
视频 视频。
webpage_view 网页浏览。