通过

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

  • 项目

定义一个对象，该对象将一个标头与 3 到 10 个代码段值配对，以告知客户有关业务的更多信息。

在以下示例中， Courses 是标头， .NET、 Java、 Python 和 PHP 是单个值的示例。

课程：.NET、Java、Python、PHP

可以将结构化代码片段广告扩展与帐户或帐户中的市场活动及广告组相关联。 (帐户、市场活动或广告组) 的每个实体最多可与 20 个结构化代码片段广告扩展相关联。 展开的文本广告将仅包含一个结构化代码片段 (一个标题，每个展示) 3 - 10 个值。

语法

<xs:complexType name="StructuredSnippetAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Header" nillable="true" type="xs:string" />
        <xs:element xmlns:q54="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Values" nillable="true" type="q54:ArrayOfstring" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

StructuredSnippetAdExtension 对象具有以下元素：Header、Values。

元素 说明 数据类型
标头 附加冒号的标头 (：) ，并在代码片段值之前。

结构化代码段标头必须用你希望显示的同一语言指定。 例如，如果想要英文标头 “设施 ”，则必须将标头指定为 “设施”。 如果要使用德语标头 Ausstattung ，则必须在德语) 中将标头指定为 Ausstattung (Amenities 。 有关每种语言支持的标头列表，请参阅 Ad 扩展标头语言。

加： 必填
更新： 必填		 string
值 在显示的广告的 Header 组件之后的代码片段值。

选择的每个文本值的最大长度可以为 25 个字符。 请注意，对于繁体中文字符，每个值的最大长度可以为 12 个字符。

加： 必填
更新： 必填		 字符串 数组

StructuredSnippetAdExtension 对象具有 Inherited Elements。

继承的元素

从 AdExtension 继承的元素

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

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

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

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

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

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

加： 只读
更新： 只读		 AdExtensionStatus
类型 广告扩展的类型。 检索结构化代码段广告扩展时，此值为 StructuredSnippetAdExtension 。

加： 只读
更新： 只读

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

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

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

要求

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