报告

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

概览

这些页面列出了可以使用 GoogleAdsService.SearchStreamGoogleAdsService.Search 在 Google Ads API 中查询的资源。资源名称关联到自己的页面。每个页面上都会显示以下列表:

  • 可在与资源相同的 SELECT 子句中使用的工件(资源、细分或指标)
  • 资源不对指标进行细分的归因资源(如果添加到这些资源字段的相同 SELECT 和 WHERE 子句中)

此类列表显示在表列表中,这些表由可在搜索查询中包含的资源字段、细分和指标的名称组成(在 FROM 子句中指定该资源)。每个名称都链接到包含其元数据的表格:

  • category
  • data type
  • type URL
  • filterable
  • selectable
  • sortable
  • repeated
可过滤
此行指示该字段是否可以在 GAQL 查询的 WHERE 子句的条件中使用。
可选
此行指明是否可以在 GAQL 查询的 SELECT 子句中指定该字段。
Sortable
此行指示字段是否可以在 GAQL 查询的 ORDER BY 子句中进行排序和使用。
重复
此行用于指示字段是否重复,应以列表形式处理。

报告示例

所有资源的列表

资源类型
无障碍出价策略 表示客户拥有并与客户共享的 BidStrategies 视图。与 BidStrategy 相比,除了此客户所有的策略,该资源还包括该客户经理拥有的、与此客户共享的策略。此资源不提供指标,仅提供有限的几个 BidStrategy 属性。
account_budget 帐号级预算。其中包含预算本身信息、最近批准的预算更改,以及待审批的更改建议。您可以在 'pending_提案' 中找到待审批的提议更改(如果有)。有关预算的有效详细信息可在带有前缀 #&93;approved_'、'adjusted_' 的字段以及没有前缀的字段中找到。由于一些有效的细节可能与用户最初要求的有所不同(例如,支出限额),因此这些差异会并入 &posited_'approved_' 和可能 'adjusted_' 字段。此资源使用 AccountBudgetProposal 进行转变,无法直接更改。在任意给定时间,一个预算最多只能有一个待处理的提案。请仔细阅读。获得批准后,预算可能会有所调整,例如赠送金额调整项。所做调整会在“已批准”字段与“已调整”字段之间产生差异(原本是相同的),
account_budget_suggest 帐号级预算提案。所有以 'proposed' 为前缀的字段不一定都直接应用。例如,建议的支出限额可能会在应用生效之前进行调整。如果 &{/3} 字段包含对应的 & 值,例如,存在支出限额。请注意,提案类型 (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_audience_view 广告组的受众群体视图。包括在展示广告网络和 YouTube 广告网络上的兴趣和再营销名单、搜索广告再营销名单 (RLSA) 的效果数据,在受众群体一级汇总。
ad_group_bid_modifier 表示广告组出价调节系数。
广告组条件 广告组条件。
广告组标准条件 在 AdGroupCriterion 级别,关联的 CustomrAttribute 的定制工具值。
广告组标准条件 广告组标准与标签之间的关系。
广告组_条件_模拟 广告组条件模拟。下文详细介绍了支持的广告渠道类型、条件类型、模拟类型和模拟修改方法。从 V5 开始的 Hotel AdGroupCriterion 模拟操作。1. 展示广告 - 关键字 - 每次点击费用出价 - 统一 2. 搜索广告 - 关键字 - 每次点击费用_出价 - 统一 3. 购物 - LISTING_GROUP - CPC_BID - UNIFORM 4. 酒店 - 列表组 - 每次点击费用出价 - 统一 5. 酒店 - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
广告组自定义工具 广告组一级的关联 CustomrAttribute 的定制工具值。
ad_group_extension_setting 广告组附加信息设置。
广告组 Feed 广告组 Feed。
广告组标签 广告组和标签之间的关系。
广告组_模拟 广告组模拟。下文详细介绍了支持的广告渠道类型、模拟类型和模拟修改方法的组合。1. 搜索网络 - 每次点击费用出价 - 默认 2. 搜索网络 - CPC 出价 - 统一 3. 搜索广告 - 目标每次转化费用 - 统一 4. 搜索广告 - 目标广告支出回报率 - 统一 5. 展示 - 每次点击费用出价 - 默认 6. 展示广告 - 每次点击费用出价 - 统一 7. 展示广告 - TARGET_CPA - 统一
ad_parameter 一种广告参数,用于更新广告的任何文本行(包括网址)中的数值(例如价格或广告资源级别)。每个广告组条件最多可以有两个 AdParameters。(一个参数为 parameter_index = 1,另一个参数为 parameter_index = 2)。在广告中,参数以格式“{param#:value}”的占位符引用。例如,"{param1:$17}"
ad_schedule_view 广告投放时间视图按广告投放时间标准汇总了广告系列的效果。
age_range_view 年龄段视图。
素材资源 素材资源是广告的一部分,可以跨多个广告进行共享。素材资源可以是图片 (ImageAsset)、视频 (YouTubeVideoAsset) 等。素材资源是不可变的,无法移除。要停止投放某个素材资源,请从使用该素材资源的实体中移除该素材资源。
asset_field_type_view 资产字段类型视图。该视图会在将素材资源用作附加信息时,报告每种素材资源字段类型的未超量指标。
素材资源组 素材资源组。AssetGroupAsset 用于将素材资源与素材资源组相关联。AssetGroupSignal 用于将信号与素材资源组相关联。
asset_group_asset AssetGroupAsset 是素材资源与素材资源组之间的关联。添加 AssetGroupAsset 可将素材资源与素材资源组相关联。
asset_group_listing_group_filter AssetGroupListingGroupFilter 表示素材资源组中的产品信息组过滤条件树节点。
asset_group_product_group_view 素材资源组产品组视图。
素材资源组信号 AssetGroupSignal 表示素材资源组中的一个信号。信号的存在可以告知效果最大化广告系列最有可能完成转化的用户。效果最大化广告系列会利用此信号,寻找意向相似或更强的新用户,以在搜索网络、展示广告网络、视频平台等位置获取转化。
资源集 表示一组素材资源的资源集。使用 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_simulation 出价策略模拟。下面分别详细介绍了支持的模拟类型和模拟修改方法。1. 目标每次转化费用 - 统一 2. TARGET_ROAS - 统一
billing_setup 将付款帐号与广告客户相关联的结算设置。结算设置对应一个广告客户。
call_view 包含对来电专用广告或附加电话信息进行来电跟踪的来电视图。
广告系列 广告系列。
广告系列素材资源 广告系列和资产之间的关联。
campaign_asset_set CampaignAssetSet 是广告系列与素材资源集之间的关联。添加 CampaignAssetSet 可将素材资源集与广告系列相关联。
campaign_audience_view 广告系列受众群体视图。包括按展示广告网络和 YouTube 网络广告的兴趣和再营销名单以及搜索广告再营销名单 (RLSA) 提供的效果数据,这些数据按广告系列和受众群体条件汇总。此视图仅包含广告系列一级附加的受众群体。
campaign_bid_modifier 表示在广告系列一级仅限可修改的条件。
campaign_budget 广告系列预算。
广告系列转化目标 仅为具有匹配类别和来源匹配的所有转化操作的指定广告系列进行出价设置。
campaign_criteria 广告系列条件。
广告系列条件_模拟 广告系列条件模拟。下文详细介绍了支持的广告渠道类型、标准 ID、模拟类型和模拟修改方法。1. 搜索广告系列 - 30000、30001、30002 - BID_MODIFIER - Uniiform 2。展示广告 - 30001 - BID_MODIFIER - UNIFORM
广告系列定制工具 广告系列一级的关联 CustomrAttribute 的定制工具值。
广告系列草稿 广告系列草稿。
广告系列实验 一项 A/B 实验,用于比较基准广告系列(对照组)和该广告系列的变体的效果(实验组)。
campaign_extension_setting 广告系列附加信息设置。
广告系列 Feed 广告系列 Feed。
广告系列组 广告系列组。
广告系列标签 表示广告系列和标签之间的关系。
广告系列共享集 CampaignSharedSet 用于管理与广告系列相关联的共享集。
广告系列模拟 广告系列模拟。下文详细介绍了支持的广告渠道类型、模拟类型和模拟修改方法的组合。- - - - 快捷部门:-
carrier_constant 可在广告系列定位中使用的运营商标准。
更改事件 描述所返回资源类型的特定资源的细微更改。系统会显示过去 30 天内外部用户(包括外部用户和可对外显示的内部用户)通过界面、API 和新版编辑器所做的更改。变更内容会显示变更前变更字段的旧值以及变更之后的新值。ChangeEvent 最多可能会延迟 3 分钟才能反映新的更改。
更改状态 描述所返回资源的状态。ChangeStatus 最多可能会延迟 3 分钟才能反映新的更改。
点击观看 一个点击次数视图,其中包含在各点击级别汇总的指标,包括有效点击次数和无效点击次数。对于非搜索广告系列,metrics.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_constant 货币常量。
custom_audience 自定义受众群体。这是按兴趣细分的用户列表。
custom_conversion_goal 可使任意转化操作可出价的自定义转化目标。
自定义兴趣 自定义的兴趣。这是按兴趣细分的用户列表。
客户 客户。
customer_asset 客户与资产之间的关联。
客户客户 指定客户与客户间的关联。CustomerClients 仅适用于经理帐号。包括所有直接和间接客户以及经理。
customer_client_link 表示客户与客户的关联关系。
customer_conversion_goal 针对具有匹配类别和来源的转化操作的可出价性控制。
customer_Customizer 客户级别的关联 CustomrAttribute 的定制工具值。
customer_extension_setting 客户附加信息设置。
customer_feed 客户 Feed。
customer_label [客户标签] 表示客户与标签之间的关系。此客户可能无权访问其随附的所有标签。通过使用 login-customer-id 增加权限,可能会返回其他 CustomerLabels。
customer_manager_link 表示客户-经理关联关系。
customer_negative_criteria 在客户一级排除的排除项。
customer_user_access 表示单个用户对单个客户的权限。
customer_user_access_invitation 向此客户帐号中的新用户表示邀请。
customizer_attribute 定制工具属性。使用 CustomerCustomizer、CampaignCustomizer、AdGroupCustomizer 或 AdGroupCriterionCustomizer,分别关联定制工具属性并在客户、广告系列、广告组或广告组标准一级设置其值。
detail_placement_view 包含按广告组和网址或 YouTube 视频汇总的指标的数据视图。
详细受众特征 详细受众特征:根据用户的长期生活情况来定位的基于兴趣的特定行业。
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。
Feed 项 Feed 项。
feed_item_set 表示一组 Feed 项。该集合可在特定的 Feed 项功能中使用和共享。例如,可以在 CustomerFeed、CampaignFeed 和 AdGroupFeed 的匹配函数中引用该集合。
feed_item_set_link 表示 FeedItem 与 FeedItemSet 之间的关联。
feed_item_target Feed 项定位条件。
feed_mapping Feed 映射。
feed_placeholder_view Feed 占位符视图。
gender_view 性别视图。
geo_target_constant 地理位置定位常量。
geographic_view 地理位置视图。地理位置视图包含国家/地区一级的所有指标,每个国家/地区占一行。报告会按照用户的实际位置或感兴趣的地区来报告指标。如果使用了其他细分字段,每个国家/地区可能会占多行。
group_placement_view 组展示位置视图。
酒店组视图 酒店组视图。
hotel_performance_view 酒店广告效果视图。
酒店对帐 酒店对帐。其中包含酒店预订转化信息,以便与广告客户记录进行对帐。在通过批量上传进行结算之前,这些行可能会更新或取消。
收入范围视图 收入范围视图。
关键字方案 关键字规划师方案。已保存的关键字方案数量上限:10000。如果达到上限,则可以移除方案。
关键字方案_广告组 关键字规划师广告组。每个方案的关键字方案广告组数量上限:200。
关键字方案_广告组_关键字 关键字方案广告组关键字。每个方案的关键字方案关键字数量上限:10000。
关键字方案广告系列 关键字广告系列。每个方案允许的关键字方案广告系列数量上限:1.
keyword_plan_campaign_keyword 关键字方案广告系列关键字。广告系列关键字仅支持否定关键字。
关键字主题常量 智能广告系列关键字主题常量。
关键字视图 关键字视图。
label 标签。
landing_page_view 在未展开最终到达网址一级汇总指标的着陆页视图。
language_constant 语言。
潜在客户表单数据_lead_form_submission_data 潜在客户表单提交中的数据。
人生大事 人生大事:当用户处于人生重大事件时,定位于兴趣的特定行业。
location_view 营业地点视图按地理位置条件汇总了广告系列的效果。
managed_placement_view 自选展示位置视图。
媒体文件 媒体文件。
mobile_app_category_constant 移动应用类别常量。
mobile_device_constant 移动设备常量。
离线用户数据作业 包含商店访问者的离线用户数据或异步处理的用户名单成员的作业。上传的数据无法读取,并且只能使用 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 建议。
再营销操作 一种再营销操作。一段 JavaScript 代码,用于收集用户在广告客户网站上访问的商品 ID 和网页类型(产品页、购物车页、购买页、一般网站访问页)。
search_term_view 一个搜索字词视图,显示按广告组一级的搜索字词汇总的指标。
共享条件 属于共享集的条件。
共享集合 SharedSets 用于在多个广告系列之间共享条件排除对象。
shopping_performance_view 购物效果视图。提供多个产品维度级别的购物广告系列统计信息汇总。Merchant Center 中的产品维度值(例如品牌、类别、自定义属性、产品条件和产品类型)将反映每个维度在记录相应事件时的日期和时间的状态。
智能广告系列搜索_数据视图 智能广告系列的搜索字词视图。
智能广告系列设置 用于配置智能广告系列的设置。
third_party_app_analytics_link 一种数据共享连接,允许将第三方应用分析工具导入 Google Ads 客户。
topic_constant 根据展示位置所属的类别(例如“宠物与动物/宠物/狗”),使用主题定位或排除 Google 展示广告网络中的展示位置。
topic_view 主题视图。
用户兴趣 用户兴趣:要定位的特定针对用户兴趣的行业。
user_list 用户名单。这是客户可以定位的用户列表。
user_location_view 用户位置视图。用户地理位置视图包括所有在国家/地区一级汇总的指标,每个国家/地区占一行。它会按照定位的地理位置或未定位的地理位置报告用户实际所处的位置。如果使用了其他细分字段,每个国家/地区可能会占多行。
视频 视频。
webpage_view 网页浏览。