Microsoft Advertising でホテル広告キャンペーンを作成する場合は、価格フィードを使用して旅程データ (価格と空室状況) を更新します。
Microsoft 価格フィードを送信する前に、アカウント マネージャーに連絡してサインアップする必要があります。
Microsoft に旅程データを送信するためのさまざまなモード
Microsoft では、スケジュール データの提供に使用できる次のモードをサポートしています。
- プッシュ モード
- プル モード
- ヒント付きのプル モード
プッシュ モードでは、選択した間隔で未承諾の更新プログラムを Microsoft に送信します。 このモードを使用するには、価格フィードの送信に使用するすべてのサーバーの IPv4 アドレス (または CIDR 形式のアドレス範囲) を指定する必要があります。 詳細については、「 Microsoft への価格フィードのプッシュ」を参照してください。
プル モード オプションを使用すると、返す必要があるホテルの旅程データを指定するクエリ メッセージが Microsoft から送信されます。 2 つのプル モードの違いは、Microsoft に送信するデータの量です。 プル モードでは、すべての旅程とすべてのホテルのデータを返します。 ただし、 ヒント付きのプルでは、どのデータが変更されたかを Microsoft に伝え、そのデータのみを要求します。 詳細については、「 Microsoft Pull Price フィードの提供」を参照してください。
価格フィードとは
価格フィードは、1 つ以上のホテル施設の価格と可用性データを含む XML ドキュメントです。 ホテルの施設ごとに、事前予約ウィンドウでCheckinごとに 1 つのResult要素とNightsの組み合わせ (旅程表とも呼ばれます) を指定します。 5 日間の事前予約と最大 3 泊の滞在を許可する場合、メッセージには 15 個の Result 要素が含まれます。 次の例は、1 日分の旅程を示しています。
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-05-25T20:44:56-04:00" id="de0be689-d094-406e-
8027-724309deb373">
<Result>
<Property>13579</Property>
<Checkin>2017-05-26</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">100.00</Baserate>
<Tax currency="USD">10.00</Tax>
<OtherFees currency="USD">4.00</OtherFees>
</Result>
<Result>
<Property>13579</Property>
<Checkin>2017-05-26</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">200.00</Baserate>
<Tax currency="USD">20.00</Tax>
<OtherFees currency="USD">8.00</OtherFees>
</Result>
<Result>
<Property>13579</Property>
<Checkin>2017-05-26</Checkin>
<Nights>3</Nights>
<Baserate currency="USD">300.00</Baserate>
<Tax currency="USD">30.00</Tax>
<OtherFees currency="USD">12.00</OtherFees>
</Result>
</Transaction>
14泊までのご滞在で、180日分までの予約を指定できます。 たとえば、メッセージの timestamp が 2017-06-10 の場合、メッセージが指定できる最終 Checkin 日は 2017-09-08 になります。
文書では UTF-8 エンコードを使用する必要があります。
送信前にメッセージを検証する
Microsoft に価格フィードを送信する前に、 トランザクション XSD を使用してメッセージを検証してください。 これにより、XSD によって課されるドキュメント構文エラーと制約をキャッチすることで、時間とラウンド トリップを節約できます。
次の例は、xmllint を使用して SampleTransaction.xml に含まれるメッセージを検証する方法を示しています。
xmllint.exe --schema transaction.xsd SampleTransaction.xml
注:
XSD で定義されていない制約があり、Microsoft によるメッセージの処理時にエラーが発生することがあります。 メッセージがこのドキュメントで定義されているすべての制約に準拠していることを確認してください。