共用方式為

ExpandedTextAd 數據物件 - 行銷活動管理

  • 發行項

定義展開的文字廣告。

此廣告格式可順暢地在行動裝置、平板電腦和桌面裝置上運作，因此您可以更專注於製作較長的廣告複本，並將廣告文字優化，以便在客戶按兩下您的廣告之前，更有效地吸引客戶。

注意事項

  • 在 2023 年 2 月 1 日前，將擴充的文字廣告升級至回應式搜尋廣告。 在此日期之後，您將無法再建立新的或編輯現有的展開文字廣告。 如需詳細資訊，請 參閱關於回應式搜尋廣告。
  • 現有的展開文字廣告將會繼續提供，而且您將能夠檢視其效能的報告。
  • 您仍然可以暫停、啟用或移除展開的文字廣告。 否則，嘗試新增或更新展開的文字廣告會導致 CampaignServiceAdTypeInvalid 錯誤。
  • 深入瞭解這項變更。

注意事項

展開的文字廣告只能在 AdGroupType 設定為 “SearchStandard” 的搜尋活動中建立。 如果 AdGroupType 設定為 “SearchDynamic”，則廣告群組不支持展開的文字廣告。

FinalUrls、Path1、Path2、Text、TextPart2、TitlePart1、TitlePart2 和 TitlePart3 元素的組合，讓展開的文字廣告成為唯一的。

語法

<xs:complexType name="ExpandedTextAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="Domain" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TextPart2" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TitlePart1" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TitlePart2" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TitlePart3" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

ExpandedTextAd 物件具有下列元素：Domain、Path1、Path2、Text、TextPart2、TitlePart1、TitlePart2、TitlePart3。

元素 描述 資料類型
網域 將顯示的 URL，而不是最後一個 URL。 最終 URL 仍會用於登陸頁面 URL。

保留給有限的試驗使用量，例如，藥物客戶。

URL 的網域部分結合路徑 1 和路徑 2 字串不能超過 67 個字元。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。		 string
Path1 選擇性路徑的第一個部分，將附加至顯示URL的網域部分。 顯示 URL 的網域部分，例如 https://www.contoso.com ，會從 Final URL (FinalUrls 元素) 的網域產生。 然後，如果您已指定 Path1 的值，它會附加至顯示URL。 如果您也指定 Path2的值，則它也會附加至 Path1之後的顯示URL。 例如，如果您 的 FinalUrls 包含 https://www.contoso.com、 Path1 設定為 subdirectory1，且 Path2 設定為 subdirectory2，則顯示的 URL 會是 https://www.contoso.com/subdirectory1/subdirectory2。

路徑可以包含 IF 和 倒數函式 。 不論所有未命名倒數參數的總長度為何，最終顯示的倒數計時一律會使用可用字元總數中的8個字元。 如需詳細資訊，請參閱 倒數自定義工具。

路徑可以包含動態參數，例如 {MatchType}。 如需支持的參數清單，請參閱 Microsoft Advertising 說明文章 我可以使用哪些追蹤或 URL 參數？。

如果您包含動態文字字串，則輸入長度上限為1,000個字元。 不能輸入超過15個最終 (不是動態文字) 字元。 如果最終 URL 網域的長度和合併的路徑超過 67 個字元，則廣告將無法顯示或使用 預設文字 。

對於具有雙寬字元的語言，例如繁體中文，如果您包含動態文字字串，輸入長度上限為1,000個字元。 不能輸入超過 7 個最終 (不是動態文字) 字元。 如果最終 URL 網域的長度和合併的路徑超過 33 個字元，則廣告將無法顯示或使用 預設文字 。 雙寬字元取決於您使用的字元，而不是營銷活動或廣告群組語言設定的字元集。 雙角字元包括韓文、日文和中文字元，以及 Emoji。

路徑不能包含正斜線 (/) 或換行符 (\n) 字元。

如果路徑包含空格，則會在廣告顯示時以底線 (_) 取代。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。		 string
Path2 選擇性路徑的第二個部分，將附加至顯示URL的網域部分。 顯示 URL 的網域部分，例如 https://www.contoso.com ，會從 Final URL (FinalUrls 元素) 的網域產生。 然後，如果您已指定 Path1 的值，它會附加至顯示URL。 如果您也指定 Path2的值，則它也會附加至 Path1之後的顯示URL。 例如，如果您 的 FinalUrls 包含 https://www.contoso.com、 Path1 設定為 subdirectory1，且 Path2 設定為 subdirectory2，則顯示的 URL 會是 https://www.contoso.com/subdirectory1/subdirectory2。

如果也已設定 Path1 ，您只能指定 Path2 。

路徑可以包含 IF 和 倒數函式 。 不論所有未命名倒數參數的總長度為何，最終顯示的倒數計時一律會使用可用字元總數中的8個字元。 如需詳細資訊，請參閱 倒數自定義工具。

路徑可以包含動態參數，例如 {MatchType}。 如需支持的參數清單，請參閱 Microsoft Advertising 說明文章 我可以使用哪些追蹤或 URL 參數？。

如果您包含動態文字字串，則輸入長度上限為1,000個字元。 不能輸入超過15個最終 (不是動態文字) 字元。 如果最終 URL 網域的長度和合併的路徑超過 67 個字元，則廣告將無法顯示或使用 預設文字 。

對於具有雙寬字元的語言，例如繁體中文，如果您包含動態文字字串，輸入長度上限為1,000個字元。 不能輸入超過 7 個最終 (不是動態文字) 字元。 如果最終 URL 網域的長度和合併的路徑超過 33 個字元，則廣告將無法顯示或使用 預設文字 。 雙寬字元取決於您使用的字元，而不是營銷活動或廣告群組語言設定的字元集。 雙角字元包括韓文、日文和中文字元，以及 Emoji。

路徑不能包含正斜線 (/) 或換行符 (\n) 字元。

如果路徑包含空格，則會在廣告顯示時以底線 (_) 取代。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。		 string
發簡訊 可以在您的廣告中顯示之廣告描述的第一個部分。

若要讓所有廣告格式的曝光數最大化，描述不一定會顯示在您的廣告中。

文字必須至少包含一個字。 為了有效率地使用資源，建議您使用動態文字字串，例如 {keyword}，而不是為每個關鍵詞建立新的廣告複本。 如需詳細資訊，請參閱 Microsoft Advertising 說明文章 使用動態文字參數來自定義您的廣告。

文字可以包含 IF 和 倒數函式 。 不論所有未命名倒數參數的總長度為何，最終顯示的倒數計時一律會使用可用字元總數中的8個字元。 如需詳細資訊，請參閱 倒數自定義工具。

如果您包含動態文字字串，則輸入長度上限為1,000個字元。 不能輸入超過90個最終 (不是動態文字) 字元。 如果兩個文字部分的長度在動態文字替換之後超過 180 個字元，廣告將無法顯示或使用 預設 文字。

對於具有雙寬字元的語言，例如繁體中文，如果您包含動態文字字串，輸入長度上限為 500 個字元。 不能輸入超過 45 個最終 (不是動態文字) 字元。 如果兩個文字部分的長度在動態文字替換之後超過 90 個字元，廣告將無法顯示或使用 預設 文字。 雙寬字元取決於您使用的字元，而不是營銷活動或廣告群組語言設定的字元集。 雙角字元包括韓文、日文和中文字元，以及 Emoji。

文字不能包含換行符 (\n) 字元。

加： 必填
更新： 自選		 string
TextPart2 可以在您的廣告中顯示之廣告描述的第二個部分。

若要讓所有廣告格式的曝光數最大化，描述不一定會顯示在您的廣告中。

