Oracle OPERAのスタートガイド
概要
ホテルや複数施設を運営するホスピタリティグループで使用されるプロパティ管理システム(PMS)であるOracle OPERA CloudとKlaviyoを連携する方法をご覧ください。Klaviyoは、OPERAからゲストのプロファイル、メールとテキストメッセージの購読者、ロイヤルティメンバーシップ、予約、施設内での購入(飲食、ミニバー、宴会料金など)を同期するため、滞在前、滞在中、滞在後にゲスト向けメッセージをパーソナライズできます。
KlaviyoのOracle OPERA外部連携は、複数施設を持つチェーン向けに構築されています。OPERAチェーンを一度接続し、その後、そのチェーン内のどのホテルが予約データをKlaviyoに同期するかを選択します。宿泊客のプロファイルとロイヤルティメンバーシップはチェーンレベルで同期されるため、複数のお客様のホテルに宿泊する宿泊客も、Klaviyoでは1つのプロファイルになります。
注: KlaviyoのOracle OPERA外部連携を使用するには、OPERA環境にレポート作成 & 分析モジュールが必要です。
この外部連携について
Oracle OPERAをKlaviyoに接続すると、ホテルの予約、ゲスト、ロイヤルティ、支出データが自動的にKlaviyoに取り込まれます。そのため、手動でエクスポートしなくても、実際のゲスト行動(予約の確定、到着予定、滞在完了、館内での購入)に基づいてメールマーケティングとSMSのプログラムを構築できます。
接続すると、Klaviyoは3種類のOPERAデータを同期します:
- 予約:接続した施設でのすべての予約(現在のステータス(確定、チェックイン、チェックアウト、キャンセル、またはノーショー)を含む)。
- ゲストプロファイル:ロイヤルティプログラムのメンバーシップを含む、アクティブな個別ゲストプロファイル。
- フォリオアクティビティ:対象となる施設内料金(飲食、ミニバー、宴会、その他の収益計上)を判定し、宿泊客の支出を把握して対応できます。
始める前に
始める前に、以下をご用意ください。
- Oracle OPERA Cloudアカウント(施設またはチェーンでレポート作成 & 分析(R&A)データAPIが有効化されていること)。この外部連携はOPERA Cloudのみに対応しています。OPERA 5およびオンプレミス版のOPERAはサポートされていません。
- Oracle Data API(Oracle OPERAにより有効化)。
- OPERA環境向けのOHIP開発者ポータルへのアクセス。パートナーからのリクエストを承認し、クライアント認証情報を発行する権限が必要です。
- Klaviyoのアクセス承認。設定を開始する前に、各OPERA環境のEnterprise ID、チェーンコード、リージョンをoracle-opera@klaviyo.comにメールで送信してください。Klaviyoがアクセスをリクエストし、お客様はOPERAの開発者ポータルでそのリクエストを承認します。
- 各OPERA環境の接続情報。OPERA開発者ポータルで次を見つけてください:
- クライアント ID
- クライアントシークレット
- ゲートウェイURL:OPERA Cloud APIゲートウェイのアドレス(例:
https://yourhotel-api.us-ashburn-1.ocs.oraclecloud.com)。 - Enterprise ID:OPERA Cloudテナントの識別子
- チェーンコード。OPERAのチェーンコード(どのコードがチェーンに適用されるか不明な場合は、Oracle担当者にご確認ください)。
- 同期する各施設のホテルID。OPERAでは、ホテルIDは施設(リゾート)コードです。
- (任意)購読者向けのKlaviyoリスト。OPERAのメールまたはテキストメッセージの購読者を同期する予定がある場合は、開始前に、追加先にしたいリストを作成してください。
- OPERAから同期されるゲストにオプトイン確認メッセージが送信されないように、各リストをシングルオプトインに設定してください。
ステップ1:Oracle OPERAの資格情報を追加する
- Klaviyo にログインします。
- [外部連携] タブを選択します。
- [アプリを探す] をクリックします。
- アプリマーケットプレイスでOracle OPERAを検索し、カードを選択します。
- [接続]をクリックします。
- 新しい環境で、Client ID、Client secret、Gateway URL、Enterprise ID、チェーンコードを入力します。
- 複数のOPERA環境を接続するには、別の環境を追加をクリックし、詳細を入力します。
- [Oracle OPERAに接続]をクリックします。

![Client ID、Client secret、Gateway URL、Enterprise ID、Chain codeの入力フィールドを備えたソフトウェアインターフェースの[環境を追加]ポップアップウィンドウ。](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/377f567824f50c13011f421162dc1f043dd5ccd8-1486x955.png?w=1600&auto=format)
ステップ2:Klaviyoへのアクセスを認可する
Oracle OPERAがお客様のKlaviyoアカウントにアクセスできるよう、許可を求められるのは1回のみです。[許可]をクリックしてください。
![Oracle OPERAがアカウント情報にアクセスする権限を求めるKlaviyoの認可プロンプトで、[拒否]または[許可]を選択できます。](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/49d4adcaaae03286b4942352d24ee5d63b364e45-1440x1018.jpg?w=1600&auto=format)
ステップ3:環境ごとにホテルIDを追加する
アクセスを承認したら、接続した各環境のHotel IDを追加します。追加したホテルのみが、予約データとフォリオデータをKlaviyoに同期します。
ホテルはいつでも追加できます。後で別の環境に接続するには、Oracle OPERAの設定ページで環境を追加をクリックします。

手順4(任意):メールとテキストメッセージの購読者を同期
購読者の設定は、すべての環境のゲストに適用されます。Oracle OPERAの設定ページで、購読者を収集の下にあります:
- OPERAのメール購読者をKlaviyoに同期にチェックを入れ、追加先のKlaviyoリストを選択します。
- OPERAのテキストメッセージ購読者をKlaviyoに同期をオンにして、追加先のKlaviyoリストを選択します。

注:テキストメッセージの購読者を同期するには、事前にKlaviyoアカウントでテキストメッセージを設定しておく必要があります。
Klaviyoはゲストを一度だけ購読します。Klaviyoですでにそのプロファイルに対する同意に関する判断を行っている場合、OPERAはそれを上書きしません。ゲストが後からOPERAでメールの受信をオプトアウトした場合、Klaviyoはそのゲストをリストから削除して購読解除します。ただし、最初にこの外部連携によって購読された場合に限ります。SMS同意の同期は一方向のみ(オプトイン)です。現時点でOPERAには、SMSのオプトアウトを通知する方法がありません。
ステップ5:動作していることを確認する
接続後の初回同期には、Klaviyoが新しいアクティビティだけでなく履歴も取り込むため、しばらく時間がかかることがあります:
- 予約とフォリオアクティビティは、ホテルごとに最大3年分の履歴を遡って取り込みます。
- ゲストプロファイルでは、参照期間の上限なく、すべての履歴がバックフィルされます。
- 初回のバックフィル後は、3つすべてが新規および更新されたレコードを取得するために、おおむね1時間に1回同期します。
データが流れていることを確認するには:
- Analytics > メトリックに移動し、Created Reservation、Confirmed Reservation、注文の確定を探します。予約とフォリオの計上が入ると、イベントが表示されるはずです。OPERAメトリックのみを表示するには、すべての外部連携ドロップダウンを使用して、Oracle OPERAを選択します。

- [オーディエンス] > [プロファイル]に移動し、OPERAにいることが分かっているゲストを検索します。予約履歴と宿泊履歴がプロファイルのタイムラインに表示されます。
- Content > Objectsに移動し、Reservationレコード(および、ゲストがロイヤルティメンバーシップに加入している場合はLoyaltyAccountレコード)を探します。
注:初回接続後、データが表示されるまで最大1時間かかることがあります。特に、予約履歴が多い大規模な施設では一般的です。
Klaviyoに同期される内容
イベント(メトリック)
イベント | 発生条件 |
|---|---|
予約作成 | 新しい予約が作成されました |
予約確定 | 予約が確定した |
予約にチェックイン | ゲストがチェックインする |
予約をチェックアウト | ゲストがチェックアウトする |
予約キャンセル | 予約がキャンセルされる |
予約の無断キャンセル | ゲストが確認済みの予約に来ない |
宿泊確認済み | 確定済みの予約に対して、客室1室につき1泊1回 |
宿泊完了 | 客室1室につき1泊1回、チェックアウト後 |
注文の確定 | 対象となるフォリオの記帳(施設内請求)が行われる |
購入商品 | フォリオ計上内の各項目/単位につき1つ |
プロファイル
アクティブな個別のゲストプロファイルは、Klaviyoプロファイルとして同期されます。ゲストを同期するには、使用可能なメールアドレスまたは電話番号が必要です。どちらもないゲストはKlaviyoで作成されません。後からOPERAで使用可能なメールまたは電話番号でゲストが更新された場合、Klaviyoが自動的に追従し、直近の予約履歴と注文履歴を補完します。
カスタムオブジェクト
- 予約:予約ごとに1件。宿泊日、部屋の詳細、料金、ステータスが含まれます。
- LoyaltyAccount:ロイヤルティメンバーシップごとに1つ。ロイヤルティプログラムに登録されているゲストが対象です。
デフォルトのセグメント
Oracle OPERAを接続すると、すぐに使えるセグメント一式がアカウントに追加されます:
セグメント | 含まれる対象 |
|---|---|
初回購入者(Oracle OPERA) | メールマーケティングを受信できる、確定済みの予約がちょうど1件のゲスト |
リピート顧客(Oracle OPERA) | メールマーケティングを受信でき、確定済みの予約が2件以上あるゲスト |
VIP顧客(Oracle OPERA) | メールマーケティングを受信できる、確定済みの予約が5件を超えるゲスト |
チャーンリスク(Oracle OPERA) | 過去90日間に少なくとも2通のメールも受信しており、開封がないゲストを呼び戻す |
ウィンバックの機会(Oracle OPERA) | 以前に予約の確認を行ったことがあるが、過去180日間は行っておらず、メールマーケティングを受信できるゲスト |
現在のゲスト(Oracle OPERA) | 過去90日以内に到着し、今後90日以内に出発する予約のあるゲスト |
今後のゲスト(Oracle OPERA) | 今後の予約のあるゲスト |
現在および今後のゲスト(Oracle OPERA) | 現在または今後のゲスト |
これらをフローやキャンペーンの出発点として使用するか、ビジネスに合わせてカスタマイズできます。
Oracle OPERAのデータを使用して宿泊客をセグメント化する
デフォルトのセグメントを編集するか、OPERAのメトリックとオブジェクトを使用して独自のセグメントを作成できます。たとえば、特定のホテルで予約の確認が完了しているゲストのセグメントを作成するには、次のようにします:
- [オーディエンス] > [リスト & セグメント] に移動します。
- [作成]をクリックし、[新しいセグメントを作成]を選択します。
- セグメントに名前を付け、必要に応じてタグを選択します。
- 次の定義とフィルターを選択します。
- 顧客行動履歴(実行・未実行) > 確定済みの予約(Oracle OPERA) > 全期間に少なくとも1回
- 次の場合 > PropertyName > 次と等しい > (ホテル名)
- [セグメントを作成] をクリックします。
オブジェクトを使用すると、到着予定があるゲストのセグメントを作成できます:
- [オーディエンス] > [リスト & セグメント] に移動します。
- [作成]をクリックし、[新しいセグメントを作成]を選択します。
- セグメントに名前を付け、必要に応じてタグを選択します。
- 次の定義とフィルターを選択します。
- プロパティ情報 > 予約(Oracle OPERA) > 少なくとも 1 件
- where > ArrivalDate > 今後 > 5200週間
- [セグメントを作成] をクリックします。
フローでOracle OPERAデータを使用する
Oracle OPERAのデータを使用して、フロー(自動化された一連のアクション)をトリガーできます。Klaviyoには、Oracle OPERAのデータを使用する事前構築済みフローが複数あり、以下が含まれます:
- ウェルカムシリーズ
- 予約確認
- 到着前
- 予約のチェックイン
- 予約のチェックアウト
- ゲストへの感謝
- 予約キャンセル
- ゲストの再獲得
- ハッピーバースデー
これらの構築済みフローを表示する手順は以下のとおりです。
- Klaviyo で、[フロー] タブを選択します。
- [フローを作成] をクリックします。
- Oracle OPERAで絞り込むと、Oracle OPERAのフローがすべて表示されます。

また、任意のOracle OPERAメトリック、またはReservationオブジェクトの日付をトリガーとして使用し、独自のフローを作成することもできます。たとえば、到着前フローを作成するには:
- フロー > フローを作成 > 独自に構築に移動します。
- フローに名前を付け、タグを選択します(任意)。
- Date propertyトリガーを選択します。
- Date propertyドロップダウンから、Oracle OPERA, Reservation: ArrivalDateを選択します。
- フローを開始するタイミング(例:7日前)を選択してください。
- メッセージを追加してください。
注:すべての予約イベントには、予約された客室タイプの画像URLを含むRoomInfoURLプロパティが含まれます。そのため、確認メッセージや到着前メッセージで宿泊客に客室の写真を表示できます。
良いこと
- 複数のプロパティとアカウント。複数のOPERAアカウントを接続し、それらのアカウントにまたがる任意の数のホテルを、1つのKlaviyoアカウントから同期できます。
- 連絡先情報のないゲスト。使用できるメールアドレスまたは電話番号がないゲストには、Klaviyoでプロファイル、イベント、またはオブジェクトが作成されません。後で状況が変わった場合、Klaviyoは次回のプロファイル同期でそれを検出します。
- サードパーティの予約メール。予約に、ゲスト本人のメールアドレスではなくオンライン旅行代理店(OTA)のリレー経由のメールアドレスしか含まれていない場合、Klaviyoはそれをゲストのメールアドレスとして使用しません。代わりに、Klaviyoは電話番号でゲストを識別しようとします。
- 仮予約/未確定の予約。仮押さえ(未確認)の予約では、Created Reservationイベントのみが生成されます。確定されるまで、残りのライフサイクルイベントには進みません。
- フォリオアクティビティ。同期されるのは特定の請求タイプ(飲食、ミニバー、宴会、およびその他の対象となる収益計上)のみで、対象は個別のゲストに限られます。フォリオ上のすべての明細行が同期されるわけではありません。
トラブルシューティング
接続しましたが、まだデータが表示されません。しばらくお待ちください。初回の同期では履歴データが取り込まれ、予約アクティビティが多いプロパティの場合はしばらく時間がかかることがあります。数時間以上経っても何も表示されない場合は、各環境に対して少なくとも1つのホテルIDを追加していることを再確認してください。
OPERAにいるはずのゲストがKlaviyoに表示されません。そのゲストのOPERAプロファイルに、使用可能なメールアドレスまたは電話番号があるか確認してください。どちらもないゲストは同期されません。また、ゲストのプロファイルがアクティブで、かつ個人のゲストプロファイル(会社、旅行代理店、その他のゲスト以外のプロファイルタイプではない)であることも確認してください。
メール/SMS購読者がリストに同期されません。上記の手順4で、購読者の同期オプションにチェックが入っていることと、リストを選択していることを確認してください。これをオンにする前に、ゲストの購読に関する決定がすでにKlaviyoに記録されていた場合、Klaviyoはそれを変更しません。
一部のフォリオ料金が表示されません。想定内です。同期されるのは特定の収益を生み出す料金タイプのみであり、非収益または非アクティブな明細行は意図的に除外されます。
その他のリソース
その他のリソース
- 外部連携の同期頻度のリファレンス
特定の Klaviyo 外部連携から同期されるデータと、同期が実行される頻度について確認してください。これらの外部連携は、E コマースプラットフォーム、メール送信プロバイダー、その他のデータ外部連携別に整理しています。
- Klaviyo が構築した外部連携を編集、無効化、または削除する方法
アカウントの [外部連携] タブで、Klaviyo が構築した外部連携を編集、無効化、または削除する方法をご覧ください。
- カスタム オブジェクトのスタートガイド
カスタムオブジェクトについて確認します。カスタムオブジェクトを使用すると、複数のプロパティを 1 つの「object」に保存し、関連付けることができます。カスタムオブジェクトを使用すると、プロファイルプロパティでは保存できない多様な多重リレーションのデータ概念を Klaviyo にマッピングできます。その後、メッセージやセグメントなどでカスタムオブジェクトを使用できます。