ResponsiveAd 資料物件 - 營銷活動管理

物件廣告和多媒體廣告的回應式廣告格式。

ResponsiveAd 物件同時用於搜尋網路中的 多媒體廣告 ，以及Microsoft對象網路中的物件 廣告 。 See the remarks section below for details about the key differentiators.

注意事項

相同廣告群組中允許重複的回應式廣告。

語法

<xs:complexType name="ResponsiveAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="AdSubType" nillable="true" type="tns:AdSubType">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="BusinessName" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="CallToAction" nillable="true" type="tns:CallToAction" />
        <xs:element minOccurs="0" name="CallToActionLanguage" nillable="true" type="tns:LanguageName" />
        <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Headline" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element xmlns:q4="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ImpressionTrackingUrls" nillable="true" type="q4:ArrayOfstring">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="LongHeadline" nillable="true" type="tns:AssetLink" />
        <xs:element minOccurs="0" name="LongHeadlineString" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="LongHeadlines" nillable="true" type="tns:ArrayOfAssetLink">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="VerifiedTrackingSettings" nillable="true" type="tns:VerifiedTrackingSetting">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="Videos" nillable="true" type="tns:ArrayOfAssetLink">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

ResponsiveAd 物件具有下列元素：AdSubType、BusinessName、CallToAction、CallToActionLanguage、Descriptions、標題、標題、影像、ImpressionTrackingUrls、LongHeadline、LongHeadlines、LongHeadlineString、Text、VerifiedTrackingSettings、Videos。

