AppAdExtension 数据对象 - 市场活动管理
定义可包含在广告中的应用广告扩展。
可以将应用广告扩展与帐户或帐户中的市场活动及广告组相关联。 每个实体 (帐户、市场活动或广告组) 可以与你决定的任意数量的应用广告扩展相关联，最多与帐户中应用广告扩展的总数相关联。
语法
<xs:complexType name="AppAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexContent mixed="false">
<xs:extension base="tns:AdExtension">
<xs:sequence>
<xs:element minOccurs="0" name="AppPlatform" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="AppStoreId" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="DisplayText" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
<xs:element xmlns:q48="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q48:ArrayOfstring" />
<xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
<xs:element xmlns:q49="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q49:ArrayOfstring" />
<xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
元素
AppAdExtension 对象具有以下元素：AppPlatform、AppStoreId、DestinationUrl、DisplayText、FinalAppUrls、FinalMobileUrls、FinalUrls、FinalUrlSuffix、TrackingUrlTemplate、UrlCustomParameters。
| 元素 | 说明 | 数据类型 |
|---|---|---|
| AppPlatform | 应用程序平台。 可能的值包括 iOS、Android 和 Windows。 加： 必填 更新： 必填 |
string |
| AppStoreId | 应用商店提供的应用程序标识符。 如果应用程序是新的，请等待 4-7 天，广告才有资格投放。 加： 必填 更新： 必填 |
string |
| DestinationUrl | 用户在单击应用扩展链接时将访问的应用商店下载网页的 URL。 URL 可以包含动态文本字符串，例如 {关键字 (keyword) }。 有关支持的参数列表，请参阅Microsoft广告帮助文章 可以使用哪些跟踪或 URL 参数？中的可用参数部分。 URL 最多可以包含 1,024 个字符。 如果 URL 未指定协议，则当用户单击广告时，系统会使用 HTTP 协议。 如果在添加广告时 URL 指定了 HTTP 协议，则服务将删除 http:// 协议字符串， (HTTP 协议字符串不计入 1,024 个字符限制) ;但是，该服务不会从 URL 中删除 HTTPS 协议字符串 (https：//) 。 加： 必填 更新： 自选 |
string |
| DisplayText | 应用广告扩展中显示的文本。 文本最多可以包含 35 个字符。 加： 必填 更新： 自选 |
string |
| FinalAppUrls | 供将来使用。 | AppUrl 数组 |
| FinalMobileUrls | 保留供以后使用。 | 字符串 数组 |
| FinalUrls | 保留供以后使用。 | 字符串 数组 |
| FinalUrlSuffix | 保留供以后使用。 | string |
| TrackingUrlTemplate | 保留供以后使用。 | string |
| UrlCustomParameters | 保留供以后使用。 | CustomParameters |
AppAdExtension 对象具有 Inherited Elements。
继承的元素
从 AdExtension 继承的元素
AppAdExtension 对象派生自 AdExtension 对象，并继承以下元素：DevicePreference、ForwardCompatibilityMap、Id、Schedule、Status、Type、Version。 以下说明特定于 AppAdExtension，可能不适用于从 AdExtension 对象继承相同元素的其他对象。
| 元素 | 说明 | 数据类型 |
|---|---|---|
| DevicePreference | 此元素确定首选项是在移动设备还是所有设备上显示广告扩展。 若要指定移动设备的首选项，请将此元素设置为 30001。 若要指定所有设备，请将此元素设置为 0 (零) 或将元素保留为 nil。 默认情况下，此元素将为 nil。 加： 自选 更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 |
long |
| ForwardCompatibilityMap | 用于向前兼容性的键和值字符串列表，以避免在当前 API 版本中添加新元素时发生重大更改。 AdExtension 对象当前没有向前兼容性更改。 加： 只读 更新： 只读 |
KeyValuePairOfstringstring 数组 |
| ID | 广告扩展的唯一Microsoft广告标识符。 加： 只读 更新： 只读和必需 |
long |
| 计划 | 确定广告扩展插件有资格显示在广告中的日历日期和时间范围。 加： 自选 更新： 自选。 如果将此元素设置为 null，则广告扩展的任何现有计划集都将保持不变。 如果将此设置为任何非 null Schedule 对象，则实际上将替换广告扩展的现有计划设置。 若要删除所有计划，请将此元素设置为空 Schedule 对象。 |
Schedule |
| 状态 | 广告扩展的状态。 该值将始终为 “活动” ，因为市场活动管理服务不会返回已删除的广告扩展。 加： 只读 更新： 只读 |
AdExtensionStatus |
| 类型 | 广告扩展的类型。 检索应用广告扩展时，此值为 AppAdExtension 。 加： 只读 更新： 只读 有关广告扩展插件类型的详细信息，请参阅 Ad 扩展插件数据对象备注。 |
string |
| 版本 | 跟踪广告扩展已更新的次数。 创建广告扩展时，版本设置为 1，并在每次更新后递增 1 。 加： 不允许 更新： 不允许 |
int |
要求
服务： CampaignManagementService.svc v13
Namespace： https://bingads.microsoft.com/CampaignManagement/v13