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

ホテル広告を定義します。 ホテル広告は、旅行者が検索または地図でホテルを検索したときに表示されます。

構文

<xs:complexType name="HotelAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence />
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

要素

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

継承された要素

Ad から継承された要素

HotelAd オブジェクトは Ad オブジェクトから派生し、AdFormatPreference、DevicePreference、EditorialStatus、FinalAppUrls、FinalMobileUrls、FinalUrls、FinalUrlSuffix、ForwardCompatibilityMap、Id、Status、TrackingUrlTemplate、Type、UrlCustomParameters の各要素を継承します。 以下の説明は HotelAd に固有であり、 Ad オブジェクトから同じ要素を継承する他のオブジェクトには適用されない場合があります。

要素	説明	データ型
AdFormatPreference	この広告タイプではサポートされていません。	string
DevicePreference	この広告タイプではサポートされていません。	long
EditorialStatus	この広告タイプではサポートされていません。	AdEditorialStatus
FinalAppUrls	この広告タイプではサポートされていません。	AppUrl 配列
FinalMobileUrls	この広告タイプではサポートされていません。	string 配列
FinalUrls	この広告タイプではサポートされていません。	string 配列
FinalUrlSuffix	最後の URL サフィックスには、ランディング ページ URL の末尾に追加される追跡パラメーターを含めることができます。 顧客が常にランディング ページに送信されるように、ランディング ページで必要な追跡パラメーターを最終的な URL サフィックスに配置することをお勧めします。 詳細と検証規則については、テクニカル ガイドの 「最終 URL サフィックス」を 参照してください。 追加： オプション 更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空の文字列 ("") に設定すると、前の設定が削除されます。	string
ForwardCompatibilityMap	現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。 現在、ホテル広告に適用できる ForwardCompatibilityMap キーと値のペアはありません。	KeyValuePairOfstring 配列
Id	広告の一意の Microsoft Advertising 識別子。 追加： 読み 取り 専用 更新： 必須と読み取り専用	long
Status	広告の状態。 広告の状態を [アクティブ] または [一時停止] に設定できます。 追加： オプション 更新： オプション	AdStatus
TrackingUrlTemplate	すべてのランディング ページ URL の既定として使用する追跡テンプレート。 追跡テンプレートには、次の検証規則が適用されます。 サポートされているテンプレートとパラメーターの詳細については、Microsoft Advertising のヘルプ記事「 どのような追跡または URL パラメーターを使用できますか?」を参照してください。 - 低レベルのエンティティに対して定義された追跡テンプレート (広告など) は、キャンペーンなど、上位レベルのエンティティに対して設定されたものをオーバーライドします。 詳細については、「 エンティティの制限」を参照してください。 - 追跡テンプレートの長さは 2,048 文字に制限されています。 HTTP または HTTPS プロトコル文字列は、2,048 文字の制限にカウントされます。 - 追跡テンプレートは、 http://、 https://、 {lpurl}、または {unescapedlpurl} のいずれかで始まる整形式の URL である必要があります。 - Microsoft Advertising では、カスタム パラメーターが存在するかどうかを検証しません。 追跡テンプレートでカスタム パラメーターを使用し、それらが存在しない場合、ランディング ページ URL には、代替なしでカスタム パラメーターのキーと値のプレースホルダーが含まれます。 たとえば、トラッキング テンプレートがであり https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} 、キャンペーン、広告グループ、条件、キーワード、または広告レベルで {_season} または {_promocode} が 定義されていない場合、ランディング ページの URL は同じになります。 追加： オプション 更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空の文字列 ("") に設定すると、前の設定が削除されます。	string
型	広告の種類。 この値は、 ホテル 広告を取得するときの Hotel です。 広告の種類の詳細については、「 Ad Data Object 解説」を参照してください。 追加： 読み 取り 専用 更新： 読み 取り 専用	AdType
UrlCustomParameters	URL 追跡用のキーパラメーターと値パラメーターのカスタム コレクション。 Microsoft Advertising では、 CustomParameters オブジェクトに含める最初の 8 個の CustomParameter オブジェクトを受け入れ、8 つ以上のカスタム パラメーターを含める場合はエラーが返されます。 各 CustomParameter には、Key 要素と Value 要素が含まれています。 追加： オプション 更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 既存のカスタム パラメーターを保持するには、 UrlCustomParameters 要素を null または空に設定します。 すべてのカスタム パラメーターを削除するには、CustomParameters オブジェクトの Parameters 要素を null または空に設定します。 カスタム パラメーターのサブセットを削除するには、CustomParameters オブジェクトの Parameters 要素に保持するカスタム パラメーターを指定します。	CustomParameters

要件

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