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:q47="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q47:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q48="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q48: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 Advertising 說明文章中的可用參數一節 ：我可以使用哪些追蹤或 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、Scheduling、Status、Type、Version。 下列描述專屬於 AppAdExtension，而且可能不適用於從 AdExtension 物件繼承相同元素的其他物件。

元素	說明	資料類型
DevicePreference	此元素會決定廣告延伸模組的喜好設定是否要顯示在行動裝置或所有裝置上。 若要指定行動裝置的喜好設定，請將此元素設定為 30001。 若要指定所有裝置，請將此元素設定為 0 (零) 或保留元素 nil。 根據預設，此元素會是 nil。 添加： 選 更新： 選。 如果未設定更新的值，則此設定不會變更。	長
ForwardCompatibilityMap	用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。 AdExtension 物件目前沒有向前相容性變更。 添加： 唯讀 更新： 唯讀	KeyValuePairOfstringstring 陣 列
識別碼	廣告延伸模組的唯一 Microsoft Advertising 識別碼。 添加： 唯讀 更新： 唯讀和必要	長
排程	決定廣告延伸模組符合廣告顯示資格的行事曆日期和時間範圍。 添加： 選 更新： 選。 如果您將此元素設定為 null，廣告延伸模組的任何現有排程集將保持不變。 如果您將此設定為任何非 Null Schedule 物件，則實際上是取代廣告延伸模組的現有排程設定。 若要移除所有排程，請將此項目設定為空的 Schedule 物件。	Schedule
狀態	廣告延伸模組的狀態。 此值一律為 [作用 中]，因為營銷活動管理服務不會傳回已刪除的廣告延伸模組。 添加： 唯讀 更新： 唯讀	AdExtensionStatus
類型	廣告延伸模組的類型。 當您擷取應用程式廣告延伸模組時，此值為 AppAdExtension 。 添加： 唯讀 更新： 唯讀 如需廣告延伸模組類型的詳細資訊，請參閱 廣告延伸模組數據物件備註。	string
版本	追蹤廣告延伸模組更新的次數。 建立廣告延伸模組時，版本會設定為 1 ，並在每次更新之後遞增一。 添加： 不允許 更新： 不允許	int

需求

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