ビジネスジャーニーの設定

Related pages:

このページでは、ビジネスジャーニーを設定する方法について説明します。

はじめる前に

ビジネスジャーニーを作成する前に、環境内でこの機能が有効になっていることを確認してください。また、データの前提条件、検証ルール、および名前とビジネスジャーニー定義の制限事項を確認する必要があります。

ビジネスジャーニーの有効化

ビジネスジャーニーは、SaaS 環境ではデフォルトで有効になっています。ただし、オンプレミスのインストールでは、この機能は無効になっています。ビジネスジャーニーを有効にするには、管理者が [Settings] で特定のプロパティを設定する必要があります。

イベントサービスを開始する前に、次のようにします。

events-service-api-store.properties ファイルを開きます。
ad.bizoutcome.enabled=false を true に変更します。

このページには、マイルストーン間のビジネスワークフローを詳述したフローマップが表示されます。[Settings] で analytics.business.outcomes.flowmap.enabled プロパティの値を false に変更することによって、フローマップを非表示にすることができます。

フローマップの有効化

マイルストーンを作成すると、ビジネスワークフローの詳細を示すフローマップがページに表示されます。ビジネスジャーニーを選択すると、フローマップが有効になっている新しいウィンドウが表示されます。この動作は、[Settings] の analytics.business.outcomes.flowmap.enabled プロパティによって制御されます。この値を true に設定すると、ビジネスジャーニーに対してフローマップが有効になります。

ビジネスジャーニーを定義するためのデータの前提条件

Analytics では、分析データとしてすでにキャプチャされているイベントとフィールドを収集することによって、ビジネスジャーニー複合イベントが作成されます。組み込みの分析データソースに加えて、カスタムイベントデータを使用してビジネスジャーニーを作成することもできます。ビジネスジャーニーでマイルストーンを定義する際には、使用するイベントとイベントから抽出するフィールドを指定します。デフォルトで収集されるフィールドまたは収集対象として設定したカスタムフィールドを抽出できます。また、Analytics API キーから作成されたカスタムイベントを使用してマイルストーンを追加できます。

開始イベントと終了イベント、およびその間で明確に定義されたステップを把握しておく必要があります。分析によってキャプチャされるイベントの追加フィールドを収集するには、次を参照してください。

制限事項と注意事項

ビジネスジャーニー名は大文字と小文字が区別されず、すべて小文字で保存されます。これは、application と Application という 2 つの定義が重複と見なされることを意味します。
[Event Type] ドロップダウンには、小文字の定義名が表示されます。
高度なクエリには、小文字の名前を使用します。
プライマリキーは、一意である必要があり、null であってはなりません。プライマリキーが null 値を保持している場合、ビジネスジャーニーイベントを形成するために、基盤となるマイルストーンイベントが結合されることはありません。
プライマリキーを慎重に選択します（特に値の基数）。マイルストーンイベントを一意に識別および結合し、有益なビジネスワークフローを形成するためにプライマリキーが必要です。マイルストーンイベントがプライマリキーによって誤認される場合は、不正確なマイルストーンイベントが結合されて、問題のある結果が生成されます。
プライマリキー名は、ビジネスジャーニーの定義がドラフト状態でない限り変更できません。
ビジネスジャーニーの定義は、展開された後、変更できません。定義がドラフト状態のときは名前を変更できます。
カスタムイベントに関連するフィールドの名前が変更された場合は、名前が変更されたフィールドを正しく抽出するために、カスタムイベントから作成されたビジネスジャーニーの定義を更新します。

検証ルール

ここでは、ビジネスジャーニーの定義、およびビジネスジャーニー、マイルストーン、抽出対象フィールドの命名規則を検証するための特定のルールについて説明します。検証を呼び出すことなく、作業をドラフトとして保存できます。準備ができたら、Validate and Save を使用して定義が受け入れ可能であるか確認できます。ビジネスジャーニーの定義を保存しても、ビジネスジャーニーは有効になりません。データは、実際にビジネスジャーニーを有効にするまでキャプチャされません。「ビジネスジャーニーのライフサイクル」を参照してください。

名前の検証ルール

ここでは、ビジネスジャーニー、マイルストーン、および抽出対象フィールドの命名の検証ルールについて説明します。ビジネスジャーニーの定義をドラフトとして保存した場合、検証ルールは適用されません。検証は、Validate and Save を使用する場合にのみ呼び出されます。検証ルールには、以下が含まれます。

ビジネスジャーニー、マイルストーン、および抽出対象フィールドの名前には、a ～ z、A ～ Z、および 0 ～ 9 を含む英数字の文字列を指定する必要があります。使用できる特殊文字は、アンダースコア（_）のみです。
名前には、スペース、ハイフン、ダッシュなどの特殊文字は使用できません。
プライマリキーフィールドには、ビジネスジャーニーの定義のすべてのマイルストーンで同じ名前（ラベル）を指定する必要があります。フィールド名自体は、イベントタイプによって異なる場合があります。
プライマリキー名は、ビジネスジャーニーの定義がドラフト状態でない限り変更できません。詳細については、「ビジネスジャーニーのライフサイクル」を参照してください。
ビジネスジャーニーの定義のマイルストーンまたはフィールドに名前を付けるために、次の予約済みフィールド名は使用できません。
- pickupTimestamp
- eventTimestamp
- totalTime
- userExperience
マイルストーンまたはフィールド名に、ADQL キーワードを使用した名前を付けることはできません。詳細については、ADQL クエリを参照してください。

ビジネスジャーニーの定義の検証ルール

ビジネスジャーニーの定義には、次のものを含める必要があります。

