建立元數據價格摘要
如果您使用會議室套件組合,通常您會建立只包含房間和套件數據的 Price 摘要。 針對元數據使用個別訊息,比將它包含在具有路線數據的相同訊息中更好,因為它不會像反覆數據一樣頻繁地變更,而且會釋放行程數據的空間。
使用 GZip 壓縮) ,價格摘要限制為 100 MB 的未壓縮數據或 10 MB 的壓縮資料 (。 若要減少網路流量,您應該傳送壓縮的數據。
價格摘要應該只包含您要新增或更新的元數據, 不包含自上次傳送訊息以來未變更的元數據。
文件必須使用UTF-8編碼,而且必須符合 交易 XSD。
重要事項
您必須閱讀並遵循所有旅館價格廣告原則。 如需原則清單,請參閱 試驗計劃原則。
注意事項
Bing 不支援所有交易 XSD 元素。 Bing 會忽略訊息中不支援的任何元素或屬性。 價格摘要參考僅包含 Bing 支援的元素和屬性。
注意事項
訊息必須以交易 XSD (中定義的順序或參考) 中所示來指定專案。
重要事項
雖然您可以使用路線來指定空間和套件內嵌,但不建議使用,因為其效率不佳、可能為備援,而且會減少路線可用的空間量。
最上層 Transaction 元素
若要提供 Bing 會議室和套件數據,請建立包含價格摘要的 XML 檔。 訊息包含單一的最上層 Transaction 元素。
<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:09 訊息中未包含在 14:10 訊息中的元數據。
id
屬性是使用者定義的標識碼,可唯一識別訊息給廣告商。 廣告商會使用標識碼來識別屬性摘要狀態報告清單中的訊息。
指定元數據
元素 Transaction
包含 PropertyDataSet 元素的清單,每個您定義元數據的屬性各一個。 訊息應該只包含新的元數據或已變更的元數據。
下列顯示 PropertyDataSet
屬性 12345 的專案。 標識 Property
碼必須符合屬性摘要檔案中屬性的標識碼。 您可以指定任意數目的 RoomData
和 PackageData
元素。
<PropertyDataSet>
<Property>88888</Property>
<RoomData>. . .</RoomData>
<RoomData>. . .</RoomData>
<RoomData>. . .</RoomData>
<PackageData>. . .</PackageData>
<PackageData>. . .</PackageData>
</PropertyDataSet>
RoomData
針對屬性中可用的每個會議室和容量類型指定 物件。 下列範例顯示您可以指定的所有專案。 您可以提供的資訊越多越好,但唯一必要的元素是 RoomID
和 Name
。 雖然是選擇性的,但您也應該一律包含 Capacity
。 在大部分情況下,您也會包含 Occupancy
,除非套件指定它 (例如,適用於兩個) 的 Honeymoon 套件。
<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
。 不過,如果套件是以佔用量為基礎,例如適用於兩個的 Honeymoon 套件,則會 Occupancy
包含在 PackageData
中。 唯一需要的設施是可退款。 此範例示範您可以指定布爾值的多種方式。
<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 提取價格摘要。
如需在您的行程中使用元數據的相關信息,請參閱 使用會議室套件組合。