XDM ExperienceEvent class

XDM ExperienceEvent は標準のエクスペリエンスデータモデル (XDM) クラスで、特定のイベントが発生した場合や特定の条件が満たされた場合に、システムのタイムスタンプ付きのスナップショットを作成できます。

エクスペリエンスイベントは、発生した事実(特定の時点や個人の ID など)を記録したものです。 イベントは、明示的(直接観察可能な人間のアクション)または暗黙的(直接人間のアクションなしで発生)に設定でき、集計や解釈なしで記録されます。 プラットフォームエコシステムでのこのクラスの使用に関する概要については、XDM の概要 を参照してください。

XDM ExperienceEvent クラス自体は、1 つのスキーマに時系列関連のフィールドを複数提供します。 データの取得時に、これらのフィールドの一部の値が自動的に設定されます。

プロパティ 説明
_id イベントの一意の文字列識別子。 このフィールドは、個々のイベントの一意性を追跡し、データの重複を防ぎ、ダウンストリームサービスでそのイベントを検索するために使用します。 場合によっては、_idUniversally Unique Identifier(UUID) または Globally Unique Identifier(GUID) にすることができます。

ソース接続からデータをストリーミングする場合、または Parquet ファイルから直接取り込む場合は、プライマリ ID、タイムスタンプ、イベントタイプなど、イベントを一意にするフィールドの特定の組み合わせを連結して、この値を生成します。連結された値は、uri-reference 形式の文字列である必要があります。つまり、コロン文字は削除する必要があります。 その後、連結された値は、SHA-256 または選択した別のアルゴリズムを使用してハッシュ化する必要があります。

このフィールドは、個人 に関連する ID ではなく、データ自体のレコードを表すことを区別することが重要です。個人に関する ID データは、互換性のあるフィールドグループから提供される ID フィールド に置き換える必要があります。
eventMergeId Adobe Experience Platform Web SDK を使用してデータを取り込む場合、これはレコードが作成される原因となった取り込まれたバッチの ID を表します。 このフィールドは、データの取り込み時にシステムによって自動的に設定されます。 Web SDK 実装のコンテキスト外でのこのフィールドの使用はサポートされていません。
eventType イベントのタイプまたはカテゴリを示す文字列。 このフィールドは、製品表示イベントと小売会社の買い物かごへの追加イベントを区別するなど、同じスキーマとデータセット内の異なるイベントタイプを区別する場合に使用できます。

このプロパティの標準値は付録の で提供され、使用例の説明を含みます。このフィールドは拡張可能な列挙型です。つまり、独自のイベントタイプ文字列を使用して、追跡するイベントを分類することもできます。

eventType では、アプリケーションでのヒットあたり 1 つのイベントのみを使用できます。そのため、計算フィールドを使用して、最も重要なイベントをシステムに知らせる必要があります。詳しくは、 計算フィールドのベストプラクティス に関する節を参照してください。
producedBy イベントのプロデューサーまたは発生元を示す string 値です。 このフィールドを使用すると、セグメント化のために必要な場合に、特定のイベントプロデューサーを除外できます。

このプロパティの推奨値の一部は、付録の節に記 載されています。このフィールドは拡張可能な列挙型です。つまり、独自の文字列を使用して、様々なイベントプロデューサーを表すこともできます。
identityMap イベントが適用される個人の名前空間付き ID のセットを含む map フィールド。 このフィールドは、ID データが取り込まれると、システムによって自動的に更新されます。 このフィールドを リアルタイム顧客プロファイル に適切に利用するには、データ操作でフィールドの内容を手動で更新しないでください。

使用例について詳しくは、「スキーマ合成の基 本」の「 ID マッ プ」の節を参照してください。
timestamp イベントが発生した時点の ISO 8601 タイムスタンプ。RFC 3339 Section 5.6 に従って形式設定されます。 このタイムスタンプは過去に発生している必要があります。 このフィールドの使用に関するベストプラクティスについては、 タイムスタンプ に関する以下の節を参照してください。

