AppInstallAd 数据对象 - 市场活动管理
定义应用安装广告。
应用安装广告类似于文本广告，但通过按钮提供指向应用的直接链接，将客户直接发送到适用的应用商店下载应用程序。 对于想要管理和推动应用下载（而不是网站流量）的广告客户来说，这是一个理想的解决方案。
应用安装广告会自动检测客户的移动设备和操作系统，并将其发送到相应的 Apple App Store 或 Google Play。 还可以使用与应用扩展相同的转换跟踪合作伙伴跟踪转换：AppsFlyer、Kochava、Tune、Singular、Adjust 和 Branch。
注意
应用安装广告仅在 iOS 和 Android 上在澳大利亚、巴西、加拿大、法国、德国、印度、英国和 美国提供。 目前仅支持 Apple App Store 和 Google Play Store 美国中提供的应用。 不支持 Windows。
还不是每个人都有此功能。 如果你没有，别担心。 它即将推出。
注意
应用安装广告只能在 AdGroupType 设置为“SearchStandard”的搜索市场活动中创建。 如果 AdGroupType 设置为“SearchDynamic”，则广告组不支持应用安装广告。
AppPlatform、AppStoreId、Text 和 Title 元素的组合使应用安装广告是唯一的。
语法
<xs:complexType name="AppInstallAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexContent mixed="false">
<xs:extension base="tns:Ad">
<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="Text" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Title" nillable="true" type="xs:string" />
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
元素
AppInstallAd 对象具有以下元素：AppPlatform、AppStoreId、Text、Title。
AppInstallAd 对象具有 Inherited Elements。
继承的元素
从 Ad 继承的元素
AppInstallAd 对象派生自 Ad 对象，并继承以下元素：AdFormatPreference、DevicePreference、EditorialStatus、FinalAppUrls、FinalMobileUrls、FinalUrls、FinalUrlSuffix、ForwardCompatibilityMap、Id、Status、TrackingUrlTemplate、Type、UrlCustomParameters。 以下说明特定于 AppInstallAd，可能不适用于从 Ad 对象继承相同元素的其他对象。
| 元素 | 说明 | 数据类型 |
|---|---|---|
| AdFormatPreference | 此广告类型不支持。 | string |
| DevicePreference | 此元素确定首选项是在移动设备和平板电脑设备上显示应用安装广告，还是仅在移动设备上显示。 (桌面计算机上当前不支持应用安装广告。) 若要指定仅 (移动设备的首选项，即不包括平板电脑) ，请将此元素设置为 30001。 若要同时指定移动设备和平板电脑设备的首选项，请将此元素设置为 0 (零) 或使元素保持为零。 默认情况下，此元素将为 nil。 加： 自选 更新： 自选 |
long |
| 编辑状态 | 广告的编辑评审状态，指示广告是等待评审、已批准还是已遭拒批。 加： 只读 更新： 只读 |
AdEditorialStatus |
| FinalAppUrls | 不支持应用安装广告。 | AppUrl 数组 |
| FinalMobileUrls | 不支持应用安装广告。 | 字符串 数组 |
| FinalUrls | 搜索用户登录并可以选择安装应用的 URL。 加： 必填 更新： 自选 |
字符串 数组 |
| FinalUrlSuffix | 最终 URL 后缀可以包括跟踪参数，这些参数将追加到登陆页 URL 的末尾。 建议将登陆页面所需的跟踪参数放在最终 URL 后缀中，以便始终将客户发送到登陆页面。 有关更多详细信息和验证规则，请参阅技术指南中的 最终 URL 后缀 。 加： 自选 更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 如果将此元素设置为空字符串 (“ ”) ，则会删除以前的设置。 |
string |
| ForwardCompatibilityMap | 用于向前兼容性的键和值字符串列表，以避免在当前 API 版本中添加新元素时发生重大更改。 目前没有任何 ForwardCompatibilityMap 键和值对适用于此对象。 |
KeyValuePairOfstringstring 数组 |
| ID | 广告的唯一Microsoft广告标识符。 加： 只读 更新： 必需和只读 |
long |
| 状态 | 广告的状态。 可以将广告状态设置为“活动”或“已暂停”。 加： 自选 更新： 自选 |
AdStatus |
| TrackingUrlTemplate | 要用作 FinalUrls 指定 URL 的默认跟踪模板。 以下验证规则适用于跟踪模板。 有关支持的模板和参数的更多详细信息，请参阅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 将相同。加： 自选 更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 如果将此元素设置为空字符串 (“ ”) ，则会删除以前的设置。 |
string |
| 类型 | 广告的类型。 检索应用安装广告时，此值为 AppInstall 。 有关广告类型的详细信息，请参阅 Ad 数据对象备注。 加： 只读 更新： 只读 |
AdType |
| UrlCustomParameters | 用于 URL 跟踪的键和值参数的自定义集合。 Microsoft Advertising 将接受在 CustomParameters 对象中包含的前 8 个 CustomParameter 对象 ，如果包含 8 个以上的自定义参数，则会返回错误。 每个 CustomParameter 都包含 键 和 值 元素。 加： 自选 更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 将 UrlCustomParameters 元素设置为 null 或空，以保留任何现有自定义参数。 若要删除所有自定义参数，请将 CustomParameters 对象的 Parameters 元素设置为 null 或空。 若要删除自定义参数的子集，请指定要保留在 CustomParameters 对象的 Parameters 元素中的自定义参数。 |
CustomParameters |
要求
服务： CampaignManagementService.svc v13
Namespace： https://bingads.microsoft.com/CampaignManagement/v13