ジャーニーでのオーディエンスの使用 segment-trigger-activity

このページ:​オーディエンスを読み取りアクティビティを設定して、オンデマンドまたはスケジュールに基づいて Adobe Experience Platform オーディエンスのプロファイルをジャーニーに取り込み、各プロファイルのパスをパーソナライズする方法について説明します。

オーディエンスを読み取りアクティビティを使用して、定義済みのオーディエンスでジャーニーを開始します。 オーディエンスとその実行日時を選択し、条件、タイマー、アクションを使用して、各プロファイルのパスをパーソナライズします。

オーディエンスを読み取りアクティビティについて about-segment-trigger-activity

オーディエンスを読み取り​アクティビティは、選択した Adobe Experience Platform オーディエンスのすべてのプロファイルをジャーニーに追加するジャーニーエントリポイントアクティビティです。 エントリは 1 回または定期的に実行できます。 API および技術リファレンスでは、このアクティビティはセグメントトリガーまたはオーディエンスベースのジャーニーエントリとも呼ばれます。

オーディエンスを読み取りとオーディエンスの選定を使用するタイミング

次の場合に​ オーディエンスを読み取り ​を使用
次の場合に​ オーディエンスの選定 ​を使用
ジャーニーを 1 回またはスケジュール(バッチ)で実行する場合。
選定された時点で、リアルタイムにジャーニーにエントリするプロファイルが必要な場合。
オーディエンスがバッチ評価される場合(例:毎日のスナップショット)。
オーディエンスがストリーミングベースまたはイベントベースである場合。
オーディエンスの評価とジャーニーエントリの間に遅延が発生しても問題ない場合。
プロファイルが選定されたら、すぐにエントリする必要がある場合。
TIP
実際の例
  • 週刊ニュースレター → オーディエンスを読み取り。 オーディエンスは毎日のバッチスナップショットです。 毎週月曜日の午前 9 時にジャーニーをスケジュールします。 すべての選定されるプロファイルが一緒にエントリされます。
  • ロイヤルティ層のアップグレード → オーディエンスの選定。 プロファイルがストリーミングオーディエンスでゴールドステータスに到達するとすぐに、ジャーニーにエントリしてお祝いメールを受信します。
  • 再エンゲージメントシリーズ → オーディエンスを読み取り。 90 日以上非アクティブなプロファイルをターゲットにする繰り返しジャーニーを 30 日ごとに実行します。

主な制限:​ジャーニーごとに 1 つのオーディエンスを読み取り(最初のアクティビティにする必要があります)。アクティビティごとに 1 つのオーディエンス。組織ごとに最大 5 つのオーディエンスを読み取りの同時実行。サンドボックスごとに 1 秒あたり 20,000 プロファイル。12 時間のジョブタイムアウト。 詳しくは、ガードレールと制限を参照してください。

前提条件:​作成および評価される Adobe Experience Platform オーディエンス(実現済みステータス)、ジャーニー用に選択された人物ベースの ID 名前空間、(繰り返し実行の場合)スケジュールおよびスループット制限の理解。

例えば、オーディエンスを作成ユースケースで作成した Luma app opening and checkout オーディエンスをエントリポイントとして使用できます。 条件、タイマー、イベント、アクションを使用して、選定されたすべてのプロファイルがジャーニーにエントリし、個別のパスを進みます。

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

CAUTION

アクティビティの設定 configuring-segment-trigger-activity

オーディエンス(必須)、名前空間(必須)、読み取り率(必須、デフォルトは 5,000/秒)、スケジュール(ジャーニーが実行するタイミング)を設定します。 オプションで、ラベル​や​ 補助識別子 ​を追加します。 以下の手順では、各設定を順を追って説明します。

アクティビティを追加し、オーディエンスを選択 add-activity-and-select-audience

  1. オーケストレーション​カテゴリを展開し、オーディエンスをを読み取り​アクティビティをキャンバスにドロップします。

    アクティビティは、ジャーニーの最初のステップとして配置する必要があります。

  2. アクティビティに​ ラベル ​を追加します(オプション)。 オプションのラベルを使用すると、レポートモードとテストモードのログでアクティビティを識別できます。

  3. 「オーディエンス」フィールドで、ジャーニーにエントリする Adobe Experience Platform オーディエンスを選択し、「保存」をクリックします。 セグメント定義を使用して生成された Adobe Experience Platform オーディエンスを選択できます。

    note
    NOTE
    さらに、オーディエンス構成を使用して作成された Adobe Experience Platform オーディエンスをターゲットにすることができます。
    また、CSV ファイルからアップロードされたオーディエンスをターゲットにすることもできます。
    Journey Optimizer でオーディエンスを生成およびターゲットにする方法の詳細情報。

    リストに表示される列は、カスタマイズして並べ替えることができます。

    使用可能な Adobe Experience Platform オーディエンスを示すオーディエンス選択インターフェイス

    オーディエンスが追加されると、「コピー」ボタンを使用して、オーディエンスの名前と ID をコピーできます。

    {"name":"Luma app opening and checkout","id":"8597c5dc-70e3-4b05-8fb9-7e938f5c07a3"}

    オーディエンス名と ID を JSON 形式でコピーする「コピー」ボタン

    note
    NOTE
    オーディエンスの参加ステータスが​ 適合 ​の個人のみが、ジャーニーにエントリします。 オーディエンスの評価方法について詳しくは、セグメント化サービスのドキュメントを参照してください。
  4. 「名前空間」フィールドで、個人の識別に使用する名前空間を選択します。 デフォルトでは、このフィールドには、最後に使用した名前空間が事前に入力されています。 名前空間の詳細情報。

    note
    NOTE
    様々な ID の中から選択した ID(名前空間)を持たないオーディエンスに属する個人は、ジャーニーにエントリできません。 ユーザーベースの ID 名前空間のみ選択できます。 名前空間を参照テーブルに対して定義した場合(例:ProductID 名前空間を Product 参照に対して定義した場合)、その名前空間を​ 名前空間 ​ドロップダウンリストで使用することはできません。

補助識別子 read-audience-supplemental-id

オプションで、補助識別子を使用​を有効にすると、プロファイル ID に加えて、セカンダリ識別子(例:注文 ID または予約 ID)のコンテキストでジャーニーを実行できます。 これにより、補助識別子が異なる場合、同じプロファイルの複数のエントリを許可できます。

ジャーニーの補助識別子の使用方法の詳細情報。 オーディエンスを読み取りジャーニーの場合、補助識別子は、統合プロファイルサービス​オーディエンスの​ 和集合/プロファイルスキーマ ​から準備されるか、外部オーディエンス(例:CSV ファイルからインポートされたオーディエンスや、構成ワークフローの結果)の実施要件を満たす属性から選択されます。 補助 ID を使用する場合、読み取り率はジャーニーインスタンスごとに 1 秒あたり 500 プロファイルに制限されます。

ガードレールとレコメンデーション must-read

オーディエンスを読み取り​アクティビティに関するすべてのガードレールと制限(同時実行数、スループット、アクティビティごとに 1 つのオーディエンス、ジョブタイムアウト、再試行など)は、ガードレールと制限に一覧表示されています。

レコメンデーション

  • ベストプラクティスとして、信頼性が高く一貫性のあるカウントを得るために、オーディエンスを読み取り​アクティビティでバッチオーディエンスを使用します。 「オーディエンスを読み取り」は、バッチのユースケース向けに設計されています。 ユースケースでリアルタイムデータが必要な場合は、代わりにオーディエンスの選定アクティビティを使用します。
  • CSV ファイルから読み込まれたオーディエンスや、構成ワークフローから生成されたオーディエンスは、「オーディエンスを読み取り」アクティビティで選択できます。 これらのオーディエンスは、「オーディエンスの選定」アクティビティでは使用できません。
  • オーディエンススナップショットのタイミング、バッチセグメント化の完了ウィンドウ、ジャーニーを常に最新のデータで実行する方法について詳しくは、タイミングとデータの生成を参照してください。 繰り返しジャーニーについては、「バッチオーディエンス評価の後にトリガー」オプションを有効にすることを検討してください。これにより、最新のオーディエンススナップショットの準備が整うまで、実行を自動的に遅延させることができます。 学習を増やす。
CAUTION
リアルタイム顧客プロファイルデータとセグメント化のガードレールは、Adobe Journey Optimizer にも適用されます。

次:​読み取り率とスケジュールを設定し、テストして公開します。

プロファイルのエントリと読み取り率 profile-entry-and-reading-rate

読み取り率​を設定します(必須)。 これは、1 秒あたりにジャーニーにエントリできるプロファイルの最大数です。 このレートは、このアクティビティにのみ適用され、ジャーニーの他のアクティビティには適用されません。 例えば、カスタムのアクションに対してスロットルレートを定義する場合は、Throttling API を使用する必要があります。 このページを参照してください。

この値は、ジャーニーバージョンのペイロードに格納されます。 デフォルト値は、1 秒あたり 5,000 プロファイルです。 この値は、1 秒あたり 500~20,000 プロファイルの範囲で変更できます。

NOTE
サンドボックスあたりの全体的な読み取り率は、1 秒あたり 20,000 プロファイルに設定されています。 したがって、同じサンドボックスで同時に実行されるすべての読み取りオーディエンスの読み取り率は、合計で 1 秒あたり最大 20,000 プロファイルになります。 このキャップは変更できません。 ジャーニーの処理率とスループットについて詳しくは、この節を参照してください。

ジャーニーのスケジュール schedule

デフォルトでは、ジャーニーは 1 回実行されるように設定されています。 ジャーニーを実行する特定の日付/時刻と頻度を定義するには、次の手順に従います。

NOTE
ジャーニーステータスと 91 日間のグローバルタイムアウト:
  • 繰り返し以外​のオーディエンスを読み取りジャーニーは、最後にアクティブなプロファイルが離脱すると、自動的に​ 停止 ​ステータスに移行します。待機期間を発生させるノード(待機ノード、反応ノード、イベントトリガートランジション)がジャーニーに含まれていない限り、その場合は標準の 91 日間のグローバルタイムアウトが適用されます。 詳細情報
  • 終了日のない​ 繰り返し ​のオーディエンスを読み取りジャーニーは、ジャーニーが公開されている限り、ライブのまま​になります。 実行の​ 最後の発生 ​から 91 日後に、完了​ステータスに移行します。
  • 91 日間のタイムアウトは、ジャーニーを通じてフローする個々の​プロファイル(プロファイルがアクティブなままでいられる最大時間)に適用され、ジャーニーのライブステータスには適用されません。
  • 91 日間の​ レポートウィンドウ ​は別の概念です。UI には、過去約 91 日間のパフォーマンスデータが表示されます。 古いデータには UI ではアクセスできませんが、ジャーニーは引き続き実行されます。 詳細情報
  1. オーディエンスを読み取り​アクティビティのプロパティで、「ジャーニースケジュールを編集」を選択します。

    オーディエンスを読み取りアクティビティのプロパティの「ジャーニースケジュールを編集」ボタン

  2. ジャーニーのプロパティが表示されます。 スケジューラータイプ​ドロップダウンリストで、ジャーニーを実行する頻度を選択します。

    頻度オプション(1 回、毎日、毎週、毎月)を含むスケジューラータイプドロップダウン

繰り返しジャーニーの場合は、ジャーニーへのプロファイルのエントリを管理するのに役立つ特定のオプションを使用できます。 各オプションについて詳しくは、以下の節を展開してください。

NOTE
オーディエンススナップショットの使用方法
オーディエンスを読み取りの各実行では、実行時に使用可能なオーディエンスメンバーシップが使用されます。 バッチオーディエンスの場合、Journey Optimizer は使用可能な最新のバッチオーディエンススナップショットから読み取ります。 ジャーニーの開始時にリアルタイムでオーディエンスが再計算されることはありません。
繰り返しジャーニーの場合、各実行時には、その実行時に使用可能なスナップショットが使用されます。 ジャーニーの実行前に最新のバッチオーディエンス評価を待機させる場合は、「バッチオーディエンス評価の後にトリガー」を有効にします。

オーディエンスの読み取りの繰り返しオプション:増分読み取り、再エントリを適用、バッチ後にトリガー

増分読み取り

繰り返しの​ オーディエンスを読み取り ​を含んだジャーニーが初めて実行されると、オーディエンス内のすべてのプロファイルがジャーニーにエントリします。 このオプションを使用すると、最初の実行後、ジャーニーの前回の実行以降にオーディエンスにエントリした個人のみをターゲットにすることができます。

このオプションを使用すると、システムは Adobe Experience Platform のセグメント化サービスによって実行された前回のオーディエンス評価ジョブの時点から 24 時間​前まで遡って確認します。

