# Real-Time 2.0 入門ガイド

このガイドでは、Real-Time 2.0 を正常に実装するために必要な前提条件、セットアップワークフロー、設定制限、およびベストプラクティスについて説明します。このガイドを使用して、Real-Time 2.0 のデプロイを計画・実行してください。

**Real-Time 2.0 が初めての方へ：** まず [Real-Time 2.0 概要](/ja/products/customer-data-platform/real-time/real-time) をご覧いただき、Real-Time 2.0 とは何か、ビジネスにどのような価値をもたらすかをご確認ください。

## 前提条件

Real-Time 2.0 を設定する前に、以下を確認してください。

### 必須

- **Parent Segment の作成：** 少なくとも1つの Parent Segment が作成済みであること。リアルタイム機能は Parent Segment 単位で有効化されます。
- **管理者アクセス：** Parent Segment のオーナーが Treasure Data の管理者であるか、リアルタイム機能を有効化するための管理者権限を持っていること。
- **エンタープライズサポート契約：** Real-Time 2.0 の SLA 保証を受けるには、エンタープライズサポート契約が必要です（スタンダードサポートは対象外）。
- **リアルタイムイベント取り込みパス：** Real-Time 2.0 を動かすイベントは、Treasure Data JavaScript SDK v4+、Mobile SDK v1+、またはIngestion API 経由で取り込む必要があります。


### 推奨

- **プロファイルキー戦略：** リアルタイムを有効化する前に、プロファイルキー（プライマリ ID）を計画してください。有効化後は変更できません。
- **データ取り込みの設定：** サポートされているエンドポイントを使用して、リアルタイムデータ取り込み（Web トラッキング、モバイル SDK、またはIngestion API）を設定済みであること。
- **ユースケースの定義：** 実装したい具体的なユースケース（例：カート放棄、Web パーソナライゼーション）を特定してください。
- **チャネル統合：** 配信先チャネル（メール、SMS、パーソナライゼーションエンジン）が設定済みであること。


## セットアップワークフロー

Real-Time 2.0 を有効化・設定するための大まかな手順は以下のとおりです。

### ステップ 1：Parent Segment を作成する

Parent Segment がまだない場合は、Data Workbench を使用して作成してください。この Parent Segment には、リアルタイム判断に使用するバッチ顧客データが含まれます。

**重要な決定事項：**

- プロファイルキー（プライマリ ID）を定義する（後から変更不可）
- パーソナライゼーションやトリガーに必要な関連バッチ属性をすべて含める


**詳細：** [Parent Segment の作成](/products/customer-data-platform/data-workbench/parent-segments/creating-parent-segments)

### ステップ 2：リアルタイム有効化を依頼する

Treasure Data カスタマーサポートに連絡し、リアルタイム機能有効化を依頼してください。以下の情報を提供してください。

- 顧客アカウント情報
- 有効化対象の Parent Segment ID
- 注文書へのリンク
- アクティベーションに使用したいコネクター


このステップでは Parent Segment のリアルタイムインフラがプロビジョニングされ、数時間かかる場合があります。

### ステップ 3：リアルタイムデータを取り込む

顧客イベントをリアルタイムでキャプチャするデータ取り込みを設定します。

- Web サイトの行動データ用に Treasure Data JavaScript SDK v4+ を設定する
- アプリイベント用に Treasure Data Mobile SDK v4+ を設定する
- Ingestion API（Webhook やストリーミングプラットフォームなど）経由でバックエンドから他のシステムを統合する


### ステップ 4：リアルタイム処理用に Parent Segment を設定する

Data Workbench を使用して、リアルタイム処理用に Parent Segment を設定します。

1. **イベントテーブル：** リアルタイム処理をトリガーするストリーミングテーブルを指定する
2. **イベント定義：**（任意）トリガーロジックを絞り込むフィルタリングされたイベント定義を作成する
3. **属性：** バッチ属性をインポートし、リアルタイム属性を設定する
4. **[ID ステッチング](/ja/products/customer-data-platform/real-time/real-time-id-stitching-overview)：** 顧客プロファイルを識別・統合するための ID ステッチングキーを定義する
5. **プロファイルキー：** 顧客データ検索用のプロファイルキーを選択する


