note important |
---|
IMPORTANT |
ストリーミングセグメント化またはエッジセグメント化を使用して現在評価されている既存のセグメント定義は、編集または更新されない限り、引き続きそのまま機能します。 |
ルールセット ruleset
次のルールセットに一致する 新規または編集 セグメント定義は、ストリーミングまたはエッジセグメント化を使用して 評価されなくなります。 代わりに、バッチセグメント化を使用して評価されます。
- 24 時間を超える時間枠を持つ単一イベント
- 過去 3 日間に Web ページを表示したすべてのプロファイルでオーディエンスをアクティブ化します。
- 時間枠のない単一イベント
- Web ページを表示したすべてのプロファイルでオーディエンスをアクティブ化します。
時間枠 time-window
ストリーミングセグメント化を使用してオーディエンスを評価するには、24 時間の時間枠内にオーディエンスを制限する 必要 があります。
ストリーミングオーディエンスへのバッチデータの組み込み include-batch-data
この更新を行う前は、バッチとストリーミングの両方のデータソースを組み合わせたストリーミングオーディエンス定義を作成していました。 ただし、最新の更新では、バッチデータソースとストリーミングデータソースの両方を使用したオーディエンスの作成は、バッチセグメント化を使用して評価されます。
更新されたルールセットに一致するストリーミングまたはエッジセグメント化を使用してセグメント定義を評価する必要がある場合は、バッチおよびストリーミングルールセットを明示的に作成し、セグメントのセグメントを使用してそれらを組み合わせる必要があります。 このバッチルールセット 必須 は、プロファイルスキーマに基づいている必要があります。
例えば、プロファイルスキーマデータを格納するオーディエンスと、エクスペリエンスイベントスキーマデータを格納する他のオーディエンスの 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でアクティブ」結合ポリシー上にある必要があります。
アクティブな結合ポリシーが設定されていない場合は、 結合ポリシーを設定し、エッジでアクティブに設定する必要があります。
ストリーミングセグメント化は、データの豊富さを重視しながら、ほぼリアルタイムでAdobe Experience Platformのオーディエンスを評価する機能です。
ストリーミングセグメント化を使用すると、ストリーミングデータがExperience Platformに到着する際にオーディエンスの選定が行われるので、セグメント化ジョブをスケジュールして実行する必要がなくなります。 これにより、データをExperience Platformに渡す際に評価し、オーディエンスメンバーシップを自動的に最新の状態に保つことができます。
適格なルールセット rulesets
ルールセットは、次の表に示す条件のいずれかを満たす場合、ストリーミングセグメント化の対象となります。
CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])

homeAddress.country.equals("US", false)

workAddress.country.equals("US", 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)])

