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

展開されたテキスト広告に含めるビジネス、製品、またはサービスに関するサード パーティのレビュー (正確または言い換え) を指定するオブジェクトを定義します。

レビュー広告拡張機能をアカウントに関連付けるか、アカウント内のキャンペーンや広告グループに関連付けることができます。 各エンティティ (アカウント、キャンペーン、または広告グループ) は、最大 20 個のレビュー広告表示オプションに関連付けることができます。 拡張テキスト広告には、インプレッションごとに 1 つのレビューのみが含まれます。

構文

<xs:complexType name="ReviewAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="IsExact" type="xs:boolean" />
        <xs:element minOccurs="0" name="Source" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Url" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

要素

ReviewAdExtension オブジェクトには、IsExact、Source、Text、Url という要素があります。

要素	説明	データ型
IsExact	レビュー テキストが正確な引用符か言い換えかを決定します。 指定しない場合、 既定値の false は、レビュー テキストがソースから言い換えられます。 true に設定すると、広告と共に表示されると、レビュー テキストが引用符で自動的に囲まれます。 追加： オプション 更新： オプション。 この要素を null に設定すると、前の設定が削除されます。	boolean
ソース	レビュー ソース名。 Source 文字列と Text 文字列の長さを組み合わせて 67 文字以内にする必要があります。 繁体字中国語の場合、Source 文字列と Text Source 文字列と Text 文字列の合計長は 33 文字に制限されることに注意してください。 追加： 必須 更新： 必須	string
テキスト	言い換えまたはレビュー ソースからの正確な見積もりであるテキスト。 Source 文字列と Text 文字列の長さを組み合わせて 67 文字以内にする必要があります。 繁体字中国語の場合、Source 文字列と Text Source 文字列と Text 文字列の合計長は 33 文字に制限されることに注意してください。 テキストを引用符で囲まないでください。 IsExact が True に設定されている場合、広告と共に表示されると、レビュー テキストは引用符で自動的に囲まれます。 追加： 必須 更新： 必須	string
Url	レビュー ソース URL。 URL は、 http:// または https:// プレフィックスで始まる必要があります。 この文字列の長さは 2,048 文字に制限されています。 追加： 必須 更新： 必須	string

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

継承された要素

AdExtension から継承された要素

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

要素	説明	データ型
DevicePreference	この広告拡張機能の種類ではサポートされていません。	long
ForwardCompatibilityMap	現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。 現在、 AdExtension オブジェクトの前方互換性の変更はありません。 追加： 読み 取り 専用 更新： 読み 取り 専用	KeyValuePairOfstring 配列
Id	広告拡張機能の一意の Microsoft Advertising 識別子。 追加： 読み 取り 専用 更新： 読み取り専用と必須	long
スケジュール設定	広告表示オプションが広告に表示される資格があるカレンダーの曜日と時刻の範囲を決定します。 追加： オプション 更新： オプション。 この要素を null に設定した場合、広告拡張機能の既存のスケジュール 設定は変更されません。 これを null 以外の Schedule オブジェクトに設定すると、広告拡張機能の既存のスケジュール設定を実質的に置き換えます。 すべてのスケジュールを削除するには、この要素を空の Schedule オブジェクトに設定します。	Schedule
Status	広告拡張機能の状態。 キャンペーン管理サービスでは削除された広告表示オプションが返されないため、値は常に アクティブ になります。 追加： 読み 取り 専用 更新： 読み 取り 専用	AdExtensionStatus
型	広告拡張機能の種類。 この値は、レビュー広告拡張機能を取得するときの ReviewAdExtension です。 追加： 読み 取り 専用 更新： 読み 取り 専用 広告拡張機能の種類の詳細については、「 広告拡張機能データ オブジェクトの備考」を参照してください。	string
バージョン	広告拡張機能が更新された回数を追跡します。 バージョンは、広告拡張機能の作成時に 1 に設定され、更新のたびに 1 ずつインクリメントされます。 追加： 許可されていません 更新： 許可されていません	int

要件

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