このページ:オーディエンスを読み取りアクティビティを設定して、オンデマンドまたはスケジュールに基づいて Adobe Experience Platform オーディエンスのプロファイルをジャーニーに取り込み、各プロファイルのパスをパーソナライズする方法について説明します。
オーディエンスを読み取りアクティビティを使用して、定義済みのオーディエンスでジャーニーを開始します。 オーディエンスとその実行日時を選択し、条件、タイマー、アクションを使用して、各プロファイルのパスをパーソナライズします。
オーディエンスを読み取りアクティビティについて about-segment-trigger-activity
オーディエンスを読み取りアクティビティは、選択した Adobe Experience Platform オーディエンスのすべてのプロファイルをジャーニーに追加するジャーニーエントリポイントアクティビティです。 エントリは 1 回または定期的に実行できます。 API および技術リファレンスでは、このアクティビティはセグメントトリガーまたはオーディエンスベースのジャーニーエントリとも呼ばれます。
オーディエンスを読み取りとオーディエンスの選定を使用するタイミング
- 週刊ニュースレター → オーディエンスを読み取り。 オーディエンスは毎日のバッチスナップショットです。 毎週月曜日の午前 9 時にジャーニーをスケジュールします。 すべての選定されるプロファイルが一緒にエントリされます。
- ロイヤルティ層のアップグレード → オーディエンスの選定。 プロファイルがストリーミングオーディエンスでゴールドステータスに到達するとすぐに、ジャーニーにエントリしてお祝いメールを受信します。
- 再エンゲージメントシリーズ → オーディエンスを読み取り。 90 日以上非アクティブなプロファイルをターゲットにする繰り返しジャーニーを 30 日ごとに実行します。
主な制限:ジャーニーごとに 1 つのオーディエンスを読み取り(最初のアクティビティにする必要があります)。アクティビティごとに 1 つのオーディエンス。組織ごとに最大 5 つのオーディエンスを読み取りの同時実行。サンドボックスごとに 1 秒あたり 20,000 プロファイル。12 時間のジョブタイムアウト。 詳しくは、ガードレールと制限を参照してください。
前提条件:作成および評価される Adobe Experience Platform オーディエンス(実現済みステータス)、ジャーニー用に選択された人物ベースの ID 名前空間、(繰り返し実行の場合)スケジュールおよびスループット制限の理解。
例えば、オーディエンスを作成ユースケースで作成した Luma app opening and checkout オーディエンスをエントリポイントとして使用できます。 条件、タイマー、イベント、アクションを使用して、選定されたすべてのプロファイルがジャーニーにエントリし、個別のパスを進みます。
- オーディエンスを読み取りアクティビティを使用する前に、ガードレールと制限のトピックに目を通してください。
アクティビティの設定 configuring-segment-trigger-activity
オーディエンス(必須)、名前空間(必須)、読み取り率(必須、デフォルトは 5,000/秒)、スケジュール(ジャーニーが実行するタイミング)を設定します。 オプションで、ラベルや 補助識別子 を追加します。 以下の手順では、各設定を順を追って説明します。
アクティビティを追加し、オーディエンスを選択 add-activity-and-select-audience
-
オーケストレーションカテゴリを展開し、オーディエンスをを読み取りアクティビティをキャンバスにドロップします。
アクティビティは、ジャーニーの最初のステップとして配置する必要があります。
-
アクティビティに ラベル を追加します(オプション)。 オプションのラベルを使用すると、レポートモードとテストモードのログでアクティビティを識別できます。
-
「オーディエンス」フィールドで、ジャーニーにエントリする Adobe Experience Platform オーディエンスを選択し、「保存」をクリックします。 セグメント定義を使用して生成された Adobe Experience Platform オーディエンスを選択できます。
note NOTE さらに、オーディエンス構成を使用して作成された Adobe Experience Platform オーディエンスをターゲットにすることができます。
また、CSV ファイルからアップロードされたオーディエンスをターゲットにすることもできます。
Journey Optimizer でオーディエンスを生成およびターゲットにする方法の詳細情報。リストに表示される列は、カスタマイズして並べ替えることができます。
オーディエンスが追加されると、「コピー」ボタンを使用して、オーディエンスの名前と ID をコピーできます。
{"name":"Luma app opening and checkout","id":"8597c5dc-70e3-4b05-8fb9-7e938f5c07a3"}
note NOTE オーディエンスの参加ステータスが 適合 の個人のみが、ジャーニーにエントリします。 オーディエンスの評価方法について詳しくは、セグメント化サービスのドキュメントを参照してください。 -
「名前空間」フィールドで、個人の識別に使用する名前空間を選択します。 デフォルトでは、このフィールドには、最後に使用した名前空間が事前に入力されています。 名前空間の詳細情報。
note NOTE 様々な ID の中から選択した ID(名前空間)を持たないオーディエンスに属する個人は、ジャーニーにエントリできません。 ユーザーベースの ID 名前空間のみ選択できます。 名前空間を参照テーブルに対して定義した場合(例:ProductID 名前空間を Product 参照に対して定義した場合)、その名前空間を 名前空間 ドロップダウンリストで使用することはできません。
補助識別子 read-audience-supplemental-id
オプションで、補助識別子を使用を有効にすると、プロファイル ID に加えて、セカンダリ識別子(例:注文 ID または予約 ID)のコンテキストでジャーニーを実行できます。 これにより、補助識別子が異なる場合、同じプロファイルの複数のエントリを許可できます。
ジャーニーの補助識別子の使用方法の詳細情報。 オーディエンスを読み取りジャーニーの場合、補助識別子は、統合プロファイルサービスオーディエンスの 和集合/プロファイルスキーマ から準備されるか、外部オーディエンス(例:CSV ファイルからインポートされたオーディエンスや、構成ワークフローの結果)の実施要件を満たす属性から選択されます。 補助 ID を使用する場合、読み取り率はジャーニーインスタンスごとに 1 秒あたり 500 プロファイルに制限されます。
ガードレールとレコメンデーション must-read
オーディエンスを読み取りアクティビティに関するすべてのガードレールと制限(同時実行数、スループット、アクティビティごとに 1 つのオーディエンス、ジョブタイムアウト、再試行など)は、ガードレールと制限に一覧表示されています。
レコメンデーション
- ベストプラクティスとして、信頼性が高く一貫性のあるカウントを得るために、オーディエンスを読み取りアクティビティでバッチオーディエンスを使用します。 「オーディエンスを読み取り」は、バッチのユースケース向けに設計されています。 ユースケースでリアルタイムデータが必要な場合は、代わりにオーディエンスの選定アクティビティを使用します。
- CSV ファイルから読み込まれたオーディエンスや、構成ワークフローから生成されたオーディエンスは、「オーディエンスを読み取り」アクティビティで選択できます。 これらのオーディエンスは、「オーディエンスの選定」アクティビティでは使用できません。
- オーディエンススナップショットのタイミング、バッチセグメント化の完了ウィンドウ、ジャーニーを常に最新のデータで実行する方法について詳しくは、タイミングとデータの生成を参照してください。 繰り返しジャーニーについては、「バッチオーディエンス評価の後にトリガー」オプションを有効にすることを検討してください。これにより、最新のオーディエンススナップショットの準備が整うまで、実行を自動的に遅延させることができます。 学習を増やす。
次:読み取り率とスケジュールを設定し、テストして公開します。
プロファイルのエントリと読み取り率 profile-entry-and-reading-rate
読み取り率を設定します(必須)。 これは、1 秒あたりにジャーニーにエントリできるプロファイルの最大数です。 このレートは、このアクティビティにのみ適用され、ジャーニーの他のアクティビティには適用されません。 例えば、カスタムのアクションに対してスロットルレートを定義する場合は、Throttling API を使用する必要があります。 このページを参照してください。
この値は、ジャーニーバージョンのペイロードに格納されます。 デフォルト値は、1 秒あたり 5,000 プロファイルです。 この値は、1 秒あたり 500~20,000 プロファイルの範囲で変更できます。
ジャーニーのスケジュール schedule
デフォルトでは、ジャーニーは 1 回実行されるように設定されています。 ジャーニーを実行する特定の日付/時刻と頻度を定義するには、次の手順に従います。
- 繰り返し以外のオーディエンスを読み取りジャーニーは、最後にアクティブなプロファイルが離脱すると、自動的に 停止 ステータスに移行します。待機期間を発生させるノード(待機ノード、反応ノード、イベントトリガートランジション)がジャーニーに含まれていない限り、その場合は標準の 91 日間のグローバルタイムアウトが適用されます。 詳細情報
- 終了日のない 繰り返し のオーディエンスを読み取りジャーニーは、ジャーニーが公開されている限り、ライブのままになります。 実行の 最後の発生 から 91 日後に、完了ステータスに移行します。
- 91 日間のタイムアウトは、ジャーニーを通じてフローする個々のプロファイル(プロファイルがアクティブなままでいられる最大時間)に適用され、ジャーニーのライブステータスには適用されません。
- 91 日間の レポートウィンドウ は別の概念です。UI には、過去約 91 日間のパフォーマンスデータが表示されます。 古いデータには UI ではアクセスできませんが、ジャーニーは引き続き実行されます。 詳細情報
-
オーディエンスを読み取りアクティビティのプロパティで、「ジャーニースケジュールを編集」を選択します。
-
ジャーニーのプロパティが表示されます。 スケジューラータイプドロップダウンリストで、ジャーニーを実行する頻度を選択します。
繰り返しジャーニーの場合は、ジャーニーへのプロファイルのエントリを管理するのに役立つ特定のオプションを使用できます。 各オプションについて詳しくは、以下の節を展開してください。
繰り返しの オーディエンスを読み取り を含んだジャーニーが初めて実行されると、オーディエンス内のすべてのプロファイルがジャーニーにエントリします。 このオプションを使用すると、最初の実行後、ジャーニーの前回の実行以降にオーディエンスにエントリした個人のみをターゲットにすることができます。
このオプションを使用すると、システムは 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
オーディエンスを読み取りアクティビティを使用すると、単一プロファイルでジャーニーをテストできます。
それには、テストモードを有効にします。
通常どおりにテストモードを設定し実行します。 ジャーニーのテスト方法を学ぶ。
テストを実行したら、「ログを表示」ボタンを使用して、テスト結果を確認できます。 詳しくは、この節を参照してください。
テストが正常に完了すると、ジャーニーを公開できます(ジャーニーの公開を参照)。 オーディエンスに属する個人は、ジャーニーのプロパティの「スケジューラー」セクションで指定された日時にジャーニーにエントリします。
ジャーニーでのオーディエンスのターゲティング audience-targeting-in-journeys
オーディエンスベースのジャーニーは常に、オーディエンスを読み取りアクティビティで始まり、Adobe Experience Platform オーディエンスに属する個人を取得します。 これらのプロファイルは、1 回または繰り返しスケジュールで読み取られます。
ジャーニーがエントリされた後、条件アクティビティを使用して参加者を調整します。属性や行動でセグメント化したり、母集団の一部を除外したり、分岐を再結合(和集合)したりします。 以下の節では、各パターンについて説明します。
セグメント化
条件を使用して、条件アクティビティでセグメント化を実行できます。 例えば、VIP 顧客は特定のパス、VIP 以外の顧客は別のパスに沿って進むようにすることができます。
セグメント化は以下に基づいて実行できます。
- データソースのデータ
- ジャーニーデータに含まれるイベントのコンテキスト(例:ある人物が 1 時間前に受け取ったメッセージをクリックしたか)
- 日付(例:ある人物がジャーニーを経験したのは 6 月だったか?)。
- 時間(例:その人物のタイムゾーンで午前中か?)
- ジャーニーに流入するオーディエンスを割合に基づいて分割するアルゴリズム(例:コントロール母集団を除外するために 90% - 10% に分割)
除外
セグメント化に使用するのと同じ 条件 アクティビティ(上記を参照)を使用すると、母集団の一部を除外することもできます。 例えば、VIP を除外するには、そのユーザーを終了ステップ直前の分岐に送ります。
この除外は、母集団のカウントを目的として、または複数のステップから成るジャーニーに従って、オーディエンスの取得直後に発生する可能性があります。
和集合
ジャーニーを使用すると、セグメント化の後に、N 個の分岐を作成および結合できます。 その結果、2 つのオーディエンスを同じエクスペリエンスに戻すことができます。
例えば、VIP の顧客と VIP 以外の顧客は、ジャーニーで 10 日間別々のエクスペリエンスを経た後で、同じパスに戻ることができます。 和集合の後、セグメント化や除外を実行してオーディエンスを再度分割できます。
トラブルシューティング audience-count-mismatch
この節は、オーディエンスサイズの不一致(想定より少ないまたは多いプロファイルがエントリしている)、処理されたプロファイルがゼロ(オーディエンスを読み取りアラートまたはエントリなし)、エントリの遅延または欠落(タイミングやデータの生成)の解決に役立ちます。
segmentExportJob イベントと呼ばれる)が生成されます。 これらのイベントは、個々のプロファイルごとではなく、アクティビティレベルで記録され、モニタリングやトラブルシューティングの目的でクエリを実行できます。 詳しくは、オーディエンスを読み取りイベントのクエリを参照してください。問題を検索:
処理されたプロファイルがゼロ zero-profiles-processed
オーディエンスを読み取りアクティビティがプロファイルを処理していない場合(例:オーディエンスを読み取りアラートを参照):
- オーディエンスが空かどうかを確認 - Adobe Experience Platform で、オーディエンスサイズとそのプロファイルが 実現済み ステータスであることを確認します。 空のオーディエンスまたはまだ未評価のオーディエンスは、エントリが 0 になります。
- 名前空間を確認 - オーディエンスを読み取りアクティビティで選択された名前空間が、オーディエンス内のプロファイルに存在している必要があります。 この ID のないプロファイルは、ジャーニーにエントリできません。 名前空間の詳細情報。
- アラートを確認して再試行 - 失敗は アラート で報告されます。 システムは、エクスポートジョブの作成を 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
「オーディエンスを読み取り」アクティビティによってトリガーされるジャーニーに適用可能なユースケースを理解します。 バッチベースのジャーニーを構築する方法と適用するベストプラクティスについて説明します。
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.