文字必須至少包含一個字。 為了有效率地使用資源，建議您使用動態文字字串，例如 {keyword}，而不是為每個關鍵詞建立新的廣告複本。 如需詳細資訊，請參閱 Microsoft Advertising 說明文章 使用動態文字參數來自定義您的廣告。

文字可以包含 IF 和 倒數函式 。 不論所有未命名倒數參數的總長度為何，最終顯示的倒數計時一律會使用可用字元總數中的8個字元。 如需詳細資訊，請參閱 倒數自定義工具。

如果您包含動態文字字串，則輸入長度上限為1,000個字元。 不能輸入超過90個最終 (不是動態文字) 字元。 如果兩個文字部分的長度在動態文字替換之後超過 180 個字元，廣告將無法顯示或使用 預設 文字。

對於具有雙寬字元的語言，例如繁體中文，如果您包含動態文字字串，輸入長度上限為 500 個字元。 不能輸入超過 45 個最終 (不是動態文字) 字元。 如果兩個文字部分的長度在動態文字替換之後超過 90 個字元，廣告將無法顯示或使用 預設 文字。 雙寬字元取決於您使用的字元，而不是營銷活動或廣告群組語言設定的字元集。 雙角字元包括韓文、日文和中文字元，以及 Emoji。

文字不能包含換行符 (\n) 字元。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。		 string
TitlePart1 廣告標題的第一個部分。 三個標題部分會自動以空格、垂直線和空格 ( 分隔|顯示廣告時 ) 。 標題的每個部分至少必須包含一個字。 為了有效率地使用資源，建議您使用動態文字字串，例如 {keyword}，而不是為每個關鍵詞建立新的廣告複本。 如需詳細資訊，請參閱 Microsoft Advertising 說明文章 使用動態文字參數來自定義您的廣告。

標題可以包含 IF 和 倒數函式 。 不論所有未命名倒數參數的總長度為何，最終顯示的倒數計時一律會使用可用字元總數中的8個字元。 如需詳細資訊，請參閱 倒數自定義工具。

如果您包含動態文字字串，則輸入長度上限為1,000個字元。 不能輸入超過 30 個最終 (不是動態文字) 字元。 如果在動態文字替換之後，所有三個標題部分的長度都超過90個字元，則廣告將無法顯示或使用 預設 文字。

對於具有雙寬字元的語言，例如繁體中文，如果您包含動態文字字串，輸入長度上限為 500 個字元。 不能輸入超過15個最終 (不是動態文字) 字元。 廣告將無法顯示，或者，如果在動態文字替換之後，所有三個標題部分的長度都超過 45 個字元，則會使用 預設 文字。 雙寬字元取決於您使用的字元，而不是營銷活動或廣告群組語言設定的字元集。 雙角字元包括韓文、日文和中文字元，以及 Emoji。

標題不能包含換行符 (\n) 字元。

加： 必填
更新： 自選		 string
TitlePart2 廣告標題的第二個部分。 三個標題部分會自動以空格、垂直線和空格 ( 分隔|顯示廣告時 ) 。 標題的每個部分至少必須包含一個字。 為了有效率地使用資源，建議您使用動態文字字串，例如 {keyword}，而不是為每個關鍵詞建立新的廣告複本。 如需詳細資訊，請參閱 Microsoft Advertising 說明文章 使用動態文字參數來自定義您的廣告。

標題可以包含 IF 和 倒數函式 。 不論所有未命名倒數參數的總長度為何，最終顯示的倒數計時一律會使用可用字元總數中的8個字元。 如需詳細資訊，請參閱 倒數自定義工具。

如果您包含動態文字字串，則輸入長度上限為1,000個字元。 不能輸入超過 30 個最終 (不是動態文字) 字元。 如果在動態文字替換之後，所有三個標題部分的長度都超過90個字元，則廣告將無法顯示或使用 預設 文字。