イベントモデリングのベストプラクティス

以下の節では、Adobe Experience Platformでイベントベースのエクスペリエンスデータモデル (XDM) スキーマを設計する際のベストプラクティスについて説明します。

タイムスタンプ

イベントスキーマのルート timestamp フィールドは、のみ で、イベント自体の観察を表し、過去に発生する必要があります。 セグメント化の使用例で、将来発生する可能性のあるタイムスタンプの使用が必要な場合、これらの値はエクスペリエンスイベントスキーマの他の場所で制限する必要があります。

例えば、旅行・接客業の企業がフライト予約イベントをモデル化している場合、クラスレベルの timestamp フィールドは予約イベントが発生した時刻を表します。 旅行予約の開始日など、イベントに関連するその他のタイムスタンプは、標準フィールドグループまたはカスタムフィールドグループで提供される個別のフィールドに取り込む必要があります。

クラスレベルのタイムスタンプをイベントスキーマ内の他の関連する日時値とは別に保つことで、カスタマージャーニーのタイムスタンプ付きの説明をエクスペリエンスアプリケーションに保存しながら、柔軟なセグメント化の使用例を実装できます。

計算フィールドの使用

エクスペリエンスアプリケーションの特定のインタラクションによって、複数の関連イベントが技術的に同じイベントタイムスタンプを共有する可能性があるので、単一のイベントレコードとして表すことができます。 例えば、顧客が Web サイトで製品を閲覧すると、次の 2 つの eventType 値を持つイベントレコードが生成される可能性があります。「製品表示」イベント (commerce.productViews) または汎用の「ページ表示」イベント (web.webpagedetails.pageViews)。 このような場合、計算フィールドを使用して、1 回のヒットで複数のイベントをキャプチャする際に最も重要な属性をキャプチャできます。

Adobe Experience Platform Data Prepaloes では、XDM との間でデータのマッピング、変換、検証をおこなうことができます。Experience Platformに取り込まれる際に、論理演算子を呼び出して、複数イベントレコードのデータの優先順位付け、変換、統合を行うことができます。 🔗上記の例では、eventType を、「製品表示」と「ページ表示」の両方が発生したときに優先順位を付ける計算フィールドとして指定できます。

UI を使用してデータを Platform に手動で取り込む場合、 計算フィールドのガイド を参照して、計算フィールドの作成方法の詳細を確認してください。

ソース接続を使用して Platform にデータをストリーミングする場合は、代わりに計算フィールドを使用するようにソースを設定できます。 接続を設定する際の計算フィールドの実装方法については、使用する特定のソース 🔗 の ドキュメントを参照してください。

互換性のあるスキーマフィールドグループ

メモ

複数のフィールドグループの名前が変更されました。 詳しくは、 フィールドグループ名の更新 のドキュメントを参照してください。

Adobeは、XDM ExperienceEvent クラスで使用するいくつかの標準フィールドグループを提供します。 次に、クラスでよく使用されるフィールドグループの一覧を示します。

付録

次の節では、XDM ExperienceEvent クラスに関する追加情報を示します。

eventType に指定できる値

eventType に指定できる値とその定義を次の表に示します。

