广告组条件

广告组条件。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 正确 重复 错误