# リアルタイム用ペアレントセグメントの設定

Data Workbench を使用して、データエンジニアは、Audience Studio のリアルタイムジャーニーオブジェクトをサポートするために、ペアレントセグメントのイベント、ID ステッチキー、および属性を設定できます。これらのリアルタイム対応ペアレントセグメントを作成した後、マーケターは、Treasure コンソール のイベント設定 UI から設定されたキーイベントとそれに関連するフィルターを使用して、Audience Studio のリアルタイムジャーニーエディター内でリアルタイムジャーニーオブジェクトを確立できます。これらのオブジェクトには、エントリ基準、マイルストーン、および目標が含まれます。バッチ属性は、メールキャンペーンのトリガーアクティベーション設定でも指定できます。

## プロセスの概要

リアルタイム対応ペアレントセグメントを作成するための高レベルのプロセスは次のとおりです：

1. リアルタイムユースケースでの意思決定をサポートするために必要なデータを含むペアレントセグメントがない場合は、Data Workbench（Legacy）を使用して[ペアレントセグメントを作成して実行](/ja/products/customer-data-platform/data-workbench/parent-segments/creating-parent-segments)します。
2. テクニカルサポートに連絡して、ペアレントセグメントをリアルタイムで有効にします。
3. ペアレントセグメントがリアルタイムで有効になった後、Data Workbench を使用してペアレントセグメントでリアルタイムイベント設定を実行します。


リアルタイム設定プロセスは、Treasure コンソール の Data Workbench を使用して、ユースケースの意思決定に必要なイベントとデータを指定することで構成されます。

![rtConfigTabs](/assets/rtconfigtabs2.e40ae9222fb1f90a96853b7bfba5cbe6d282801aeb92d44225e09e8cc0215800.142841d8.png)

## 要件

* 作業している各ペアレントセグメントは、リアルタイムで有効にする必要があります。カスタマーサポートに連絡して、ペアレントセグメントのリアルタイム機能を有効にしてもらってください。


## 制限事項

* 最大 100 個のイベントテーブルのみを定義できます。
* ID ステッチ用に最大 100 個の ID のみを定義できます。ステッチに使用する ID は文字列値である必要があります。
* 定義できるイベント定義の数に数値的な制限はありません。ただし、これらの定義で使用されるすべてのフィルターの合計長は 1000 文字を超えることはできません。


## リアルタイム設定ページ

リアルタイム設定ページに移動するには：

1. Treasure コンソール を開きます。
2. Treasure コンソール（Legacy）から、ダイヤモンドアイコン ![diamondIcon](/assets/diamondicon.1de9a47c5527239070c65325fcca391b37a5d23226f14290a73ce066e5ba9c22.142841d8.png) を選択して Treasure コンソールを表示します。
3. 左の列から、Data Workbench アイコン ![dataWorkbenchIcon](/assets/dataworkbenchicon.cce5689f8e143519db7ab78461b0ce35ee69d08166c99f3ab1ccf0a9c7fd65e1.142841d8.png) を選択します。
4. Parent Segments ページから、リアルタイム用に設定するペアレントセグメントを選択します。
5. Real-time Configuration 行で **Configure settings** を選択します。


Real-time Configuration 行が表示されない場合、または行が表示されているがペアレントセグメントでリアルタイムが利用できない場合は、カスタマーサポートに連絡してペアレントセグメントでリアルタイム機能を有効にしてもらってください。

リアルタイム設定ページが表示されます：

![realtimeConfigPage](/assets/realtimeconfigpage.46c87c01bba7226a354fca3012f7e171c1ed249559bf7f60983b21ed5a69e8f2.142841d8.png)

これらのページを使用して、次のタスクを実行できます：

