ツアー・アクティビティAPI
旅行会社向けViator API連携
Viator Partner APIを通じて、Viatorのツアー、観光スポット、アクティビティをPHPTRAVELSの予約サイトに追加できます。Viatorが商品、料金、行程、レビューを提供し、PHPTRAVELSが検索、マークアップ、通貨、予約記録を担います。
- ツアーカテゴリのViatorモジュール
- サンドボックスと本番のエンドポイント
- すべてのViator料金にマークアップ
- 行程、含まれるもの、レビュー
仕組み
自社の旅行サイトでViatorの体験を販売
Viator API連携は、予約サイトとViatorのパートナーアカウントを接続し、ツアーやアクティビティを航空券やホテルと並べて表示します。PHPTRAVELSにはツアーカテゴリのViatorモジュールがあります。管理画面にViatorのAPIキーを貼り付け、サンドボックスか本番環境を選ぶと、目的地検索でマークアップ適用済みのViator商品が返るようになります。パートナー権限と予約モデルはViatorが付与するため、ローンチ計画の前にアカウントの種類を確認してください。
- Viatorのパートナープログラムに申し込み、APIキーを受け取る
- PHPTRAVELS管理画面のModulesを開き、Viator設定にキーを入力する
- サンドボックス環境を選んで保存し、認証情報チェックを実行する
- マークアップを設定し、主要な目的地で検索をテストする
- 結果と料金に問題がなければ本番環境に切り替える
- 環境
- サンドボックス
- エンドポイント
- Partner API v2 · api.sandbox.viator.com
- APIキー
- ••••••••-••••-••••
- マークアップ
- Viator料金に10%
- 表示通貨
- 顧客のセッション通貨
検索と詳細
ツアー検索結果にViator商品を、顧客が確認する詳細とともに
各Viator結果にはタイトル、最低料金、所要時間、評価、画像が含まれ、詳細ページでは含まれるもの、含まれないもの、行程の立ち寄り先、キャンセルポリシーが加わります。
- 4.7★ディナー付きイブニング砂漠サファリ6時間 · 評価4.7 · 無料キャンセル$72大人1名
- 4.5★ドバイ・マリーナのダウ船ディナークルーズ2時間 · 含まれるもの・含まれないもの記載$58大人1名
- ドバイ発アブダビ日帰りツアー10時間 · 地図上の立ち寄り先付き行程$115大人1名
目的地検索
目的地と日付をViatorのフリーテキスト商品検索に送信し、料金と評価のフィルター、1ページ最大100件に対応します。
所在地チェック
結果を商品の住所とタイトルにある目的地と照合し、関係のないツアーを一覧から除外します。
商品の詳細情報
詳細ページでViator商品の説明、含まれるもの、含まれないもの、行程項目を読み込み、Viatorが提供する場合は地図上の地点も表示します。
評価とレビュー
各ツアーにViatorの平均評価とレビュー総数を表示し、顧客が体験を比較できます。
キャンセルポリシー
Viatorのキャンセルポリシー本文をツアーに表示し、商品のポリシー種別から返金可否を示します。
マークアップと通貨
Viatorの最低料金にマークアップを加えて顧客の通貨に換算し、仕入れ値も併せて保存します。
予約の流れ
Viator検索から予約記録まで
標準モジュールで、1つのViator商品がサイト内をたどる流れです。
検索
目的地、日付、旅行者をViatorに送り、該当する商品が返ります。
料金
各最低料金にマークアップと通貨換算を適用します。
詳細
顧客が商品を開き、行程、含まれるもの、キャンセルポリシーを確認します。
記録
旅行者、仕入れ値、販売価格とともに予約記録を管理画面に保存します。
Viatorで完了
顧客は新しいウィンドウでViatorの商品ページに移動し、予約を完了します。
役割分担
Viator API連携で誰が何を担うか
Viator接続を機能させるには、予約プラットフォーム、承認済みのViatorパートナーアカウント、そして誰が決済を受けるかの明確な取り決めが必要です。
PHPTRAVELS：予約プラットフォーム
サイト、Viatorモジュール設定、マークアップ、通貨、ツアーページ、予約記録。その他のB2C・B2Bツールはご利用パッケージによります。
Viator：体験コンテンツ
Partner APIを通じた商品、料金、行程、レビュー、キャンセルポリシー。アクセスレベルと予約条件はViatorが定めます。
貴社：商取引の運用
販売価格、顧客対応とサポート。Viatorとの変更やキャンセルを誰が担当するかも含みます。
バックオフィス
Viatorの販売を管理画面から運用
Viator商品の認証情報、料金、予約記録を、自社ツアーや他のサプライヤーと同じダッシュボードで管理できます。
モジュール設定
APIキーと環境をModulesに保存し、認証情報チェックで公開前にダミーのキーを拒否します。
仕入れ値と販売価格
各予約記録に大人・子どものViator料金とマークアップ後の価格を並べて保存し、予約ごとの利益を確認できます。
通貨
Viatorの料金を商品の通貨から顧客のセッション通貨に換算し、両方の通貨を保存します。
自社ツアーと並べて
Viator商品はツアーモジュールで作成した自社ツアーと並び、検索も管理画面も一つです。
Viator Merchantモジュール
別モジュールで、そのモデルのアカウント向けにViator Merchant APIキーとMerchant IDを保存・確認します。
自社サイトでの決済
自社のチェックアウト内での決済とViator予約の確定は、プロジェクトごとにカスタマイズとして見積もります。
比較
Viator APIで自社開発する場合とPHPTRAVELSの比較
Viatorが提供するのは商品APIで、その周りの予約サイトは別に必要です。PHPTRAVELSと比べた独自開発の一般的な作業内容です。
| 項目 | Viator APIでの独自開発 | PHPTRAVELS |
|---|---|---|
| ツアーサイト | Viator APIでの独自開発検索、結果、商品ページをゼロから設計・開発 | PHPTRAVELSブランド対応のツアー検索、結果、詳細ページを用意済み |
| Viator接続 | Viator APIでの独自開発検索、商品詳細、料金の呼び出しを自社で実装・テスト | PHPTRAVELSサンドボックス、認証チェック、マークアップ付きの既存Viatorモジュール |
| 商品コンテンツ | Viator APIでの独自開発行程、含まれるもの、レビューのマッピングはこれから | PHPTRAVELS含まれるもの・含まれないもの、行程、レビュー、ポリシーを対応済み |
| 管理と利益 | Viator APIでの独自開発予約記録と料金ルールはこれから構築 | PHPTRAVELSすべての予約に仕入れ値と販売価格を保存 |
| その他の商品 | Viator APIでの独自開発航空券、ホテル、自社ツアーは別プロジェクト | PHPTRAVELS航空券、ホテル、レンタカー、自社ツアーのモジュールが同じ環境に |
活用例
ViatorをPHPTRAVELSに接続する事業者
オンライン旅行会社
航空券やホテルの隣に現地アクティビティを加え、旅行者が一つのサイトで旅程全体を計画できます。
ランドオペレーター（DMC）
すべてのツアーを自社で催行していない目的地で、自社の観光とViator商品を組み合わせます。
旅行メディア運営者
目的地ガイドを予約サイトに変え、扱う都市ごとにViatorの体験を掲載できます。
PHPTRAVELSを選ぶ理由
Viatorアカウントもプラットフォームもコードも貴社のもの
ソースコード付き
商用ライセンスでセルフホストでき、開発者がViatorの流れを拡張できます。
貴社のViator認証情報
APIキーは貴社が保持し、自社環境に保存され、保存時に確認されます。
まずサンドボックスで
モジュールを本番に切り替える前に、Viatorのサンドボックスエンドポイントでテストできます。
B2CとB2B
一般向けサイトとエージェントポータルを一つの環境で、24言語に対応。
ツアーカテゴリのViatorモジュールを通じて、Viator Partner APIをPHPTRAVELSの予約プラットフォームに接続するものです。Viatorが料金、行程、レビュー付きのツアーとアクティビティを提供し、PHPTRAVELSがサイト、マークアップ、通貨、予約記録を提供します。
ViatorはパートナープログラムでAPIアクセスを付与します。承認後に受け取るAPIキーをViatorモジュールの設定に入力します。参加資格、アクセスレベル、商取引条件はViatorに直接ご確認ください。
はい。モジュールはViatorのサンドボックスエンドポイントと本番のどちらにも接続でき、認証情報チェックは選択した環境で実行されます。検索と料金をテストしてから本番に切り替えてください。
標準モジュールでは、PHPTRAVELSが旅行者と料金を含む予約記録を保存し、その後Viatorの商品ページを開いて顧客がそこで予約を完了します。自社チェックアウト内での決済と確定はカスタマイズとして見積もります。
はい。PHPTRAVELSのツアーモジュールで作成した自社ツアーとViator商品は同じ検索と管理画面を共有し、Tiqetsも別のツアーサプライヤーとして利用できます。
Viator専用のガイドはdocs.phptravels.comでまだ公開されていません。設定はモジュール設定でAPIキーと環境を指定するだけで、導入時にはPHPTRAVELSチームがサポートできます。