価格フィードを作成する

[アーティクル]
11/13/2024

ホテルの価格と可用性データBing提供するには、Price フィードを含む XML ドキュメントを作成します。 Price フィードには、チェックの日付、滞在期間、価格の一覧が含まれています。

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

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

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

ドキュメントでは UTF-8 エンコードを使用する必要があり、 Transaction XSD に準拠している必要があります。

重要

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

注:

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

注:

メッセージは、Transaction XSD で定義された順序で (または参照に示されているように) 要素を指定する必要があります。

最上位の Transaction 要素

価格フィードには、最上位レベルの Transaction 要素が 1 つ含まれています。

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

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

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

id属性は、広告主へのメッセージを一意に識別するユーザー定義 ID です。広告主は ID を使用して、プロパティフィードの状態レポートの一覧のメッセージを識別します。

スケジュールの一覧を指定する

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

次に、必要な子要素を指定する 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">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>3</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>
</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:

Today = 2018 年 3 月 16 日
CheckInDate = 2018 年 4 月 1 日
ExpirationTimestamp = 2018 年 3 月 20 日

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

ケース 2:

Today = 2018 年 3 月 21 日
CheckInDate = 2018 年 4 月 1 日
ExpirationTime = 2018 年 3 月 20 日

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

販売時点管理 (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 と一致する必要があります。

次の手順

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

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

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

旅程にルームバンドルを追加する方法については、「メタデータ価格フィードの作成」および「会議室バンドルの使用」を参照してください。

次の方法で共有