メタデータ価格フィードの作成

ルーム バンドルを使用する場合、通常はルームとパッケージ データのみを含む価格フィードを作成します。 旅程データほど頻繁に変更されず、旅程データ用のスペースを解放できるため、旅程データと同じメッセージに含めるよりも、メタデータに別のメッセージを使用する方が望ましいです。

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

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

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

重要

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

注:

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

注:

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

重要

旅程で部屋とパッケージをインラインで指定することはできますが、非効率的で冗長である可能性が高く、旅程に使用できるスペースの量を減らすため、お勧めしません。

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

Bing に部屋とパッケージのデータを提供するには、価格フィードを含む XML ドキュメントを作成します。 メッセージには、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 つずつ、PropertyDataSet 要素のリストが含まれています。 メッセージには、新しいメタデータまたは変更されたメタデータのみを含める必要があります。

次に、プロパティ 12345 の PropertyDataSet 要素を示します。 Property ID は、施設フィード ファイル内の施設の ID と一致する必要があります。 任意の数の RoomData と PackageData 要素を指定できます。

  <PropertyDataSet>
    <Property>88888</Property>
    <RoomData>. . .</RoomData>
    <RoomData>. . .</RoomData>
    <RoomData>. . .</RoomData>
    <PackageData>. . .</PackageData>
    <PackageData>. . .</PackageData>
  </PropertyDataSet>

施設で利用できる部屋の種類と容量ごとに RoomData オブジェクトを指定します。 次の例は、指定できるすべての要素を示しています。 提供できる情報は多ければ多いほど良いですが、必要な要素は RoomID と Nameだけです。 省略可能ですが、 Capacity も常に含める必要があります。 パッケージで指定されている場合を除き、ほとんどの場合は Occupancy も含めます (たとえば、2 人用の新婚旅行パッケージなど)。

  <RoomData>
    <RoomID>12345</RoomID>
    <Name>
      <Text text="Double queen room - Non-smoking" language="en" />
    </Name>
    <Description>
      <Text text="A spacious, non-smoking room with two queen beds" language="en" />
    </Description>
    <PhotoURL>
      <URL>https://mydomain.com/pic1.jpg</URL>
      <Caption>
        <Text text="Desk with USB outlets for charging your devices" language="en" />
      </Caption>
    </PhotoURL>
    <Capacity>4</Capacity>
    <Occupancy>4</Occupancy>
    <OccupancyDetails>
      <NumAdults>4</NumAdults>
    </OccupancyDetails>
  </RoomData>

定義するアメニティのパッケージごとに PackageData オブジェクトを指定します。 パッケージでは Capacity と Occupancy を指定できますが、通常はそれらを RoomDataに含めます。 ただし、パッケージが占有率に基づいている場合は、PackageDataにOccupancyを含めます (2 人用の新婚旅行パッケージなど)。 必要なアメニティは返金可能のみです。 この例では、ブール値を指定する複数の方法を示します。

  <PackageData>
    <PackageID>67890</PackageID>
    <Name>
      <Text text="Standard" language="en" />
    </Name>
    <Description>
      <Text text="Standard room package that applies to most rooms" language="en" />
    </Description>
    <Capacity>4</Capacity>
    <Occupancy>2</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
    </OccupancyDetails>
    <ChargeCurrency>Web</ChargeCurrency>
    <Refundable available="true" refundable_until_days="2" refundable_until_time="17:00:00" />
    <BreakfastIncluded/>
    <ParkingIncluded>true</ParkingIncluded>
    <InternetIncluded>1</InternetIncluded>
    <MembershipBenefitsIncluded>
      <ProgramName>
        <Text text="Holiday" language="en" />
      </ProgramName>
      <ProgramLevel>
        <Text text="Platinum" language="en" />
      </ProgramLevel>
      <NightlyValue currency="USD">50.00</NightlyValue>
    </MembershipBenefitsIncluded>
    <CarRentalIncluded/>
    <MilesIncluded>
      <NumberOfMiles>1500</NumberOfMiles>
      <Provider>
        <Text text="Contoso" language="en" />
      </Provider>
    </MilesIncluded>
    <OnPropertyCredit currency="USD">25.00</OnPropertyCredit>
  </PackageData>

次の手順

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

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

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

旅程でのメタデータの使用の詳細については、「 ルーム バンドルの使用」を参照してください。

  • 最終更新: