通过

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

  • 项目

定义一个 对象，该对象指定要包含在文本广告中的有关你的业务、产品或服务的其他文本。

可以将应用广告扩展与帐户或帐户中的市场活动及广告组相关联。 必须为每个实体关联 2 到 20 个标注广告扩展， (帐户、市场活动或广告组) 。 如果将一个或多个标注扩展插件与帐户、市场活动或广告组相关联，则不会随广告一起提供标注文本。 一个广告在每个展示中可以包含 2 到 4 个标注。

在广告组级别关联的广告扩展将覆盖在市场活动级别关联的相同类型的广告扩展。 例如，如果为 市场活动 A 设置了 2 个标注扩展，没有与 广告组 AA 关联的标注扩展，以及一个与 Ad Group AB 关联的标注扩展，则只有 广告组 AA 才有资格使用标注修饰其文本广告。

语法

<xs:complexType name="CalloutAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

CalloutAdExtension 对象具有以下元素：Text。

元素 说明 数据类型
发短信 要包含在文本广告中的有关你的企业、产品或服务的其他标注文本。 标注扩展文本必须与广告文本不同。

此字符串的长度必须介于 1 到 25 个字符之间。 请注意，对于繁体中文字符，此字符串的长度必须介于 1 到 12 个字符之间。

加： 必填
更新： 必填		 string

CalloutAdExtension 对象具有 Inherited Elements。

继承的元素

从 AdExtension 继承的元素

CalloutAdExtension 对象派生自 AdExtension 对象，并继承以下元素：DevicePreference、ForwardCompatibilityMap、Id、Schedule、Status、Type、Version。 以下说明特定于 CalloutAdExtension，可能不适用于从 AdExtension 对象继承相同元素的其他对象。

元素 说明 数据类型
DevicePreference 此广告扩展类型不支持。 long
ForwardCompatibilityMap 用于向前兼容性的键和值字符串列表，以避免在当前 API 版本中添加新元素时发生重大更改。

AdExtension 对象当前没有向前兼容性更改。

加： 只读
更新： 只读		 KeyValuePairOfstringstring 数组
ID 广告扩展的唯一Microsoft广告标识符。

加： 只读
更新： 只读和必需		 long
计划 确定广告扩展插件有资格显示在广告中的日历日期和时间范围。

加： 自选
更新： 自选。 如果将此元素设置为 null，则广告扩展的任何现有计划集都将保持不变。 如果将此设置为任何非 null Schedule 对象，则实际上将替换广告扩展的现有计划设置。 若要删除所有计划，请将此元素设置为空 Schedule 对象。		 Schedule
状态 广告扩展的状态。 该值将始终为 “活动” ，因为市场活动管理服务不会返回已删除的广告扩展。

加： 只读
更新： 只读		 AdExtensionStatus
类型 广告扩展的类型。 检索标注广告扩展时，此值为 CalloutAdExtension 。

加： 只读
更新： 只读

有关广告扩展插件类型的详细信息，请参阅 Ad 扩展插件数据对象备注。		 string
版本 跟踪广告扩展已更新的次数。

创建广告扩展时，版本设置为 1，并在每次更新后递增 1 。

加： 不允许
更新： 不允许		 int

要求

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