BiddableAdGroupCriterion 数据对象 - 市场活动管理

项目
11/13/2024

定义要应用于指定广告组的可出价条件。

语法

XML
JSON

<xs:complexType name="BiddableAdGroupCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdGroupCriterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="CriterionBid" nillable="true" type="tns:CriterionBid" />
        <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AdGroupCriterionEditorialStatus" />
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q82="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q82:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q83="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q83:ArrayOfstring" />
        <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
        <xs:element minOccurs="0" name="CriterionCashback" nillable="true" type="tns:CriterionCashback">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "AdGroupId": "LongValueHere",
  "Criterion": {
    "Type": "AgeCriterion",
    "AgeRange": "ValueHere"
  },
  "Id": "LongValueHere",
  "Status": "ValueHere",
  "Type": "BiddableAdGroupCriterion",
  "CriterionBid": {
    "Type": "BidMultiplier",
    "Multiplier": DoubleValueHere
  },
  "CriterionCashback": {
    "Type": "CashbackAdjustment",
    "CashbackPercent": DoubleValueHere
  },
  "DestinationUrl": "ValueHere",
  "EditorialStatus": "ValueHere",
  "FinalAppUrls": [
    {
      "OsType": "ValueHere",
      "Url": "ValueHere"
    }
  ],
  "FinalMobileUrls": [
    "ValueHere"
  ],
  "FinalUrls": [
    "ValueHere"
  ],
  "FinalUrlSuffix": "ValueHere",
  "TrackingUrlTemplate": "ValueHere",
  "UrlCustomParameters": {
    "Parameters": [
      {
        "Key": "ValueHere",
        "Value": "ValueHere"
      }
    ]
  }
}

元素

BiddableAdGroupCriterion 对象具有以下元素：CriterionBid、CriterionCashback、DestinationUrl、EditorialStatus、FinalAppUrls、FinalMobileUrls、FinalUrls、FinalUrlSuffix、TrackingUrlTemplate、UrlCustomParameters。

元素	说明	数据类型
CriterionBid	要用于拍卖的出价。如果继承的条件是网页条件，则必须使用 FixedBid。如果继承的 Criterion 是 ProductPartition，则必须使用 FixedBid ，除非“赞助产品 BidOption ”设置为 BidBoost (有关详细信息，请参阅下面的 productPartition Usage) 。对于所有其他可出价广告组条件，请使用 BidMultiplier。如果不使用正确的对象类型，则请求的出价将被忽略：如果需要出价，操作将失败;如果出价是可选的，将使用默认出价。加：要求因继承的条件类型而异。出价是可选的，如果未包括 AgeCriterion、DayTimeCriterion、DeviceCriterion、GenderCriterion、LocationCriterion、ProfileCriterion、RadiusCriterion、AudienceCriterion 和网页条件，则出价将设置为默认值 0。该出价不适用于 LocationIntentCriterion (该服务不会返回任何错误，并且即使将其包含在) ，也会忽略该出价。使用 ApplyProductPartitionActions 操作添加 ProductPartition 时，需要出价，除非产品分区类型为 Subdivision，在这种情况下，不允许出价。更新：要求因继承的条件类型而异。 AgeCriterion、DayTimeCriterion、DeviceCriterion、GenderCriterion、LocationCriterion、ProfileCriterion 和 RadiusCriterion 需要出价。该出价不适用于 LocationIntentCriterion (该服务不会返回任何错误，并且即使将其包含在) ，也会忽略该出价。对于 AudienceCriterion 和网页条件，出价是可选的，如果没有为更新设置值，则不会更改此设置。使用 ApplyProductPartitionActions 操作更新 ProductPartition 时，出价是可选的，如果没有为更新设置值，则不会更改此设置。	CriterionBid
CriterionCashback	定义 CriterionCashback 数据对象。	CriterionCashback
DestinationUrl	用户在单击广告时将访问的网页的 URL。仅当继承的 Criterion 是 ProductPartition 条件时，才使用此元素。有关详细信息，请参阅下面的 ProductPartition 使用情况。	string
编辑状态	供将来使用。	AdGroupCriterionEditorialStatus
FinalAppUrls	供将来使用。	AppUrl 数组
FinalMobileUrls	供将来使用。	字符串数组
FinalUrls	供将来使用。	字符串数组
FinalUrlSuffix	最终 URL 后缀可以包括跟踪参数，这些参数将追加到登陆页 URL 的末尾。建议将登陆页面所需的跟踪参数放在最终 URL 后缀中，以便始终将客户发送到登陆页面。有关更多详细信息和验证规则，请参阅技术指南中的最终 URL 后缀。仅当继承的 Criterion 是 ProductPartition 或网页条件时，才使用此元素。有关详细信息，请参阅下面的 ProductPartition 使用情况和网页使用情况。	string
TrackingUrlTemplate	可以在跟踪模板中指定与最终 URL 或登陆页一起使用的 URL 跟踪参数。建议在帐户级别添加跟踪模板，然后将其应用于市场活动、广告组和广告等较低级别实体的所有 URL。若要了解详细信息，请参阅Microsoft广告帮助文章使用升级的 URL 跟踪。仅当继承的 Criterion 是 ProductPartition 或网页条件时，才使用此元素。有关详细信息，请参阅下面的 ProductPartition 使用情况和网页使用情况。	string
UrlCustomParameters	用于 URL 跟踪的键和值参数的自定义集合。仅当继承的 Criterion 是 ProductPartition 或网页条件时，才使用此元素。有关详细信息，请参阅下面的 ProductPartition 使用情况和网页使用情况。	CustomParameters