定義
advertising.clicks 広告のアクションをクリックします。
advertising.completes 時間指定メディアアセットが最後まで視聴されました。 視聴者が先にスキップした可能性があるので、必ずしも視聴者がビデオ全体を視聴したとは限りません。
advertising.conversions パフォーマンス評価のためのイベントをトリガーする、顧客が実行する事前定義済みのアクション。
advertising.federated エクスペリエンスイベントがデータフェデレーション(顧客間でのデータ共有)を通じて作成されたかどうかを示します。
advertising.firstQuartiles デジタルビデオ広告は、通常の速度で再生時間の 25% を再生しました。
advertising.impressions 顧客に対する広告のインプレッション(複数可)。
advertising.midpoints デジタルビデオ広告は、通常の速度で再生時間の 50%を再生しました。
advertising.starts デジタルビデオ広告の再生が開始されました。
advertising.thirdQuartiles デジタルビデオ広告は、通常の速度で再生時間の 75%を再生しました。
advertising.timePlayed 特定の時間指定メディアアセットに対するユーザーの滞在時間を示します。
application.close アプリケーションが終了したか、バックグラウンドに送信されました。
application.launch アプリケーションが起動されたか、フォアグラウンドに移行された。
commerce.checkouts 製品リストのチェックアウトイベントが発生しました。 チェックアウトプロセスに複数のステップがある場合、複数のチェックアウトイベントが存在する可能性があります。 複数の手順がある場合、各イベントのタイムスタンプと参照先のページ/エクスペリエンスが、順番に表された個々のイベント(手順)を識別するために使用されます。
commerce.productListAdds 製品が製品リストまたは買い物かごに追加されました。
commerce.productListOpens 新しい製品リスト(買い物かご)が初期化または作成されました。
commerce.productListRemovals 1 つ以上の製品エントリが製品リストまたは買い物かごから削除されました。
commerce.productListReopens アクセスできなくなった(破棄された)製品リスト(買い物かご)は、リマーケティングアクティビティを介してなど、顧客によって再度アクティブ化されました。
commerce.productListViews 製品リストまたは買い物かごに 1 つ以上の表示が届きました。
commerce.productViews 製品が 1 つ以上の表示を受け取りました。
commerce.purchases 注文が受け入れられました。これは、コマース変換で必要なアクションのみです。 購入イベントは、製品リストを参照する必要があります。
commerce.saveForLaters 製品リストは、製品の一覧など、今後の使用のために保存されました。
decisioning.propositionDisplay 判定の提案が人に表示されました。
decisioning.propositionInteract 人が判定提案に対してやり取りを行った。
delivery.feedback E メール配信などの配信のフィードバックイベント。
directMarketing.emailBounced バウンスしたユーザーへの E メール。
directMarketing.emailBouncedSoft ソフトバウンスされたユーザーへの E メール。
directMarketing.emailClicked ある人がマーケティング用電子メールのリンクをクリックしました。
directMarketing.emailDelivered ユーザーの電子メールサービスに電子メールが正常に配信されました
directMarketing.emailOpened マーケティング用の電子メールを開いた人。
directMarketing.emailUnsubscribed マーケティング用の電子メールを購読解除したユーザー。
leadOperation.convertLead リードが変換されました。
leadOperation.interestingMoment 人の興味深い瞬間を記録した。
leadOperation.newLead リードが作成されました。
leadOperation.scoreChanged リードのスコア属性の値が変更されました。
leadOperation.statusInCampaignProgressionChanged キャンペーン内のリードのステータスが変更されました。
listOperation.addToList マーケティングリストにユーザーが追加されました。
listOperation.removeFromList マーケティングリストから削除されたユーザー。
message.feedback 顧客に送信されたメッセージの送信/バウンス/エラーなどのフィードバックイベント。
message.tracking 顧客に送信されたメッセージに対する開く/クリック/カスタムアクションなどのイベントを追跡する。
opportunityEvent.addToOpportunity 機会に人を加えた。
opportunityEvent.opportunityUpdated オポチュニティが更新されました。
opportunityEvent.removeFromOpportunity 機会を失った人。
pushTracking.applicationOpened プッシュ通知からアプリを開いたユーザー。
pushTracking.customAction ユーザーがプッシュ通知でカスタムアクションをクリックしました。
web.formFilledOut Wep ページに記入した人。
web.webinteraction.linkClicks リンクが 1 回以上選択されました。
web.webpagedetails.pageViews Web ページに 1 つ以上のビューが届きました。

producedBy の推奨値

次の表に、producedBy に使用できる値の概要を示します。

定義
self 自己
system システム
salesRef 営業担当
customerRep 顧客担当者

このページ