**詳細：** [Parent Segment の設定](/ja/products/customer-data-platform/real-time/creating-a-real-time-configuration)

### ステップ 5：ジャーニーとパーソナライゼーションを構築する

Parent Segment の設定が完了したら、以下が可能になります。

- トリガーアクティベーションを使用したリアルタイムジャーニーの作成
- パーソナライゼーションルールと API 統合の設定
- Web またはモバイルパーソナライゼーションのセットアップ


**詳細：**

- [リアルタイムジャーニーオーケストレーション](/products/customer-data-platform/journey-orchestration/realtime)
- [リアルタイムパーソナライゼーション](/ja/products/customer-data-platform/real-time/about-real-time-personalization)
- [リアルタイム属性](/ja/products/customer-data-platform/real-time/real-time-attributes-overview)


## 設定制限と動作仕様

これらの制限を理解することで、効果的な Real-Time 2.0 実装を設計できます。

| Category | Limit / Behavior | Notes |
|  --- | --- | --- |
| ID ステッチングキー | 最大 100 個の ID をステッチングキーとして定義可能 | 例：email、user_id、td_client_id。イベントをプロファイルに紐付けるために使用。 |
| バッチ ID 同期（初期化） | 任意。リアルタイムへの継続性確保のためにバッチ ID グラフをインポート可能 | 既存のバッチ ID をリアルタイムで利用する必要がある場合に推奨。 |
| プロファイルキー（プライマリ ID） | Parent Segment 作成時に定義。後から変更不可 | バッチとリアルタイムデータ間の主要な結合キーを決定。 |
| イベントテーブル | Parent Segment あたり最大 100 テーブル | バッチおよびリアルタイムイベントテーブルの両方に適用。 |
| イベント定義 | ハードリミットなし | 定義全体のフィルター文字列の合計が 1000 文字以内であること。 |
| 属性バックフィル | バッチ属性に対応 | バックフィルを使用して既存のバッチデータから RT 属性に値を事前入力可能。 |
| バッチ属性のインポート | 対応 | バッチテーブルに新しく追加されたフィールドは、セグメント更新後に利用可能になる。 |
| 新規イベントフィールド | データベースに自動的に追加される | パーソナライゼーションやトリガーで使用するには、RT 属性として明示的に設定が必要。 |
| マルチアカウントデプロイ | CI/CD パイプライン経由でサポート | 設定を1つの環境からエクスポートし、別の環境で再利用可能。 |


### 重要な動作仕様

**プロファイルキーの選択**

- Parent Segment のセットアップ時に選択し、リアルタイム有効化後は**変更不可**
- ID ステッチングキーかつ Parent Segment の属性である必要がある
- 顧客プロファイル検索の主要なルックアップキーとして使用される


**バッチ ID 同期**

- 必須ではないが、既存のバッチ ID をリアルタイムに移行する際に推奨
- バッチとリアルタイムの ID グラフ間の継続性を確保
- 開始時点からのプロファイル認識精度を向上させる


**属性設定**

- バックフィルにより、リアルタイム属性に過去のバッチ値を入力可能
- 新しいイベントフィールドはデータベースに自動的に表示されるが、アクティベーションやパーソナライゼーションで使用するにはリアルタイム属性として明示的に設定が必要


**設定のデプロイ**

- 設定を複数の環境にエクスポートして再利用可能
- 複数環境への一貫したデプロイのために CI/CD ワークフローをサポート


## パフォーマンスとスケール

Real-Time 2.0 はエンタープライズ規模のワークロードを処理できるよう構築されています。

### サービスレベルアグリーメント（SLA）

- **Web パーソナライゼーション：** 100 ミリ秒（最大 20 属性の場合）
- **トリガーアクティベーション：** エンドツーエンドで 3 分以内（イベント取り込みからアクティベーション配信まで）


SLA の適用にはエンタープライズサポート契約が必要です。スタンダードサポートには SLA 保証は含まれません。

### スケールキャパシティ

- **イベント取り込み：** 顧客あたり毎秒 2,000 イベント（水平スケールで毎秒 100,000 イベント以上に対応）
- **リアルタイム判断：** 顧客あたり毎秒 8,000 イベント（水平スケール可能、上限 100 倍を想定）
- **トリガーアクティベーション：** 顧客あたり毎秒 8,000 イベント（水平スケール可能）
- **プロファイル数：** 数十億の顧客プロファイルに対応