BiddableAdGroupCriterion 对象具有 Inherited Elements。

继承的元素

从 AdGroupCriterion 继承的元素

BiddableAdGroupCriterion 对象派生自 AdGroupCriterion 对象，并继承以下元素：AdGroupId、Criterion、Id、Status、Type。以下说明特定于 BiddableAdGroupCriterion，可能不适用于从 AdGroupCriterion 对象继承相同元素的其他对象。

元素	说明	数据类型
AdGroupId	要对其应用条件的广告组的标识符。加：必填更新：必填	long
条件	要应用于广告组的条件。该条件有助于确定是否提供广告组中的广告。有关可用条件类型的列表，请参阅 AdGroupCriterionType。加：自选更新：自选。如果未为更新设置任何值，则不会更改此设置。	条件
ID	广告组条件的唯一Microsoft广告标识符。加：只读更新：必填	long
状态	一个状态值，该值确定条件是否适用于广告组。对于大多数可出价广告组条件，唯一支持的状态值为 “活动”。有关例外情况，请参阅下面的网页使用情况。加：只读更新：只读	AdGroupCriterionStatus
类型	广告组条件的类型。检索可出价广告组条件时，此值为 BiddableAdGroupCriterion 。有关广告组条件类型的详细信息，请参阅 AdGroupCriterion 数据对象备注。加：只读更新：只读	string

备注

ProductPartition 使用情况

如果继承的 Criterion 是 ProductPartition 条件，请注意以下 BiddableAdGroupCriterion 属性的用法。

CriterionBid

默认情况下，拍卖将对产品组使用 FixedBid 。除非“赞助产品 BidOption”设置为 BidBoost，否则必须使用 FixedBid。如果“赞助产品 BidOption ”设置为 BidBoost，则 BidMultiplier 表示 (大于零) 用于放大合作伙伴出价的百分比。

例如，假设合作伙伴通过 CriterionBid) 在 FixedBid 的产品组中出价 5 美元 (美元。如果通过 CriterionBid) 将出价调整 (BidMultiplier 设置为 20 (%) 并且广告组的 BidMaxValue) 为 0.50 (50 美分，则你的份额将为 50 美分，而不是 1 美元。

DestinationUrl

如果当前使用的是目标 URL，则最终必须将它们替换为跟踪模板。有关详细信息，请参阅使用已升级 URL 进行 URL 跟踪。

URL 可以包含动态参数，例如 {MatchType}。有关支持的参数列表，请参阅Microsoft广告帮助文章我可以使用哪些跟踪或 URL 参数？。

URL 最多可以包含 1,024 个字符。如果 URL 未指定协议，则当用户单击广告时，系统会使用 HTTP 协议。如果在添加广告时 URL 指定了 HTTP 协议，则服务将删除 http:// 协议字符串， (HTTP 协议字符串不计入 1,024 个字符限制) ;但是，该服务不会从 URL 中删除 HTTPS 协议字符串 (https：//) 。

如果指定，则使用目标 URL;否则，目标 URL 由你在 Microsoft 商家中心目录中为产品/服务指定的“链接”的相应值确定。

加：自选
更新： 自选。如果未为更新设置任何值，则不会更改此设置。如果将此元素设置为空字符串 (“ ”) ，则会删除以前的设置。

FinalUrlSuffix

最终 URL 后缀可以包括跟踪参数，这些参数将追加到登陆页 URL 的末尾。建议将登陆页面所需的跟踪参数放在最终 URL 后缀中，以便始终将客户发送到登陆页面。有关更多详细信息和验证规则，请参阅技术指南中的最终 URL 后缀。

加：自选
更新： 自选。如果未为更新设置任何值，则不会更改此设置。如果将此元素设置为空字符串 (“ ”) ，则会删除以前的设置。

TrackingUrlTemplate

跟踪模板可与通过内容 API 提交的产品/服务的“链接”字段中指定的 URL 结合使用。通过将源 URL 与跟踪模板组合在一起，登陆页 URL 在单击广告后将用户定向到该位置进行组合。使用 TrackingUrlTemplate 元素更新 URL 参数而不是更新源 URL 中的参数时，源 URL 无需经过编辑评审，并且广告将继续不间断地提供。例如，如果目录源中的产品/服务 URL 为 https://contoso.com/，则可以指定以下跟踪模板： {lpurl}？matchtype={matchtype}&device={device}。

以下验证规则适用于跟踪模板。有关支持的模板和参数的更多详细信息，请参阅Microsoft广告帮助文章可以使用哪些跟踪或 URL 参数？

为较低级别的实体（例如广告）定义的跟踪模板将覆盖为较高级别的实体（例如市场活动）设置的模板。有关详细信息，请参阅实体限制。
跟踪模板的长度限制为 2,048 个字符。 HTTP 或 HTTPS 协议字符串计入 2,048 个字符限制。
跟踪模板必须是格式正确的 URL，从以下项之一开始： http://、 https://、 {lpurl}或 {unescapedlpurl}。
Microsoft广告不验证自定义参数是否存在。如果在跟踪模板中使用自定义参数，并且这些参数不存在，则登陆页 URL 将包含自定义参数的键和值占位符，而不进行替换。例如，如果跟踪模板为 https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}，并且未在市场活动、广告组、条件、关键字 (keyword) 或广告级别定义 {_season} 或 {_promocode}，则登陆页 URL 将相同。

