ジャーニーでのオーディエンスの使用 segment-trigger-activity
オーディエンスを読み取りアクティビティを使用すると、定義済みのオーディエンスでジャーニーを開始できます。 オーディエンスとそれが実行されるタイミングを選択し、条件、タイマー、アクションを使用して各プロファイルのパスをパーソナライズします。
オーディエンスを読み取りアクティビティについて about-segment-trigger-activity
オーディエンスを読み取り アクティビティは、選択したオーディエンスのすべてのプロファイルをジャーニーに追加する、ジ Adobe Experience Platform ーニーのエントリポイントアクティビティです。 エントリは、1 回または定期的なスケジュールで実行できます。 API およびテクニカルリファレンスでは、このアクティビティはセグメントトリガーまたはオーディエンスベースのジャーニーエントリとも呼ばれます。
オーディエンスを読み取りとオーディエンスの選定のどちらを使用するか
キー制限： ジャーニーごとに 1 つの読み取りオーディエンス（最初のアクティビティである必要があります）、アクティビティごとに 1 つのオーディエンス、1 組織あたり最大 5 つの同時オーディエンスの読み取り実行、サンドボックスごとに 1 秒あたり 20,000 個のプロファイル、12 時間のジョブタイムアウト。 詳しくは、 ガードレールと推奨事項 を参照してください。
前提条件： 構築および評価される Adobe Experience Platform オーディエンス（実現ステータス）、ジャーニー用に選択されたユーザーベースの ID 名前空間、繰り返し実行の場合 スケジュールとスループットの制限 の理解。
例えば、Luma app opening and checkout オーディエンスを作成 ユースケースで作成した オーディエンスは、エントリポイントとして使用できます。 すべての認定プロファイルは、条件、タイマー、イベント、アクションを使用して、ジャーニーにエントリし、個別のパスを進めます。
➡️ この機能をビデオで確認
- オーディエンスを読み取りアクティビティを使用する前に、ガードレールと制限のトピックに目を通してください。
アクティビティの設定 configuring-segment-trigger-activity
オーディエンス （必須）、名前空間 （必須）、読み取り率 （必須、デフォルト 5,000/s）、スケジュール （ジャーニーの実行時）を設定します。 必要に応じて、「ラベル および 補足識別子 を追加します。 次の手順では、各設定について説明します。
アクティビティを追加してオーディエンスを選択 add-activity-and-select-audience
-
オーケストレーションカテゴリを展開し、オーディエンスをを読み取りアクティビティをキャンバスにドロップします。
アクティビティは、ジャーニーの最初のステップとして配置する必要があります。
-
アクティビティに ラベル を追加します（オプション）。 オプションのラベルを使用すると、レポートやテストモードのログでアクティビティを特定するのに役立ちます。
-
「オーディエンス」フィールドで、ジャーニーにエントリする Adobe Experience Platform オーディエンスを選択し、「保存」をクリックします。セグメント定義を使用して生成された Adobe Experience Platform オーディエンスを選択できます。
note 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 note NOTE 様々な ID の中から選択した ID（名前空間）を持たないオーディエンスに属する個人は、ジャーニーにエントリできません。ユーザーベースの ID 名前空間のみ選択できます。名前空間を参照テーブルに対して定義した場合（例：ProductID 名前空間を Product 参照に対して定義した場合）、その名前空間を 名前空間 ドロップダウンリストで使用することはできません。
追加の識別子 read-audience-supplemental-id
必要に応じて、追加の識別子を使用 を有効にして、プロファイル ID に加えて、セカンダリ識別子（注文 ID、予約 ID など）のコンテキストでジャーニーを実行できます。 これにより、追加の識別子が異なる場合に、同じプロファイルの複数のエントリが可能になります。
ジャーニーで追加の識別子を使用する方法を説明します 。 オーディエンスを読み取りジャーニーの場合、追加の識別子はプロファイル属性である必要があります。追加の ID を使用すると、読み取り速度は 1 秒あたり 500 プロファイルに制限されます。
ガードレールとレコメンデーション must-read
-
ジャーニーで使用できる オーディエンスを読み取り アクティビティは 1 つだけで、それをキャンバスの最初のアクティビティにする必要があります。
-
オーディエンスを読み取りアクティビティのターゲットにできるオーディエンスは 1 つだけです。複数のオーディエンスが必要な場合は、使用前に、それらのオーディエンスを 1 つのオーディエンスに結合することを検討してください。構成ワークフローを使用してオーディエンスを結合する方法については、こちらを参照してください
-
オーディエンスを読み取りアクティビティを使用するジャーニーの場合、同時に開始できるジャーニーの最大数が決まっています。再試行は、システムによって実行されます。ただし、5 つを超えるジャーニー（オーディエンスを読み取り、スケジュール済み、または「できるだけ早く」開始）が同時に開始されることは避けてください。ベストプラクティスは、時間の経過と共に、5 分から 10 分の間隔で分散することです。
-
エクスペリエンスイベントのフィールドグループは、オーディエンスを読み取りアクティビティ、オーディエンスの選定アクティビティ、またはビジネスイベントアクティビティで始まるジャーニーでは使用できません。
-
ベストプラクティスとして、バッチオーディエンスは、オーディエンスを読み取りアクティビティでのみ使用することをお勧めします。これにより、ジャーニーで使用されるオーディエンスが、高い信頼性かつ一貫してカウントされます。「オーディエンスを読み取り」は、バッチのユースケース向けに設計されています。ユースケースでリアルタイムデータが必要な場合は、オーディエンスの選定アクティビティを使用します。
-
CSV ファイルから読み込まれたオーディエンスや、構成ワークフローから生成されたオーディエンスは、「オーディエンスを読み取り」アクティビティで選択できます。これらのオーディエンスは、「オーディエンスの選定」アクティビティでは使用できません。
-
組織ごとのオーディエンス同時読み取り制限：各組織はオーディエンスの読み取りインスタンスを最大 5 つ同時に実行できます。これには、スケジュールされた実行とビジネスイベントによってトリガーされる実行の両方が含まれます。制限は、すべてのサンドボックスとジャーニーをまたいで適用されます。この制限は、すべての組織で公平かつバランスの取れたリソース配分が確保するのに適用されます。
-
サンドボックススループット管理：システムは、サンドボックスごとの処理スループットを動的に管理し、すべてのオーディエンス読み取りアクティビティで共有されるプロファイル数の上限は 1 秒あたり 20,000 個です。個々のオーディエンス読み取りアクティビティは、1 秒あたり最低 500 個のプロファイルで設定できます。サンドボックスレベルのスループット制限に達した場合、公正なリソース割り当てを確保するために、ジョブをキューに追加することができます。
-
ジョブ処理タイムアウト：ガードレールの制限により 12 時間以内に処理できないオーディエンス読み取りジョブは、自動的にクリーンアップされ、実行されなくなります。これにより、ジョブの蓄積を防ぎ、システムの安定性が確保されます。
-
バッチセグメントを使用する場合は、ジャーニーが開始する前に、取り込みと毎日のスナップショットの更新が適切に完了していることを確認します。セグメントが同じ日に取り込まれたデータを反映する必要がある場合は、追加の待機期間を考慮します。即時プロファイルの鮮度が重要である場合は、毎日のバッチアプローチの代わりにイベントベースまたはストリーミングアプローチを使用します。または、待機メカニズムを挿入して、ジャーニーの評価の前に生成する更新済みのデータを許可します。
「オーディエンスを読み取り」アクティビティに関連するガードレールについて詳しくは、このページを参照してください。
次： 読み取り率 と スケジュール を設定し、 テストして公開 を設定します。
プロファイルのエントリと読み取り率 profile-entry-and-reading-rate
読み取り率 を設定します（必須）。 これは、1 秒あたりにジャーニーにエントリできるプロファイルの最大数です。このレートは、このアクティビティにのみ適用され、ジャーニーの他のアクティビティには適用されません。例えば、カスタムのアクションに対してスロットルレートを定義する場合は、Throttling API を使用する必要があります。このページを参照してください。
この値は、ジャーニーバージョンのペイロードに格納されます。デフォルト値は、1 秒あたり 5,000 プロファイルです。この値は、1 秒あたり 500～20,000 プロファイルの範囲で変更できます。
ジャーニーのスケジュール schedule
デフォルトでは、ジャーニーは 1 回実行されるように設定されています。ジャーニーを実行する特定の日付／時刻と頻度を定義するには、次の手順に従います。
-
オーディエンスを読み取りアクティビティのプロパティで、「ジャーニースケジュールを編集」を選択します。
-
ジャーニーのプロパティが表示されます。スケジューラータイプドロップダウンリストで、ジャーニーを実行する頻度を選択します。
繰り返しジャーニーの場合は、ジャーニーへのプロファイルのエントリを管理するのに役立つ特定のオプションを使用できます。各オプションについて詳しくは、以下の節を展開してください。
繰り返しの オーディエンスを読み取り を含んだジャーニーが初めて実行されると、オーディエンス内のすべてのプロファイルがジャーニーにエントリします。このオプションを使用すると、最初の実行後、ジャーニーの前回の実行以降にオーディエンスにエントリした個人のみをターゲットにすることができます。
このオプションを使用すると、システムは Adobe Experience Platform のセグメント化サービスによって実行された前回のオーディエンス評価ジョブの時点から 24 時間前まで遡って確認します。
セグメント化が完了すると、プロファイルスナップショットのエクスポートジョブが開始され、Journey Optimizer が新しいプロファイルを検出して処理できるようになります。これらの 2 つのジョブの間にジャーニーがスケジュールされている場合、増分読み取りでは、ジャーニーの前回の実行以降にオーディエンスのメンバーになったプロファイルは取得されません。
プロファイルが欠落するリスクを最小限に抑えるには：
- 「バッチオーディエンス評価の後にトリガー」オプションを有効にすると、発生した経過時間に関係なく、最後に成功したジャーニー実行時までルックバック期間を延長できます
- 毎日のバッチセグメント化ジョブが完了した後にジャーニーが適切に実行されるようにスケジュールします（通常 2～3 時間のバッファー）
- すぐにプロファイルを組み込む必要がある緊急のユースケースでは、代わりにストリーミングオーディエンスでのオーディエンスの選定アクティビティの使用を考慮します
| note caution |
|---|
| CAUTION |
| ジャーニーで カスタムアップロードオーディエンス をターゲットにしている場合、プロファイルは、繰り返しジャーニーでこのオプションが有効になっている場合の最初の繰り返し時にのみ取得されます。 これらのオーディエンスは固定されています。 |
このオプションを使用すると、ジャーニーにまだ存在するすべてのプロファイルを、次回の実行時に自動的に終了させることができます。
例えば、毎日の繰り返しジャーニーに 2 日間の待機がある場合、このオプションを有効にすると、プロファイルは次のジャーニーの実行に移動します。 これは、次回実行されるオーディエンスに含まれているかどうかに関係なく、翌日に発生します。
このジャーニーでのプロファイルの存続期間が繰り返し頻度よりも長くなる可能性がある場合は、プロファイルがジャーニーを終了できるようにするために、このオプションをアクティブ化しないでください。
毎日スケジュールされ、バッチオーディエンスをターゲティングするジャーニーの場合、バッチセグメント化ジョブからの新しいオーディエンスデータを待機するジャーニーの時間枠を最大 6 時間まで定義できます。セグメント化ジョブが時間枠内に完了すると、ジャーニーがトリガーされます。それ以外の場合は、次回の実行までジャーニーはスキップされます。このオプションにより、正確かつ最新のオーディエンスデータを使用してジャーニーが実行されます。
例えば、毎日午後 6 時にジャーニーがスケジュールされている場合、ジャーニーの実行前に待機する分数または時間数を指定できます。午後 6 時にジャーニーが起動すると、新しいオーディエンス、つまり前回のジャーニー実行時に使用されたオーディエンスよりも新しいオーディエンスがないか確認します。指定した時間枠内で、新しいオーディエンスが検出されるとすぐにジャーニーが実行されます。新しいオーディエンスが検出されない場合、その日のジャーニーの実行はスキップされます。
ジャーニーのテストと公開 testing-publishing
オーディエンスを読み取りアクティビティを使用すると、単一プロファイルでジャーニーをテストできます。
それには、テストモードを有効にします。
通常どおりにテストモードを設定し実行します。ジャーニーのテスト方法を学ぶ。
テストを実行したら、「ログを表示」ボタンを使用して、テスト結果を確認できます。詳しくは、この節を参照してください。
テストが正常に完了すると、ジャーニーを公開できます（ジャーニーの公開を参照）。オーディエンスに属する個人は、ジャーニーのプロパティの「スケジューラー」セクションで指定された日時にジャーニーにエントリします。
ジャーニーでのオーディエンスのターゲティング
オーディエンスベースのジャーニーは常に、オーディエンスに属する個人を取得する オーディ ンスを読み取り 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 で、オーディエンスサイズとプロファイルが 実現済み ステータスであることを確認します。 空のオーディエンスや評価されていないオーディエンスの場合、エントリはゼロになります。
- 名前空間を確認 - オーディエンスを読み取りアクティビティで選択した名前空間は、オーディエンスのプロファイルに存在する必要があります。 その ID を持たないプロファイルは、ジャーニーにエントリできません。 名前空間の詳細情報。
- アラートと再試行の確認 - エラーは アラート で報告されます。 エクスポートジョブの作成は、最大 1 時間、10 分ごとに再試行されます。 再試行とアラートの詳細情報 。
これらのチェック後も問題が解決しない場合は、バッチおよび設定の原因に関する タイミングとデータの伝播 および データの検証と監視 を参照してください。
タイミングとデータの生成 timing-and-data-propagation
-
バッチセグメント化ジョブの完了：バッチオーディエンスの場合、ジャーニーを実行する前に、毎日のバッチセグメント化ジョブが完了し、スナップショットが更新されていることを確認します。バッチオーディエンスは、セグメント化ジョブの完了から約 2 時間後に使用できます。詳しくは、オーディエンスの評価方法を参照してください。
-
データ取り込みのタイミング：ジャーニーの実行前にプロファイルデータ取り込みが完全に完了していることを確認します。プロファイルがジャーニーの開始直前に取り込まれた場合、まだオーディエンスに反映されていないことがあります。詳しくは、 のデータ取り込み Adobe Experience Platform を参照してください。
-
「バッチオーディエンス評価の後にトリガー」を使用：バッチオーディエンスを使用する毎日のスケジュール済みジャーニーの場合は、「バッチオーディエンス評価の後にトリガー」オプションを有効にすることを考慮します。これにより、ジャーニーは実行される前に最新のオーディエンスデータ（最大 6 時間）を待機するようになります。 詳しくは、スケジュール設定を参照してください。
-
待機アクティビティを追加：最近取り込まれたデータを持つストリーミングオーディエンスの場合は、データの生成とプロファイルの選定の時間を確保するために、ジャーニーの開始時に 待機 アクティビティを追加することを考慮します。待機アクティビティの詳細情報
データの検証 data-validation-and-monitoring
-
セグメント化ジョブのステータスの確認:Adobe Experience Platform 監視ダッシュボード でバッチセグメント化ジョブの完了時間を監視します。 オーディエンスデータの準備が整ったタイミングを確認するために使用します。
-
結合ポリシーを確認：オーディエンスに対して設定された結合ポリシーが、異なるソースからのプロファイルデータを組み合わせる場合の予想される動作と一致していることを確認します。詳しくは、 の結合ポリシー Adobe Experience Platform を参照してください。
-
セグメント定義を確認：セグメント定義が正しく設定され、予想されるすべての選定条件が含まれていることを確認します。詳しくは、オーディエンスの作成を参照してください。特に注意すべき点：
- イベントのタイムスタンプに基づいてプロファイルを除外する場合がある時間ベースの条件
- 最近更新されたデータに依存する属性の選定
- ストリーミングとバッチの評価方法
-
名前空間の設定を検証：オーディエンスを読み取りアクティビティで選択された名前空間が、オーディエンス内のプロファイルで使用されるプライマリ ID と一致していることを確認します。選択された名前空間のないプロファイルは、ジャーニーにエントリしません。詳しくは、ID 名前空間を参照してください。
ベストプラクティス
-
セグメント化の後にジャーニーをスケジュール：バッチオーディエンスの場合、通常のバッチセグメント化ジョブの完了時間から 2～3 時間以上後にジャーニーの実行をスケジュールします。ジャーニーのスケジュールの詳細情報
-
リアルタイムのユースケースにストリーミングオーディエンスを使用：即時のプロファイルの選定とジャーニーのエントリが必要な場合は、バッチオーディエンスでの オーディエンスを読み取り の代わりに、ストリーミングオーディエンスでオーディエンスの選定アクティビティを使用します。
-
最初に小規模なオーディエンスでテスト：大規模なジャーニーを開始する前に、小規模なサブセットでテストして、カウントが期待値と一致することを検証します。ジャーニーのテスト方法の詳細情報
-
定期的に監視：オーディエンスサイズとジャーニーエントリ指標の定期的な監視を設定し、不一致を早期に検出します。詳しくは、ジャーニーの処理率とエントリ管理を参照してください。
サポートに連絡するタイミング
上記の手順を実行してもカウントが一致しない、またはプロファイルが 0 で実行される場合は、Adobe サポートにお問い合わせください。 準備ができている：オーディエンス名/ID、ジャーニー名/ID、スケジュールされた実行時間、サンドボックスおよび不一致の簡単な説明（例：「オーディエンスは 10,000 件実現を示し、[ 日付 ]」にジャーニーにエントリしたのは 2,000 件のみ）。
再試行 read-audience-retry
再試行は、エクスポートジョブの取得中に、オーディエンストリガージャーニー（オーディエンスを読み取りまたは ビジネスイベント で始まる）にデフォルトで適用されます。エクスポートジョブの作成中にエラーが発生した場合、最大 1 時間、10 分ごとに再試行が行われます。それ以降は失敗と見なされます。したがって、これらのタイプのジャーニーは、スケジュールされた時間から最大 1 時間後に実行できます。
失敗した オーディエンスを読み取りトリガーはキャプチャされ、アラート に表示されます。 オーディエンスを読み取り アラートは、オーディエンスを読み取り アクティビティが、スケジュールされた実行時間から 10 分後にプロファイルを処理していない場合、警告を表示します。 このエラーは、技術的な問題や空のオーディエンスが原因で発生する可能性があります。 技術的な問題が原因でエラーが発生した場合でも、問題のタイプによっては、再試行が行われることがあります。 例えば、エクスポートジョブの作成に失敗した場合は、10 分ごとに最大 1 時間再試行します。 詳細情報
関連トピック
チュートリアルビデオ video
「オーディエンスを読み取り」アクティビティによってトリガーされるジャーニーに適用可能なユースケースを理解します。バッチベースのジャーニーを構築する方法と適用するベストプラクティスについて説明します。