次のシナリオでは、セグメント定義はストリーミングセグメント化の対象 なります 対象外)。
- セグメント定義には、Adobe Audience Manager(AAM)のセグメントまたは特性が含まれます。
- セグメント定義には複数のエンティティ(複数エンティティクエリ)が含まれます。
- セグメント定義には、単一のイベントと
inSegment
イベントの組み合わせが含まれます。- 例えば、1 つのルールセットで次の要素を連結します。
inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(<= 24 hours before now)])
- 例えば、1 つのルールセットで次の要素を連結します。
- セグメント定義では、時間制約の一部として「年を無視」を使用します。
ストリーミングセグメント化クエリに適用される次のガイドラインに注意してください。
- ルックバックウィンドウは 1 日 に制限されています。
- イベント間に厳密な時間順序条件が存在する 必要があります。
- 少なくとも 1 つの否定イベントを含むクエリがサポートされています。 ただし、イベント全体を否定することは できません。
セグメント定義を変更して、ストリーミングセグメント化の条件を満たさなくなった場合、セグメント定義は自動的に「ストリーミング」から「バッチ」に切り替わります。
また、セグメントの選定解除は、セグメントの選定と同様に、リアルタイムで発生します。その結果、オーディエンスがセグメントの選定対象ではなくなった場合、そのオーディエンスはただちに選定解除となります。例えば、セグメント定義で「過去 3 時間で赤い靴を購入したすべてのユーザー」という要求があった場合、3 時間後に、最初にセグメント定義で選定されたすべてのプロファイルが無効になります。
オーディエンスの結合 combine-audiences
バッチソースとストリーミングソースの両方のデータを組み合わせるには、バッチコンポーネントとストリーミングコンポーネントを別々のオーディエンスに分離する必要があります。
プロファイル属性とエクスペリエンスイベント profile-and-event
例えば、次の 2 つのサンプルオーディエンスを考慮します。
e3be6d7f-1727-401f-a41e-c296b45f607a
9e1646bb-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-6316df049948
9e1646bb-57ff-4309-ba59-17d6c5bab6a1
この場合は、次のように 3 つ目のオーディエンスを作成する必要があります。
inSegment("7deb246a-49b4-4687-95f9-6316df049948) and inSegment("9e1646bb-57ff-4309-ba59-17d6c5bab6a1")
オーディエンスを作成 create-audience
Segmentation Service API または UI のオーディエンスポータルを使用して、ストリーミングセグメント化を使用して評価されるオーディエンスを作成できます。
セグメント定義が 適格なルールセットのいずれかと一致する場合、ストリーミングを有効にすることができます。
API 形式
code language-http |
---|
|
リクエスト
accordion | ||
---|---|---|
ストリーミングセグメント化が有効なセグメント定義を作成するリクエストの例 | ||
|
応答
リクエストが成功した場合は、新しく作成したセグメント定義の詳細と HTTP ステータス 200 が返されます。
accordion | ||
---|---|---|
セグメント定義を作成する際の応答のサンプル | ||
|
このエンドポイントの使用について詳しくは、 セグメント定義エンドポイントガイドを参照してください。
オーディエンスポータルで、「オーディエンスを作成」を選択します。
ポップオーバーが表示されます。 ルールを作成 を選択して、セグメントビルダーに入ります。
セグメントビルダー内で、 適格なルールセットの 1 つに一致するセグメント定義を作成します。 セグメント定義がストリーミングセグメント化の対象になると、評価方法 として ストリーミング を選択できるようになります。
セグメント定義の作成について詳しくは、セグメントビルダーガイドを参照してください。
オーディエンスの取得 retrieve-audiences
Segmentation Service API または UI のオーディエンスポータルを使用して、ストリーミングセグメント化を使用して評価されるすべてのオーディエンスを取得できます。
/segment/definitions
エンドポイントに対してGET リクエストを行い、組織内でストリーミングセグメント化を使用して評価されるすべてのセグメント定義のリストを取得します。
API 形式
ストリーミングセグメント化を使用して評価されたセグメント定義を取得するには、リクエストパスにクエリパラメーター evaluationInfo.synchronous.enabled=true
を含める必要があります。
code language-http |
---|
|
リクエスト
accordion | ||
---|---|---|
ストリーミングが有効なすべてのセグメント定義を一覧表示するサンプルリクエスト | ||
|
応答
応答に成功すると、HTTP ステータス 200 が、ストリーミングセグメント化が有効になっている組織内のセグメント定義の配列と共に返されます。
accordion | ||
---|---|---|
組織内のストリーミングセグメント化が有効なすべてのセグメント定義のリストを含むサンプル応答 | ||
返されるセグメント定義について詳しくは、セグメント定義エンドポイントガイドを参照してください。 |
オーディエンスポータルのフィルターを使用すると、組織内でストリーミングセグメント化が有効になっているすべてのオーディエンスを取得できます。
使用可能なフィルター内で、頻度を更新 に移動し、「 ストリーミング 」を選択します。 このフィルターを使用すると、ストリーミングセグメント化を使用して評価された、組織内のすべてのオーディエンスが表示されます。
Experience Platformでのオーディエンスの表示について詳しくは、 オーディエンスポータルガイドを参照してください。
オーディエンスの詳細 audience-details
ストリーミングセグメント化を使用して評価された特定のオーディエンスの詳細を、オーディエンスポータル内で選択して表示できます。
オーディエンスポータルでオーディエンスを選択すると、オーディエンスの詳細ページが表示されます。 オーディエンスの詳細の概要、選定されたプロファイルの量の推移、オーディエンスがアクティブ化されている宛先など、オーディエンスに関する情報が表示されます。
ストリーミングが有効なオーディエンスの場合は、プロファイルの推移 カードが表示され、合計選定済み指標と新しいオーディエンスの更新済み指標が表示されます。
合計選定 指標は、このオーディエンスのバッチおよびストリーミングの評価に基づいた、選定オーディエンスの合計数を表します。
更新された新しいオーディエンス 指標は、ストリーミングセグメント化によるオーディエンスサイズの変化を示す折れ線グラフで表されます。 ドロップダウンを調整して、過去 24 時間、先週または過去 30 日間を表示できます。
オーディエンスの詳細については、 オーディエンスポータルの概要を参照してください。
次の手順
このガイドでは、ストリーミングが有効なセグメント定義がAdobe Experience Platformでどのように機能するか、およびストリーミングが有効なセグメント定義をどのように監視するかについて説明します。
Adobe Experience Platform ユーザーインターフェイスの使用について詳しくは、セグメント化ユーザーガイドを参照してください。
ストリーミングセグメント化に関するよくある質問については、FAQ のストリーミングセグメント化の節を参照してください。