価格フィードの作成

ホテルの価格と空室状況データを Bing に提供するには、価格フィードを含む XML ドキュメントを作成します。 価格フィードには、チェック日、滞在期間、価格のリストが含まれます。

価格フィードには、最大 180 日間分の事前予約が含まれる場合があり、各予約には最大 14 泊の滞在を指定できます。 チェック日と滞在期間は旅程表と呼ばれます。 旅程の最大数を指定する場合、メッセージには 2,520 の旅程が含まれます。

価格フィードは、非圧縮データ 100 MB、圧縮データ (GZip 圧縮を使用) 10 MB に制限されます。 ネットワーク トラフィックを減らすには、圧縮データを送信する必要があります。

価格フィードには、追加または更新する旅行日のみを含める必要があります。前回メッセージを送信してから変更されていない旅行日は含めないでください。

ドキュメントは UTF-8 エンコーディングを使用する必要があり、 トランザクション XSD に準拠している必要があります。

重要

すべてのホテル価格広告ポリシーを読み、遵守する必要があります。 ポリシーの一覧については、「 パイロット プログラムのポリシー」を参照してください。

注:

Bing はすべてのトランザクション XSD 要素をサポートしているわけではありません。 Bing は、サポートしていないメッセージ内の要素または属性を無視します。 価格フィード リファレンスには、Bing がサポートする要素と属性のみが含まれます。

注:

メッセージは、トランザクション XSD で定義されている順序 (または参照に示されている順序) で要素を指定する必要があります。

最上位のトランザクション要素

価格フィードには、1 つのトップレベルの トランザクション 要素が含まれます。

<Transaction timestamp="2017-05-25T20:44:56-04:00" id="de0be689-d094-406e-
8027-724309deb373">

timestamp 属性と id 属性を指定する必要があります。

timestamp 属性は、メッセージを送信する時刻を指定する必要があります。 Bing はタイム スタンプを使用して、最新の旅程のみを処理するようにします。 たとえば、Bing がタイム スタンプが 14:10 のメッセージを処理し、タイム スタンプが 14:09 のメッセージを処理した場合、Bing は 14:10 メッセージに含まれていない 14:09 メッセージのスケジュールのみを処理します。

id 属性は、広告主へのメッセージを一意に識別するユーザー定義の ID です。 広告主はこの ID を使用して、施設フィード ステータス レポートのリストでメッセージを識別します。

旅程のリストの指定

Transaction要素には、定義するスケジュールごとに 1 つずつ、Result 要素のリストが含まれます。 メッセージには、新しい旅程または変更された旅程のみを含める必要があります。

以下に、必要な子要素を指定する Result 要素を示します。

  <Result>
    <Property>13579</Property>
    <Checkin>2017-06-10</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
  </Result>

Property ID は、施設フィード ファイル内の施設の ID と一致する必要があります。 Checkin日は 90 日前予約期間内である必要があり、Nightsは 1 から 14 の範囲内である必要があります。

Baserateは、宿泊料金ではなく、滞在期間全体の費用を指定します。

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">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="mobile"/>
      <PointOfSale id="desktop"/>
    </AllowablePointsOfSale>
  </Result>
  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">319.98</Baserate>
    <Tax currency="USD">40.00</Tax>
    <OtherFees currency="USD">8.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="mobile"/>
      <PointOfSale id="desktop"/>
    </AllowablePointsOfSale>
  </Result>
  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>3</Nights>
    <Baserate currency="USD">479.97</Baserate>
    <Tax currency="USD">60.00</Tax>
    <OtherFees currency="USD">12.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="mobile"/>
      <PointOfSale id="desktop"/>
    </AllowablePointsOfSale>
  </Result>
</Transaction>

15 個の旅程を定義した後、後続の各メッセージには、変更された旅程のみが含まれます。 たとえば、価格や提供状況の変更などです。

旅程の削除

旅程を削除するには、 Baserate、 Tax、 OtherFees 要素を -1.00 に設定します。 Bing は、過去のチェックイン日を含む旅程を自動的に削除します。

省略可能な Result 要素の使用

オプションの子要素を含む Result 要素を次に示します。

  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
    <ExpirationTimestamp>2017-05-28T09:00:34Z</ExpirationTimestamp>
    <ChargeCurrency>deposit</ChargeCurrency>
    <Custom1>summer2017</Custom1>
    <AllowablePointsOfSale>
      <PointOfSale id="mobile"/>
      <PointOfSale id="desktop"/>
    </AllowablePointsOfSale>
  </Result>

ExpirationTimestamp を使用して、旅程の有効期限を指定します。 たとえば、ケース 1 では、旅程が提供されます。

ケース 1:

今日 = 2018/3/16
CheckInDate = 4/1/2018
ExpirationTimestamp = 3/20/2018

ただし、ケース 2 では、旅程は提供されません。

ケース 2:

今日 = 2018/3/21
CheckInDate = 4/1/2018
ExpirationTime = 3/20/2018

ChargeCurrency 要素を使用して、ユーザーに予約料金が請求されるタイミングを指定します。 既定では、ユーザーは予約時に支払います (これは Web オプションです)。 この例では、デポジットを使用します。これは、ユーザーに予約時に一部を支払い、残りを後で(たとえば、チェックアウトするとき)支払うように求めます。

販売時点管理 (POS) URL 内の動的パラメーターの置換値を指定するには、5 つの Custom 要素のうち 1 つ以上を使用します。 たとえば、POS URL が https://www.partnerdomain.com?promo=(CUSTOM1) で、 Custom1 が summer2017 に設定されている場合、Bing使用する POS URL は https://www.partnerdomain.com?promo=summer2017. 詳細については、「 動的クエリ パラメータの使用」を参照してください。

すべての Custom[1-5] 値の合計は最大 1,000 文字に制限されますが、URL の最大長を考えると、実際的な制限はそれより小さい場合があることに注意してください。

AllowablePointsOfSale 要素を使用して、ユーザーが予約に使用できる特定の POS URL を指定します。 既定では、ユーザーはパートナーのランディング ページ フィード ファイル内の任意の POS を使用できます。 id 属性は、フィード ファイル内の POS と一致する必要があります。

次の手順

価格フィードを送信する前に、プロパティ フィード ファイルとランディング ページ ファイルが最新であることを確認してください。 これらのファイルを更新するには、TAM にお問い合わせください。 TAM がデータを Bing にインポートした後、価格フィードの送信を開始できます。 データをインポートする前に送信された価格フィードは失敗します。

価格フィードを Bing に送信する前に検証してください。 詳細については、「 価格フィードの検証」を参照してください。

Bing に価格フィードを送信する方法の詳細については、「価格 フィードを Bing にプッシュ する、または Bing プル価格フィードを使用する」を参照してください。

旅程へのルーム バンドルの追加の詳細については、「 メタデータ価格フィードの作成 」と「 ルーム バンドルの使用」を参照してください。

  • 最終更新: