共用方式為

SitelinkAdExtension 資料物件 - 行銷活動管理

  • 發行項

定義每個廣告延伸模組具有一個網站連結的物件。 您可以使用網站連結來促銷網站的特定產品、服務或區段，並讓潛在客戶確切瞭解他們所搜尋的資訊。 這可以增加點選速率和轉換。

您可以將網站連結廣告延伸模組與帳戶建立關聯，或與帳戶中的行銷活動和廣告群組建立關聯。 每個實體 (帳戶、行銷活動或廣告群組) 最多可以與 20 個網站連結廣告延伸模組相關聯。

語法

<xs:complexType name="SitelinkAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Description1" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Description2" 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:q49="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q49:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q50="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q50: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>

元素

SitelinkAdExtension物件具有下列元素：Description1、Description2、DestinationUrl、DisplayText、FinalAppUrls、FinalMobileUrls、FinalUrls、FinalUrlSuffix、TrackingUrlTemplate、UrlCustomParameters。

元素 說明 資料類型
Description1 網站連結描述第 1 行。

輸入長度上限為 35 個字元。 如果包含任何繁體中文字元，則限制為 15 個字元。 每個繁體中文字元會計算為兩個字元，而每個英文字元只會算為一個字元。

如果您指定 Description1 ，則需要 Description2 。

添加： 選
更新： 選。 如果未設定更新的值，則會移除先前的設定。		 string
Description2 網站連結描述第 2 行。

輸入長度上限為 35 個字元。 如果包含任何繁體中文字元，則限制為 15 個字元。 每個繁體中文字元會計算為兩個字元，而每個英文字元只會算為一個字元。

如果您指定 Description2 ，則需要 Description1 。

添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。 如果您將此元素設定為空字串 (「」) ，則會刪除先前的設定。		 string
DestinationUrl 使用者按一下網站連結時所前往的網頁 URL。

重要： 如果您目前使用目的地 URL，則必須將它們取代為最終 URL。 如需詳細資訊，請參閱 URL 追蹤與升級的 URL。

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

URL 最多可以包含 1,024 個字元。 如果 URL 未指定通訊協定，系統會在使用者按一下廣告時使用 HTTP 通訊協定。 如果 URL 在您新增廣告時指定 HTTP 通訊協定，服務會移除 HTTP:// 通訊協定字串， (HTTP 通訊協定字串不會計入 1,024 個字元的限制) ;不過，服務不會從 URL 移除 HTTPs：//) (HTTPS 通訊協定字串。

添加： 不允許。 目的地 URL 已被取代，您必須改為設定 FinalUrls 元素。
更新： 選。 目的地 URL 已被取代，您必須改為設定 FinalUrls 元素。 您可以將這個專案保留空白，或將它設定為空字串。		 string
DisplayText 廣告中顯示的網站連結文字。

如果您指定 Description1 或 Description2，則顯示文字最多可以包含 25 個字元;否則，顯示文字最多可以包含 35 個字元。 如果包含任何繁體中文字元，則指定 Description1 或 Description2 的限制為 11 個字元，否則為 15 個字元。 每個繁體中文字元會計算為兩個字元，而每個英文字元只會算為一個字元。

添加： 必填
更新： 必填		 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。
- 如果DevicePreference設定為30001 (行動裝置) ，您可能無法指定FinalMobileUrls。

添加： 選
更新： 選。 如果未設定更新的值，則會移除先前的設定。		 字串數 組
FinalUrls 登陸頁面 URL。

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

添加： 必填
更新： 必填		 字串數 組
FinalUrlSuffix 最終的 URL 尾碼可以包含將附加至登陸頁面 URL 結尾的追蹤參數。 建議您在最後的 URL 尾碼中放置登陸頁面所需的追蹤參數，讓您的客戶一律傳送至您的登陸頁面。 如需詳細資訊和驗證規則，請參閱技術指南中的 最終 URL 尾碼 。

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

添加： 選
更新： 選。 如果未設定更新的值，則會移除先前的設定。		 string
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 個自訂參數，則會傳回錯誤。

添加： 選
更新： 選。 如果未設定更新的值，則會移除先前的設定。		 CustomParameters

SitelinkAdExtension物件具有Inherited Elements。

繼承的專案

從 AdExtension 繼承的專案

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

元素 說明 資料類型
DevicePreference 此元素會決定廣告延伸模組的喜好設定是否要顯示在行動裝置或所有裝置上。

若要指定行動裝置的喜好設定，請將此元素設定為 30001。

若要指定所有裝置，請將此元素設定為 0 (零) 或保留元素 nil。 根據預設，此元素會是 nil。

添加： 選
更新： 選。 如果未設定更新的值，則會移除先前的設定。		 長
ForwardCompatibilityMap 用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。

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

添加： 唯讀
更新： 唯讀		 KeyValuePairOfstringstring 數 組
識別碼 廣告延伸模組的唯一 Microsoft Advertising 識別碼。

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

添加： 選
更新： 選。 如果您將此元素設定為 null，廣告延伸模組的任何現有排程集將保持不變。 如果您將此設定為任何非 Null Schedule 物件，則實際上是取代廣告延伸模組的現有排程設定。 若要移除所有排程，請將此專案設定為空的 Schedule 物件。		 Schedule
狀態 廣告延伸模組的狀態。 此值一律為 [作用 中]，因為行銷活動管理服務不會傳回已刪除的廣告延伸模組。

添加： 唯讀
更新： 唯讀		 AdExtensionStatus
類型 廣告延伸模組的類型。 當您擷取網站連結廣告延伸模組時，此值為 SitelinkAdExtension 。

添加： 唯讀
更新： 唯讀

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

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

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

需求

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