元素	描述	資料類型
AdSubType	可能的廣告子類型。	AdSubType
BusinessName	企業名稱。 您的公司名稱可能會出現在您的廣告中，視廣告位置而定。 字串的長度限制為 25 個字元。 加： 必填 更新： 自選。 如果未設定更新的值，則此設定不會變更。	string
CallToAction	讓客戶立即按下您廣告的簡短、吋笛原因。 這會顯示在您對動作的呼叫按鈕上。 加： 不適用於物件廣告;多媒體廣告的必要專案 更新： 自選。 如果未設定更新的值，則此設定不會變更。	CallToAction
CallToActionLanguage	將用來提供動作呼叫的語言。 不論營銷活動的語言設定為何，動作的呼叫一律會以這種語言提供。 加： 不適用於物件廣告;多媒體廣告的必要專案 更新： 自選。 如果未設定更新的值，則此設定不會變更。	LanguageName
描述	廣告路徑下方顯示的描述。 為了將所有廣告格式的曝光數最大化，描述不一定會顯示在您的廣告中。 為了將所有廣告格式的曝光率最大化，描述不一定會顯示在您的廣告中。 除非您將其中一個描述 釘選 到特定位置，否則 Bing 會以使用者搜尋查詢的最佳標題和描述動態優化廣告版面配置。 從數據模型的觀點來看，還原鏈接和標題會分別儲存為文字資產，也就是每個 AssetLink 一個 TextAsset。 多個廣告可以使用相同的資產。 例如，如果「無縫整合」是文字資產，則其在相同廣告帳戶中的所有廣告上都會有相同的資產標識碼Microsoft。 您必須設定 1-5 個描述。 每個描述的 文字 至少必須包含一個字。 為了有效率地使用資源，建議您使用動態文字字串，例如 {keyword}，而不是為每個關鍵詞建立新的廣告複本。 如需詳細資訊，請參閱 Microsoft Advertising 說明文章 使用動態文字參數來自定義您的廣告。 每個描述的 文字 輸入長度上限為 1,000 個字元，包括動態文字字串，而在這 1,000 個字元中，取代之後不允許超過 90 個最終字元。 廣告將無法顯示，如果在動態文字替換之後長度超過 90 個字元，則會使用 預設 文字。 對於具有雙寬字元的語言，例如繁體中文，輸入長度上限為 500 個字元，包括動態文字字串，而在這 500 個字元中，取代之後不允許超過 45 個最終字元。 廣告將無法顯示，如果在動態文字替換之後長度超過 45 個字元，則會使用 預設 文字。 雙寬字元取決於您使用的字元，而不是營銷活動或廣告群組語言設定的字元集。 雙角字元包括韓文、日文和中文字元，以及 Emoji。 Text 不能包含換行符 (\n) 字元。 加： 多媒體廣告和對象廣告的必要專案。 不適用於影片廣告。 更新： 自選。 若要保留所有現有的資產連結，請將此項目設定或保留為 nil。 如果您設定此元素，則會取代先前連結至此廣告的任何描述。	AssetLink 陣 列
標題	標題是您廣告中顯示的最醒目提示文字，因此您應該充分利用可用的字元。 我們需要多個標題，廣告才能在各種發行者和位置之間靈活顯示。 字串的長度限制為30個字元。 加： 影片廣告的必要專案。 不適用於多媒體廣告和對象廣告。 更新： 自選。 多媒體和物件廣告已被取代。 請改用標題。	string
標題	標題是您廣告中顯示的最醒目提示文字，因此您應該充分利用可用的字元。 我們需要多個標題，廣告才能在各種發行者和位置之間靈活顯示。 除非您將其中一個標題 釘選 到特定位置，否則 Bing 會以使用者搜尋查詢的最佳標題和描述動態優化廣告版面配置。 從數據模型的觀點來看，還原鏈接和標題會分別儲存為文字資產，也就是每個 AssetLink 一個 TextAsset。 多個廣告可以使用相同的資產。 例如，如果「無縫整合」是文字資產，則其在相同廣告帳戶中的所有廣告上都會有相同的資產標識碼Microsoft。 您必須設定 1-15 個標題。 每個標題的 文字 至少必須包含一個字。 為了有效率地使用資源，建議您使用動態文字字串，例如 {keyword}，而不是為每個關鍵詞建立新的廣告複本。 如需詳細資訊，請參閱 Microsoft Advertising 說明文章 使用動態文字參數來自定義您的廣告。 每個標題的 文字 輸入長度上限為 1,000 個字元，包括動態文字字串，而在這 1,000 個字元中，取代之後不允許超過 30 個最終字元。 廣告將無法顯示，如果在動態文字替換之後長度超過 30 個字元，則會使用 預設 文字。 對於具有雙寬字元的語言，例如繁體中文，輸入長度上限為 500 個字元，包括動態文字字串，而在這 500 個字元中，取代之後不允許超過 15 個最終字元。 廣告將無法顯示，如果在動態文字替換之後長度超過 15 個字元，則會使用 預設 文字。 雙寬字元取決於您使用的字元，而不是營銷活動或廣告群組語言設定的字元集。 雙角字元包括韓文、日文和中文字元，以及 Emoji。 Text 不能包含換行符 (\n) 字元。 加： 多媒體廣告和對象廣告的必要專案。 不適用於影片廣告。 更新： 自選。 若要保留所有現有的資產連結，請將此項目設定或保留為 nil。 如果您設定此元素，則會取代先前連結至此廣告的任何標題。	AssetLink 陣 列
影像	具有不同大小和外觀比例的影像資產，以便在各種發行者和位置之間靈活顯示。 包含一或多個 AssetLink 物件，其中每個物件都包含具有 SubType 的 ImageAsset，以及符合所需外觀比例的裁剪設定。 如需詳細資訊，請參閱下 列備註 。 加： 必填 更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您在更新期間包含映像，將會取代任何先前設定的映像。	AssetLink 陣 列
ImpressionTrackingUrls	1x1 曝光追蹤圖元的 URL。 每個像素都會向您的第三方廣告報告工具報告Microsoft對象網路曝光數。 每個回應式廣告最多可以包含 2 個曝光追蹤 URL。 每個 URL 都必須可供存取。 URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。 針對每個Microsoft對象網路曝光，Microsoft會 ping URL，以在第三方廣告報告工具中啟用曝光追蹤。 不支援進階層級用戶追蹤，例如根據 Cookie 或 IP 位址進行轉換追蹤或追蹤。 預設不會傳回這個專案。 若要取得此元素，請在呼叫 GetAdsByAdGroupId、 GetAdsByEditorialStatus 和 GetAdsByIds 服務作業時，在 ReturnAdditionalFields 元素中包含 ImpressionTrackingUrls 值。 加： 自選 更新： 自選。 如果未設定更新的值，則此設定不會變更。 若要移除曝光追蹤 URL，請將此元素設定為空字串陣列。	字串陣列
LongHeadline	針對對象行銷活動， LongHeadline 是兩個可能回應式廣告標題中較長的。	AssetLink
LongHeadlines	您必須設定 1-5 個長的標題。 每個標題的文字至少必須包含一個字。 Text 不能包含換行符 (\n) 字元。 如果父活動與商店相關聯，而且您指定 LongHeadlines，您也必須指定標題、描述和影像。 新增：如果父活動與商店產生關聯，則為選擇性，如果其父活動未與市集相關聯，則為必要專案。 如果空白，則會使用 LongHeadlineString 。 更新：選擇性。 若要保留所有現有的資產連結，請將此項目設定或保留為 nil。 如果您設定此元素的值，將會取代先前連結至此資產群組的任何標題。 如果父活動與存放區產生關聯，而且您將此元素設定為空白清單，則會刪除先前的設定。	AssetLink 陣 列
LongHeadlineString	標題是您廣告中顯示的最醒目提示文字，因此您應該充分利用可用的字元。 我們需要多個標題，廣告才能在各種發行者和位置之間靈活顯示。 字串的長度限制為90個字元。 加： 自選。 提供 LongHeadlines 時會忽略 。 如果 LongHeadlines 是空的，我們會以 LongHeadlineString 填入 LongHeadlines 。 不適用於多媒體廣告。 更新： 自選。 如果未設定更新的值，則此設定不會變更。	string
Text	視廣告位置而定，此文字會出現在廣告的長標題或短標題下方或旁邊。 您在廣告文字中使用的字元空間比在標題中要處理的更多。 因此，一旦影像和標題有潛在客戶的注意，廣告文字就必須讓他們能夠按兩下它。 哪些專案會將您的產品或服務分開？ 文字必須至少包含一個字。 字串的長度限制為90個字元。 文字不能包含換行符 (\n) 字元。 加： 影片廣告的必要專案。 不適用於多媒體廣告和對象廣告。 更新： 視訊廣告的選擇性。 請改用 (已被取代) 對象廣告或多媒體廣告的描述。	string
VerifiedTrackingSettings	VerifiedTrackingSetting 與第三方測量設定有關。 這可讓您透過第三方驗證提供者追蹤可檢視性、品牌安全性和無效的流量計量，例如 整數廣告科學。 此功能適用於使用 CPM 報價策略的原生、顯示和在線影片廣告。 注意：IAS 目前是唯一支援的廠商， (廠商 名稱) ，但其他驗證提供者即將推出。 下列範例與 IAS 有關。 IAS 有 3 個機碼/值組： “vendorName” “ (驗證提供者的用戶端標識符) “publisherEntityID” (驗證提供者的報告標識符) IAS) 所需的範例 (： vendorName： “IAS” 效能標識碼： “12345678” publisherEntityID ： “12345678”	VerifiedTrackingSetting
影片	具有不同大小和外觀比例的視訊資產，以便在各種發行者和位置之間靈活顯示。 包含一或多個 AssetLink 物件，其中每個物件都包含具有 SubType 的 VideoAsset。 加： 影片廣告的必要專案 更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您在更新期間包含影片，將會取代任何先前設定的影片。	AssetLink 陣 列

ResponsiveAd 物件具有 Inherited Elements。

繼承的專案

從廣告繼承的元素

ResponsiveAd 物件衍生自 Ad 物件，並繼承下列元素：AdFormatPreference、DevicePreference、TranslateStatus、FinalAppUrls、FinalMobileUrls、FinalUrls、FinalUrlSuffix、ForwardCompatibilityMap、Id、Status、TrackingUrlTemplate、Type、UrlCustomParameters。 下列描述專屬於 ResponsiveAd，而且可能不適用於從 Ad 物件繼承相同元素的其他物件。

元素	描述	資料類型
AdFormatPreference	不支援此廣告類型。	string
DevicePreference	不支援此廣告類型。	長
編輯狀態	廣告的編輯檢閱狀態，指出廣告是否擱置檢閱、已核准或已取消核准。 加： 唯讀 更新： 唯讀	AdEditorialStatus
FinalAppUrls	不支援此廣告類型。	AppUrl 陣 列
FinalMobileUrls	行動登陸頁面 URL。 下列驗證規則適用於最終 URL 和最終行動 URL。 - URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。 - 您最多可以為 FinalUrls 和FinalMobileUrls 指定 10 個專案;不過，只有每個清單中的第一個專案會用於傳遞。 此服務最多可允許 10 個，以取得潛在的向前相容性。 - 只允許使用 '{' 和 '}' 來描述標籤，例如 {lpurl}。 - 最終 URL 必須是以 http:// 或 https:// 開頭且格式正確的 URL。 - 如果您指定 FinalMobileUrls，則也必須指定 FinalUrls。 - 如果裝置喜好設定設定為行動裝置，您可能無法指定 FinalMobileUrls 。 只有在 關鍵詞未指定最終行動 URL 時，才會使用此 URL。 加： 自選 更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空白清單，則會刪除先前的設定。	字串陣列
FinalUrls	登陸頁面 URL。 URL 的網域部分結合路徑 1 和路徑 2 字串不能超過 67 個字元。 下列驗證規則適用於最終 URL 和最終行動 URL。 - URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。 - 您最多可以為 FinalUrls 和FinalMobileUrls 指定 10 個專案;不過，只有每個清單中的第一個專案會用於傳遞。 此服務最多可允許 10 個，以取得潛在的向前相容性。 - 只允許使用 '{' 和 '}' 來描述標籤，例如 {lpurl}。 - 最終 URL 必須是以 http:// 或 https:// 開頭且格式正確的 URL。 - 如果您指定 FinalMobileUrls，則也必須指定 FinalUrls。 - 如果裝置喜好設定設定為行動裝置，您可能無法指定 FinalMobileUrls 。 另請注意，如果已設定此廣告的 TrackingUrlTemplate 或 UrlCustomParameters 元素，則至少需要一個最終 URL。 只有在 關鍵詞未指定最終 URL 時，才會使用此 URL。 加： 必填 更新： 自選	字串陣列
FinalUrlSuffix	最終的 URL 後綴可以包含將附加至登陸頁面 URL 結尾的追蹤參數。 建議您在最後的 URL 後綴中放置登陸頁面所需的追蹤參數，讓您的客戶一律傳送至您的登陸頁面。 如需詳細資訊和驗證規則，請參閱技術指南中的 最終 URL 後綴 。 加： 自選 更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。	string
ForwardCompatibilityMap	用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。 未來的版本中將會記下向前相容性變更。 此物件目前沒有向前相容性變更。	KeyValuePairOfstringstring 陣 列
標識碼	廣告的唯一Microsoft廣告標識符。 加： 唯讀 更新： 必要和 Read-Only	長
地位	廣告的狀態。 您可以將廣告狀態設定為 [作用中] 或 [已暫停]。 加： 自選 更新： 自選	AdStatus
TrackingUrlTemplate	要作為所有登陸頁面 URL 預設值的追蹤範本。 下列驗證規則適用於追蹤範本。 如需支援的範本和參數的詳細資訊，請參閱 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
類型	廣告的類型。 當您擷取響應式廣告時，此值為 ResponsiveAd 。 如需廣告類型的詳細資訊，請參閱 廣告數據物件備註。 加： 唯讀 更新： 唯讀	AdType
UrlCustomParameters	用於 URL 追蹤的自訂索引鍵和值參數集合。 Microsoft Advertising 會接受您在 CustomParameters 物件中包含的前 8 個 CustomParameter 物件，而且如果您包含超過 8 個自定義參數，則會傳回錯誤。 每個 CustomParameter 都包含 Key 和 Value 元素。 加： 自選 更新： 自選。 如果未設定更新的值，則此設定不會變更。 將 UrlCustomParameters 元素設定為 null 或空白，以保留任何現有的自定義參數。 若要移除所有自定義參數，請將 CustomParameters 物件的 Parameters 元素設定為 null 或空白。 若要移除自定義參數的子集，請在 CustomParameters 物件的 Parameters 元素中指定您想要保留的自定義參數。	CustomParameters

註解

ResponsiveAd 對象用於搜尋網路中的 多媒體廣告 ，以及Microsoft對象網路中的物件 廣告 。

大部分支持的屬性都相同，但以下是一些索引鍵差異變數。

• 針對對象廣告，您將設定 BusinessName、 標題、 影像、 ImpressionTrackingUrls、 LongHeadlines 和 Descriptions。
• 針對多媒體廣告，您將設定 BusinessName、 CallToAction、 CallToActionLanguage、 Descriptions、 標題、 影像和 LongHeadlines。

注意事項

影 像 的數據是透過 AddMedia作業佈 建。 您可以使用 GIF、JPEG 或 PNG MIME 類型。 不支援具有動畫的影像。 雖然您只能透過 AddMedia 作業新增具有一些外觀比例的媒體，但您可以使用 ImageAsset 裁剪設定來判斷每個回應式廣告 AssetLink 內容中的有效外觀比例。 在帳戶層級媒體櫃中，預存映像的外觀比例會保持不變。

檔案大小上限為 5 MB。 以像素為單位的最大寬度和高度是 2592 和 2048，而且您仍然必須維持其中一個支持的外觀比例。 例如，如果子類型為 LandscapeImageMedia 的影像資產寬度為 2592，則高度必須是 1357。

多媒體廣告影像

針對多媒體廣告，您將建立具有不同大小和外觀比例的多個影像資產。 您必須新增至少 1 個外觀比例為 1.91：1 的影像，以及 1 個外觀比例為 1：1 的影像。

在 Images 元素 中包含一或多個 AssetLink 物件。 每個資產連結都包含 ImageAsset，並將 SubType 設定為下表中的其中一個字串值。

子類型	縱橫比	以像素為單位的最小維度
LandscapeImageMedia	1.91:1	703 寬度 x 368 高度
ImageMedia4x1	4:1	608 寬度 x 152 高度
SquareImageMedia	1:1	470 寬度 x 470 高度
ImageMedia1x2	1:2	470 寬度 x 940 高度

多媒體廣告標誌

針對多媒體廣告，您將建立具有不同大小、外觀比例和裁剪設定的多個標誌資產，讓它們可以彈性地顯示在縮圖清單中。

如果影像與廣告關聯為 「LandscapeLogoMedia」 或 「SquareLogoMedia」，則子類型必須設定為 「Logo」。

子類型	縱橫比	以像素為單位的最小維度
LandscapeLogoMedia	4:1	512 寬度 x 128 高度
SquareLogoMedia	1:1	128 寬度 x 128 高度

物件廣告影像

針對物件廣告，您將建立具有不同大小、外觀比例和裁剪設定的多個影像資產，以便在各種發行者和位置之間靈活顯示。

在 Images 元素 中包含一或多個 AssetLink 物件。 每個資產連結都包含 ImageAsset，並將 SubType 設定為下表中的其中一個字串值。

注意事項

下表針對物件廣告第 2 版與目前正在試驗的影像子類型和 。

子類型	縱橫比	以像素為單位的最小維度
OriginalImage	不適用	703 寬度 x 368 高度
LandscapeImageMedia	1.91:1	300 寬度 x 157 高度
SquareImageMedia	1:1	114 寬度 x 114 高度
ImageMedia201X100	2.01:1	612 寬度 x 304 高度
ImageMedia120X100	1.2:1	300 寬度 x 250 高度
ImageMedia200X100	2:1	200 寬 x 100 高度
ImageMedia169X100	1.69:1	628 寬度 x 372 高度
ImageMedia124X100	1.24:1	104 寬度 x 84 高度
ImageMedia153X100	1.53:1	306 寬度 x 200 高度

注意事項

下表中的影像子類型適用於第1版的物件廣告。

子類型	以像素為單位的最小維度
LandscapeImageMedia	703 寬度 x 368 高度 外觀無線電 1.91：1
SquareImageMedia	300 寬度 x 300 高度 外觀無線電 1：1
ImageMedia169X100	622 寬度 x 368 高度 外觀無線電 1.69：1
ImageMedia93X100	311 寬度 x 333 高度 外觀無線電 0.93：1
ImageMedia15X10	300 寬度 x 200 高度 外觀無線電 1.5：1
ImageMedia155X100	300 寬度 x 194 高度 外觀無線電 1.55：1
ImageMedia133X100	100 寬度 x 75 高度 外觀無線電 1.33：1
ImageMedia178X100	624 寬度 x 350 高度 外觀無線電 1.78：1
ImageMedia172X100	300 寬度 x 174 高度 外觀無線電 1.72：1

您只需要提供預設影像 OriginalImage 影像資產， (預設映射先前是 LandscapeImageMedia) 。 在 Images 元素中包含 AssetLink，其中包含一個將 SubType 設定為 OriginalImage 的 ImageAsset。 OriginalImage 的建議維度是 1200 寬度 x 628 高度。 您可以選擇性地包含其他資產連結，也就是針對每個支援的子類型包含一個映像資產。 對於未明確設定的任何映射資產子類型，Microsoft Advertising 會藉由裁剪 OriginalImage 自動建立影像資產連結。

假設下列 GetAdsByAdGroupId 回應範例，請記下下列事項：

• 相同的映像資產標識碼 (例如，1234567890000) 用于所有自动产生的映像资产子类型。 無論您是否讓 Microsoft Advertising 自動產生裁剪的影像，標識 碼在連結 至相同廣告的影像資產中都不需要是唯一的。
• 由於此範例中的廣告是在未針對 OriginalImage 映射資產子類型進行裁剪設定的情況下建立的，因此除了 OriginalImage 相關聯的影像以外，會裁剪所有影像資產。
• Microsoft Advertising 會針對所有預設裁剪設定使用 OriginalImage 的裁剪設定。 在此範例中，所有系統產生影像資產的裁剪高度為628，而且我們可以推斷OriginalImage (OriginalImage子類型) 1.91：1外觀比例的寬度和高度為1200x628。 自動產生映像資產的裁剪設定是以 OriginalImage 資產連結的裁剪設定為基礎。

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
	<s:Header>
		<h:TrackingId xmlns:h="https://bingads.microsoft.com/CampaignManagement/v12">3acf4989-d6a3-405f-9fd1-a2e8dd1b09f8</h:TrackingId>
	</s:Header>
	<s:Body>
		<GetAdsByAdGroupIdResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v12">
			<Ads xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
				<Ad i:type="ResponsiveAd">
					<AdFormatPreference i:nil="true"/>
					<DevicePreference>0</DevicePreference>
					<EditorialStatus>Inactive</EditorialStatus>
					<FinalAppUrls i:nil="true"/>
					<FinalMobileUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
						<a:string>https://mobile.contoso.com/womenshoesale</a:string>
					</FinalMobileUrls>
					<FinalUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
						<a:string>https://www.contoso.com/womenshoesale</a:string>
					</FinalUrls>
					<ForwardCompatibilityMap xmlns:a="http://schemas.datacontract.org/2004/07/System.Collections.Generic"/>
					<Id>9876543210000</Id>
					<Status>Active</Status>
					<TrackingUrlTemplate i:nil="true"/>
					<Type>ResponsiveAd</Type>
					<UrlCustomParameters i:nil="true"/>
					<BusinessName>Contoso</BusinessName>
					<CallToAction>AddToCart</CallToAction>
					<Headline>Fast &amp; Easy Setup</Headline>
					<Images>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight i:nil="true"/>
								<CropWidth i:nil="true"/>
								<CropX i:nil="true"/>
								<CropY i:nil="true"/>
								<SubType>OriginalImage</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>628</CropWidth>
								<CropX>286</CropX>
								<CropY>0</CropY>
								<SubType>SquareImageMedia</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>942</CropWidth>
								<CropX>129</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia15X10</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>835</CropWidth>
								<CropX>183</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia133X100</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>1118</CropWidth>
								<CropX>41</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia178X100</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
					</Images>
					<LandscapeImageMediaId>1234567890000</LandscapeImageMediaId>
					<LandscapeLogoMediaId i:nil="true"/>
					<LongHeadline>Find New Customers &amp; Increase Sales!</LongHeadline>
					<SquareImageMediaId>1234567890000</SquareImageMediaId>
					<SquareLogoMediaId i:nil="true"/>
					<Text>Find New Customers &amp; Increase Sales! Start Advertising on Contoso Today.</Text>
				</Ad>
			</Ads>
		</GetAdsByAdGroupIdResponse>
	</s:Body>
</s:Envelope>

需求

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