セグメント化が完了すると、プロファイルスナップショットのエクスポートジョブが開始され、Journey Optimizer が新しいプロファイルを検出して処理できるようになります。 これらの 2 つのジョブの間にジャーニーがスケジュールされている場合、増分読み取りでは、ジャーニーの前回の実行以降にオーディエンスのメンバーになったプロファイルは取得されません。

プロファイルが欠落するリスクを最小限に抑えるには:

  • 「バッチオーディエンス評価の後にトリガー」オプションを有効にすると、発生した経過時間に関係なく、最後に成功したジャーニー実行時までルックバック期間を延長できます
  • 毎日のバッチセグメント化ジョブが完了した後にジャーニーが適切に実行されるようにスケジュールします(通常 2~3 時間のバッファー)
  • すぐにプロファイルを組み込む必要がある緊急のユースケースでは、代わりにストリーミングオーディエンスでのオーディエンスの選定アクティビティの使用を考慮します
note caution
CAUTION
カスタムアップロードオーディエンス(CSV アップロード)やその他の外部オーディエンス(例:連合オーディエンス構成)の場合、現時点では​ 増分読み取り ​は機能的にサポートされていません。 繰り返しごとに、増分読み取りの切替スイッチ設定に関係なく、オーディエンス全体​が処理されます。
繰り返しエントリを制御するには、繰り返し時に再エントリを強制するを使用します。
繰り返し時に再エントリを強制する

このオプションを使用すると、ジャーニーにまだ存在するすべてのプロファイルを、次回の実行時に自動的に終了させることができます。

例えば、毎日の繰り返しジャーニーに 2 日間の待機が含まれている場合、このオプションをアクティブ化すると、プロファイルは次のジャーニー実行に移動します。 これは、次の実行オーディエンスに属しているかどうかに関係なく、次の日に実行されます。

このジャーニーでのプロファイルの存続期間が繰り返し頻度よりも長くなる可能性がある場合は、プロファイルがジャーニーを終了できるようにするために、このオプションをアクティブ化しないでください。

増分読み取りと繰り返し時に再エントリを強制するの連携動作

これら 2 つのオプションは、ジャーニー実行の異なる部分を制御します。

  • 増分読み取り​では、次の繰り返し実行で​ オーディエンスから選択されるプロファイル ​を制御します。
  • 繰り返し時に再エントリを強制する​では、次の繰り返し実行が開始された際に、ジャーニーで引き続きアクティブなプロファイルに発生する内容​を制御します。

次の表を使用して、次の実行時の組み合わせ動作を把握します。

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
増分読み取り 繰り返し時に再エントリを強制する 次の実行での動作
オフ オフ Journey Optimizer はその実行の完全なオーディエンスを読み取ります。 ジャーニーで引き続きアクティブなプロファイルは、自動的にリセットされません。
オン オフ Journey Optimizer は、前回の実行以降にオーディエンスに追加されたプロファイルのみを読み取ります。 ジャーニーで引き続きアクティブなプロファイルは、自動的にリセットされません。
オフ オン Journey Optimizer は、次の実行を開始する前に、現在のジャーニー実行からアクティブな参加者を削除してから、完全なオーディエンスをもう一度読み取ります。 これにより、プロファイルは新しい実行時に最初から開始できます。
オン オン Journey Optimizer は、次の実行を開始する前に、現在のジャーニー実行からアクティブな参加者を削除してから、最後の実行以降にオーディエンスに追加されたプロファイルのみを読み取ります。 再エントリを強制すると、アクティブなジャーニーの参加がリセットされますが、増分読み取りは新しく追加されたオーディエンスメンバーに選択を引き続き制限します。

つまり、繰り返し時に再エントリを強制するでは、増分読み取り​は無効になりません。 両方のオプションが有効になっている場合、プロファイルは、次の実行が開始される前にアクティブなジャーニーインスタンスから削除されますが、次の実行では、前回の実行以降に新規と見なされたオーディエンスメンバーのみが引き続き選択されます。

note important
IMPORTANT
繰り返し時に再エントリを強制する​で削除されたプロファイルは、増分読み取り​の新しいオーディエンスメンバーとして自動的に処理されません。 オーディエンスの選択は、前回の実行以降にプロファイルが新しくオーディエンスに追加されたかどうかによって引き続き異なります。
バッチオーディエンス評価の後にトリガー

