AdGroupCriterion

广告组标准。adGroupCriterion 报告仅返回明确添加到广告组中的条件。

JSON 表示法 
{
  "resourceName": string,
  "displayName": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "systemServingStatus": enum (CriterionSystemServingStatus),
  "approvalStatus": enum (AdGroupCriterionApprovalStatus),
  "disapprovalReasons": [
    string
  ],
  "labels": [
    string
  ],
  "effectiveCpcBidSource": enum (BiddingSource),
  "effectiveCpmBidSource": enum (BiddingSource),
  "effectiveCpvBidSource": enum (BiddingSource),
  "effectivePercentCpcBidSource": enum (BiddingSource),
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "primaryStatusReasons": [
    enum (AdGroupCriterionPrimaryStatusReason)
  ],
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "cpmBidMicros": string,
  "cpvBidMicros": string,
  "percentCpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "effectiveCpmBidMicros": string,
  "effectiveCpvBidMicros": string,
  "effectivePercentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,
  "primaryStatus": enum (AdGroupCriterionPrimaryStatus),

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "placement": {
    object (PlacementInfo)
  },
  "mobileAppCategory": {
    object (MobileAppCategoryInfo)
  },
  "mobileApplication": {
    object (MobileApplicationInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "incomeRange": {
    object (IncomeRangeInfo)
  },
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "youtubeVideo": {
    object (YouTubeVideoInfo)
  },
  "youtubeChannel": {
    object (YouTubeChannelInfo)
  },
  "topic": {
    object (TopicInfo)
  },
  "userInterest": {
    object (UserInterestInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "appPaymentModel": {
    object (AppPaymentModelInfo)
  },
  "customAffinity": {
    object (CustomAffinityInfo)
  },
  "customIntent": {
    object (CustomIntentInfo)
  },
  "customAudience": {
    object (CustomAudienceInfo)
  },
  "combinedAudience": {
    object (CombinedAudienceInfo)
  },
  "audience": {
    object (AudienceInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "language": {
    object (LanguageInfo)
  }
  // End of list of possible types for union field criterion.
}
字段
resourceName

string

不可变。广告组条件的资源名称。广告组条件资源名称采用以下格式：

customers/{customerId}/adGroupCriteria/{adGroupId}~{criterionId}
displayName

string

仅限输出。条件的显示名称。

对于变更，此字段会被忽略。
status

enum (AdGroupCriterionStatus)

条件的状态。

这是由客户设置的广告组条件实体的状态。注意：界面报告可能包含其他信息，这些信息会影响条件是否能够运行。在某些情况下，在 API 中已移除的标准仍可在界面中显示为已启用。例如，默认情况下，广告系列会面向所有年龄段的用户展示（已被排除的除外）。该界面会将各个年龄段显示为“已启用”，因为它们有资格观看广告；但 AdGroupCriterion.status 会显示为“已移除”，因为系统未添加任何肯定条件。
qualityInfo

object (QualityInfo)

仅限输出。关于标准质量的信息。
type

enum (CriterionType)

仅限输出。标准的类型。
systemServingStatus

enum (CriterionSystemServingStatus)

仅限输出。条件的投放状态。
approvalStatus

enum (AdGroupCriterionApprovalStatus)

仅限输出。条件的审批状态。
disapprovalReasons[]

string

仅限输出。条件拒登原因列表。

要了解拒批条件的不同原因，请访问：https://support.google.com/adspolicy/answer/6008942

此字段为只读字段。
labels[]

string

仅限输出。广告组条件所附标签的资源名称。
effectiveCpcBidSource

enum (BiddingSource)

仅限输出。有效每次点击费用出价的来源。
effectiveCpmBidSource

enum (BiddingSource)

仅限输出。有效每千次展示费用出价的来源。
effectiveCpvBidSource

enum (BiddingSource)

仅限输出。有效每次观看费用出价的来源。
effectivePercentCpcBidSource

enum (BiddingSource)

仅限输出。有效百分比形式的每次点击费用出价的来源。
positionEstimates

object (PositionEstimates)

仅限输出。不同排名的定位标准出价估算值。
finalUrls[]

string

广告的所有跨网域重定向之后可能存在的最终到达网址列表。
finalMobileUrls[]

string

所有跨网域重定向之后可能存在的最终到达移动网址列表。
urlCustomParameters[]

object (CustomParameter)

用于替换 trackingUrlTemplate、finalUrls 或 mobile_final_urls 中的自定义参数标记的映射列表。
primaryStatusReasons[]

enum (AdGroupCriterionPrimaryStatusReason)

仅限输出。广告组条件的主要状态原因。
criterionId

string (int64 format)

仅限输出。条件的 ID。

对于变更，此字段会被忽略。
adGroup

string

不可变。条件所属的广告组。
negative

boolean

不可变。是定位 (false) 还是排除 (true) 条件。

该字段不可更改。 如需将条件从正切换为负，请先移除再重新添加。
bidModifier

number

条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。
cpcBidMicros

string (int64 format)

每次点击费用出价。
cpmBidMicros

string (int64 format)

CPM（每千次可见展示费用）出价。
cpvBidMicros

string (int64 format)

每次观看费用 (cost-per-view) 出价。
percentCpcBidMicros

string (int64 format)

每次点击费用出价金额，表示为某些商品或服务的广告价格的分数。分数的有效范围为 [0,1)，此处存储的值为 1,000,000 * [fraction]。
effectiveCpcBidMicros

string (int64 format)

仅限输出。有效每次点击费用出价。
effectiveCpmBidMicros

string (int64 format)

仅限输出。有效每千次展示费用（每千次可见的展示费用）出价。
effectiveCpvBidMicros

string (int64 format)

仅限输出。有效每次观看费用出价。
effectivePercentCpcBidMicros

string (int64 format)

仅限输出。有效的百分比形式的每次点击费用出价金额。
finalUrlSuffix

string

用于将参数附加到最终到达网址的网址模板。
trackingUrlTemplate

string

用于构建跟踪网址的网址模板。
primaryStatus

enum (AdGroupCriterionPrimaryStatus)

仅限输出。广告组条件的主要状态。

联合字段 criterion。广告组条件。

您只能设置一个。criterion 只能是下列其中一项：
keyword

object (KeywordInfo)

不可变。关键字。
placement

object (PlacementInfo)

不可变。展示位置。
mobileAppCategory

object (MobileAppCategoryInfo)

不可变。移动应用类别。
mobileApplication

object (MobileApplicationInfo)

不可变。移动应用。
listingGroup

object (ListingGroupInfo)

不可变。产品信息组。
ageRange

object (AgeRangeInfo)

不可变。年龄段。
gender

object (GenderInfo)

不可变。性别。
incomeRange

object (IncomeRangeInfo)

不可变。收入范围。
parentalStatus

object (ParentalStatusInfo)

不可变。生育情况。
userList

object (UserListInfo)

不可变。用户列表。
youtubeVideo

object (YouTubeVideoInfo)

不可变。YouTube 视频。
youtubeChannel

object (YouTubeChannelInfo)

不可变。YouTube 频道。
topic

object (TopicInfo)

不可变。主题。
userInterest

object (UserInterestInfo)

不可变。用户兴趣。
webpage

object (WebpageInfo)

不可变。网页
appPaymentModel

object (AppPaymentModelInfo)

不可变。应用付费模式。
customAffinity

object (CustomAffinityInfo)

不可变。自定义的兴趣相似受众群体。
customIntent

object (CustomIntentInfo)

不可变。自定义的意向受众群体。
customAudience

object (CustomAudienceInfo)

不可变。自定义受众群体。
combinedAudience

object (CombinedAudienceInfo)

不可变。组合的受众群体。
audience

object (AudienceInfo)

不可变。受众群体。
location

object (LocationInfo)

不可变。位置信息。
language

object (LanguageInfo)

不可变。语言。

AdGroupCriterionStatus

AdGroupCriterion 的可能状态。

枚举
UNSPECIFIED 未指定值。
UNKNOWN

接收的值在此版本中未知。

这是一个仅用于响应的值。
ENABLED 广告组条件已启用。
PAUSED 广告组条件已暂停。
REMOVED 广告组条件会被移除。

QualityInfo

广告组条件质量信息的容器。

JSON 表示法 
{
  "creativeQualityScore": enum (QualityScoreBucket),
  "postClickQualityScore": enum (QualityScoreBucket),
  "searchPredictedCtr": enum (QualityScoreBucket),
  "qualityScore": integer
}
字段
creativeQualityScore

enum (QualityScoreBucket)

仅限输出。与其他广告主相比广告的效果。
postClickQualityScore

enum (QualityScoreBucket)

仅限输出。着陆页的质量得分。
searchPredictedCtr

enum (QualityScoreBucket)

仅限输出。与其他广告主点击率相比的点击率。
qualityScore

integer

仅限输出。质量得分。

如果 Google 没有足够的信息来确定值，则系统可能不会填充该字段。

CriterionSystemServingStatus

枚举标准系统投放状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
ELIGIBLE 符合条件。
RARELY_SERVED 搜索量较低。

AdGroupCriterionApprovalStatus

枚举 AdGroupCriterion 审批状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 此版本中的值未知。
APPROVED 已批准。
DISAPPROVED 已拒登。
PENDING_REVIEW 待审核。
UNDER_REVIEW 审核中。

PositionEstimates

不同排名的定位标准出价估算值。

JSON 表示法 
{
  "firstPageCpcMicros": string,
  "firstPositionCpcMicros": string,
  "topOfPageCpcMicros": string,
  "estimatedAddClicksAtFirstPositionCpc": string,
  "estimatedAddCostAtFirstPositionCpc": string
}
字段
firstPageCpcMicros

string (int64 format)

仅限输出。要让广告显示在搜索结果首页所需的每次点击费用出价的估算值。
firstPositionCpcMicros

string (int64 format)

仅限输出。要让广告显示在搜索结果首页顶部首位所需的每次点击费用出价的估算值。
topOfPageCpcMicros

string (int64 format)

仅限输出。要让广告显示在搜索结果首页顶部所需的每次点击费用出价的估算值。
estimatedAddClicksAtFirstPositionCpc

string (int64 format)

仅限输出。将关键字出价更改为 firstPositionCpcMicros 中的值后，每周可能获得的点击次数估算值。
estimatedAddCostAtFirstPositionCpc

string (int64 format)

仅限输出。将关键字出价更改为 firstPositionCpcMicros 中的值后，每周的费用可能会发生的变化估算值。

AdGroupCriterionPrimaryStatus

描述可能的广告组条件主要状态的枚举。提供有关广告组条件未正常投放或未以最佳方式投放的原因。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ELIGIBLE 广告组条件符合投放条件。
PAUSED 广告组条件已暂停。
REMOVED 广告组条件会被移除。
PENDING 广告组条件为待处理。
NOT_ELIGIBLE 广告组条件不符合投放条件。

AdGroupCriterionPrimaryStatusReason

描述广告组条件主要状态原因的枚举。可深入了解为何广告组条件无法投放或无法以最佳方式投放。我们会将这些原因汇总起来，以确定总体广告组条件主要状态。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
CAMPAIGN_PENDING 用户指定的此广告系列开始投放的时间是将来的时间。有助于 AdGroupCriterionPrimaryStatus.PENDING。
CAMPAIGN_CRITERION_NEGATIVE 广告组条件被广告系列排除条件覆盖。有助于 AdGroupCriterionPrimaryStatus.NOT_ELIGIBLE。
CAMPAIGN_PAUSED 用户指定的广告系列处于“已暂停”状态。有助于 AdGroupCriterionPrimaryStatus.PAUSED。
CAMPAIGN_REMOVED 用户指定的广告系列状态会被移除。有助于 AdGroupCriterionPrimaryStatus.REMOVED。
CAMPAIGN_ENDED 用户指定的此广告系列的结束时间已过。对 AdGroupCriterionPrimaryStatus.ENDED 有贡献。
AD_GROUP_PAUSED 用户指定的广告组处于“已暂停”状态。有助于 AdGroupCriterionPrimaryStatus.PAUSED。
AD_GROUP_REMOVED 用户指定的广告组状态将被移除。有助于 AdGroupCriterionPrimaryStatus.REMOVED。
AD_GROUP_CRITERION_DISAPPROVED 广告组标准未获广告审批系统批准。有助于 AdGroupCriterionPrimaryStatus.NOT_ELIGIBLE。
AD_GROUP_CRITERION_RARELY_SERVED 广告组条件很少投放。有助于 AdGroupCriterionPrimaryStatus.NOT_ELIGIBLE。
AD_GROUP_CRITERION_LOW_QUALITY 广告组定位条件的质量得分较低。对 AdGroupCriterionPrimaryStatus.LIMITED 有贡献。
AD_GROUP_CRITERION_UNDER_REVIEW 广告组条件正在接受审核。有助于 AdGroupCriterionPrimaryStatus.PENDING。
AD_GROUP_CRITERION_PENDING_REVIEW 广告组条件为待审核状态。有助于 AdGroupCriterionPrimaryStatus.NOT_ELIGIBLE。
AD_GROUP_CRITERION_BELOW_FIRST_PAGE_BID 广告组条件的出价低于在首页上投放所需的金额。对 AdGroupCriterionPrimaryStatus.LIMITED 有贡献。
AD_GROUP_CRITERION_NEGATIVE 广告组条件为负数。有助于 AdGroupCriterionPrimaryStatus.NOT_ELIGIBLE。
AD_GROUP_CRITERION_RESTRICTED 广告组条件受限。有助于 AdGroupCriterionPrimaryStatus.NOT_ELIGIBLE。
AD_GROUP_CRITERION_PAUSED 用户指定的广告组条件处于“已暂停”状态。有助于 AdGroupCriterionPrimaryStatus.PAUSED。
AD_GROUP_CRITERION_PAUSED_DUE_TO_LOW_ACTIVITY 该广告组条件已被中止，因为它在投放期间活动量长期较低。有助于 AdGroupCriterionPrimaryStatus.PAUSED。
AD_GROUP_CRITERION_REMOVED 用户指定的广告组条件状态将被移除。有助于 AdGroupCriterionPrimaryStatus.REMOVED。

ListingGroupInfo

产品信息组条件。

JSON 表示法 
{
  "type": enum (ListingGroupType),
  "caseValue": {
    object (ListingDimensionInfo)
  },
  "parentAdGroupCriterion": string,
  "path": {
    object (ListingDimensionPath)
  }
}
字段
type

enum (ListingGroupType)

产品信息组的类型。
caseValue

object (ListingDimensionInfo)

此产品信息组用于优化其父级的维度值。对于根组，未定义。
parentAdGroupCriterion

string

广告组条件（作为父级产品信息组的细分）的资源名称。对于根组，为 null。
path

object (ListingDimensionPath)

用于定义此产品信息组的维度的路径。

ListingGroupType

产品信息组的类型。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
SUBDIVISION 根据某些商品详情维度对商品进行细分。这些节点不会用于定位列表条目，而仅用于定义树的结构。
UNIT 产品信息组的单位，用于定义出价。

ListingDimensionPath

用于定义信息组的维度的路径。

JSON 表示法 
{
  "dimensions": [
    {
      object (ListingDimensionInfo)
    }
  ]
}
字段
dimensions[]

object (ListingDimensionInfo)

信息组层次结构中从根（不包括根本身）到此产品信息组的维度的完整路径。

AppPaymentModelInfo

应用付款模式条件。

JSON 表示法 
{
  "type": enum (AppPaymentModelType)
}
字段
type

enum (AppPaymentModelType)

应用付款模式的类型。

AppPaymentModelType

描述可能的应用付款模式的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
PAID 表示付费应用。

CustomIntentInfo

自定义的意向条件。此类型的条件只能用于定位。

JSON 表示法 
{
  "customIntent": string
}
字段
customIntent

string

CustomInterest 资源名称。