新版 Search Ads 360 Reporting API 现已发布。您可以加入 searchads-api-announcements Google 网上论坛，及时了解即将发布的增强功能和版本。

此页面由 Cloud Translation API 翻译。

广告组条件

广告组条件。ad_group_criterion 报告仅会返回明确添加到广告组中的条件。

归因资源
ad_group
campaign
customer
user_list

您可以在 SELECT 和 WHERE 子句中选择上述资源以及此资源中的字段。这些字段不会对 SELECT 子句中的指标进行细分。

ad_group_criterion.ad_group
字段说明	条件所属的广告组。
类别	`ATTRIBUTE`
数据类型	`RESOURCE_NAME`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	错误
重复	错误

ad_group_criterion.age_range.type
字段说明	年龄段的类型。
类别	`ATTRIBUTE`
数据类型	`ENUM AGE_RANGE_18_24 AGE_RANGE_25_34 AGE_RANGE_35_44 AGE_RANGE_45_54 AGE_RANGE_55_64 AGE_RANGE_65_UP AGE_RANGE_UNDETERMINED UNKNOWN UNSPECIFIED`
输入网址	`google.ads.searchads360.v0.enums.AgeRangeTypeEnum.AgeRangeType`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.bid_modifier
字段说明	条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。
类别	`ATTRIBUTE`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.cpc_bid_micros
字段说明	每次点击费用出价。
类别	`ATTRIBUTE`
数据类型	`INT64`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.creation_time
字段说明	创建此广告组条件时的时间戳。时间戳采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss”格式。
类别	`ATTRIBUTE`
数据类型	`DATE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.criterion_id
字段说明	条件的 ID。
类别	`ATTRIBUTE`
数据类型	`INT64`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.effective_cpc_bid_micros
字段说明	有效每次点击费用 (cost-per-click) 出价。
类别	`ATTRIBUTE`
数据类型	`INT64`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.effective_labels
字段说明	附加到此广告组条件的有效标签的资源名称。有效标签是指继承或直接分配给此广告组条件的标签。
类别	`ATTRIBUTE`
数据类型	`RESOURCE_NAME`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	错误
重复	正确

ad_group_criterion.engine_id
字段说明	外部引擎账号中的广告组条件的 ID。此字段仅适用于非 Google Ads 账号，例如 Yahoo Japan、Microsoft、百度等。对于 Google Ads 实体，请改用“ad_group_criterion.criterion_id”。
类别	`ATTRIBUTE`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.engine_status
字段说明	广告组条件的引擎状态。
类别	`ATTRIBUTE`
数据类型	ENUM AD_GROUP_CRITERION_ACCOUNT_PAUSED AD_GROUP_CRITERION_APPROVED AD_GROUP_CRITERION_DISAPPROVED AD_GROUP_CRITERION_ELIGIBLE AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH AD_GROUP_CRITERION_INVALID_PC_SEARCH AD_GROUP_CRITERION_INVALID_SEARCH AD_GROUP_CRITERION_LOW_SEARCH_VOLUME AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW AD_GROUP_CRITERION_NOT_REVIEWED AD_GROUP_CRITERION_ON_HOLD AD_GROUP_CRITERION_PARTIALLY_INVALID AD_GROUP_CRITERION_PAUSED AD_GROUP_CRITERION_PENDING_REVIEW AD_GROUP_CRITERION_REMOVED AD_GROUP_CRITERION_SERVING AD_GROUP_CRITERION_TO_BE_ACTIVATED AD_GROUP_CRITERION_UNDER_REVIEW UNKNOWN UNSPECIFIED
输入网址	`google.ads.searchads360.v0.enums.AdGroupCriterionEngineStatusEnum.AdGroupCriterionEngineStatus`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.final_url_suffix
字段说明	用于将参数附加到最终到达网址的网址模板。
类别	`ATTRIBUTE`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.final_urls
字段说明	广告的所有跨网域重定向之后可能存在的最终到达网址列表。
类别	`ATTRIBUTE`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	错误
重复	正确

ad_group_criterion.gender.type
字段说明	性别的类型。
类别	`ATTRIBUTE`
数据类型	`ENUM FEMALE MALE UNDETERMINED UNKNOWN UNSPECIFIED`
输入网址	`google.ads.searchads360.v0.enums.GenderTypeEnum.GenderType`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.keyword.match_type
字段说明	关键字的匹配类型。
类别	`ATTRIBUTE`
数据类型	`ENUM BROAD EXACT PHRASE UNKNOWN UNSPECIFIED`
输入网址	`google.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchType`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.keyword.text
字段说明	关键字文本（最多 80 个字符和 10 个字词）。
类别	`ATTRIBUTE`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.labels
字段说明	广告组条件所附标签的资源名称。
类别	`ATTRIBUTE`
数据类型	`RESOURCE_NAME`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	错误
重复	正确

ad_group_criterion.last_modified_time
字段说明	上次修改此广告组条件的日期时间。日期时间采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。
类别	`ATTRIBUTE`
数据类型	`DATE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.listing_group.type
字段说明	商品详情组的类型。
类别	`ATTRIBUTE`
数据类型	`ENUM SUBDIVISION UNIT UNKNOWN UNSPECIFIED`
输入网址	`google.ads.searchads360.v0.enums.ListingGroupTypeEnum.ListingGroupType`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.location.geo_target_constant
字段说明	目标地理位置常量资源名称。
类别	`ATTRIBUTE`
数据类型	`RESOURCE_NAME`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	错误
重复	错误

