イベント転送の概要
Adobe Experience Platformのイベント転送(旧称Adobe Experience Platform Launch サーバーサイド)を使用すると、収集したイベントデータをサーバーサイド処理の宛先に送信できます。 イベント転送は、通常クライアントで行なわれるタスクを、Adobe Experience Platform Edge ネットワークを使用して実行することにより、web ページやアプリの負担を軽減します。 タグと同様の方法で実装されたイベント転送ルールは、データを変換して新しい宛先に送信できますが、このデータを web ブラウザーなどのクライアントアプリケーションから送信する代わりに、アドビのサーバーから送信します。
このドキュメントでは、Experience Platformでのイベント転送の概要を説明します。
データ収集エコシステムでの
イベント転送を Adobe Experience Platform Web SDK および Mobile SDK と組み合わせると、次のような利点があります。
パフォーマンス:
- データのペイロードを含むページから 1 回の呼び出しを行い、このデータをサーバーサイドで統合して、クライアントサイドのネットワークトラフィックを減らし、より高速なエクスペリエンスを顧客に提供します。
- Web ページの読み込みにかかる時間を短縮し、サイトのパフォーマンスを向上させます。
- 多くの宛先へのエクスペリエンスの配信やデータの送信に必要なクライアントサイドテクノロジーの数を減らします。
データガバナンス:
- 透明性を高め、すべてのプロパティを通して、どのテータをどこに送信するかを制御します。
イベント転送とタグの違い differences-from-tags
設定に関しては、イベント転送はルール、データ要素、拡張など、タグと同じ概念の多くを使用します。 この 2 つの主な違いを要約すると、次のようになります。
- Web サイトまたはネイティブモバイルアプリケーションから イベントデータをタグ付けして 収集し、Experience Platform Edge Networkに送信します。
- イベント転送は、Experience Platform Edge Networkから受信した イベントデータを、元のペイロードをエンリッチするデータを提供する最終宛先またはエンドポイントを表すエンドポイントに送信します。
タグは、Experience Platform Web SDKとMobile SDKを使用して、サイトまたはネイティブモバイルアプリケーションからイベントデータを直接収集しますが、イベント転送では、イベントデータを配信先に転送するために、Experience Platform Edge Networkを通じて既に送信する必要があります。 つまり、イベント転送を使用するには、Experience Platform WebまたはMobile SDKをデジタルプロパティ(タグ経由または生コードを使用)に実装する必要があります。
プロパティ properties
イベント転送では、タグとは別に独自のプロパティのストアが保持されます。左側のナビゲーションで「イベント転送」を選択すると、Experience Platform UIまたはデータ収集UIで表示できます。
データ収集UIの
すべてのイベント転送プロパティには、Edgeがプラットフォームとして一覧表示されます。 webとモバイルを区別しないのは、Experience Platform Edge Networkから受信したデータのみを処理し、それ自体がwebとモバイルの両方のプラットフォームからイベントデータを受信できるためです。
拡張機能 extensions
イベント転送には、Core 拡張機能や Adobe Cloud Connector 拡張機能など、互換性のある拡張機能の独自のカタログがあります。 UIでイベント転送プロパティの使用可能な拡張機能を表示するには、左側のナビゲーションで 拡張機能 を選択し、次に カタログ を選択します。
右側のパネルから「
データ収集UIの
データ要素 data-elements
イベント転送で利用できるデータ要素のタイプは、それらを提供する互換性のある拡張機能のカタログに限定されます。
データ要素自体は、タグと同じようにイベント転送で作成および設定されますが、Experience Platform Edge Networkのデータを参照する方法に関しては、いくつかの重要な構文の違いがあります。
Experience Platform Edge Networkからのデータの参照 data-element-path
Experience Platform Edge Networkからデータを参照するには、そのデータへの有効なパスを提供するデータ要素を作成する必要があります。 UIでデータ要素を作成する際に、拡張機能にCore、タイプに Path を選択します。
データ要素の Path 値は、パターン arc.event.{ELEMENT}に従う必要があります(例:arc.event.xdm.web.webPageDetails.URL)。 データを送信するには、このパスを正しく指定する必要があります。
右側のパネルから「
ルール rules
イベント転送プロパティでのルールの作成はタグと同様に機能しますが、重要な違いは、イベントをルールコンポーネントとして選択できないことです。 代わりに、イベント転送ルールはデータストリームから受け取ったすべてのイベントを処理し、特定の条件を満たした場合にそれらのイベントを宛先に転送します。
さらに、イベント転送プロパティ内のすべてのルール(したがって、すべてのアクション)で処理される1つのイベントに適用される30秒のタイムアウトがあります。 つまり、単一のイベントに対するすべてのルールとすべてのアクションは、この時間枠で完了する必要があります。
右側のパネルから「
データ収集UIの
データ要素のトークン化 tokenization
タグルールでは、データ要素名の先頭と末尾に % を付けてデータ要素をトークン化します(例:%viewportHeight%)。 イベント転送ルールでは、データ要素は代わりにデータ要素名の先頭に {{、末尾に }} を付けてトークン化します(例:{{viewportHeight}})。
右側のパネルから「
ルールアクションのシーケンス action-sequencing
イベント転送ルールの アクション セクションは、常に順次実行されます。 例えば、ルールに2つのアクションがある場合、2番目のアクションは、前のアクションが完了するまで実行を開始しません(また、エンドポイントから応答が期待される場合は、そのエンドポイントが応答します)。 ルールを保存する際に、アクションの順序が正しいことを確認します。 この実行シーケンスは、タグルールと同様に非同期で実行することはできません。
秘密鍵 secrets
イベント転送を使用すると、データの送信先のサーバーへの認証に使用できる秘密鍵を作成、管理、保存できます。 利用可能な秘密鍵のタイプと UI での実装方法については、秘密鍵のガイドを参照してください。
ビデオの概要 video
次のビデオは、イベント転送とReal-Time CDPの連携をより深く理解することを目的としています。
次の手順
このドキュメントでは、イベント転送の概要を説明しました。 組織用にこの機能を設定する方法について詳しくは、はじめる前にを参照してください。