毎日スケジュールされ、バッチオーディエンスをターゲティングするジャーニーの場合、バッチセグメント化ジョブからの新しいオーディエンスデータを待機するジャーニーの時間枠を最大 6 時間まで定義できます。 バッチセグメント化ジョブが既に進行中の場合、ジャーニーは常に時間枠内で完了するのを待ちます。 バッチセグメント化ジョブが進行中ではなく、利用可能なスナップショットが前回の実行で使用されたバッチのみである場合、ジャーニーは新しいバッチを再利用せずに待機します。 タイムウィンドウの最後に新しいバッチが見つからない場合、その発生時にジャーニー実行はスキップされます。

例えば、毎日午後 6 時にジャーニーがスケジュールされている場合、ジャーニーの実行前に待機する分数または時間数を指定できます。 午後 6 時にジャーニーが起動すると、新しいオーディエンス、つまり前回のジャーニー実行時に使用されたオーディエンスよりも新しいオーディエンスがないか確認します。 指定した時間枠内で、新しいオーディエンスが検出されるとすぐにジャーニーが実行されます。 新しいオーディエンスが検出されない場合、その日のジャーニーの実行はスキップされます。

ジャーニーのテストと公開 testing-publishing

オーディエンスを読み取り​アクティビティを使用すると、単一プロファイルでジャーニーをテストできます。

それには、テストモードを有効にします。

テストプロファイルの選択を含むオーディエンスを読み取りアクティビティのテストモードインターフェイス

通常どおりにテストモードを設定し実行します。 ジャーニーのテスト方法を学ぶ。

テストを実行したら、「ログを表示」ボタンを使用して、テスト結果を確認できます。 詳しくは、この節を参照してください。

オーディエンス実行結果とプロファイルフローを示すテストログ

テストが正常に完了すると、ジャーニーを公開できます(ジャーニーの公開を参照)。 オーディエンスに属する個人は、ジャーニーのプロパティの「スケジューラー」セクションで指定された日時にジャーニーにエントリします。

NOTE
繰り返しのオーディエンスベースジャーニーの場合、ジャーニーは、最後の実行が完了すると自動的にクローズします。 終了日時が指定されていない場合は、新しいエントリに対するジャーニーを手動でクローズして終了する必要があります。

ジャーニーでのオーディエンスのターゲティング audience-targeting-in-journeys

オーディエンスベースのジャーニーは常に、オーディエンスを読み取り​アクティビティで始まり、Adobe Experience Platform オーディエンスに属する個人を取得します。 これらのプロファイルは、1 回または繰り返しスケジュールで読み取られます。

ジャーニーがエントリされた後、条件​アクティビティを使用して参加者を調整します。属性や行動でセグメント化したり、母集団の一部を除外したり、分岐を再結合(和集合)したりします。 以下の節では、各パターンについて説明します。

セグメント化

条件を使用して、条件​アクティビティでセグメント化を実行できます。 例えば、VIP 顧客は特定のパス、VIP 以外の顧客は別のパスに沿って進むようにすることができます。

セグメント化は以下に基づいて実行できます。

  • データソースのデータ
  • ジャーニーデータに含まれるイベントのコンテキスト(例:ある人物が 1 時間前に受け取ったメッセージをクリックしたか)
  • 日付(例:ある人物がジャーニーを経験したのは 6 月だったか?)。
  • 時間(例:その人物のタイムゾーンで午前中か?)
  • ジャーニーに流入するオーディエンスを割合に基づいて分割するアルゴリズム(例:コントロール母集団を除外するために 90% - 10% に分割)

VIP パスと VIP 以外のパスへのオーディエンスのセグメント化の条件アクティビティ

NOTE
オーディエンスを読み取り​アクティビティで「毎日」のスケジューラータイプを使用する場合、新しいオーディエンスデータを待機するジャーニーの時間枠を定義できます。 これにより、正確なターゲティングが確保され、バッチセグメント化ジョブの遅延によって発生する問題を防ぐことができます。 詳しくは、ジャーニーのスケジュール方法を参照してください

除外

セグメント化に使用するのと同じ​ 条件 ​アクティビティ(上記を参照)を使用すると、母集団の一部を除外することもできます。 例えば、VIP を除外するには、そのユーザーを終了ステップ直前の分岐に送ります。

この除外は、母集団のカウントを目的として、または複数のステップから成るジャーニーに従って、オーディエンスの取得直後に発生する可能性があります。

終了アクティビティを使用した除外分岐を含むジャーニーパス

和集合