ad_group_criterion.negative
字段说明	是定位 (`false`) 还是排除 (`true`) 条件。该字段不可更改。如需将条件从正切换为负，请先移除再重新添加。
类别	`ATTRIBUTE`
数据类型	`BOOLEAN`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.position_estimates.top_of_page_cpc_micros
字段说明	要让广告显示在搜索结果首页顶部所需的每次点击费用出价的估算值。
类别	`ATTRIBUTE`
数据类型	`INT64`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.quality_info.quality_score
字段说明	质量得分。如果 Google 没有足够的信息来确定值，则系统可能不会填充该字段。
类别	`ATTRIBUTE`
数据类型	`INT32`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.resource_name
字段说明	广告组条件的资源名称。广告组条件资源名称采用以下格式：`customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}`
类别	`ATTRIBUTE`
数据类型	`RESOURCE_NAME`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	错误
重复	错误

ad_group_criterion.status
字段说明	条件的状态。这是广告组条件实体的状态，由客户端设置。注意：界面报告可能包含其他信息，这些信息会影响条件是否能够运行。在某些情况下，在 API 中移除的条件可能仍会在界面中显示为已启用。例如，默认情况下，广告系列会面向所有年龄段的用户展示（已被排除的除外）。该界面会将各个年龄段显示为“已启用”，因为它们有资格观看广告；但 AdGroupCriterion.status 会显示为“已移除”，因为系统未添加任何肯定条件。
类别	`ATTRIBUTE`
数据类型	`ENUM ENABLED PAUSED REMOVED UNKNOWN UNSPECIFIED`
输入网址	`google.ads.searchads360.v0.enums.AdGroupCriterionStatusEnum.AdGroupCriterionStatus`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.tracking_url_template
字段说明	用于构建跟踪网址的网址模板。
类别	`ATTRIBUTE`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.type
字段说明	条件的类型。
类别	`ATTRIBUTE`
数据类型	ENUM AD_SCHEDULE AGE_RANGE APP_PAYMENT_MODEL AUDIENCE BRAND BRAND_LIST CARRIER COMBINED_AUDIENCE CONTENT_LABEL CUSTOM_AFFINITY CUSTOM_AUDIENCE CUSTOM_INTENT DEVICE GENDER INCOME_RANGE IP_BLOCK KEYWORD KEYWORD_THEME LANGUAGE LIFE_EVENT LISTING_GROUP LISTING_SCOPE LOCAL_SERVICE_ID LOCATION LOCATION_GROUP MOBILE_APPLICATION MOBILE_APP_CATEGORY MOBILE_DEVICE OPERATING_SYSTEM_VERSION PARENTAL_STATUS PLACEMENT PROXIMITY TOPIC UNKNOWN UNSPECIFIED USER_INTEREST USER_LIST WEBPAGE YOUTUBE_CHANNEL YOUTUBE_VIDEO
输入网址	`google.ads.searchads360.v0.enums.CriterionTypeEnum.CriterionType`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.user_list.user_list
字段说明	用户名单资源名称。
类别	`ATTRIBUTE`
数据类型	`RESOURCE_NAME`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	错误
重复	错误

ad_group_criterion.webpage.conditions
字段说明	网页定位的条件或逻辑表达式。在为定位进行评估时，网页定位条件列表会连接在一起。如果条件列表为空，则表示定位到广告系列所属网站的所有网页。此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。
类别	`ATTRIBUTE`
数据类型	`MESSAGE`
输入网址	`google.ads.searchads360.v0.common.WebpageConditionInfo`
可过滤	错误
可选择	正确
Sortable	错误
重复	正确

ad_group_criterion.webpage.coverage_percentage
字段说明	网站条件覆盖率。这是系统根据广告组和广告系列中的网站定位条件、否定网站定位条件和否定关键字计算出的网站覆盖率。例如，如果覆盖率返回为 1，则表示覆盖率为 100%。此字段为只读字段。
类别	`ATTRIBUTE`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

ad_group_criterion.webpage.criterion_name
字段说明	由此参数定义的条件的名称。名称值将用于使用此类参数标识、排序和过滤条件。此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。
类别	`ATTRIBUTE`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。

最后更新时间 (UTC)：2024-11-08。