對於具有雙寬字元的語言，例如繁體中文，如果您包含動態文字字串，輸入長度上限為 500 個字元。 不能輸入超過15個最終 (不是動態文字) 字元。 廣告將無法顯示，或者，如果在動態文字替換之後，所有三個標題部分的長度都超過 45 個字元，則會使用 預設 文字。 雙寬字元取決於您使用的字元，而不是營銷活動或廣告群組語言設定的字元集。 雙角字元包括韓文、日文和中文字元，以及 Emoji。

標題不能包含換行符 (\n) 字元。

加： 必填
更新： 自選		 string
TitlePart3 廣告標題的第三個部分。 三個標題部分會自動以空格、垂直線和空格 ( 分隔|顯示廣告時 ) 。 標題的每個部分至少必須包含一個字。 為了有效率地使用資源，建議您使用動態文字字串，例如 {keyword}，而不是為每個關鍵詞建立新的廣告複本。 如需詳細資訊，請參閱 Microsoft Advertising 說明文章 使用動態文字參數來自定義您的廣告。

標題可以包含 IF 和 倒數函式 。 不論所有未命名倒數參數的總長度為何，最終顯示的倒數計時一律會使用可用字元總數中的8個字元。 如需詳細資訊，請參閱 倒數自定義工具。

如果您包含動態文字字串，則輸入長度上限為1,000個字元。 不能輸入超過 30 個最終 (不是動態文字) 字元。 如果在動態文字替換之後，所有三個標題部分的長度都超過90個字元，則廣告將無法顯示或使用 預設 文字。

對於具有雙寬字元的語言，例如繁體中文，如果您包含動態文字字串，輸入長度上限為 500 個字元。 不能輸入超過15個最終 (不是動態文字) 字元。 廣告將無法顯示，或者，如果在動態文字替換之後，所有三個標題部分的長度都超過 45 個字元，則會使用 預設 文字。 雙寬字元取決於您使用的字元，而不是營銷活動或廣告群組語言設定的字元集。 雙角字元包括韓文、日文和中文字元，以及 Emoji。

標題不能包含換行符 (\n) 字元。

加： 自選
更新： 自選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「) ，則會刪除先前的設定。		 string

ExpandedTextAd 物件具有 Inherited Elements。

繼承的專案

從廣告繼承的元素

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

元素 描述 資料類型
AdFormatPreference [廣告格式喜好設定] 可用來指出您是否偏好將廣告復本顯示給使用者做為搜尋或對象廣告。 搜尋廣告通常會撰寫為動作的呼叫，而對象廣告應該以更多資訊樣式撰寫。 雖然您可以選擇使用擴充的文字廣告作為對象廣告，但將廣告指定為對象廣告慣用格式，可讓您優化其傳訊以進行原生傳遞。

重要： 您必須為每個不偏好物件廣告的廣告群組定義至少一個展開的文字廣告，否則所有展開文字廣告的廣告複本都符合搜尋和對象廣告的資格。

可能的值為 AudienceAd 和 All。 如果設定為 [全部]，廣告將符合搜尋和對象廣告格式的資格。 如果設定為 AudienceAd，則廣告將僅符合物件廣告格式的資格。

加： 自選。 如果您未設定此元素，預設會將廣告格式喜好設定設定為 [全部]。
更新： 自選。 如果未設定更新的值，則此設定不會變更。		 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
類型 廣告的類型。 當您擷取展開的文字廣告時，此值為 ExpandedText 。 如需廣告類型的詳細資訊，請參閱 廣告數據物件備註。

加： 唯讀
更新： 唯讀		 AdType
UrlCustomParameters 用於 URL 追蹤的自訂索引鍵和值參數集合。

Microsoft Advertising 會接受您在 CustomParameters 物件中包含的前 8 個 CustomParameter 物件，而且如果您包含超過 8 個自定義參數，則會傳回錯誤。 每個 CustomParameter 都包含 Key 和 Value 元素。

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

需求

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