価格フィードの概要
Microsoft Advertising でホテル広告キャンペーンを作成する場合は、価格フィードを使用して旅程データ (価格と可用性) を更新します。
Microsoft Price フィードを送信する前に、アカウント マネージャーに連絡してサインアップする必要があります。
Microsoft の旅程データを送信するためのさまざまなモード
Microsoft では、旅程データを提供するために使用できる次のモードがサポートされています。
- プッシュ モード
- プル モード
- ヒントを含むプル モード
プッシュ モードでは、選択した間隔で未承諾の更新プログラムを Microsoft に送信します。 このモードを使用するには、価格フィードの送信に使用するすべてのサーバーの IPv4 アドレス (または CIDR 形式のアドレス範囲) を指定する必要があります。 詳細については、「 Microsoft への価格フィードのプッシュ」を参照してください。
プル モード オプションを使用すると、返す必要があるホテルの旅程データを指定するクエリ メッセージが Microsoft から送信されます。 2 つのプル モードの違いは、Microsoft に送信するデータの量です。 プル モードでは、すべての旅程とすべてのホテルのデータを返します。 ただし、 ヒントを使用したプルでは、変更されたデータを Microsoft に伝え、そのデータのみを要求します。 詳細については、「 Microsoft Pull Price フィードを使用する」を参照してください。
価格フィードとは
Price フィードは、1 つ以上のホテル プロパティの価格と可用性データを含む XML ドキュメントです。 各ホテルのプロパティに対して、各CheckinとNightsの組み合わせ (旅程としても知られます) に 1 つのResult要素を指定します。 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 に Price フィードを送信する前に、 Transaction XSD を使用してメッセージを検証します。 これにより、XSD によって課されるドキュメント構文エラーと制約をキャッチすることで、時間とラウンド トリップを節約できます。
次の例は、xmllint を使用して、SampleTransaction.xml に含まれるメッセージを検証する方法を示しています。
xmllint.exe --schema transaction.xsd SampleTransaction.xml
注:
MICROSOFT がメッセージを処理する際にエラーを生成する可能性がある XSD によって定義されていない制約があります。 メッセージがこのドキュメントで定義されているすべての制約に準拠していることを確認してください。