ジャーニーを使用すると、セグメント化の後に、N 個の分岐を作成および結合できます。 その結果、2 つのオーディエンスを同じエクスペリエンスに戻すことができます。

例えば、VIP の顧客と VIP 以外の顧客は、ジャーニーで 10 日間別々のエクスペリエンスを経た後で、同じパスに戻ることができます。 和集合の後、セグメント化や除外を実行してオーディエンスを再度分割できます。

和集合を使用したセグメント化の後に再度結合されるジャーニーパス

トラブルシューティング audience-count-mismatch

この節は、オーディエンスサイズの不一致(想定より少ないまたは多いプロファイルがエントリしている)、処理されたプロファイルがゼロ(オーディエンスを読み取りアラートまたはエントリなし)、エントリの遅延または欠落(タイミングやデータの生成)の解決に役立ちます。

NOTE
オーディエンスを読み取りアクティビティを実行すると、システムではオーディエンスの書き出し操作のライフサイクルを追跡する内部イベント(segmentExportJob イベントと呼ばれる)が生成されます。 これらのイベントは、個々のプロファイルごとではなく、アクティビティレベルで記録され、モニタリングやトラブルシューティングの目的でクエリを実行できます。 詳しくは、オーディエンスを読み取りイベントのクエリを参照してください。

問題を検索:

症状
移動先
オーディエンスサイズよりもエントリされたプロファイル数がより少ない(または多い)
タイミングとデータの生成、データの検証と監視
オーディエンスを読み取りがゼロのプロファイルを処理しました。アラートが実行されました
処理されたプロファイルがゼロ
バッチオーディエンスのエントリが遅延または欠落している
タイミングとデータの生成
カスタムアップロードのエンリッチメント属性が見つからないか、「エンリッチメントされたオーディエンスが見つかりません」と表示される
​ エンリッチメント属性のトラブルシューティング ​
セグメントジョブのステータスまたは名前空間を確認する必要がある
データの検証と監視

処理されたプロファイルがゼロ zero-profiles-processed

オーディエンスを読み取り​アクティビティがプロファイルを処理していない場合(例:オーディエンスを読み取りアラートを参照):

  1. オーディエンスが空かどうかを確認 - Adobe Experience Platform で、オーディエンスサイズとそのプロファイルが​ 実現済み ​ステータスであることを確認します。 空のオーディエンスまたはまだ未評価のオーディエンスは、エントリが 0 になります。
  2. 名前空間を確認 - オーディエンスを読み取りアクティビティで選択された名前空間が、オーディエンス内のプロファイルに存在している必要があります。 この ID のないプロファイルは、ジャーニーにエントリできません。 名前空間の詳細情報。
  3. アラートを確認して再試行 - 失敗は​ アラート ​で報告されます。 システムは、エクスポートジョブの作成を 10 分間隔で最大 1 時間再試行します。 再試行とアラートの詳細情報。

これらの確認後も問題が解決しない場合、バッチと設定の原因について詳しくは、タイミングとデータの生成およびデータの検証と監視を参照してください。

タイミングとデータの生成 timing-and-data-propagation

  • バッチセグメント化ジョブの完了:バッチオーディエンスの場合、ジャーニーを実行する前に、毎日のバッチセグメント化ジョブが完了し、スナップショットが更新されていることを確認します。 バッチオーディエンスは、セグメント化ジョブの完了から約 2 時間​後に使用できます。 詳しくは、オーディエンスの評価方法を参照してください。

  • データ取り込みのタイミング:ジャーニーの実行前にプロファイルデータ取り込みが完全に完了していることを確認します。 プロファイルがジャーニーの開始直前に取り込まれた場合、まだオーディエンスに反映されていないことがあります。 詳しくは、​ Adobe Experience Platform でのデータ取り込みを参照してください。

  • 「バッチオーディエンス評価の後にトリガー」を使用:バッチオーディエンスを使用する毎日のスケジュール済みジャーニーの場合は、「バッチオーディエンス評価の後にトリガー」オプションを有効にすることを考慮します。 これにより、ジャーニーは実行される前に最新のオーディエンスデータ(最大 6 時間)を待機するようになります。 詳しくは、スケジュール設定を参照してください。

  • 待機アクティビティを追加:最近取り込まれたデータを持つストリーミングオーディエンスの場合は、データの生成とプロファイルの選定の時間を確保するために、ジャーニーの開始時に​ 待機 ​アクティビティを追加することを考慮します。 待機アクティビティの詳細情報

  • inAudience()条件のタイミング:​オーディエンスを読み取りジャーニー内の条件ノードで inAudience() を使用する場合、セグメントメンバーシップはプロファイルのバッチ投影から読み取られます。 この投影のデータは、取り込み後 2 時間​以内に更新されます。 生成のタイミングのシナリオについて詳しくは、inAudience 関数ドキュメントを参照してください。

