Cloudbeds データリファレンス
Cloudbeds から Klaviyo に同期されるデータと、その閲覧場所を確認します。これには、予約、ゲスト情報、メールの同意が含まれます。まだの方は、この記事を読み進める前に、まず連携手順を段階的に説明した Cloudbeds のスタートガイドをお読みください。
送信頻度
Cloudbedsと連携すると、Klaviyoは過去の宿泊者データを同期し、予約データについては約2年分を遡って取得します。今後は、予約データと宿泊者データがリアルタイムで同期されます。
Cloudbeds データの表示方法
Cloudbeds のデータを表示するには：
- [分析]>[メトリック] に移動します。
- ここでは、あなたのアカウント内のすべてのメトリックを表示できます。Cloudbeds アイコンが付いたメトリックは、Cloudbeds 外部連携から同期されたすべてのメトリックを表します。
- 外部連携フィルターを使用し、Cloudbedsを選択して、Cloudbedsのメトリックのみを表示します。
客室宿泊数メトリック
以下の宿泊数メトリック（予約関連）は Cloudbeds から同期されます。
- Confirmed Room Night
Cloudbeds でゲストが予約を確定すると、ルームナイトごとに 1 つの Confirmed Room Night イベントを作成します（例：2 室を 2 泊で予約した場合、イベントは 4 件になります）。 - 完了した客室宿泊数
ゲストが Cloudbeds でチェックアウトすると、宿泊数 1 泊ごとに 1 つの 完了した客室宿泊数 イベントを作成します（例：2 部屋を 2 泊で予約した場合は 4 つのイベントになります）。
Cloudbedsでは、ルームレートが設定されている宿泊日のみ、客室泊イベントが同期されます。レートがない宿泊日は除外されます。
Confirmed Room Nightイベントの日付は、予約の作成日時に基づきます。完了したRoom Nightイベントは、ゲストがチェックアウトした時点で同期されますが、宿泊施設のタイムゾーンにおける各宿泊日の23:59に日付が設定されます。
これらの各メトリックについて、以下の最上位プロパティが Klaviyo に同期されます：
- 値
特定の夜の客室の合計金額（例：客室収益）。 - Id
ルームナイトに関連付けられた Klaviyo 生成の ID。 - ReservationID
PMS の予約に関連付けられている ID。 - StartDate
夜が始まる日付。 - EndDate
宿泊日の終了日。 - DayOfWeek
夜が始まる曜日（例：月曜日）。 - AdultCounts
部屋にいる大人の人数。 - ChildCounts
部屋にいる子どもの数。 - PersonCounts
部屋内の人数（例：成人と子どもの合計）。 - RoomTypeName
Cloudbedsに保存されている部屋タイプ名。 - PropertyID
ホテルに対応する ID。 - PropertyName
ホテルの施設プロパティに対応する名前。 - Source
予約が行われたソース（例：「Website/Booking Engine」）。 - MarketCode
部屋のマーケットコード。
予約メトリック
次の予約メトリックは Cloudbeds から同期されます：
- 予約の作成
Cloudbedsで未確定ステータスの予約が作成されたとき。過去データの同期では、他のステータスの予約についてもこのイベントが作成されます。 - Confirmed Reservation
Cloudbeds でゲストの予約が確定したとき。 - Checked In to Reservation
ゲストが予約にチェックインしたとき。 - 予約のチェックアウト完了
ゲストが予約のチェックアウトを行ったとき。 - 予約キャンセル
ゲストまたは管理者がゲストの予約をキャンセルした場合。 - ノーショー予約
ゲストが予約に現れない場合。
これらの各メトリックについて、以下の最上位プロパティが Klaviyo に同期されます：
- 値
予約の合計金額。 - 予約 ID
Cloudbeds の予約 ID。 - 宿泊数
予約の宿泊数。 - プロパティ ID
予約が行われた宿泊施設のプロパティの ID（例：「12345」）。 - プロパティ名
予約が行われた施設のプロパティ名（例：「メイン州のブティック ホテル」）。 - プロパティ画像
Cloudbedsのプロパティ画像のリストです（画像URLを含む）。 - Source
予約が行われたソース（例：「Website/Booking Engine」）。 - ソース ID
予約のソースの ID（例: “s-1”）。 - 出所
予約の出所（例：“Expedia”）。 - サードパーティ識別子
予約がオンライン旅行代理店（OTA）経由の場合、そのシステム内での予約の ID。 - 到着予定時刻
ゲストが施設に到着する推定時刻。 - Start Date
予約の開始日。 - 終了日
予約の終了日です。 - 割り当てブロック コード
予約で使用された割り当てブロック コード。 - 追加商品の金額
ゲストが予約時に購入したすべての追加オプションの金額。 - 追加商品のアイテム数
ゲストが予約時に購入した追加商品の合計数です。 - 予約の人数
予約で割り当てられた部屋にいる人数です。割り当て済みの部屋の人数が利用できない場合、これは1になります。 - 予約の大人の人数
予約内で割り当てられた部屋にいる大人の人数。割り当て済みの部屋の人数が利用できない場合、これは1になります。 - 予約の子どもの人数
予約で割り当てられた客室にいる子どもの人数です。割り当て済みの部屋数のカウントが利用できない場合、これは0です。
予約オブジェクト
Cloudbeds 外部連携の最新バージョン（アップグレード ガイド）では、Cloudbeds から予約オブジェクトが同期されます。これらには次のフィールドがあります：
- 値
予約の合計金額。 - ValueCurrency
Cloudbedsでプロパティに設定されている通貨コードです。 - ReservationID
Cloudbeds の予約 ID。オブジェクト ID として使用されます。 - ReservationStatus
予約の現在のステータス。 - ReservationNights
予約の泊数。 - PropertyID
予約が行われたプロパティの ID（例：“12345”）。 - PropertyName
予約が行われた施設のプロパティ名（例：「メイン州のブティック ホテル」）。 - PropertyImage
施設のメイン画像 URL。 - Source
予約が行われたソース（例：「Website/Booking Engine」）。 - SourceID
予約のソースの ID（例: “s-1”）。 - 出所
予約の出所（例：“Expedia”）。 - ThirdPartyIdentifier
予約がオンライン旅行代理店（OTA）からのものだった場合、そのシステムにおける予約の ID です。 - EstimatedArrivalTime
ゲストがプロパティに到着する予定時刻。 - StartDate
予約の開始日。 - EndDate
予約の終了日。 - AllotmentBlockCode
予約で使用された割り当てブロック コード。 - RoomTypeName
予約で最初に割り当てられた部屋の部屋タイプ名です。 - AdditionalProductsValue
ゲストが予約時に購入したアドオンの値。 - AdditionalProductsItemCount
予約に含まれる追加商品のエントリー数です（数量の合計ではありません）。 - ReservationPersonCounts
予約に含まれる人数の合計。 - ReservationAdultCounts
予約に含まれる大人の合計人数。 - ReservationChildCounts
予約に含まれる子供の合計数。
ゲスト データ
Klaviyoは、ゲストに有効なメールアドレスまたは電話番号がある場合に、Cloudbedsからゲストデータを同期します。匿名化されたゲストレコードは除外されます。Booking.comやExpediaなどの既知のオンライン旅行代理店（OTA）ドメインのマスクされたメールアドレスは除外されますが、有効な電話番号を持つゲストは、電話番号のみのプロファイルとして引き続き同期できます。予約メトリック、宿泊数メトリック、予約オブジェクトには、OTA以外のメールアドレスが必要です。
OTA経由で予約したゲストが、後からCloudbedsで実際のメールアドレスを提供した場合（例：チェックインフォーム経由）、Klaviyoはそのプロファイルを作成または更新します。最新バージョンの外部連携では、Klaviyoは過去の予約も予約オブジェクトとしてバックフィルするため、日付ベースのセグメントやフローで使用できます。今後の予約はこれまでどおり同期されます。
次のゲストデータを Klaviyo プロファイルに同期します：
- メール
- 電話番号
- 名
- 姓
- 番地等
- 市区町村
- ステータス
- 郵便番号
- 国
- Cloudbeds ゲスト ID
- Cloudbeds 性別
- Cloudbeds バースデー
- Cloudbeds 会社名
- Cloudbeds の特別リクエスト
- Cloudbeds 主なゲスト
- Cloudbeds カスタムフィールド
- Cloudbeds 作成日
- メールの同意
Cloudbedsでメールマーケティングにオプトインしたゲストは、Cloudbedsのメール購読者をKlaviyoに同期を有効にしてリストを選択すると同期されます。Cloudbedsでゲストのメールのオプトインをオフにしても、Klaviyoで購読解除にはなりません。
Cloudbeds から SMS 同意は同期されませんのでご注意ください。
その他のリソース
- Cloudbeds のスタートガイド
予約管理プラットフォームである Cloudbeds と Klaviyo を外部連携する方法をご覧ください。Klaviyo は Cloudbeds からゲスト、メール購読者、予約を同期するため、ゲスト向けメッセージをパーソナライズできます。