AdGroupCriterion

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

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)
    }
  ],
  "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,

  // 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 中的自定义参数标记的映射列表。
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)

每千次展示费用出价。
cpvBidMicros

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

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

string

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

联合字段 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

CocoaPods 的可能状态。

枚举
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

枚举 CocoaPods 审批状态。

枚举
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 中的值后，每周费用可能发生的变化估算值。

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 资源名称。