イベント転送の概要
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 および Mobile SDK を使用して、サイトまたはネイティブモバイルアプリケーションから直接イベントデータを収集しますが、イベント転送でイベントデータを宛先に転送するには、Experience Platform Edge Network経由でイベントデータが既に送信されている必要があります。 つまり、イベント転送を使用するには、デジタルプロパティにExperience Platform web またはモバイル SDKを(タグを通じてまたは生のコードを使用して)実装する必要があります。
プロパティ properties
イベント転送は、タグとは別に独自のプロパティのストアを保持しており、左側のナビゲーションから「Event Forwarding」を選択してExperience Platform UI またはデータ収集 UI で表示できます。
すべてのイベント転送プロパティには、プラットフォームとして Edge がリストされています。 Web とモバイルは区別されません。Experience Platform Edge Networkから受信したデータのみを処理し、それ自体が web とモバイルの両方のプラットフォームからイベントデータを受信できるからです。
拡張機能 extensions
イベント転送には、Core 拡張機能や Adobe Cloud Connector 拡張機能など、互換性のある拡張機能の独自のカタログがあります。左側のナビゲーションで「Extensions」、「Catalog」の順に選択すると、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 秒のタイムアウトがあります。 つまり、単一のイベントのすべてのルールとすべてのアクションは、この期間内に完了する必要があります。
右側のパネルから
データ要素のトークン化 tokenization
タグルールでは、データ要素名の先頭と末尾に % を付けてデータ要素をトークン化します(例:%viewportHeight%)。イベント転送ルールでは、データ要素は代わりにデータ要素名の先頭に {{、末尾に }} を付けてトークン化します(例:{{viewportHeight}})。
右側のパネルから
ルールアクションのシーケンス action-sequencing
イベント転送ルールの Actions セクションは常に順番に実行されます。 例えば、ルールに 2 つのアクションがある場合、2 番目のアクションは、前のアクションが完了するまで(およびエンドポイントから応答が期待される場合は、そのエンドポイントが応答するまで)実行を開始しません。 ルールを保存する際に、アクションの順序が正しいことを確認します。この実行シーケンスは、タグルールの場合のように非同期で実行することはできません。
秘密鍵 secrets
イベント転送を使用すると、データの送信先のサーバーへの認証に使用できる秘密鍵を作成、管理、保存できます。 利用可能な秘密鍵のタイプと UI での実装方法については、秘密鍵のガイドを参照してください。
ビデオの概要 video
次のビデオは、イベント転送とReal-Time CDP接続をより深く理解できるようにすることを目的としています。
次の手順
このドキュメントでは、イベント転送の概要を説明しました。組織用にこの機能を設定する方法について詳しくは、はじめる前にを参照してください。