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のサポートツール

API Tester
DiversityControlをGUI画面で設定し、
リクエスト実施・レスポンス内容の確認が可能な
開発支援ツールです。
 
詳細はこちら

リクエストサンプル

当サンプルのレスポンスは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"
    }
}