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

定義物件，將一個標頭與介於 3 到 10 個代碼段值之間配對，讓客戶深入瞭解您的業務。

在下列範例中， Courses 是標頭， 而 .NET、 Java、 Python 和 PHP 是個別值的範例。

課程：.NET、Java、Python、PHP

您可以將結構化代碼段廣告延伸模組與帳戶建立關聯，或與帳戶中的行銷活動和廣告群組建立關聯。 每個實體 (帳戶、行銷活動或廣告群組) 最多可以與 20 個結構化代碼段廣告延伸模組相關聯。 展開的文字廣告只會包含一個結構化代碼段 (一個標題，每個曝光) 3 - 10 個值。

語法

XML

<xs:complexType name="StructuredSnippetAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Header" nillable="true" type="xs:string" />
        <xs:element xmlns:q54="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Values" nillable="true" type="q54:ArrayOfstring" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

JSON

{
  "DevicePreference": "LongValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "Scheduling": {
    "DayTimeRanges": [
      {
        "Day": "ValueHere",
        "EndHour": IntValueHere,
        "EndMinute": "ValueHere",
        "StartHour": IntValueHere,
        "StartMinute": "ValueHere"
      }
    ],
    "EndDate": {
      "Day": IntValueHere,
      "Month": IntValueHere,
      "Year": IntValueHere
    },
    "StartDate": {
      "Day": IntValueHere,
      "Month": IntValueHere,
      "Year": IntValueHere
    },
    "UseSearcherTimeZone": "ValueHere"
  },
  "Status": "ValueHere",
  "Type": "StructuredSnippetAdExtension",
  "Version": IntValueHere,
  "Header": "ValueHere",
  "Values": [
    "ValueHere"
  ]
}

元素

StructuredSnippetAdExtension 物件具有下列元素：Header、Values。

元素	描述	資料類型
頁首	附加冒號的標頭 (：) ，並在代碼段值之前。 結構化代碼段標頭必須以您想要顯示的相同語言指定。 例如，如果您想要使用英文標頭 Amenities ，您必須將標頭指定為 Amenities。 如果您想要以德文標頭 Ausstattung ，則必須將標頭指定為 Ausstattung (德文) 中的 Amenities 。 如需每種語言支援的標頭清單，請參閱 Ad Extension Header Languages。 加： 必填 更新： 必填	string
值	顯示之廣告標 頭 元件後面的代碼段值。 您選擇的每個文字值長度上限為 25 個字元。 請注意，對於繁體中文字元，每個值的長度上限為 12 個字元。 加： 必填 更新： 必填	字串陣列

StructuredSnippetAdExtension 物件具有 Inherited Elements。

繼承的專案

從 AdExtension 繼承的專案

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

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

需求

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