データの検証 data-validation-and-monitoring

  • セグメント化ジョブのステータスを確認:Adobe Experience Platform の監視ダッシュボードでバッチセグメント化ジョブの完了時間を監視します。 これを使用して、オーディエンスデータの準備が整ったことを確認します。

  • 結合ポリシーを確認:オーディエンスに対して設定された結合ポリシーが、異なるソースからのプロファイルデータを組み合わせる場合の予想される動作と一致していることを確認します。 詳しくは、​ Adobe Experience Platform の結合ポリシーを参照してください。

  • セグメント定義を確認:セグメント定義が正しく設定され、予想されるすべての選定条件が含まれていることを確認します。 詳しくは、オーディエンスの作成を参照してください。 特に注意すべき点:

    • イベントのタイムスタンプに基づいてプロファイルを除外する場合がある時間ベースの条件
    • 最近更新されたデータに依存する属性による選定
    • ストリーミングとバッチの評価方法
  • 名前空間の設定を検証:オーディエンスを読み取り​アクティビティで選択された名前空間が、オーディエンス内のプロファイルで使用されるプライマリ ID と一致していることを確認します。 選択された名前空間のないプロファイルは、ジャーニーにエントリしません。 詳しくは、ID 名前空間を参照してください。

ベストプラクティス

  • セグメント化の後にジャーニーをスケジュール:バッチオーディエンスの場合、通常のバッチセグメント化ジョブの完了時間から 2~3 時間以上後にジャーニーの実行をスケジュールします。 ジャーニーのスケジュールの詳細情報

  • リアルタイムのユースケースにストリーミングオーディエンスを使用:即時のプロファイルの選定とジャーニーのエントリが必要な場合は、バッチオーディエンスでの​ オーディエンスを読み取り ​の代わりに、ストリーミングオーディエンスでオーディエンスの選定アクティビティを使用します。

  • 最初に小規模なオーディエンスでテスト:大規模なジャーニーを開始する前に、小規模なサブセットでテストして、カウントが期待値と一致することを検証します。 ジャーニーのテスト方法の詳細情報

  • 定期的にモニタリング:オーディエンスサイズとジャーニーエントリ指標の定期的なモニタリングを設定し、不一致を早期に検出します。 詳しくは、ジャーニーの処理率とエントリ管理を参照してください。

サポートに連絡するタイミング

上記の手順を実行した後もカウントの不一致またはプロファイルがゼロの実行が保持される場合は、アドビサポートにお問い合わせください。 次の情報を準備してください:オーディエンス名/ID、ジャーニー名/ID、スケジュールされた実行時間、サンドボックス、不一致に関する簡単な説明(例:「オーディエンス数は 1 万件と示されていますが、[当日]にジャーニーにエントリしたのは 2 千件のみです」)。

再試行 read-audience-retry

再試行は、エクスポートジョブの取得中に、オーディエンストリガージャーニー(オーディエンスを読み取り​または​ ビジネスイベント ​で始まる)にデフォルトで適用されます。 エクスポートジョブの作成中にエラーが発生した場合、最大 1 時間、10 分ごとに再試行が行われます。 それ以降は失敗と見なされます。 したがって、これらのタイプのジャーニーは、スケジュールされた時間から最大 1 時間後に実行できます。

失敗した​ オーディエンスを読み取り ​トリガーはキャプチャされ、アラート​に表示されます。 「オーディエンスを読み取りアラート」は、スケジュールされた実行時間から 10 分経過しても、オーディエンスを読み取り​アクティビティでプロファイルが処理されなかった場合に警告します。 このエラーは、技術的な問題または空のオーディエンスが原因で発生する場合があります。 技術的な問題が原因で失敗した場合でも、問題のタイプによっては再試行が引き続き発生する場合があります。 例えば、エクスポートジョブの作成に失敗した場合、10 分間隔で最大 1 時間再試行します。 詳細情報

