メタデータ価格フィードを作成する

ルーム バンドルを使用する場合は、通常、会議室とパッケージのデータのみを含む価格フィードを作成します。 メタデータに別のメッセージを使用する方が、スケジュール データと同じメッセージに含めるよりも優れています。これは、スケジュール データほど頻繁に変更されないため、スケジュール データの領域が解放されるためです。

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

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

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

重要

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

注:

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

注:

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

重要

旅程で会議室とパッケージをインラインで指定することもできますが、非効率的で冗長な可能性があり、旅程に使用できる領域が減るため、お勧めしません。

最上位の Transaction 要素

会議室とパッケージ データBingを提供するには、Price フィードを含む XML ドキュメントを作成します。 メッセージには、最上位レベルの 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要素には、メタデータを定義するプロパティごとに 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に含めます。 ただし、パッケージが 2 人用の新婚旅行パッケージなど、占有率に基づいている場合は、PackageDataにOccupancyを含めます。 必要なアメニティは払い戻し可能のみです。 この例では、ブール値を指定する複数の方法を示します。

  <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>

次の手順

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

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

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

旅程でメタデータを使用する方法については、「 会議室バンドルの使用」を参照してください。