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

使用 [動作呼叫] 按鈕來定義動作廣告延伸模組。

語法

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

元素

ActionAdExtension物件具有下列元素：ActionType、FinalMobileUrls、FinalUrls、FinalUrlSuffix、Language、TrackingUrlTemplate、UrlCustomParameters。

元素	說明	資料類型
ActionType	您在這裡選擇的動作類型，以及您所設定的 語言 ，會決定顯示在 [行動呼叫] 按鈕上的文字。 Microsoft Advertising 不支援所有語言的所有動作類型。 如果您嘗試使用不支援的動作類型和語言組合，則會傳回錯誤。 如需詳細資訊，請參閱 動作廣告延伸模組的動作文字。 添加： 必填 更新： 必填	ActionAdExtensionActionType
FinalMobileUrls	在行動裝置上提供動作擴充功能時，這是易於行動的登陸頁面 URL。 如果您指定最終的行動 URL，則也必須指定 FinalUrls。 URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。 添加： 選 更新： 選。 如果您將此元素設定為 null，則會刪除先前的設定。	字串數 組
FinalUrls	這是對應至動作文字之特定網頁或表單的連結。 未提供動作 URL 時，將會使用廣告的最終 URL。 URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。 雖然資料類型是字串清單，但 Microsoft Advertising 只會使用第一個清單專案。 添加： 選 更新： 選。 如果您將此元素設定為 null，則會刪除先前的設定。	字串數 組
FinalUrlSuffix	最終的 URL 尾碼可以包含將附加至登陸頁面 URL 結尾的追蹤參數。 建議您在最後的 URL 尾碼中放置登陸頁面所需的追蹤參數，讓您的客戶一律傳送至您的登陸頁面。 如需詳細資訊和驗證規則，請參閱技術指南中的 最終 URL 尾碼 。 這項功能僅適用于最終 URL 尾碼階段 3 試驗中的客戶 (GetCustomerPilotFeatures 會傳回 636) 。 如果您不在試驗中，則會忽略此屬性，而且不會傳回任何錯誤。 添加： 選 更新： 選。 如果您將此元素設定為 null，則會刪除先前的設定。	string
語言	將用來提供廣告延伸模組的語言。 不論行銷活動或廣告群組的語言設定為何，擴充功能一律會以這種語言提供。 支援的語言字串為：丹麥文、荷蘭文、英文、芬蘭文、法文、德文、義大利文、挪威文、葡萄牙文、西班牙文、瑞典文和傳統語言。 Microsoft Advertising 不支援所有語言的所有動作類型。 如果您嘗試使用不支援的動作類型和語言組合，則會傳回錯誤。 如需詳細資訊，請參閱 動作廣告延伸模組的動作文字。 添加： 必填 更新： 必填	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 會相同。 添加： 選 更新： 選。 如果您將此元素設定為 null，則會刪除先前的設定。	string
UrlCustomParameters	用於 URL 追蹤的自訂索引鍵和值參數集合。 Microsoft Advertising 會接受您在CustomParameters物件中包含的前 8 個CustomParameter物件，而且如果您包含超過 8 個自訂參數，則會傳回錯誤。 每個 CustomParameter 都包含 Key 和 Value 元素。 針對自訂參數限制增加階段 3 試驗的客戶 (GetCustomerPilotFeatures 會傳回 635) ，Microsoft Advertising 會接受您包含的前 8 個自訂參數索引鍵和值組，如果您包含超過 8 個自訂參數，則會傳回錯誤。 添加： 選 更新： 選。 如果您將此元素設定為 null，則會刪除先前的設定。	CustomParameters

ActionAdExtension物件具有Inherited Elements。

繼承的專案

從 AdExtension 繼承的專案

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

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

需求

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