ストリーミングセグメンテーションガイド
ストリーミングセグメンテーションとは、Adobe Adobe Experience Platformのオーディエンスを、データリッチメントに重点を置いてほぼリアルタイムで評価する能力です。
ストリーミングセグメンテーションを利用することで、ストリーミングデータがExperience Platformに格納される際に、オーディエンスの選定を実行できるようになり、セグメンテーションジョブをスケジュールして実行する必要性が軽減されました。 これにより、Experience Platformに渡されたデータを評価して、オーディエンスメンバーシップを自動的に最新の状態に保つことができます。
対象ルールセット rulesets
ルールセットは、次の表に示す基準のいずれかを満たす場合、ストリーミングセグメンテーションの対象となります。
CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])
homeAddress.country.equals("Canada", false)
workAddress.country.equals("Canada", false) and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])
workAddress.country.equals("US", false) and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("directMarketing.emailClicked", false)) WHEN(today), C1: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])
セグメント定義は、次のシナリオでnot ストリーミングセグメント化の対象となります。
-
セグメント定義には、Adobe Audience Manager(AAM)のセグメントまたは特性が含まれます。
-
セグメント定義には複数のエンティティ(複数エンティティクエリ)が含まれます。
-
セグメント定義には、単一のイベントと
inSegmentイベントの組み合わせが含まれます。- 例えば、単一のルールセットで次のチェーンを作成します:
inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(<= 24 hours before now)])。
- 例えば、単一のルールセットで次のチェーンを作成します:
-
セグメント定義では、時間制約の一部として「年を無視」を使用します。
-
セグメント定義は、次のルールセットと一致します。
- 24時間を超える時間枠を持つ単一のイベント
- 例えば、「過去3日間にweb ページを閲覧したすべてのプロファイルでオーディエンスをアクティベートする」とします。
- 時間枠のない単一のイベント
- 例えば、「Web ページを閲覧したすべてのプロファイルを使用してオーディエンスをアクティベートする」とします。
- 24時間を超える時間枠を持つ単一のイベント
ストリーミングセグメンテーションクエリに適用される次のガイドラインに注意してください。
- ルックバックウィンドウは 1 日に制限されています。
- イベント間に厳密な時間順序条件が存在する必要があります。
- 少なくとも 1 つの否定イベントを含むクエリがサポートされています。 ただし、イベント全体を否定することはできません。
セグメント定義を変更して、ストリーミングセグメント化の条件を満たさなくなった場合、セグメント定義は自動的に「ストリーミング」から「バッチ」に切り替わります。
また、セグメントの選定解除は、セグメントの選定と同様に、リアルタイムで発生します。その結果、オーディエンスがセグメントの選定対象ではなくなった場合、そのオーディエンスはただちに選定解除となります。例えば、セグメント定義で「過去 3 時間で赤い靴を購入したすべてのユーザー」という要求があった場合、3 時間後に、最初にセグメント定義で選定されたすべてのプロファイルが無効になります。
オーディエンスの組み合わせ combine-audiences
バッチソースとストリーミングソースの両方からのデータを組み合わせるには、バッチコンポーネントとストリーミングコンポーネントを別々のオーディエンスに分ける必要があります。
プロファイル属性とエクスペリエンスイベント profile-and-event
例えば、次の2つのサンプルオーディエンスを考えてみましょう。
e3be6d7f-1727-401f-a41e-c296b45f607a9e1646bb-57ff-4309-ba59-17d6c5bab6a1ストリーミングオーディエンスでバッチコンポーネントを使用する場合は、セグメントのセグメントを使用してバッチオーディエンスを参照する必要があります。
したがって、2つのオーディエンスを組み合わせるルールセットの例は次のようになります。
inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and
CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false))
WHEN(<= 24 hours before now)])
結果のオーディエンス は、バッチオーディエンスコンポーネントを参照してバッチオーディエンスのメンバーシップを活用するため、ストリーミングセグメンテーションを使用して評価されます。
複数のエクスペリエンスイベント two-events
複数のオーディエンスをイベントデータと組み合わせたい場合、は イベントを組み合わせることはできません。 イベントごとにオーディエンスを作成し、inSegmentを使用してすべてのオーディエンスを参照する別のオーディエンスを作成する必要があります。
例えば、2つのオーディエンスがあり、両方のオーディエンスにエクスペリエンスイベントスキーマデータが格納されているとします。
7deb246a-49b4-4687-95f9-6316df0499489e1646bb-57ff-4309-ba59-17d6c5bab6a1この場合、次のように3番目のオーディエンスを作成する必要があります。
inSegment("7deb246a-49b4-4687-95f9-6316df049948) and inSegment("9e1646bb-57ff-4309-ba59-17d6c5bab6a1")
オーディエンスを作成 create-audience
ストリーミングセグメンテーションを使用して評価されるオーディエンスは、Segmentation Service APIまたはUIのAudience Portalを使用して作成できます。
セグメント定義は、適格なルールセット のいずれかに一致する場合、ストリーミングを有効にできます。
API 形式
| code language-http |
|---|
|
リクエスト
| accordion | ||
|---|---|---|
| ストリーミングセグメント化が有効なセグメント定義を作成するためのサンプルリクエスト | ||
|
応答
リクエストが成功した場合は、新しく作成したセグメント定義の詳細と HTTP ステータス 200 が返されます。
| accordion | ||
|---|---|---|
| セグメント定義を作成する際の応答のサンプル。 | ||
|
このエンドポイントの使用について詳しくは、 セグメント定義エンドポイントガイド を参照してください。
オーディエンスポータルで、Create audienceを選択します。
ポップオーバーが表示されます。 Build rulesを選択してセグメントビルダーに入ります。
セグメントビルダー内で、適格なルールセット のいずれかに一致するセグメント定義を作成します。 セグメント定義がストリーミングセグメント化に適合する場合は、Streamingを Evaluation method として選択できます。
セグメント定義の作成について詳しくは、セグメントビルダーガイドを参照してください。
オーディエンスの取得 retrieve-audiences
ストリーミングセグメンテーションを使用して評価されたすべてのオーディエンスを取得するには、Segmentation Service APIまたはUIのAudience Portalを使用します。
/segment/definitions エンドポイントに対してGET リクエストを行うことで、組織内のストリーミングセグメンテーションを使用して評価されたすべてのセグメント定義のリストを取得します。
API 形式
ストリーミングセグメント化を使用して評価されたセグメント定義を取得するには、クエリパラメーターevaluationInfo.synchronous.enabled=trueをリクエストパスに含める必要があります。
| code language-http |
|---|
|
リクエスト
| accordion | ||
|---|---|---|
| ストリーミングが有効なすべてのセグメント定義を一覧表示するサンプルリクエスト | ||
|
応答
応答が成功すると、ストリーミングセグメント化が有効になっている組織内のセグメント定義の配列を含むHTTP ステータス 200が返されます。
| accordion | ||
|---|---|---|
| 組織内のすべてのストリーミングセグメンテーション対応セグメント定義のリストを含むサンプル応答 | ||
返されるセグメント定義について詳しくは、セグメント定義エンドポイントガイドを参照してください。 |
オーディエンスポータルのフィルターを使用すると、組織内のストリーミングセグメンテーションに有効なすべてのオーディエンスを取得できます。
使用可能なフィルター内で、Update frequencyに移動し、「Streaming」を選択します。 このフィルターを使用すると、ストリーミングセグメンテーションを使用して評価された組織内のすべてのオーディエンスが表示されます。
Experience Platformでのオーディエンスの表示について詳しくは、 オーディエンスポータルガイド を参照してください。
オーディエンスの詳細 audience-details
ストリーミングセグメンテーションを使用して評価された特定のオーディエンスの詳細を、オーディエンスポータル内で選択して表示できます。
オーディエンスポータルでオーディエンスを選択すると、オーディエンスの詳細ページが表示されます。 これにより、オーディエンスの詳細の要約、時間の経過に伴う適格プロファイルの量、オーディエンスがアクティブ化された宛先など、オーディエンスに関する情報が表示されます。
ストリーミングが有効なオーディエンスの場合、Profiles over time カードが表示され、合計適格オーディエンス数と新しいオーディエンス更新指標が表示されます。
Total qualified指標は、このオーディエンスのバッチ評価とストリーミング評価に基づいて、選定されたオーディエンスの合計数を表します。
New audience updated指標は、ストリーミングセグメンテーションによるオーディエンスサイズの変化を示す折れ線グラフで表されます。 ドロップダウンを調整して、過去24時間、先週、または過去30日間を表示できます。
オーディエンスの詳細については、 オーディエンスポータルの概要を参照してください。
次の手順
このガイドでは、Adobe Experience Platformでのストリーミング対応セグメント定義の仕組みと、ストリーミング対応セグメント定義のモニタリング方法について説明します。
Adobe Experience Platform ユーザーインターフェイスの使用について詳しくは、セグメント化ユーザーガイドを参照してください。
ストリーミングセグメンテーションに関するよくある質問については、FAQの「 ストリーミングセグメンテーション」の節をご覧ください。
付録
この節では、ストリーミングセグメンテーションに関する補足情報を提供します。
2025年5月20日(PT)資格情報の更新 may-20-eligibility-update
以降では、Experience Platformの2025年5月リリース中に発生したストリーミングセグメンテーションの実施要件アップデートの詳細を後世の段階で説明します。
| note important |
|---|
| IMPORTANT |
| ストリーミングまたはエッジセグメント化を使用して現在評価されている既存のセグメント定義はすべて、編集または更新されない限り、そのまま機能し続けます。 |
ルールセット ruleset
次のルールセットに一致する新しいまたは編集された セグメント定義は、ストリーミングまたはエッジセグメント化を使用して評価されなくなります。 代わりに、バッチセグメンテーションを使用して評価されます。
- 24時間を超える時間枠を持つ単一のイベント
- 過去3日間にweb ページを閲覧したすべてのプロファイルを含むオーディエンスをアクティベートします。
- 時間枠のない単一のイベント
- web ページを閲覧したあらゆるプロファイルをもとに、オーディエンスをアクティベートできます。
時間枠 time-window
ストリーミングセグメンテーションを使用してオーディエンスを評価するには、24時間以内に制限する必要があります。
バッチデータをストリーミングオーディエンスに含める include-batch-data
| note note |
|---|
| NOTE |
| バッチデータを使用する際にストリーミングセグメンテーションを正確に保つには、バッチデータがバッチオーディエンス内に のみ 保持され、ストリーミングオーディエンス内で参照されていることを確認します。 |
このアップデートの前に、バッチデータソースとストリーミングデータソースの両方を組み合わせたストリーミングオーディエンス定義を作成できます。 ただし、最新のアップデートでは、バッチデータソースとストリーミングデータソースの両方を使用してオーディエンスを作成することが、バッチセグメンテーションを使用して評価されます。
更新されたルールセットに一致するストリーミングまたはエッジセグメント化を使用してセグメント定義を評価する必要がある場合は、バッチおよびストリーミングルールセットを明示的に作成し、セグメントのセグメントを使用して組み合わせる必要があります。 このバッチ ルールセット は、プロファイル スキーマに基づく必要があります。
例えば、1つのオーディエンスハウジングのプロファイルスキーマデータと他のハウジングのエクスペリエンスイベントスキーマデータを含む2つのオーディエンスがあるとします。
| table 0-row-5 1-row-5 2-row-5 | ||||
|---|---|---|---|---|
| オーディエンス | スキーマ | ソースタイプ | クエリ定義 | オーディエンス ID |
| カリフォルニア在住の方 | プロファイル | バッチ | 住所はカリフォルニア州 | e3be6d7f-1727-401f-a41e-c296b45f607a |
| 最近のチェックアウト | エクスペリエンスイベント | ストリーミング | 過去24時間に少なくとも1回のチェックアウトがある | 9e1646bb-57ff-4309-ba59-17d6c5bab6a1 |
ストリーミングオーディエンスでバッチコンポーネントを使用する場合は、セグメントのセグメントを使用してバッチオーディエンスを参照する必要があります。
したがって、2つのオーディエンスを組み合わせるルールセットの例は次のようになります。
| code language-none |
|---|
|
結果のオーディエンス は、バッチオーディエンスコンポーネントを参照してバッチオーディエンスのメンバーシップを活用するため、ストリーミングセグメンテーションを使用して評価されます。
ただし、2つのオーディエンスをイベントデータと組み合わせたい場合、2つのイベントを組み合わせることはできません。 両方のオーディエンスを作成してから、inSegmentを使用してこれらの両方のオーディエンスを参照する別のオーディエンスを作成する必要があります。
例えば、2つのオーディエンスがあり、両方のオーディエンスにエクスペリエンスイベントスキーマデータが格納されているとします。
| table 0-row-5 1-row-5 2-row-5 | ||||
|---|---|---|---|---|
| オーディエンス | スキーマ | ソースタイプ | クエリ定義 | オーディエンス ID |
| 最近の放棄 | エクスペリエンスイベント | バッチ | 過去24時間に少なくとも1つの放棄イベントがある | e3be6d7f-1727-401f-a41e-c296b45f607a |
| 最近のチェックアウト | エクスペリエンスイベント | ストリーミング | 過去24時間に少なくとも1回のチェックアウトがある | 9e1646bb-57ff-4309-ba59-17d6c5bab6a1 |
この場合、次のように3番目のオーディエンスを作成する必要があります。
| code language-none |
|---|
|
| note important |
|---|
| IMPORTANT |
| ルールセットに一致するすべての既存のセグメント定義は、編集されるまで、ストリーミングセグメントまたはエッジセグメント化を使用して評価されたままになります。 |
| さらに、現在、他のストリーミングまたはエッジセグメント化の評価基準を満たす既存のセグメント定義はすべて、ストリーミングまたはエッジセグメント化で評価されたままになります。 |
結合ポリシー merge-policy
ストリーミングまたはエッジセグメント化 に適格な 新規または編集された セグメント定義は、「Edgeでアクティブ」結合ポリシーに 含まれている必要があります。
アクティブな結合ポリシーセットがない場合は、結合ポリシーを設定し エッジでアクティブになるように設定する必要があります。