## ベストプラクティス

### 開始前

1. リアルタイムを有効化する前に、**プロファイルキー戦略を慎重に計画**してください。一度設定すると変更できません。
2. **ユースケースを明確に定義**してください。どの顧客行動に反応し、どのアクションをトリガーしたいかを把握しておきましょう。
3. **シンプルに始める：** 1 つのチャネルで 2〜3 のキャンペーンから始め、経験を積みながら拡張してください。
4. **ストリーミングデータとバッチデータを分離する：** 整理を保つために、ストリーミングイベントデータを Parent Segment テーブルとは別に保管してください。


### 設定中

1. 既存のバッチセグメントに対してリアルタイムを有効化する場合は、**属性バックフィルを使用**して過去のデータを利用可能にしてください。
2. 本当に顧客を一意に識別するキー（メール、電話番号、顧客 ID）に絞って **ID ステッチングキーの数を制限**してください。
3. 不要な処理を減らすために、必要なイベントだけをフィルタリングするよう**イベント定義を慎重に設定**してください。
4. 本番環境にデプロイする前に、**非本番環境で十分にテスト**してください。


### デプロイ後

1. 成功・失敗・パフォーマンスを追跡するために、**アクティベーションログを定期的に監視**してください。
2. リアルタイム属性として昇格すべきかどうかを判断するために、**新しいバッチフィールドやイベントフィールドを定期的に確認**してください。
3. 複数環境への一貫したデプロイを確保するために、**CI/CD を使用して設定を管理**してください。
4. **継続的な改善：** A/B テストを使用してリアルタイム体験を継続的に最適化してください。


## Real-Time 成熟度モデル

リアルタイムエンゲージメントの専門知識は時間をかけて発展します。このモデルを参考にしてください。

### 基礎レベル（Foundational）

メールや Web など 1 つのチャネルで 2〜3 のキャンペーンから始め、リアルタイムエンゲージメントのノウハウを構築します。

**フォーカス：** トリガーアクティベーションとシンプルなパーソナライゼーションの基礎を習得

### 初級レベル（Beginner）

基礎キャンペーンを拡張し、さらに 2〜3 のチャネルを組み込みます。

**フォーカス：** 複数チャネルをまたいだリアルタイムインタラクションのオーケストレーション

### 中級レベル（Intermediate）

リアルタイムインタラクションに ML・AI を取り入れ、リアルタイム戦略に営業・サービスのタッチポイントを含めます。

**フォーカス：** 判断の自動化とマーケティング以外への拡張

### 上級レベル（Expert）

全部門にわたるジャーニー戦略を構築し、ブランドと接触するすべての顧客に完全に統一されたエクスペリエンスを提供します。

**フォーカス：** AI/ML 最適化による全社的なリアルタイム判断

## 次のステップ

セットアッププロセスを理解したら、次に進みましょう。

1. **[リアルタイムデータの取り込み](/products/customer-data-platform/real-time/real-time)** - Web トラッキング、モバイル SDK、またはIngestion API のセットアップ
2. **[Parent Segment の設定](/ja/products/customer-data-platform/real-time/creating-a-real-time-configuration)** - イベントテーブル、ID ステッチング、属性の設定
3. **[リアルタイムジャーニー](/products/customer-data-platform/journey-orchestration/realtime)** - トリガーアクティベーションの構築
4. **[リアルタイムパーソナライゼーション](/ja/products/customer-data-platform/real-time/about-real-time-personalization)** - パーソナライズされた Web / モバイル体験の提供


## 関連リソース

- [Real-Time 2.0 概要](/ja/products/customer-data-platform/real-time/real-time) - 製品概要、機能、ユースケース
- [パフォーマンス制限と期待される動作](/ja/products/customer-data-platform/real-time/real-time-2-0-system-performance-limitations-and-expected-behavior)
- [オブザーバビリティとログ](/ja/products/customer-data-platform/real-time/real-time-observability-and-logs)
- [リアルタイム属性 FAQ](/ja/products/customer-data-platform/real-time/real-time-attribute-faqs)