少なくとも 2 つのマイルストーン。
フィルタの一意のセット。同じ定義では、必須フィルタとオプションフィルタのセットがまったく同じである複数のマイルストーンは許可されません。
固有のマイルストーン名。
抽出フィールド名は一意である必要があります（プライマリキーフィールドを除く）。
マイルストーンごとに 1 つのプライマリキーフィールドが必要です。
[Slow] しきい値の期間は 30 分より長くする必要があります。

ビジネスジャーニーの定義の作成

コントローラ UI で、[Analytics ] > [ Business Journeys] に移動します。既存のビジネスジャーニーのリスト（存在する場合）が表示されます。
マイルストーンを定義するには、以下をクリックします。+ Add Milestone.
名前を入力します。
[Type] ドロップダウンから、トランザクション、ログ、ブラウザ要求、モバイル要求などの分析データのソースを選択します。
[Milestone Events] セクションには、選択したデータソースに基づく必須フィルタが表示されます。このフィールドは、データソースのタイプによって異なります。

トランザクションの場合は、作成するマイルストーンごとにアプリケーション、階層、およびビジネストランザクションを指定します。Analytics では、階層は、アプリケーション環境内の Java 仮想マシン（JVM）サービス（認証サービスなど）を表します。ビジネストランザクションは、アプリケーションが提供するサービスの要求を表すクロスティア処理パスです。
必要に応じて [+ Add Criteria] をクリックし、データソースのタイプに基づいてフィルタを追加できます。
同じイベントタイプのマイルストーンイベントを複数定義できます。[+ Add Event] をクリックして、別のマイルストーンイベントを作成します。
[Extract Fields] セクションでプライマリキーフィールドと名前を定義し、マイルストーンイベントからキャプチャするフィールドを指定します。[Auto Fit] をクリックすると、マイルストーンイベントを自動編成したり、イベントを自由に編成したりできます。

プライマリキーに名前を付けた後、定義がドラフト状態でない限り、その名前は変更できません。「ビジネスジャーニーのライフサイクル」を参照してください。
プライマリキーには、異なるマイルストーン用のイベントタイプの異なるフィールド名がある場合があるため、プライマリキーフィールドには、後続のマイルストーンは入力されません。

ビジネスジャーニーでデフォルトで抽出されるフィールドは表示されません。
ビジネスジャーニーは、次のいずれかの方法で保存できます。
- Save As Draft: 定義をドラフト形式で保存します。検証は実行されません。定義に戻り、後で実行することができます。
- Validate and Save：必要な検証を実行します。すべてのマイルストーンを完了した場合は、このオプションを使用します。定義は保存されますが、有効にはなりません。
[Health Thresholds] タブで、許容可能なパフォーマンスを決定する値を指定できます。
ユーザエクスペリエンス値の計算方法について詳しくは、「ビジネスジャーニーの正常性しきい値」を参照してください。ビジネスジャーニーの定義の作成を完了した後、それを有効にすることができます。
ビジネスジャーニーをリストから選択し、[Enable] をクリックします。このオプションは、リストから有効なドラフト状態のビジネスジャーニーを選択するまでグレー表示されます。ビジネスジャーニーを有効にするには、状態が "Valid Draft" でなければなりません。

ビジネスジャーニーのライフサイクル

このセクションでは、ビジネスジャーニーのライフサイクルについて説明します。

Draft

最初は必要なすべての詳細が含まれていないため、定義の作成には複数の一時バージョンが含まれる場合があります。Save As Draft を使用して、初期の不完全な定義をキャプチャし、ビジネスジャーニーを [Draft] 状態にします。

[Draft] 状態では、分析データは処理されず、ビジネスジャーニーイベントは作成されないため、照会するものは何もありません。
ビジネスジャーニーが [Draft] 状態の場合、プライマリキーを変更できます。
[Draft] 状態は検証に関しては制限が少なく、ほとんどの更新操作がサポートされます。

Valid Draft

定義に必要な詳細情報を追加した後、Validate and Save を使用して、定義を [Valid Draft] 状態に移行します。この状態でも定義を変更できます。定義を有効にするまで、ビジネスジャーニーイベントはキャプチャされません。

Enabled

データを処理する準備ができたら、Enable アクションを使用します。これにより、定義が [Enabled] 状態に移行します。ほとんどの定義では、[Enabled] 状態でライフタイムが消費されます。

設定の変更は、2 分ごとに Analytics サーバに同期されます。したがって、ビジネスジャーニーの定義を有効にした後、イベントが生成されるまでに最大 2 分の遅延が発生する可能性があります。
着信イベントが処理され、複合ビジネスジャーニーイベントが作成され保存されます。ビジネスジャーニーイベントに対してクエリを実行できます。
次の方法で定義を変更できます。
- 抽出対象のフィールド（デフォルト以外のフィールド）を追加、名前変更、または削除する
- マイルストーンを追加、名前変更、または削除する

User Disabled

ある時点で、ビジネスジャーニーを無効にしたい場合があります。この Disable アクションにより、ビジネスジャーニーの定義が [User Disabled] 状態に移行します。この状態では、着信イベントは処理されません。既存のイベントは引き続き照会できます。

次の方法で定義を更新できます。

抽出対象のフィールド（デフォルト以外のフィールド）を追加、名前変更、または削除する
マイルストーンを追加、名前変更、または削除する

Deleted

ビジネスジャーニーの定義が不要になった場合は、Delete アクションを使用します。これは、定義のライフサイクルの最終フェーズです。この状態では、着信イベントは処理されません。既存のビジネスジャーニーイベントは照会できません。