概览
这些页面列出了可以使用 SearchAds360Service.SearchStream 或 SearchAds360Service.Search 在 API 中查询的资源。资源名称会链接到其各自的页面。每个页面上都会显示以下列表:
- 可与该资源在同一 SELECT 子句中使用的工件(资源、细分或指标)
- 当这些资源字段包含在同一 SELECT 和 WHERE 子句中时,其字段不会细分指标的归因资源
在这些列表之后,是包含资源字段、细分和指标名称的表格,当在 FROM 子句中指定此资源时,这些名称可以包含在搜索查询中。 每个名称都链接到包含其元数据的表:
categorydata typetype URLfilterableselectablesortablerepeated
- 可过滤
- 此行指明该字段是否可用于查询的
WHERE子句的条件中。 - 可选择
- 此行指明是否可以在查询的
SELECT子句中指定该字段。 - Sortable
- 此行指明是否可以对该字段进行排序,以及是否可以在查询的
ORDER BY子句中使用该字段。 - 重复
- 此行指示字段是否重复,应作为列表处理。
所有资源列表
| 资源类型 | |
|---|---|
| accessible_bidding_strategy | 表示客户拥有和共享的出价策略视图。与 BiddingStrategy 不同,此资源不仅包含此客户拥有的策略,还包含此客户的经理拥有并与此客户共享的策略。此资源不提供指标,仅公开 BiddingStrategy 属性的有限子集。 |
| ad_group | 广告组。 |
| ad_group_ad | 广告组广告。 |
| ad_group_ad_effective_label | 广告组广告与有效标签之间的关系。有效标签是指继承或直接分配给此广告组广告的标签。 |
| ad_group_ad_label | 广告组广告与标签之间的关系。 |
| ad_group_asset | 广告组与素材资源之间的关联。 |
| ad_group_asset_set | AdGroupAssetSet 是广告组与素材资源集之间的关联。创建 AdGroupAssetSet 会将素材资源集与广告组相关联。 |
| ad_group_audience_view | 广告组受众群体视图。包括展示广告网络和 YouTube 广告网络广告的兴趣和再营销名单的效果数据,以及搜索广告再营销名单 (RLSA) 的效果数据,这些数据在受众群体一级汇总。 |
| ad_group_bid_modifier | 表示广告组出价调节系数。 |
| ad_group_criterion | 广告组条件。ad_group_criterion 报告仅返回明确添加到广告组中的条件。 |
| ad_group_criterion_effective_label | 广告组条件与有效标签之间的关系。有效标签是指继承或直接分配给此广告组条件的标签。 |
| ad_group_criterion_label | 广告组条件与标签之间的关系。 |
| ad_group_effective_label | 广告组与有效标签之间的关系。有效标签是指继承或直接分配给此广告组的标签。 |
| ad_group_label | 广告组与标签之间的关系。 |
| age_range_view | 年龄段视图。表示按年龄段汇总的客户效果指标(例如展示次数和点击次数)视图。所有统计信息都会在广告组一级汇总。注意:虽然您可以使用 age_range_view 按年龄段细分指标,或使用 gender_view 按性别细分指标,但 Search Ads 360 API 不支持在单个查询中同时按年龄段和性别细分指标。Search Ads 360 API 不支持同时分析这两个维度的效果。 |
| 资产 | 素材资源是广告的一部分,可在多个广告之间共享。它可以是图片 (ImageAsset)、视频 (YoutubeVideoAsset) 等。素材资源不可变,无法移除。如需停止投放某个素材资源,请将其从正在使用它的实体中移除。 |
| asset_group | 素材资源组。AssetGroupAsset 用于将素材资源与素材资源组相关联。AssetGroupSignal 用于将信号与素材资源组相关联。 |
| asset_group_asset | AssetGroupAsset 是素材资源与素材资源组之间的关联。添加 AssetGroupAsset 会将素材资源与素材资源组相关联。 |
| asset_group_listing_group_filter | AssetGroupListingGroupFilter 表示素材资源组中的产品信息组过滤条件树节点。 |
| asset_group_signal | AssetGroupSignal 表示素材资源组中的信号。信号的存在会告知效果最大化广告系列哪些用户最有可能完成转化。效果最大化广告系列会参考该信号,寻找意向相似或更强烈的新用户,以在搜索网络、展示广告网络、视频平台等位置促成转化。 |
| asset_group_top_combination_view | 素材资源组素材资源最佳组合的使用情况视图。 |
| asset_set | 代表一组素材资源的素材资源集。使用 AssetSetAsset 将素材资源关联到素材资源集。 |
| asset_set_asset | AssetSetAsset 是素材资源与素材资源集之间的关联。添加 AssetSetAsset 会将素材资源与素材资源集相关联。 |
| audience | 受众群体是一种有效的定位选项,可让您通过组合各种细分受众群属性(例如详细受众特征和兴趣相似的受众群体)得出其交集部分,从而创建出代表目标细分受众群某一部分的受众群体。 |
| bidding_strategy | 出价策略。 |
| campaign | 广告系列。 |
| campaign_asset | 广告系列与素材资源之间的关联。 |
| campaign_asset_set | CampaignAssetSet 是广告系列与素材资源集之间的关联。添加 CampaignAssetSet 会将素材资源集与广告系列相关联。 |
| campaign_audience_view | 广告系列受众群体视图。包含展示广告网络和 YouTube 广告网络广告的兴趣和再营销名单的效果数据,以及搜索广告再营销名单 (RLSA) 的效果数据,按广告系列和受众群体条件汇总。此视图仅包含在广告系列一级添加的受众群体。 |
| campaign_budget | 广告系列预算。 |
| campaign_criterion | 广告系列条件。 |
| campaign_effective_label | 表示广告系列与有效标签之间的关系。有效标签是指继承或直接分配给此广告系列的标签。 |
| campaign_label | 表示广告系列与标签之间的关系。 |
| cart_data_sales_view | 购物车数据销售视图。如果实现了含购物车数据的转化,则会提供所购商品的相关信息。对于在产品目录 Feed 中定义且因 Google 广告而售出的产品,您可以查看其效果指标(例如收入、毛利润、作为主推产品/交叉销售产品时的指标等)和 Merchant Center 属性(例如品牌、类别等)。对于归因于购物广告点击的购买,您可以同时查看所点击商品和所售商品的维度。 |
| conversion | 转化。 |
| conversion_action | 转化操作。 |
| conversion_custom_variable | 转化自定义变量。请参阅“新版 Search Ads 360 中的自定义 Floodlight 指标和维度简介”,网址为 https://support.google.com/sa360/answer/13567857 |
| customer | 客户。 |
| customer_asset | 客户与素材资源之间的关联。 |
| customer_asset_set | CustomerAssetSet 是客户与素材资源集之间的关联。添加 CustomerAssetSet 会将素材资源集与客户相关联。 |
| customer_client | 给定客户与客户顾客之间的关联。CustomerClient 仅适用于经理客户。包括所有直接和间接客户顾客,以及经理账号本身。 |
| customer_manager_link | 表示客户与经理之间的关联关系。 |
| dynamic_search_ads_search_term_view | 动态搜索广告搜索字词视图。 |
| gender_view | 性别视图资源。表示按性别汇总的客户效果指标视图。所有统计信息都会在广告组一级汇总。注意:虽然您可以使用 age_range_view 按年龄段细分指标,或使用 gender_view 按性别细分指标,但 Search Ads 360 API 不支持在单个查询中同时按年龄段和性别细分指标。Search Ads 360 API 不支持同时分析这两个维度的效果。 |
| geo_target_constant | 地理位置定位目标常量。 |
| keyword_view | 关键字视图。 |
| label | 标签。 |
| language_constant | 一种语言。 |
| location_view | 地理位置视图按地理位置条件汇总广告系列的效果。 |
| product_bidding_category_constant | 商品出价类别。 |
| product_group_view | 产品组视图。 |
| shopping_performance_view | 购物广告效果视图。提供在多个产品维度级别汇总的购物广告系列和效果最大化广告系列统计信息。Merchant Center 中的商品维度值(例如品牌、类别、自定义属性、商品使用情况和商品类型)将反映相应事件记录日期和时间时每个维度的状态。shopping_performance_view 返回统计数据的展示次数和点击次数可能与广告系列报告中的数据不同。shopping_performance_view显示广告中展示的商品的展示次数和点击次数,而广告系列报告则显示广告本身的展示次数和点击次数。根据广告格式,一个广告可以展示零到多个商品,因此这些数字可能不一致。在 Search Ads 360 界面中,您可以在报告编辑器中从“商品属性”中选择一列,查询广告中出现的商品的展示次数和点击次数。例如,选择“品牌”列相当于选择 segments.product_brand。 |
| user_list | 用户名单。这是客户可能定位的用户列表。用户名单的唯一键由以下字段组成:id。请注意,对于给定客户拥有的用户名单,name 也必须是唯一的,除非在某些情况下 access_reason 设置为 SHARED。违反唯一名称限制条件会产生错误:UserListError.INVALID_NAME。 |
| user_location_view | 用户地理位置视图。“用户地理位置”视图包含在国家/地区一级汇总的所有指标,每个国家/地区一行。它会按定位到或未定位到的地理位置,显示基于用户实际所在地理位置的指标。如果使用其他细分字段,您可能会看到每个国家/地区有多行数据。 |
| visit | 一次访问。 |
| webpage_view | 网页视图。 |