* [イベントテーブルの設定](/ja/products/customer-data-platform/real-time/creating-a-real-time-configuration#configure-event-tables)
* [イベント定義の設定](/ja/products/customer-data-platform/real-time/creating-a-real-time-configuration#configure-event-definitions)
* [属性の設定](/ja/products/customer-data-platform/real-time/creating-a-real-time-configuration#configure-attributes)
* [ID ステッチの設定](/ja/products/customer-data-platform/real-time/creating-a-real-time-configuration#configure-attributes)


### イベントテーブルの設定

Event Tables ページでは、リアルタイムユースケースにとって重要なテーブル（またはデータソース）を指定します。つまり、指定したテーブルにストリーミングデータが送信されるたびに、そのデータもリアルタイムシステムで利用できるようになります。たとえば、このスクリーンショットでは、リアルタイム設定は、retail_golden データベースの abandon_cart または hotel_checkin テーブルに入ってくる新しいストリーミングデータのみを TD リアルタイムシステムに転送するように指定しています。

![](/assets/eventtables.2b520ee60ace3e167eb678ecf38ad1d120927cc00e804840aaa75fc7b80f6bb0.142841d8.png)

イベントテーブルを指定するには：

1. Event Tables ページから、**+ Add streaming event table** オプションを選択します。
2. Database ドロップダウンリストからデータベースを選択します。
3. Table ドロップダウンリストからテーブルを選択します。
4. すべてのテーブルを識別するまで、手順 1〜3 を繰り返します。
5. **Launch** を選択して、リアルタイムペアレントセグメントイベントを設定します。
Launch を選択するまで、必要な数のテーブルを追加または削除できます。Launch を選択した後は、指定されたテーブルを削除することはできません。ただし、後で最大 100 個まで追加のテーブルを追加できます。
6. **Launch** を選択して続行することを確認します。


Launch を選択すると、設定が進行中であることを示すバナーが表示されます。プロセスが完了するまで、リアルタイム設定ページでアクションを実行することはできません。起動ステージと予想される所要時間の詳細については、[設定の起動ステージ](#configuration-launch-stages)を参照してください。

Treasure コンソール に「Configuration launched successfully」バナーが表示されます。

### イベント定義の設定

イベントテーブルを指定した後、イベント定義またはフィルタールールを指定して、関心のあるリアルタイムデータを絞り込むことができます。このスクリーンショットでは、イベント定義は、hotel_checkin テーブルの hotel_name 列に追加されているデータが、ホテル名が「Park Hotel」の場合に転送されるように指定しています。

![](/assets/eventdef.f4d4040ca7ce181b9adc2b6987082612ee5aa8cca885992214cd441ebe3d539e.142841d8.png)

イベント定義を作成するには：

1. Event Definitions ページから、**+ Create new event** を選択します。
2. イベント定義の名前を入力します。
3. Source Table ドロップダウンメニューから、テーブルを選択します。
4. （オプション）![](/assets/eventdeficon.de86a114d10c7fa0b056c83a3eb85eda64ec42f76af88e901c292814aa9b7abf.142841d8.png)**add filters** を選択します。
  1. Filter rule ドロップダウンから、列を選択します。
  2. 「Input a value」フィールドに、フィルターの値を指定します。
  3. 必要に応じて追加のフィルターを追加します。


* 追加したフィルターは論理 AND で評価されます。つまり、イベントが処理されるには、すべてのフィルターの条件が満たされる必要があります。
* 定義できるイベント定義の数に数値的な制限はありません。ただし、これらの定義で使用されるすべてのフィルターの合計長は 1000 文字を超えることはできません。


1. **Create** を選択します。
イベント定義を作成した後、それを編集または削除することはできません。
2. **Create** を選択して、イベント定義を作成することを確認します。


#### イベント定義フィルターの比較演算子について

次は、イベント定義フィルターで使用できる比較演算子です：

| Treasure コンソール ラベル | 比較 | 演算子 | コメント |
|  --- | --- | --- | --- |
| = is | 等値 | `==` |  |
| ≠ is not | 不等値 | `!=` |  |
| is null | NULL と等しい | `==null` |  |
| is not null | NULL と等しくない | `!=null` |  |
| > greater than | より大きい | `>` | 数値列タイプでのみ使用してください。 |
| < less than | より小さい | `<` | 数値列タイプでのみ使用してください。 |
| ≥ at least | 以上 | `>=` | 数値列タイプでのみ使用してください。 |
| ≤ at most | 以下 | `<=` | 数値列タイプでのみ使用してください。 |
| regex | 正規表現を満たす |  | 文字列列タイプでのみ使用してください。 |
| not regex | 正規表現を満たさない |  | 文字列列タイプでのみ使用してください。 |


### 属性の設定

Treasure Data に入ってくる新しいストリーミングデータの一部には、リアルタイム意思決定に必要な属性データが含まれていない場合があります。このような場合、ペアレントセグメントからインポートしてリアルタイムシステムで利用できるようにする必要がある属性を指定できます。このスクリーンショットでは、name と email 属性が選択されています。

ペアレントセグメントのテーブルからのすべての属性は、Import Attributes モーダルの左側の列に表示され、インポートできます。

属性をインポートするには：

1. Attributes ページから、**+ Add Attributes** を選択します。
2. 左の列から 1 つ以上の属性を選択し、**>** ボタンを選択して追加します。
属性のリストを作成する際、**<** ボタンを選択して属性を削除することもできます。
3. **Import** を選択します。
属性をインポートした後、それらを削除することはできません。ただし、後で追加の属性を追加できます。
4. **Import** を選択して、属性をインポートすることを確認します。


**重要な制限事項：リアルタイムリスト属性と ID ステッチキー** 「Distinct list」オプションを有効にしてリアルタイム属性（リスト）を設定する場合、属性に選択された ID 列が既存の ID ステッチキー（例：td_client_id）でないことが重要です。ID ステッチキーが「Distinct list」を持つリアルタイム属性（リスト）の ID 列として使用される場合、属性は予想どおりにすべての異なる値を収集しません。代わりに、ID ステッチの仕組みにより、属性はそのステッチされた ID に関連付けられた最新の値のみを保存し、事実上「Last」集約のように動作します。すべての異なる値がキャプチャされるようにするには、リストしたいアイテムに固有の ID 列（放棄されたカートシナリオの product_id など）を選択し、ID ステッチキーとして設定されていないものを選択してください。

### ID ステッチの設定

一意のプロファイルを識別するために使用するキーを選択することで、ID ステッチルールを定義できます。一般的に、プロファイルまたは顧客を一意に識別する可能性が最も高い ID キーを選択する必要があります。メール、電話番号、TD ID などのキーがキーとしてよく使用されます。リアルタイム層とバッチ層にまたがる ID ステッチングの仕組みの概念的な概要については、[リアルタイム ID ステッチング概要](/ja/products/customer-data-platform/real-time/real-time-id-stitching-overview)を参照してください。

ID ステッチの設定プロセスには、2 つのステップが含まれます：

1. ID ステッチキーを定義して設定を起動します。
2. プロファイルキーを選択して設定を再起動します。


アップロードされたバッチ属性の取得を容易にするために、[プロファイルキーを定義](/ja/products/customer-data-platform/real-time/creating-a-real-time-configuration#define-a-profile-key)する必要があります。

#### ID ステッチキーの定義

1. ID Stitching ページから、**+ Create ID Stitching key** を選択します。
2. ステッチキーとして使用するテーブル列の名前を入力します。
3. （オプション）有効なキー値をテストできる正規表現を入力します。
正規表現パターンはアンカー ^ と $ の間に指定され、引用符またはスラッシュを含めることはできません。このフィールドの有効な正規表現の例を次に示します：`^[a-zA-Z ]*$`、`^\\d+$`、`^\S+@\S+\.\S+$`、`^(?=.*[a-zA-Z])(?=.*[0-9])[A-Za-z0-9]+$`。コンソールは正規表現を検証せず、定義後は編集できないため、Treasure Data は、正規表現が予想どおりに一致することを確認するためにサードパーティツールを使用することをお勧めします。無効な正規表現を修正するためのサポートが必要な場合は、カスタマーサポートに連絡してください。
4. （オプション）無効なキー値を構成するテキストを入力します。
5. （オプション）**Workflow only** チェックボックスを選択します。
このオプションを選択すると、受信データでキーを検索しないようにシステムに指示する内部フラグが設定されます。ID キーがバッチワークフローによって生成される場合は、この設定を使用します。
6. **Launch** を選択します。
ID ステッチキーを定義した後、それを削除することはできません。ただし、後で最大 100 個まで追加のキーを追加できます。
7. **Launch** を選択して、ID ステッチ設定を起動することを確認します。


Launch を選択すると、設定が進行中であることを示すバナーが表示されます。プロセスが完了するまで、リアルタイム設定ページでアクションを実行することはできません。起動ステージと予想される所要時間の詳細については、[設定の起動ステージ](#configuration-launch-stages)を参照してください。

![](/assets/idstitching2.a9d9e7ccc870d3b2f3384214c6e778398c8efe4bb51f8c6b7f5cb7742f45678e.142841d8.png)

#### プロファイルキーの定義

少なくとも 1 つの ID ステッチキーを正常に設定した後、プロファイルキーを設定でき、データがアップロードされると、これはデータベースのルックアップキーとして使用されます。プロファイルキーは、ID ステッチキーであり、セグメントの属性である必要があります。（behaviors 列のキーにすることはできません。）これらの基準を満たす ID ステッチキーが作成され、起動されている場合、モーダルの Profile Key セクションの *Table Column* ドロップダウンメニューで利用できるようになります。

プロファイルキーを作成するには：

1. ID Stitching ページから、Profile Key セクションの *Table column* ドロップダウン矢印を選択します。
2. プロファイルキーを選択します。
3. **Launch** を選択します。
4. **Launch** を選択して、ID ステッチ設定を起動することを確認します。


プロファイルキーを選択した後、新しいプロファイルキーを選択して起動することで変更できます。

Launch を選択すると、設定が進行中であることを示すバナーが表示されます。プロセスが完了するまで、リアルタイム設定ページでアクションを実行することはできません。起動ステージと予想される所要時間の詳細については、[設定の起動ステージ](#configuration-launch-stages)を参照してください。

![](/assets/profilekey.ca5470decddcee74fd3736e6515a465d1406a22b4bd43049857f5864fc659e1d.142841d8.png)

## 設定の起動ステージ

リアルタイム設定の起動または更新中、リアルタイム設定画面に設定の現在の状態を示すバナーが表示されます。これらのバナーは、既存のリアルタイムジャーニーのダッシュボード画面やパーソナライゼーションの詳細画面にも表示されます。既存の設定が更新されている場合、更新が有効になるまで既存の設定が引き続き使用されます。

起動プロセスは 2 つのステージで構成されます：

### ステージ 1：データベース更新

リアルタイム設定データベースが更新されている間、バナーが表示されます。このステージは通常数分で完了します。既存の設定が更新されている場合、更新が有効になるまで既存の設定が引き続き使用されます。

ステージ 1 のバナー：設定が進行中であることを示す
### ステージ 2：Reactor アップロード

更新された設定と関連するバッチデータが Reactor にアップロードされている間、2 番目のバナーが表示されます。アップロードする必要があるバッチデータの量に応じて、このステージは数時間かかる場合があります。既存の設定が更新されている場合、更新が有効になるまで既存の設定が引き続き使用されます。

ステージ 2 のバナー：バッチプロファイルデータがアップロード中であることを示す
バナーに「View progress」リンクが表示される場合もあり、実行中の特定のワークフローの Data Workbench ページを指します。このリンクは、Workflow Project View 権限を持つポリシーがユーザーアカウントに適用されており、ワークフローの試行 ID がバックエンドから正常に提供された場合にのみ表示されます。

## FAQ

### イベントテーブルとしてどのタイプのテーブルを定義できますか？

イベント定義は、ストリーミングテーブルをデータソースとして使用できます。リアルタイムキーイベントで使用する任意のテーブルを設定できますが、内部で生成されたテーブル（例：cdp_audience_NNN.behavior_foo）は利用できません。

### イベント定義を設定する必要がありますか？

いいえ。イベント定義は、イベントテーブルの設定が完了した後に自動的に作成されます。これらの自動的に作成されたイベント定義は <database.table> 形式で表示され、フィルタリングされていません。設定されたイベントテーブルにフィルターを追加することで、オプションで追加のイベント定義を作成できます。

### デプロイメントが失敗する可能性はありますか？

まれに、無効な設定や内部システムの問題により、デプロイメントが失敗する場合があります。UI から設定の削除が許可されていないため、デプロイメントの失敗の問題を解決するには、カスタマーサポートに連絡してください。

![](/assets/deployfail.8feaefb94678c2230a2b75f568e7d61843e294efb27dc82f697471a7a602aedf.142841d8.png)

### イベント設定を定義する際に推奨される順序はありますか？

イベントテーブルを最初に設定する必要があります。イベント定義、属性、および ID ステッチは、その後任意の順序で設定できます。推奨されるシーケンスは次のとおりです

1. イベントテーブル
2. イベント定義（オプション）
3. 属性
4. ID ステッチキー
5. プロファイルキー


### リアルタイム設定が正常に起動されるまでの予想時間はどのくらいですか？

起動プロセスは 2 つのステージで構成されます。最初のステージ（データベース更新）は通常数分で完了します。2 番目のステージ（Reactor アップロード）は、リアルタイムシステムにアップロードされるバッチ属性の数とサイズに応じて、数時間かかる場合があります。既存の設定が更新されている場合、更新が有効になるまで既存の設定が引き続き使用されます。詳細については、[設定の起動ステージ](#configuration-launch-stages)を参照してください。

### イベント設定 UI にアクセスするために必要な権限は何ですか？

リアルタイムイベント設定を編集するには、ユーザー ID がペアレントセグメントへの完全な権限を持っている必要があります。「view only」権限を持っている場合、イベント設定を表示できますが、編集することはできません。

### ペアレントセグメント設定からテーブルまたは列を削除した場合、RT イベント設定 UI にどのようなエラーメッセージが表示されますか？

ペアレントセグメントからテーブルまたは列を削除することに対する重大な影響はありません。削除されたテーブルまたは列にイベントデータが継続的に送信される場合、リアルタイムシステムはイベントの処理を続行します。

### リアルタイムイベント設定を完全に削除して、最初からやり直すことはできますか？

いいえ。何らかの理由で設定が無効になった場合は、カスタマーサポートに連絡して代替ソリューションを決定してください。

### イベントテーブルを設定せずにイベント設定を起動できますか？

はい。イベントテーブル、イベント定義、属性インポート、または ID ステッチルールを指定せずにイベント設定を起動できます。ただし、次の点に注意してください：

* イベントテーブルを指定しない場合、マーケターは Audience studio でリアルタイムジャーニーを作成できません。
* ID ステッチキーを指定しない場合、顧客プロファイルデータはリアルタイムシステムに保存されません。
* インポート属性を指定してもプロファイルキーを設定しない場合、バッチ属性はリアルタイムシステムにアップロードされません。