通过

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

  • 项目

定义广告扩展的基对象。

不要尝试实例化 AdExtension。 可以创建派生自它的一个或多个以下对象。

语法

<xs:complexType name="AdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="DevicePreference" nillable="true" type="xs:long" />
    <xs:element xmlns:q43="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q43:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Scheduling" nillable="true" type="tns:Schedule" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AdExtensionStatus" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Version" nillable="true" type="xs:int" />
  </xs:sequence>
</xs:complexType>

元素

AdExtension 对象具有以下元素：DevicePreference、ForwardCompatibilityMap、Id、Schedule、Status、Type、Version。

元素 说明 数据类型
DevicePreference 此元素确定首选项是在移动设备还是所有设备上显示广告扩展。

若要指定移动设备的首选项，请将此元素设置为 30001。

若要指定所有设备，请将此元素设置为 0 (零) 或将元素保留为 nil。 默认情况下，此元素将为 nil。

此元素仅适用于 AppAdExtension 和 SitelinkAdExtension 类型。		 long
ForwardCompatibilityMap 用于向前兼容性的键和值字符串列表，以避免在当前 API 版本中添加新元素时发生重大更改。

将来的版本中将在此处记录向前兼容性更改。 此对象当前没有向前兼容性更改。		 KeyValuePairOfstringstring 数组
Id 广告扩展的唯一 Microsoft Advertising 标识符。 long
计划 确定广告扩展插件有资格显示在广告中的日历日期和时间范围。 Schedule
状态 广告扩展的状态。 该值将始终为 “活动” ，因为市场活动管理服务不会返回已删除的广告扩展。 AdExtensionStatus
类型 广告扩展的类型。

有关详细信息，请参阅备注。		 string
版本 跟踪广告扩展已更新的次数。

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

备注

如果手动生成 SOAP，请使用节点的 <AdExtension>type 属性，如以下示例中所示，指定广告扩展的类型。

<AdExtension i:type="ReviewAdExtension" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <Id i:nil="true" />
    <Status i:nil="true" />
      . . .
</AdExtension>

要求

服务： CampaignManagementService.svc v13
命名 空间： https://bingads.microsoft.com/CampaignManagement/v13

使用者

AddAdExtensions
AdExtensionAssociation
GetAdExtensionsByIds
UpdateAdExtensions