加：自选
更新： 自选。如果未为更新设置任何值，则不会更改此设置。如果将此元素设置为空字符串 (“ ”) ，则会删除以前的设置。

UrlCustomParameters

用于 URL 跟踪的键和值参数的自定义集合。

Microsoft Advertising 将接受在 CustomParameters 对象中包含的前 8 个 CustomParameter 对象，如果包含 8 个以上的自定义参数，则会返回错误。每个 CustomParameter 都包含键和值元素。

加：自选
更新： 自选。如果未为更新设置任何值，则不会更改此设置。将 UrlCustomParameters 元素设置为 null 或空，以保留任何现有自定义参数。若要删除所有自定义参数，请将 CustomParameters 对象的 Parameters 元素设置为 null 或空。若要删除自定义参数的子集，请指定要保留在 CustomParameters 对象的 Parameters 元素中的自定义参数。

网页使用情况

如果继承的 Criterion 是网页条件，请注意 BiddableAdGroupCriterion 属性的以下用法。

FinalUrlSuffix

加：自选
更新： 自选。如果未为更新设置任何值，则不会更改此设置。如果将此元素设置为空字符串 (“ ”) ，则会删除以前的设置。

状态

一个状态值，该值确定条件是否适用于广告组。

可以将状态设置为 “活动” 或 “已暂停”。不能将状态设置为 “已删除”。

加：自选。
更新： 自选。如果未为更新设置任何值，则不会更改此设置。

TrackingUrlTemplate

对于网页条件，跟踪模板可与从为动态搜索广告市场指定的域动态生成的登陆页面 URL 结合使用。通过将域与跟踪模板组合在一起，登陆页 URL 在单击广告后将用户定向到该位置进行组合。下面是一个示例跟踪模板： {lpurl}？matchtype={matchtype}&device={device}。

以下验证规则适用于跟踪模板。有关支持的模板和参数的更多详细信息，请参阅Microsoft广告帮助文章可以使用哪些跟踪或 URL 参数？

为较低级别的实体（例如广告）定义的跟踪模板将覆盖为较高级别的实体（例如市场活动）设置的模板。有关详细信息，请参阅实体限制。
跟踪模板的长度限制为 2,048 个字符。 HTTP 或 HTTPS 协议字符串计入 2,048 个字符限制。
跟踪模板必须是格式正确的 URL，从以下项之一开始： http://、 https://、 {lpurl}或 {unescapedlpurl}。
Microsoft广告不验证自定义参数是否存在。如果在跟踪模板中使用自定义参数，并且这些参数不存在，则登陆页 URL 将包含自定义参数的键和值占位符，而不进行替换。例如，如果跟踪模板为 https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}，并且未在市场活动、广告组、条件、关键字 (keyword) 或广告级别定义 {_season} 或 {_promocode}，则登陆页 URL 将相同。

加：自选
更新： 自选。如果未为更新设置任何值，则不会更改此设置。如果将此元素设置为空字符串 (“ ”) ，则会删除以前的设置。

UrlCustomParameters

用于 URL 跟踪的键和值参数的自定义集合。

要求

服务： CampaignManagementService.svc v13
Namespace： https://bingads.microsoft.com/CampaignManagement/v13

通过

BiddableAdGroupCriterion 数据对象 - 市场活动管理

语法

元素

继承的元素

从 AdGroupCriterion 继承的元素

备注

ProductPartition 使用情况

CriterionBid

DestinationUrl

FinalUrlSuffix

TrackingUrlTemplate

UrlCustomParameters

网页使用情况

FinalUrlSuffix

状态

TrackingUrlTemplate

UrlCustomParameters

要求

反馈

其他资源