次の方法で共有

StructuredSnippetAdExtension データ オブジェクト - キャンペーン管理

  • [アーティクル]

1 つのヘッダーと 3 ~ 10 個のスニペット値を組み合わせて、顧客にビジネスの詳細を伝えるオブジェクトを定義します。

次の例では、 Courses はヘッダーであり、 .NET、 Java、 Python、 PHP は個々の値の例です。

コース: .NET、Java、Python、PHP

構造化スニペット広告拡張機能をアカウントに関連付けるか、アカウント内のキャンペーンや広告グループに関連付けることができます。 各エンティティ (アカウント、キャンペーン、または広告グループ) は、最大 20 個の構造化スニペット広告拡張機能に関連付けることができます。 拡張テキスト広告には、インプレッションごとに 1 つの構造化スニペット (3 ~ 10 個の値を含む 1 つの見出し) のみが含まれます。

構文

<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:q53="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Values" nillable="true" type="q53:ArrayOfstring" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

要素

StructuredSnippetAdExtension オブジェクトには、Header、Values という要素があります。

要素 説明 データ型
ヘッダー コロン (:) が追加され、スニペット値の前に追加されるヘッダー。

構造化スニペット ヘッダーは、表示する言語と同じ言語で指定する必要があります。 たとえば 、英語の アメニティヘッダーが必要な場合は、ヘッダーを アメニティとして指定する必要があります。 ドイツ語で ヘッダー Ausstattung が必要な場合は、ヘッダーを Ausstattung (ドイツ語のアメニティ ) として指定する必要があります。 言語ごとにサポートされているヘッダーの一覧については、「 広告拡張機能ヘッダー言語」を参照してください。

追加： 必須
更新： 必須		 string
値 表示される広告の ヘッダー コンポーネントの後に続くスニペット値。

選択した各テキスト値の最大長は 25 文字です。 繁体字中国語の場合、各値の最大長は 12 文字です。

追加： 必須
更新： 必須		 string 配列

StructuredSnippetAdExtension オブジェクトには継承された要素があります。

継承された要素

AdExtension から継承された要素

StructuredSnippetAdExtension オブジェクトは AdExtension オブジェクトから派生し、DevicePreference、ForwardCompatibilityMap、Id、Scheduling、Status、Type、Version の各要素を継承します。 以下の説明は StructuredSnippetAdExtension に固有であり、 AdExtension オブジェクトから同じ要素を継承する他のオブジェクトには適用されない場合があります。

要素 説明 データ型
DevicePreference この広告拡張機能の種類ではサポートされていません。 long
ForwardCompatibilityMap 現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。

現在、 AdExtension オブジェクトの前方互換性の変更はありません。

追加： 読み 取り 専用
更新： 読み 取り 専用		 KeyValuePairOfstring 配列
Id 広告拡張機能の一意の Microsoft Advertising 識別子。

追加： 読み 取り 専用
更新： 読み取り専用と必須		 long
スケジュール設定 広告表示オプションが広告に表示される資格があるカレンダーの曜日と時刻の範囲を決定します。

追加： オプション
更新： オプション。 この要素を null に設定した場合、広告拡張機能の既存のスケジュール 設定は変更されません。 これを null 以外の Schedule オブジェクトに設定すると、広告拡張機能の既存のスケジュール設定を実質的に置き換えます。 すべてのスケジュールを削除するには、この要素を空の Schedule オブジェクトに設定します。		 Schedule
Status 広告拡張機能の状態。 キャンペーン管理サービスでは削除された広告表示オプションが返されないため、値は常に アクティブ になります。

追加： 読み 取り 専用
更新： 読み 取り 専用		 AdExtensionStatus
型 広告拡張機能の種類。 構造化スニペット広告拡張機能を取得する場合、この値は StructuredSnippetAdExtension です。

追加： 読み 取り 専用
更新： 読み 取り 専用

広告拡張機能の種類の詳細については、「 広告拡張機能データ オブジェクトの備考」を参照してください。		 string
バージョン 広告拡張機能が更新された回数を追跡します。

バージョンは、広告拡張機能の作成時に 1 に設定され、更新のたびに 1 ずつインクリメントされます。

追加： 許可されていません
更新： 許可されていません		 int

要件

サービス: CampaignManagementService.svc v13
名前 空間： https://bingads.microsoft.com/CampaignManagement/v13