概览
这些页面列出了可在 Google Ads API 中使用 GoogleAdsService.SearchStream
或 GoogleAdsService.Search
查询的资源。资源名称关联到其自己的页面。在每个页面上,系统都会显示以下列表:
- 可以与资源在同一 SELECT 子句中使用的工件(资源、细分或指标)
- 所含资源字段的相同 SELECT 和 WHERE 子句中所含字段不会细分指标的归因资源
在 FROM 子句中指定此资源后,系统会呈现这些列表,其中包含由可包含在搜索查询中的资源字段、细分和指标的名称组成的表。每个名称均与包含其元数据的表格相关联:
category
data type
type URL
filterable
selectable
sortable
repeated
- 可过滤
- 此行指示该字段是否可以在 GAQL 查询的
WHERE
子句的条件中使用。 - 可选择
- 此行指示是否可以在 GAQL 查询的
SELECT
子句中指定该字段。 - Sortable
- 此行指示是否可以在 GAQL 查询的
ORDER BY
子句中对字段进行排序和使用。 - 重复
- 此行指示字段是否重复,应以列表形式处理。
报告示例
所有资源的列表
资源类型 | |
---|---|
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}" 占位符。例如:¶mot:{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_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 [商品组 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 | 网页浏览。 |