オーディエンスを読み取りのガードレール(再試行とスループットの制限を含む)の完全なリストについて詳しくは、ガードレールと制限を参照してください。

関連トピック

チュートリアルビデオ 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 explains how to configure and use the Read Audience activity in Adobe Journey Optimizer to add profiles from an Adobe Experience Platform audience into a journey, either once or on a recurring schedule, with guidance on scheduling, throughput, troubleshooting, and best practices.

Intents:

  • Configure a Read Audience activity as the entry point of a journey
  • Select an Adobe Experience Platform audience and identity namespace for the journey
  • Set the reading rate to control how many profiles enter per second
  • Schedule a journey to run once, daily, weekly, or on a custom recurrence
  • Enable Incremental read to process only new audience members on recurring runs
  • Troubleshoot audience count mismatches, zero-profile runs, and delayed entries
  • Decide between Read Audience and Audience Qualification based on batch vs. real-time needs

Glossary:

  • Read Audience activity: The journey entry-point activity that reads all qualified profiles from a selected Adobe Experience Platform audience and adds them to the journey (product-specific)
  • Reading rate: The maximum number of profiles that can enter the journey per second (500–20,000; default 5,000) (product-specific)
  • Incremental read: A recurring journey option that processes only profiles newly added to the audience since the last journey execution (product-specific)
  • Force reentrance on recurrence: A scheduling option that removes all active journey participants before each new run so profiles can re-enter fresh (product-specific)
  • Trigger after batch audience evaluation: A scheduling option that delays journey execution until a fresh batch audience snapshot is available (up to 6 hours) (product-specific)
  • Supplemental identifier: A secondary identifier (e.g., order ID) that allows the same profile to enter the journey multiple times when the identifier differs (product-specific)

Guardrails:

  • Only one Read Audience activity is allowed per journey, and it must be the first activity.
  • Only one audience can be selected per Read Audience activity.
  • Up to five concurrent Read Audience runs per organization.
  • Maximum reading rate is 20,000 profiles per second per sandbox (sum of all concurrent Read Audience activities).
  • Reading rate is limited to 500 profiles per second when a supplemental identifier is used.
  • Only profiles with Realized audience participation status enter the journey.
  • Only people-based identity namespaces are available; profiles without the selected namespace cannot enter.
  • The 12-hour job timeout applies to Read Audience export jobs.
  • Retries for failed export jobs occur every 10 minutes for up to 1 hour.
  • For custom upload audiences with Incremental read enabled, profiles are only retrieved on the first recurrence (these audiences are fixed).
  • Scale the Winner is not available for Read Audience journeys (path experimentation).

Terminology:

  • Canonical name: Read Audience — Acronym: none — variants: segment-trigger, audience-based journey entry, Read Segment (legacy API name)
  • Synonyms: “Read Audience” = “segment trigger” = “audience-triggered journey”
  • Do not confuse: “Read Audience” ≠ “Audience Qualification” (Read Audience is batch/scheduled; Audience Qualification is real-time streaming)

FAQ:

  • Q: When should I use Read Audience instead of Audience Qualification? — Use Read Audience for batch, scheduled use cases (e.g., weekly newsletters, re-engagement campaigns). Use Audience Qualification when profiles must enter the journey immediately as they qualify in real time.
  • Q: Why are fewer profiles entering the journey than the audience size? — Common causes include profiles not having the selected namespace, batch segmentation jobs not yet completed before the journey ran, or profiles not being in Realized status. Enable “Trigger after batch audience evaluation” and check namespace configuration.
  • Q: What does Incremental read do on the first run? — On the first execution, all audience profiles enter. On subsequent runs, only profiles newly added to the audience since the last execution are processed.
  • Q: What happens if the export job fails? — The system retries every 10 minutes for up to 1 hour. Failures are reported in Alerts. After 1 hour without success, the run is considered failed.
  • Q: Can the same profile enter a Read Audience journey multiple times? — Yes, if a supplemental identifier is configured and differs between entries, or if Force reentrance on recurrence is enabled. Without these, a profile cannot be present multiple times at the same time.
  • Q: How long does a one-shot Read Audience journey remain live? — It auto-stops to Stopped when the last profile exits, unless the journey includes Wait, Reaction, or event-triggered transitions — in which case the 91-day global timeout applies. It does not remain Live until Finished at 91 days by default.
recommendation-more-help
journey-optimizer-help