ジャーニーでのオーディエンスの使用 segment-trigger-activity
オーディエンスを読み取りアクティビティについて about-segment-trigger-actvitiy
オーディエンスを読み取り アクティビティを使用すると、オーディエンスのすべての個人をジャーニーにエントリさせることができます。 ジャーニーへのエントリは、1 回限りと定期的のいずれも可能です。
オーディエンスの作成ユースケースで作成した「Luma アプリのオープンとチェックアウト」オーディエンスを例に取ります。オーディエンスを読み取りアクティビティを使用すると、このオーディエンスに属するすべての個人をジャーニーにエントリさせることができます。 条件、タイマー、イベント、アクションなどのジャーニーのすべての機能を活用する、個別のジャーニーに送られます。
segmentExportJob イベントと呼ばれる)が生成されます。これらのイベントは、個々のプロファイルごとではなく、アクティビティレベルで記録され、監視やトラブルシューティングの目的でクエリを実行できます。詳しくは、オーディエンスを読み取りイベントのクエリを参照してください。- オーディエンスを読み取りアクティビティを使用する前に、 ガードレールと制限事項を参照 してください。
アクティビティの設定 configuring-segment-trigger-activity
オーディエンスを読み取りアクティビティを設定する手順は、次のとおりです。
オーディエンスを読み取りアクティビティを追加し、オーディエンスを選択します
-
オーケストレーションカテゴリを展開し、オーディエンスをを読み取りアクティビティをキャンバスにドロップします。
アクティビティは、ジャーニーの最初のステップとして配置する必要があります。
-
アクティビティに ラベル を追加します(オプション)。
-
「オーディエンス」フィールドで、ジャーニーにエントリする 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 参照に対して定義した場合)、その名前空間を 名前空間 ドロップダウンリストで使用することはできません。
ガードレールとレコメンデーション must-read
-
ジャーニーで使用できる オーディエンスを読み取り アクティビティは 1 つだけで、それをキャンバスの最初のアクティビティにする必要があります。
-
オーディエンスを読み取りアクティビティのターゲットにできるオーディエンスは 1 つだけです。複数のオーディエンスが必要な場合は、使用前に、それらのオーディエンスを 1 つのオーディエンスに結合することを検討してください。構成ワークフローを使用してオーディエンスを結合する方法については、こちらを参照してください
-
オーディエンスを読み取りアクティビティを使用するジャーニーの場合、同時に開始できるジャーニーの最大数が決まっています。再試行はシステムによって実行されます。 ただし、ジャーニーが 5 つ以上(オーディエンスを読み取り、スケジュールされているか、「できるだけ早く」開始されている)まったく同時に開始することは避けてください。 ベストプラクティスは、時間の経過と共に、5 分から 10 分の間隔で分散することです。
-
エクスペリエンスイベントのフィールドグループは、オーディエンスを読み取りアクティビティ、オーディエンスの選定アクティビティ、またはビジネスイベントアクティビティで始まるジャーニーでは使用できません。
-
ベストプラクティスとして、バッチオーディエンスは、オーディエンスを読み取りアクティビティでのみ使用することをお勧めします。これにより、ジャーニーで使用されるオーディエンスが、高い信頼性かつ一貫してカウントされます。「オーディエンスを読み取り」は、バッチのユースケース向けに設計されています。ユースケースでリアルタイムデータが必要な場合は、オーディエンスの選定アクティビティを使用します。
-
CSV ファイルから読み込まれたオーディエンスや、構成ワークフローから生成されたオーディエンスは、「オーディエンスを読み取り」アクティビティで選択できます。これらのオーディエンスは、「オーディエンスの選定」アクティビティでは使用できません。
-
組織ごとのオーディエンス同時読み取り制限:各組織はオーディエンスの読み取りインスタンスを最大 5 つ同時に実行できます。これには、スケジュールされた実行と、ビジネスイベントによってトリガーされる実行の両方が含まれます。 制限は、すべてのサンドボックスとジャーニーに適用されます。 この制限は、すべての組織で公平かつバランスの取れたリソース配分が確保するのに適用されます。
-
サンドボックススループット管理:システムは、サンドボックスごとの処理スループットを動的に管理し、すべてのオーディエンス読み取りアクティビティで共有されるプロファイル数の上限は 1 秒あたり 20,000 個です。個々のオーディエンス読み取りアクティビティは、1 秒あたり最低 500 個のプロファイルで設定できます。サンドボックスレベルのスループット制限に達した場合、公正なリソース割り当てを確保するために、ジョブをキューに入れることができます。
-
ジョブ処理タイムアウト:ガードレールの制限により 12 時間以内に処理できないオーディエンス読み取りジョブは、自動的にクリーンアップされ、実行されなくなります。これにより、ジョブの蓄積を防ぎ、システムの安定性が確保されます。
-
バッチセグメントを使用する場合は、ジャーニーが開始する前に、取り込みと毎日のスナップショットの更新が適切に完了していることを確認します。セグメントが同じ日に取り込まれたデータを反映する必要がある場合は、追加の待機期間を考慮します。プロファイルの即時鮮度が重要な場合は、毎日のバッチアプローチではなく、イベントベースまたはストリーミングアプローチを使用します。 または、待機メカニズムを挿入して、更新されたデータをジャーニーの評価の前に広めるようにします。
「オーディエンスを読み取り」アクティビティに関連するガードレールについて詳しくは、このページを参照してください。
ジャーニーでのプロファイルエントリの管理
読み取り率を設定します。これは、1 秒あたりにジャーニーにエントリできるプロファイルの最大数です。このレートは、このアクティビティにのみ適用され、ジャーニーの他のアクティビティには適用されません。例えば、カスタムのアクションに対してスロットルレートを定義する場合は、Throttling API を使用する必要があります。このページを参照してください。
この値は、ジャーニーバージョンのペイロードに格納されます。デフォルト値は、1 秒あたり 5,000 プロファイルです。この値は、1 秒あたり 500~20,000 プロファイルの範囲で変更できます。
ジャーニーのスケジュール schedule
デフォルトでは、ジャーニーは 1 回実行されるように設定されています。 ジャーニーを実行する特定の日付/時刻と頻度を定義するには、次の手順に従います。
-
オーディエンスを読み取り アクティビティプロパティで、「ジャーニースケジュールを編集」を選択します。
-
ジャーニーのプロパティが表示されます。スケジューラータイプドロップダウンリストで、ジャーニーを実行する頻度を選択します。
繰り返しジャーニーの場合は、ジャーニーへのプロファイルのエントリを管理するのに役立つ特定のオプションを使用できます。各オプションについて詳しくは、以下の節を展開してください。
繰り返し オーディエンスを読み取り を含んだジャーニーが初めて実行されると、オーディエンス内のすべてのプロファイルがジャーニーにエントリします。 このオプションを使用すると、最初の実行後、ジャーニーの前回の実行以降にオーディエンスにエントリした個人のみをターゲットにすることができます。
このオプションを使用する場合、システムは、のセグメント化サービスが最後に実行したオーディエンス評価ジョブの時間から 24 時間 Adobe Experience Platform を振り返ります。
セグメント化が完了すると、プロファイルスナップショットエクスポートジョブが開始され、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
ジャーニーにエントリする推定オーディエンス数、選定されたプロファイル、実際のプロファイルの間に不一致が見られる場合は、次の点を考慮します。
タイミングとデータの生成
-
バッチセグメント化ジョブの完了:バッチオーディエンスの場合、ジャーニーを実行する前に、毎日のバッチセグメント化ジョブが完了し、スナップショットが更新されていることを確認します。バッチオーディエンスは、セグメント化ジョブの完了から約 2 時間後に使用できます。詳しくは、オーディエンスの評価方法を参照してください。
-
データ取り込みのタイミング:ジャーニーの実行前にプロファイルデータ取り込みが完全に完了していることを確認します。プロファイルがジャーニーの開始直前に取り込まれた場合、まだオーディエンスに反映されていないことがあります。詳しくは、Adobe Experience Platform でのデータ取り込みを参照してください。
-
「バッチオーディエンス評価の後にトリガー」を使用:バッチオーディエンスを使用する毎日のスケジュール済みジャーニーの場合は、「バッチオーディエンス評価の後にトリガー」オプションを有効にすることを考慮します。これにより、ジャーニーは実行される前に最新のオーディエンスデータ(最大 6 時間)を待機するようになります。 詳しくは、スケジュール設定を参照してください。
-
待機アクティビティを追加:最近取り込まれたデータを持つストリーミングオーディエンスの場合は、データの生成とプロファイルの選定の時間を確保するために、ジャーニーの開始時に 待機 アクティビティを追加することを考慮します。待機アクティビティの詳細情報
データの検証と監視
-
セグメント化ジョブのステータスを確認:Adobe Experience Platform の監視ダッシュボードでバッチセグメント化ジョブの完了時間を監視して、オーディエンスデータの準備が整ったことを確認します。
-
結合ポリシーを確認:オーディエンスに対して設定された結合ポリシーが、異なるソースからのプロファイルデータを組み合わせる場合の予想される動作と一致していることを確認します。詳しくは、Adobe Experience Platform の結合ポリシーを参照してください。
-
セグメント定義を確認:セグメント定義が正しく設定され、予想されるすべての選定条件が含まれていることを確認します。詳しくは、オーディエンスの作成を参照してください。特に注意すべき点:
- イベントのタイムスタンプに基づいてプロファイルを除外する場合がある時間ベースの条件
- 最近更新されたデータに依存する属性の選定
- ストリーミングとバッチの評価方法
-
名前空間の設定を検証:オーディエンスを読み取りアクティビティで選択された名前空間が、オーディエンス内のプロファイルで使用されるプライマリ ID と一致していることを確認します。選択された名前空間のないプロファイルは、ジャーニーにエントリしません。詳しくは、ID 名前空間を参照してください。
不一致を防ぐためのベストプラクティス
-
セグメント化の後にジャーニーをスケジュール:バッチオーディエンスの場合、通常のバッチセグメント化ジョブの完了時間から 2~3 時間以上後にジャーニーの実行をスケジュールします。ジャーニーのスケジュールの詳細情報
-
リアルタイムのユースケースにストリーミングオーディエンスを使用:即時のプロファイルの選定とジャーニーのエントリが必要な場合は、バッチオーディエンスでの オーディエンスを読み取り の代わりに、ストリーミングオーディエンスでオーディエンスの選定アクティビティを使用します。
-
最初に小規模なオーディエンスでテスト:大規模なジャーニーを開始する前に、小規模なサブセットでテストして、カウントが期待値と一致することを検証します。ジャーニーのテスト方法の詳細情報
-
定期的に監視:オーディエンスサイズとジャーニーエントリ指標の定期的な監視を設定し、不一致を早期に検出します。詳しくは、ジャーニーの処理率とエントリ管理を参照してください。
これらの手順を実行してもカウントの不一致が続く場合、オーディエンス、ジャーニー設定、確認された不一致について詳しくは、アドビサポートにお問い合わせください。
再試行 read-audience-retry
再試行は、エクスポートジョブの取得中に、オーディエンストリガージャーニー(オーディエンスを読み取りまたは ビジネスイベント で始まる)にデフォルトで適用されます。エクスポートジョブの作成中にエラーが発生した場合、最大 1 時間、10 分ごとに再試行が行われます。それ以降は失敗と見なされます。したがって、これらのタイプのジャーニーは、スケジュールされた時間から最大 1 時間後に実行できます。
失敗した オーディエンスを読み取り トリガーはキャプチャされ、アラートに表示されます。「オーディエンスを読み取りアラート」は、スケジュールされた実行時間から 10 分経過しても、オーディエンスを読み取りアクティビティでプロファイルが処理されなかった場合に警告します。このエラーは、技術的な問題やオーディエンスが空であることが原因で発生する可能性があります。このエラーが技術的な問題によって発生した場合、問題のタイプに応じて、再試行が引き続き行われる可能性があります(例:エクスポートジョブの作成に失敗した場合、最大 1 時間、10 分ごとに再試行されます)。詳細情報
関連トピック
チュートリアルビデオ video
「オーディエンスを読み取り」アクティビティによってトリガーされるジャーニーに適用可能なユースケースを理解します。バッチベースのジャーニーを構築する方法と適用するベストプラクティスについて説明します。