ジャーニーイベントの操作 about-events

このページ: 3 つのイベントタイプ、これらのスキーマ要件、主な制約、ユースケースに適したイベントタイプの選択方法について説明します。

イベントを使用すると、ジャーニーを個別にトリガーし、ユーザーがジャーニーにエントリする際に各ユーザーにリアルタイムのメッセージを配信できます。 イベントの設定では、ジャーニーで想定されるイベントを設定します。 複数のイベントを(ジャーニーの様々なステップで)使用できます。また、同じイベントを複数のジャーニーで使用することもできます。

イベントの設定は​ 必須 ​であり、データエンジニアが実施する必要があります。

IMPORTANT
  • イベントを設定する前に、Journey Optimizer Administrator または データエンジニア​の役割、リアルタイム顧客プロファイル​が有効な XDM スキーマ、アクティブなストリーミングエンドポイント、正しいサンドボックスへのアクセス権があることを確認してください。

  • イベントの要件と制限事項(ストリーミング、クエリサービス、バッチ取り込み)について詳しくは、ジャーニーガードレール - イベントを参照してください。

タスクを実行する役割:

タスク
役割
XDM スキーマをデザインおよび作成
データエンジニア
ストリーミングエンドポイントを設定
データエンジニア
単一およびビジネスイベントを設定(管理/イベント
データエンジニアまたは管理者
ジャーニーでイベントを使用
ジャーニー実務担当者
オーディエンスの選定イベントを設定(キャンバスで選択)
ジャーニー実務担当者

単一イベントビジネスイベントオーディエンスの選定イベント​の 3 つのタイプのイベントを設定できます。

➡️ ビデオでこの機能を確認する

➡️ ビデオでこの機能を確認する

単一イベント unitary-events

単一​イベントは、ユーザーに関連付けられます。 これは、次に関連しています。ユーザーの行動(例えば、ユーザーが製品を購入した、ショップを訪問した、web サイトを離脱したなど)または 人物にリンクして発生した事象(10,000 ロイヤルティポイントに到達など)です。 Journey Optimizer はジャーニーでこのイベントをリッスンして、次の最適なアクションを編成します。 単一のイベントは、ルールベースとすることも、システム生成とすることもできます。 単一イベントの作成方法の詳細情報

スキーマ要件:​ユーザーベースのプライマリ ID と​ リアルタイム顧客プロファイル ​が有効になっている XDM ExperienceEvent スキーマ。

例:​顧客が品目を買い物かごに追加し、ブラウザーを閉じます。 買い物かご放棄イベントが発生すると、プロファイルはリアルタイムでジャーニーにエントリし、1 時間後に復元メールを受信します。

NOTE
単一のジャーニーには、再エントリのガードレールが含まれます。プロファイルの再エントリは、ジャーニーのトリガー後 5 分間、デフォルトでブロックされます。 例えば、あるイベントがプロファイルのジャーニーを 12:01 にトリガーし、別のイベントが 12:03 に到達した場合、そのプロファイルのジャーニーは再開されません。

ビジネスイベント business-events

ビジネス​イベントは、特定のプロファイルにリンクされません。 例えば、ニュースアラート、スポーツの最新情報、航空便の変更やキャンセル、在庫の更新、気象情報などがあります。これらのイベントはプロファイルに固有のものではありませんが、特定のニューストピックを購読している個人、フライトの乗客、在庫切れ製品に興味を持っている買い物客など、いくつかのプロファイルに関心を持つ可能性があります。ビジネスイベントは常にルールベースです。 ジャーニーにビジネスイベントをドロップすると、その直後に​ オーディエンスを読み取り ​アクティビティが自動的に追加されます。 ビジネスイベントの作成方法の詳細情報

スキーマ要件:​ユーザー以外のプライマリ ID を持つ時系列 XDM スキーマで、_id および timestamp フィールドが入力されています。 オーディエンスのエクスポート遅延を 15 分から 1 時間まで計画します。

例:​航空会社がフライトをキャンセルします。 ビジネスイベントが発生すると、Journey Optimizer は影響を受ける乗客のオーディエンスを読み取り、各乗客に再予約の通知を送信します。

オーディエンスの選定イベント audience-qualification-events

オーディエンスにプロファイルがエントリまたは離脱すると、オーディエンスの選定​イベントがトリガーされます。 例えば、ロイヤルティの支出額のしきい値を超えた顧客がゴールド層のオーディエンスにエントリすると、選定によって、そのプロファイルのジャーニーがリアルタイムでトリガーされるか(ストリーミングオーディエンスの場合)、または次のバッチ評価でトリガーされます。 単一イベントとは異なり、オーディエンスの選定では、新しいイベントを送信するために実装を変更する必要はなく、オーディエンス定義の全機能を使用して複雑なトリガーロジックを構築できます。 詳しくは、オーディエンスの選定イベント参照してください。

スキーマ要件:​追加のスキーマは必要ありません。このイベントは、Adobe Experience Platform に事前に組み込まれている既存のオーディエンス定義に依存しています。

例:​顧客のロイヤルティ支出額がゴールド層のしきい値を超えています。 このプロファイルはゴールドオーディエンスの対象となり、ジャーニーが自動的にトリガーされ、ウェルカム報酬が送信されます。

NOTE
管理/イベント​では、オーディエンスの選定イベントは設定されません。ジャーニーの最初の手順として、ジャーニーキャンバスで直接イベントを選択します。

イベントの種類の一覧 event-comparison

単一イベント
ビジネスイベント
オーディエンスの選定イベント
プロファイルにリンクしていますか?
はい。特定の個人のアクションによってトリガーされます。
いいえ。個人と関連付けられていない外部の事象によってトリガーされます。
はい。オーディエンスにプロファイルがエントリまた離脱したときにトリガーされます。
エントリの動作
ジャーニーに 1 つのプロファイルがリアルタイムでエントリします。
複数のプロファイルがオーディエンスの自動読み取りステップを介してエントリします。
オーディエンスメンバーシップが変更されたときに1つのプロファイルがエントリします。
一般的なユースケース
カート放棄の回復、フォーム送信、アプリログイン、ロイヤルティマイルストーン。
フライトのキャンセル、在庫補充アラート、速報、天気イベント。
離脱顧客の再エンゲージメント、ロイヤルティ層の変化、VIPのオフボーディングフロー。
ジャーニーの開始方法
イベントベースのエントリ – オーディエンスは必要ありません。
ビジネスイベント + 自動読み取りオーディエンス(Journey Optimizer によって追加)。
定義されたオーディエンスにプロファイルがエントリまたは離脱します。
ジャーニーごとに複数?
はい。ジャーニーステップ全体で、複数の単一イベントをリッスンできます。
いいえ。最初は、ジャーニーごとに 1 つのビジネスイベントのみが配置されます。
はい。他のアクティビティと組み合わせることができます。
イベント ID のタイプ
ルールベースまたはシステム生成
常にルールベース
イベント IDなし – オーディエンスメンバーシップの評価に基づきます。
管理で設定するのですか?
いいえ。ジャーニーキャンバスで直接選択します。
NOTE
ジャーニーに含めることができるビジネスイベントは 1 つのみであり、そのイベントは最初のアクティビティである必要があります。 Journey Optimizer はその後に、オーディエンスを読み取り​アクティビティを自動的に追加し、どのプロファイルがそのイベントによってトリガーされるジャーニーを受信するかを定義します。

イベント ID のタイプ event-id-type

ビジネス​イベントの場合、イベント ID のタイプは常にルールベースです。

単一​イベントの場合、イベント ID には次の 2 つのタイプがあります。

  • ルールベース​イベント:このタイプのイベントでは、eventID は生成されません。 簡単な式エディターを使用して、システムがジャーニーをトリガーする関連イベントの特定に使用するルールを定義します。 このルールは、イベントペイロードで使用可能な任意のフィールドに基づくことができます。例えば、プロファイルの場所や、プロファイルの買い物かごに追加された項目数などです。

    note caution
    CAUTION
    キャップルールは、ルールベースのイベントに対して定義します。 ジャーニーが処理できる対象イベントの数を、特定の組織で 1 秒あたり 5,000 件に制限します。 これは Journey Optimizer の SLA に対応しています。 詳しくは、Journey Optimizer ライセンスおよび Journey Optimizer 製品説明を参照してください。
  • システム生成​イベント:このイベントでは eventID が必要です。 eventID フィールドは、イベントの作成時に自動的に生成されます。 イベントをプッシュするシステムでは、ID を生成せずに、ペイロードプレビューにある ID を渡す必要があります。

NOTE
ジャーニーをトリガーできるのは、ストリーミングイベントのみです。 次は、ジャーニーをトリガーするために使用​できません
  • バッチで取り込まれたイベント
  • クエリサービス​経由で挿入されたイベント
  • 内部 Journey Optimizer データセットからのイベント(メッセージフィードバック、メールトラッキングなど)
ストリーミングイベントを取得できない場合は、代わりに、それらのイベントに基づいてオーディエンスを作成し、オーディエンスを読み取り​アクティビティを使用します。 セグメント化にのみイベントを使用するには、リアルタイム顧客プロファイル​のデータセットを有効にします。

選択方法 choose-event-type

次の条件を使用して、ジャーニーに適したイベントタイプを選択します。重要な質問は、特定のユーザーに対してアクションをトリガーするのですか、それとも多数のプロファイルに対してブロードキャストするのですか?​です。 ジャーニータイプの詳細情報

各イベントタイプは、特定のジャーニーパターンにマッピングされます。

イベントタイプ
ジャーニーパターン
単一イベント
リアルタイムの単一プロファイルジャーニー - ユーザーが行動するとすぐにトリガーされます
ビジネスイベント
ブロードキャストジャーニー – 自動的なオーディエンスを読み取り手順を通じて多くのプロファイルをターゲットにします
オーディエンスの選定イベント
セグメントベースのジャーニー - プロファイルがオーディエンスにエントリまたは終了した際に実行されます
  • トリガーが特定の個人(例:購入、フォーム送信、ロイヤルティマイルストーン)に関連付けられた際に、単一イベントを選択します。 単一イベントでは、スキーマにユーザーベースのプライマリ ID が必要であり、そのプロファイルのジャーニーをすぐに開始します。 単一イベントの設定方法の詳細情報

  • 製品の再入荷、価格の引き下げ、フライトのキャンセルなど、世界的な出来事がトリガーとなり、そのシグナルに関連する一連のプロファイルに対してブロードキャストする場合は、ビジネスイベントを選択します。 ビジネスイベントは、ジャーニーの最初の手順である必要があり、オーディエンスを読み取り​アクティビティを通じてプロファイルを自動的にターゲットにする必要があります。 人物以外のプライマリ ID と _id および timestamp フィールドを持つ時系列スキーマが必要です。 オーディエンスのエクスポート遅延を 15 分から 1 時間まで計画します。 ビジネスイベントの設定方法の詳細情報

  • トリガーがオーディエンスにエントリまたは終了するプロファイルであり、単一のイベントでは提供できない複雑なセグメント化ロジックが必要な場合は、オーディエンスの選定イベントを選択します。例えば、利用が途絶えていた顧客が支出のしきい値を満たした際の再エンゲージメントや、VIP メンバーがロイヤリティ層から外れた際のオフボーディングフローのトリガーなどがこれに該当します。 オーディエンス選定イベントの詳細情報

CAUTION
ビジネスイベントは、単一イベントやオーディエンスの選定アクティビティと同じジャーニーで使用することはできません。

主な制約 key-constraints

この概要を使用して、イベントを設定する前に実装を計画します。

制約
詳細
スループット制限
すべてのサンドボックス(単一およびオーディエンスを読み取りジャーニー)をまたいで、組織あたり 1 秒間に 5,000 イベント
再エントリブロック
単一ジャーニーがトリガーされた後、5 分間はプロファイルの再エントリーがブロックされます
ジャーニーごとのビジネスイベント
最大 1、最初の手順である必要があります
1 つのジャーニーでビジネスと単一を組み合わせる
サポートなし
バッチイベント
ジャーニーをトリガーできません。代わりに​ オーディエンスを読み取り ​アクティビティを使用します
オーディエンスの選定 - 管理
管理/イベント​で設定されていません - ジャーニーキャンバスで直接選択されました
ライブイベントを編集
名前と説明の変更またはペイロードフィールドの追加のみを実行できます

イベントが Journey Optimizer に取り込まれる仕組み data-cycle

イベントは、Adobe Experience Platform Streaming Ingestion API を通じて POST 呼び出しとして Journey Optimizer に送信する必要があります。 ペイロードは XDM 形式に従う必要があり、イベントスキーマでは​ リアルタイム顧客プロファイル ​が有効になっている必要があります。

認証済みストリーミングモードと未認証ストリーミングモードの両方がサポートされています。 バッチで取り込まれたイベントや内部 Journey Optimizer データセット(メッセージフィードバック、メールトラッキングなど)からのイベントは、ジャーニーのトリガーに使用できません。これらのユースケースには、代わりに​ オーディエンスを読み取り ​アクティビティを使用します。

イベントスループットの制限 event-throughput

Adobe Journey Optimizer では、すべてのサンドボックスをまたいで組織レベルでイベントタイプごとに個別のスループット制限が適用されます。

  • 単一イベント:1 秒あたり 5,000 イベント
  • オーディエンスを読み取りベースのジャーニーイベント:1 秒あたり 5,000 イベント

これらの制限は、ライブドライランクローズ済み一時停止済み​のジャーニーを含む、アクティブなジャーニーで使用されるすべてのイベントに適用されます。 制限に達すると、新しいイベントはキューに追加され、キューが空になるまで毎秒 5,000 イベントで処理されます。

ジャーニーの処理率と様々なジャーニータイプがスループットに影響を与える仕組みについて詳しくは、ジャーニーの処理率の詳細情報を参照してください

これらの割り当て量には、次のタイプのイベントがカウントされます。

  • 外部単一イベント:ルールベースのイベントとシステム生成イベントの両方が含まれます。 同じ生イベントが複数のルール定義に選定される場合、一致した各ルールは割り当て量に対する個別のイベントとしてカウントされます。

  • オーディエンスの選定イベント:同じストリーミングオーディエンスを複数のジャーニーで使用する場合、それぞれの使用は個別にカウントされます。 例えば、2 つのジャーニーのオーディエンスの選定アクティビティで同じオーディエンスを使用すると、2 つのイベントとしてカウントされます。

  • 反応イベント:ジャーニー内のプロファイル反応(メールの開封、メールのクリックなど)によってトリガーされるイベント 。

  • ビジネスイベント:特定のプロファイルに関連付けられていないが、ビジネス関連のイベントに関連付けられているイベント。

  • 分析イベントAdobe Analytics との統合によるジャーニーのトリガーが有効になっている場合、これらのイベントも含まれます。

  • 再開イベント:プロファイルが一時停止済みのジャーニーから再開した際にトリガーされる技術的なイベント。 詳しくは、一時停止したジャーニーの再開を参照してください。

  • 待機ノード完了イベント:プロファイルが待機ノードを終了すると、ジャーニーを再開する技術的なイベントが生成されます。

NOTE
待機イベントと再開イベントを除き、他のすべてのイベントタイプも、オーディエンスを読み取りに基づくジャーニーで使用する場合は割り当て量にカウントされます。

イベントの更新と削除 update-event

既存のジャーニーの中断を避けるには、ドラフト​ジャーニー、ライブ​ジャーニーまたは​ クローズド ​ジャーニーで使用されるイベントを編集する場合、名前と説明の変更およびペイロードフィールドの追加のみが可能です。

ライブ​ジャーニー、ドラフト​ジャーニーまたは​ クローズド ​ジャーニーで使用されるイベントは、削除できません。 使用済みイベントを削除するには、そのイベントを使用しているジャーニーを停止するか、そのイベントを使用しているドラフトジャーニーからそのイベントを削除する必要があります。 「使用場所」フィールドを確認できます。 特定のイベントを使用するジャーニーの数が表示されます。 「ジャーニーを表示」ボタンをクリックすると、対応するジャーニーのリストを表示できます。

よくある質問 faq

複数のジャーニーで同じイベントを使用できますか?
はい - 複数のジャーニーで同じイベントを同時にリッスンできます。

同じジャーニー内で、ビジネスイベントと単一イベントを組み合わせることはできますか?
いいえ - ビジネスイベントは、単一イベントやオーディエンスの選定アクティビティと同じジャーニーで使用することはできません。

オーディエンスの選定イベント用に何かを設定する必要がありますか?
いいえ - オーディエンスの選定イベントは、管理/イベント​で設定されていません。 最初の手順として、ジャーニーキャンバスでオーディエンスを直接選択します。

バッチ取り込みデータを使用してジャーニーをトリガーできますか?
いいえ - ジャーニーをトリガーできるのは、ストリーミングイベントのみです。 バッチデータの場合は、オーディエンスを作成し、代わりに オーディエンスを読み取り ​アクティビティを使用します。

ジャーニーがトリガーされていません。何を確認する必要がありますか?

  • イベントスキーマで​ リアルタイム顧客プロファイル ​が有効になっていることを確認します。
  • イベントがストリーミングされていることを確認します。バッチに取り込まれたイベントはジャーニーをトリガーできません。
  • ルールベースのイベントの場合、ルール条件が受信ペイロードフィールドと一致することを確認します。
  • ジャーニーのステータスが​ ライブ ​で、プロファイルがエントリ条件を満たしていることを確認します。

次の手順 next-steps

TIP
ジャーニーがトリガーされていない場合は、イベントスキーマで​ リアルタイム顧客プロファイル ​が有効になっており、イベントがストリーミングされていることを確認します。バッチに取り込まれたイベントはジャーニーをトリガーできません。

チュートリアルビデオ video

イベントの設定方法と、ストリーミングエンドポイントとイベントのペイロードの指定方法について説明します。

ビジネスイベントに適用できる使用例を理解します。 ビジネスイベントを使用したジャーニーの構築方法と、適用するベストプラクティスについて説明します。

AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

  • TL;DR: This page describes the three journey event types (unitary, business, and audience qualification), their schema requirements and key constraints, how to choose the right one, throughput limits, and how events reach Journey Optimizer.

Intents:

  • Understand the differences between unitary, business, and audience qualification events
  • Choose the right event type for a use case based on whether you target one person or many profiles
  • Learn the schema requirements and entry behavior for each event type
  • Understand event ID types and which events can trigger journeys
  • Plan for throughput limits and reentrance behavior before configuring events
  • Know what can be changed or deleted on an event used in a journey

Glossary:

  • Unitary event: An event linked to a person, based on their behavior, which can be rule-based or system generated and starts a real-time single-profile journey (product-specific)
  • Business event: An event not linked to a specific profile, always rule-based, that automatically adds a Read Audience activity and broadcasts to many profiles (product-specific)
  • Audience qualification event: An event triggered when a profile enters or exits an audience, selected directly on the journey canvas rather than in Administration (product-specific)
  • Read Audience activity: The activity automatically added after a business event to define which profiles receive the journey (product-specific)
  • Rule-based event: A unitary or business event that does not generate an eventID and instead defines a rule used to identify relevant events (product-specific)
  • System-generated event: A unitary event that requires an eventID, automatically generated when the event is created (product-specific)

Guardrails:

  • Event configuration is mandatory and must be performed by a Data engineer; prerequisites are the Journey Optimizer Administrator or Data Engineer role, an XDM schema with Real-Time Customer Profile enabled, an active streaming endpoint, and access to the correct sandbox.
  • Throughput is limited to 5,000 events per second per organization, across all sandboxes, for unitary events and for Read Audience based journey events (hard limit); when a limit is reached, new events are queued and processed at 5,000 per second until the queue is drained.
  • A capping rule limits rule-based events to 5,000 qualified events per second for a given Organization, corresponding to Journey Optimizer SLAs.
  • Throughput limits apply to all events used in active journeys, which includes Live, Dry run, Closed, and Paused journeys.
  • Profile reentrance is blocked by default for 5 minutes after a unitary journey triggers.
  • A journey can contain only one business event, which must be the first step; business events cannot be used in the same journey as unitary events or audience qualification activities.
  • Only streamed events can trigger journeys; events ingested in batch, inserted via Query Service, or from internal Journey Optimizer datasets cannot, and a Read Audience activity should be used instead.
  • Unitary events require an XDM ExperienceEvent schema with a person-based primary identity and Real-Time Customer Profile enabled; business events require a time-series schema with a non-person primary identity and populated _id and timestamp fields, with an audience export delay of 15 minutes to up to one hour.
  • When editing an event used in a Draft, Live, or Closed journey, you can only change the name, the description, or add payload fields; events used in Live, Draft, or Closed journeys cannot be deleted.

Terminology:

  • Canonical name: Journey event — Acronym: n/a — variants: event, journey trigger event
  • Do not confuse: “Unitary event” (linked to a specific person) ≠ “Business event” (external occurrence not tied to one person) ≠ “Audience qualification event” (triggered when a profile enters or exits an audience)
  • Do not confuse: “Rule-based” (defines a rule, no eventID generated) ≠ “System-generated” (requires an automatically generated eventID)

FAQ:

  • Q: Can I use the same event in multiple journeys? — Yes, several journeys can listen to the same event simultaneously.
  • Q: Can I combine a business event and a unitary event in the same journey? — No, business events cannot be used in the same journey as unitary events or audience qualification activities.
  • Q: Do I need to configure anything for audience qualification events? — No, they are not configured in Administration > Events; the audience is selected directly on the journey canvas as the first step.
  • Q: Can I use batch-ingested data to trigger a journey? — No, only streamed events can trigger journeys; for batch data, build an audience and use a Read Audience activity instead.
  • Q: What is the throughput limit for events? — 5,000 events per second per organization, across all sandboxes, for unitary events and for Read Audience based journey events.
  • Q: My journey is not triggering — what should I check? — Verify the event schema has Real-Time Customer Profile enabled, confirm events are streamed, check that rule-based conditions match the incoming payload, and confirm the journey is in Live status with the profile meeting any entry conditions.
recommendation-more-help
journey-optimizer-help