共用方式為

FlyerAdExtension 數據物件 - 營銷活動管理

  • 發行項

飛出視窗延伸模組可讓廣告商將產品或商店目錄散發 () 給潛在客戶。

他們可以在廣泛查詢上明顯顯示，例如「每週交易」或「每周銷售」，因此鼓勵顧客按兩下您的廣告，而不是競賽。 根據其本質，它們有助於更妥善地通知搜尋人員，因此增加用戶參與度，例如按下速率。

注意事項

在功能試驗 (GetCustomerPilotFeatures 會傳回 802) ，讓客戶可以使用飛出視窗擴充功能。

語法

<xs:complexType name="FlyerAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Description" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q62="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q62:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q63="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q63:ArrayOfstring" />
        <xs:element minOccurs="0" name="FlyerName" nillable="true" type="xs:string" />
        <xs:element xmlns:q64="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ImageMediaIds" nillable="true" type="q64:ArrayOflong" />
        <xs:element xmlns:q65="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ImageMediaUrls" nillable="true" type="q65:ArrayOfstring" />
        <xs:element minOccurs="0" name="StoreId" nillable="true" type="xs:long" />
        <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>

元素

FlyerAdExtension 物件具有下列元素：Description、FinalAppUrls、FinalMobileUrls、FinalUrls、FinalUrlSuffix、FlyerName、ImageMediaIds、ImageMediaUrls、StoreId、TrackingUrlTemplate、UrlCustomParameters。

元素 描述 資料類型
描述 廣告商、機構或帳戶管理員可用來追蹤、標記或管理飛出視窗延伸模組的描述。

此描述不會與廣告或影像一起顯示。

這個專案的最大長度為 1,024 個字元。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 string
FinalAppUrls 保留供日後使用。 AppUrl 陣 列
FinalMobileUrls 行動裝置的登陸頁面 URL。

下列驗證規則適用於最終 URL 和最終行動 URL。
- URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。
- 您最多可以為 FinalUrls 和FinalMobileUrls 指定最多 10 個列表專案;不過，只有每個清單中的第一個專案會用於傳遞。 此服務最多可允許 10 個列表專案，以獲得潛在的正向相容性。
- 只允許使用 '{' 和 '}' 來描述標籤，例如 {lpurl}。
- 最終 URL 必須是以 http:// 或 https:// 開頭且格式正確的 URL。
- 如果您指定 FinalMobileUrls，則也必須指定 FinalUrls。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空白清單，則會刪除先前的設定。		 字串陣列
FinalUrls 登陸頁面 URL。

下列驗證規則適用於最終 URL 和最終行動 URL。
- URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。
- 您最多可以為 FinalUrls 和FinalMobileUrls 指定最多 10 個列表專案;不過，只有每個清單中的第一個專案會用於傳遞。 此服務最多可允許 10 個列表專案，以獲得潛在的正向相容性。
- 只允許使用 '{' 和 '}' 來描述標籤，例如 {lpurl}。
- 最終 URL 必須是以 http:// 或 https:// 開頭且格式正確的 URL。
- 如果您指定 FinalMobileUrls，則也必須指定 FinalUrls。

加： 必填
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 字串陣列
FinalUrlSuffix 最終的 URL 後綴可以包含將附加至登陸頁面 URL 結尾的追蹤參數。 建議您在最後的 URL 後綴中放置登陸頁面所需的追蹤參數，讓您的客戶一律傳送至您的登陸頁面。 如需詳細資訊和驗證規則，請參閱技術指南中的 最終 URL 後綴 。

這項功能僅適用於最終 URL 後綴階段 3 試驗中的客戶 (GetCustomerPilotFeatures 會傳回 636) 。 如果您不在試驗中，則會忽略此屬性，而且不會傳回任何錯誤。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 string
FlyerName 飛出視窗名稱。

這個專案的最大長度為 150 個字元。

加： 必填
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 string
ImageMediaIds 要包含在廣告中的影像標識碼。

您只能設定一個媒體識別碼。 數據類型是long值的清單，以防稍後新增多個影像的支援。

每個媒體標識碼都會對應至 「GenericImage」 媒體子類型的影像。

您可以藉由呼叫 AddMedia 作業，在將每個映像新增至映像庫時取得每個映像的標識碼。 否則，將媒體新增至您的映像庫之後，您可以使用 GetMediaMetaDataByAccountId 作業來取得媒體識別碼。 影像的寬度和高度下限應為 220px，檔案大小上限為 3.9 MB。

加： 必填
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 long 陣列
ImageMediaUrls 您已新增的媒體 URL。

