DiversityControl
DiversityControl機能は、Bargain Finder Max（BFM）で選定される旅程に多様性を持たせるようにコントロールをする機能です。
-
検索結果をチューニングすることで、価格やキャリアの選択肢を多様化し、販売機会を拡大。
最安値旅程に加えて、条件設定を行い、ニーズに沿った検索結果を出力できます。
【利用例】
・最安値帯の特定旅程だけでなく、航空会社や旅程のバリエーションを増やし、購入時の選択肢を多様化
・ターゲット顧客層のニーズに合わせて旅程を提供することで他社と差別化
【注意事項】
DiversityControl機能は、レスポンスのおおよその傾向をチューニングするものであり、運航状況や区間特性、航空会社の運賃設定状況等により、必ずしも指定した値やWeight通りに返却されるとは限りません。
機能概要
BFMは、数ある旅程の中から、空席や運賃情報等を用いて、独自のロジックで旅程を選出します。
特定の航空会社が極端に安い運賃を設定している場合や、経由便の方が安価である場合に、特定の旅程に偏った検索結果が出力されることがあります。
このような場合に、DiversityControlをご利用いただくことで、検索結果を平準化しつつ多様性を持たせることができます。
DiversityControlご利用時は、最安運賃計算で算出されるLow Fare Bucketの割合と、設定する条件に基づき算出されるDiversity Bucketの条件を設定します。
検索結果比較（利用例：Carrier設定）
上記の図は、通常のBFMレスポンス（グレー）とDiversityControlを利用したレスポンス（緑）の比較の一例です。
通常のBFMでは、BR便とCI便に偏りが出ていた検索結果を、DiversityControlにてCarrierのウェイトを設定することで、各航空会社の旅程数を平準化して返却させることができます。
DiversityControl 条件設定
検索時には、LowFareBucket・Dimensionsの両方のタグを設定する必要があります。
【Low Fare Bucketの設定】
<LowFareBucket>
最安運賃計算で算出される旅程数や割合（%）を指定します。
・LowFareBucketタグの属性は、以下のいずれかを利用します。
| ＃ | タグ | 条件 | 属性 |
| 1 | LowFareBucket | 最安運賃計算の旅程数・割合指定 | @Options：最安運賃計算旅程の指定 @FareCutOff：最安値帯の除外指定 |
・@Optionsは、BFMで設定する検索旅程数（50・100・200旅程）を上限とした整数か、割合（％）で指定します。
100％（または旅程数上限）に設定した場合、Dimensionsの割合は0となるため、設定内容は反映されません。
0（または0%）に設定した場合は、エラーとなります。
・@FareCutOffは、割合（％）を指定します。
【Diversity Bucketの設定】
<Dimensions>
Diversity Bucketとして検索時に優先させる項目とウェイトを指定します。
・Dimensionsタグの属性（@PriceWeight）指定は任意です。
・Dimensions@PriceWeightと各タグの属性値＠Weightは、0～10の整数値で設定します。
数値が大きいほど優先度を高く検索します。
複数のパラメータを併用する場合、Weight値は重複しないように設定します。
| # | タグ | 属性 | 内容 |
| 1 | Dimensions | @PriceWeight | 金額優先 |
| 2 | .../TravelTime | @Weight | 飛行時間優先 |
| 3 | .../Carrier | @Weight | キャリア指定優先 |
| .../Carrier/Default | @Options | 1キャリアあたりのおおよその返却数指定 | |
| .../Carrier/Override | @Code | 特定航空会社とおおよその返却数指定 | |
| @Options | |||
| 4 | .../StopsNumber | @Weight | 直行便優先 |
DiversityControlのサポートツール
リクエストサンプル
当サンプルのレスポンスはGIR版となります。
OTA版をご希望の場合は、リクエスト内のResponseType（黄色ハイライト部分）を”OTA”と入力ください。
※JSON形式では、ResponseTypeはGIR版のみとなります。
【Carrier設定時のサンプル】
＜設定内容＞
・LowFareBucketを10（最安運賃計算で算出する旅程を約10旅程）
・Dimensions/Carrierのウェイトを10（Default@Options="10" 各キャリア約10旅程ずつ表示）
選択<OTA_AirLowFareSearchRQ Version="X.X.X" ResponseType="GIR" xmlns="http://www.opentravel.org/OTA/2003/05">
<POS>
<Source PseudoCityCode="8IC6">
<RequestorID ID="1" Type="1">
<CompanyName Code="TN" />
</RequestorID>
</Source>
</POS>
<OriginDestinationInformation RPH="1">
<DepartureDateTime>2022-08-01T11:00:00</DepartureDateTime>
<OriginLocation LocationCode="TYO" />
<DestinationLocation LocationCode="TPE" />
</OriginDestinationInformation>
<OriginDestinationInformation RPH="2">
<DepartureDateTime>2022-08-10T11:00:00</DepartureDateTime>
<OriginLocation LocationCode="TPE" />
<DestinationLocation LocationCode="TYO" />
</OriginDestinationInformation>
<TravelPreferences>
<CabinPref PreferLevel="Preferred" Cabin="Y" />
<TPA_Extensions>
<XOFares Value="true" />
<JumpCabinLogic Disabled="true" />
<KeepSameCabin Enabled="true" />
</TPA_Extensions>
</TravelPreferences>
<TravelerInfoSummary>
<SeatsRequested>1</SeatsRequested>
<AirTravelerAvail>
<PassengerTypeQuantity Code="ADT" Quantity="1">
</PassengerTypeQuantity>
</AirTravelerAvail>
</TravelerInfoSummary>
<TPA_Extensions>
<IntelliSellTransaction>
<RequestType Name="50ITINS" />
</IntelliSellTransaction>
<DiversityControl>
<LowFareBucket Options="10" />
<Dimensions>
<Carrier Weight="10">
<Default Options="10" />
</Carrier>
</Dimensions>
</DiversityControl>
</TPA_Extensions>
</OTA_AirLowFareSearchRQ>
選択{
"OTA_AirLowFareSearchRQ": {
"OriginDestinationInformation": [
{
"DepartureDateTime": "2022-03-01T00:00:00",
"OriginLocation": {
"LocationCode": "TYO"
},
"DestinationLocation": {
"LocationCode": "TPE"
},
"RPH": "0"
},
{
"DepartureDateTime": "2022-03-06T00:00:00",
"OriginLocation": {
"LocationCode": "TPE"
},
"DestinationLocation": {
"LocationCode": "TYO"
},
"RPH": "1"
}
],
"POS": {
"Source": [
{
"PseudoCityCode": "8IC6",
"RequestorID": {
"CompanyName": {
"Code": "TN"
},
"ID": "1",
"Type": "1"
}
}
]
},
"TPA_Extensions": {
"IntelliSellTransaction": {
"RequestType": {
"Name": "50ITINS"
}
},
"DiversityControl":{
"LowFareBucket":{
"Options":"10"
},
"Dimensions":{
"Carrier":{
"Default":{
"Options":"10"
},
"Weight":10
}
}
}
},
"TravelPreferences": {
"CabinPref":[
{
"Cabin":"Y",
"PreferLevel":"Preferred"
}
],
"TPA_Extensions": {
"XOFares":{
"Value":true
},
"JumpCabinLogic":{
"Disabled":true
},
"KeepSameCabin":{
"Enabled":true
}
}
},
"TravelerInfoSummary": {
"AirTravelerAvail": [
{
"PassengerTypeQuantity": [
{
"Code": "ADT",
"Quantity": 1
}
]
}
]
},
"Version": "4"
}
}