加： 唯讀
更新： 唯讀		 字串陣列
StoreId 產品廣告所用Microsoft商家中心商店的唯一標識符。

加： 自選
更新： 唯讀。 您無法在設定後更新存放區識別碼。		 長
TrackingUrlTemplate 要作為所有 FinalUrls 和FinalMobileUrls 預設值的追蹤範本。

下列驗證規則適用於追蹤範本。 如需支援的範本和參數的詳細資訊，請參閱 Microsoft Advertising 說明文章 我可以使用哪些追蹤或 URL 參數？
- 針對較低層級實體定義的追蹤範本，例如廣告會覆寫針對較高層級實體設定的範本，例如營銷活動。 如需詳細資訊，請參閱 實體限制。
- 追蹤範本的長度限製為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。
- 追蹤範本必須是格式正確的 URL，開頭為下列其中一項： http://、 https://、 {lpurl} 或 {unescapedlpurl}。
- Microsoft Advertising 不會驗證自定義參數是否存在。 如果您在追蹤範本中使用自定義參數，但它們不存在，則登陸頁面 URL 會包含自定義參數的索引鍵和值佔位元，而不需替代。 例如，如果您的追蹤範本是 https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} ，且 { _season} 或 {_promocode} 都未定義於行銷活動、廣告群組、準則、關鍵詞或廣告層級，則登陸頁面 URL 會相同。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。		 string
UrlCustomParameters 用於 URL 追蹤的自訂索引鍵和值參數集合。

Microsoft Advertising 會接受您包含在 CustomParameters 物件內的前 3 個 CustomParameter 物件，並忽略任何其他自定義參數。 每個 CustomParameter 都包含 Key 和 Value 元素。 針對自定義參數限制增加階段 3 試驗的客戶 (GetCustomerPilotFeatures 會傳回 635) ，Microsoft Advertising 會接受您包含的前 8 個自定義參數索引鍵和值組，如果您包含超過 8 個自定義參數，則會傳回錯誤。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 將 UrlCustomParameters 元素設定為 null 或空白，以保留任何現有的自定義參數。 若要移除所有自定義參數，請將 CustomParameters 物件的 Parameters 元素設定為 null 或空白。 若要移除自定義參數的子集，請在 CustomParameters 物件的 Parameters 元素中指定您想要保留的自定義參數。		 CustomParameters

FlyerAdExtension 物件具有 Inherited Elements。

繼承的專案

從 AdExtension 繼承的專案

FlyerAdExtension 物件衍生自 AdExtension 物件，並繼承下列元素：DevicePreference、ForwardCompatibilityMap、Id、Scheduling、Status、Type、Version。 下列描述專屬於 FlyerAdExtension，而且可能不適用於從 AdExtension 物件繼承相同元素的其他物件。

元素 描述 資料類型
DevicePreference 不支援此廣告延伸模組類型。 長
ForwardCompatibilityMap 用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。

AdExtension 物件目前沒有向前相容性變更。

加： 唯讀
更新： 唯讀		 KeyValuePairOfstringstring 陣 列
標識碼 廣告擴充功能的唯Microsoft廣告標識碼。

加： 唯讀
更新： 唯讀和必要		 長
排程 決定廣告延伸模組符合廣告顯示資格的行事曆日期和時間範圍。 EndDate 必須在 StartDate 的 30 天內。

加： 飛人廣告擴充功能需要排程 StartDate 和 EndDate 。
更新： 自選。 如果您將此元素設定為 null，廣告延伸模組的任何現有排程集將保持不變。 如果您將此設定為任何非 Null Schedule 物件，則實際上是取代廣告延伸模組的現有排程設定。 您無法將此元素設定為空的 Schedule 對象，因為這樣會有效地嘗試刪除所有排程。 這會導致錯誤，因為飛人廣告延伸模組需要 StartDate 和 EndDate 。		 Schedule
地位 廣告延伸模組的狀態。 此值一律為 [作用 中]，因為營銷活動管理服務不會傳回已刪除的廣告延伸模組。

加： 唯讀
更新： 唯讀		 AdExtensionStatus
類型 廣告延伸模組的類型。 當您擷取飛線廣告擴充功能時，此值為 FlyerAdExtension 。

加： 唯讀
更新： 唯讀

如需廣告延伸模組類型的詳細資訊，請參閱 廣告延伸模組數據物件備註。		 string
版本 追蹤廣告延伸模組更新的次數。

建立廣告延伸模組時，版本會設定為 1 ，並在每次更新之後遞增一。

加： 不允許
更新： 不允許		 int

需求

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