イベント転送の概要

NOTE
イベント転送は、Adobe Real-time Customer Data Platform Connections、Prime または Ultimate の一部として提供される有料機能です。
NOTE
Adobe Experience Platform Launch は、Adobe Experience Platform のデータ収集テクノロジースイートとしてリブランドされています。 その結果、製品ドキュメント全体でいくつかの用語が変更されました。用語の変更点の一覧については、次のドキュメントを参照してください。

Adobe Experience Platform のイベント転送を使用すると、収集したイベントデータをサーバーサイドで処理するために宛先に送信できます。イベント転送は、通常クライアントで行なわれるタスクを、Adobe Experience Platform Edge ネットワークを使用して実行することにより、web ページやアプリの負担を軽減します。タグと同様の方法で実装されたイベント転送ルールは、データを変換して新しい宛先に送信できますが、このデータを web ブラウザーなどのクライアントアプリケーションから送信する代わりに、アドビのサーバーから送信します。

このドキュメントでは、 Platform のイベント転送の概要を説明します。

データ収集エコシステムでのイベント転送

NOTE
イベント転送が Platform のデータ収集エコシステム内でどのように適合するかについての情報は、データ収集の概要を参照してください。

イベント転送を Adobe Experience Platform Web SDK および Mobile SDK と組み合わせると、次のような利点があります。

パフォーマンス

  • データのペイロードを含むページから 1 回の呼び出しを行い、このデータをサーバーサイドで統合して、クライアントサイドのネットワークトラフィックを減らし、より高速なエクスペリエンスを顧客に提供します。
  • Web ページの読み込みにかかる時間を短縮し、サイトのパフォーマンスを向上させます。
  • 多くの宛先へのエクスペリエンスの配信やデータの送信に必要なクライアントサイドテクノロジーの数を減らします。

データガバナンス

  • 透明性を高め、すべてのプロパティを通して、どのテータをどこに送信するかを制御します。

イベント転送とタグの違い differences-from-tags

設定に関しては、イベント転送はルールデータ要素拡張など、タグと同じ概念の多くを使用します。この 2 つの主な違いを要約すると、次のようになります。

  • タグは、イベントデータを web サイトまたはネイティブモバイルアプリケーションから​ 収集 ​し、Platform Edge Network に送信します。
  • イベント転送は、Platform Edge Network から受信したイベントデータを、最終的な宛先を表すエンドポイントまたは元のペイロードを強化するデータを提供するエンドポイントに​ 送信 ​します。

タグは、Platform Web および Mobile SDK を使用して、サイトまたはネイティブモバイルアプリケーションから直接イベントデータを収集しますが、イベント転送でイベントデータを宛先に転送するには、Platform Edge Network 経由でイベントデータが既に送信されている必要があります。つまり、イベント転送を使用するには、デジタルプロパティに Platform Web または Mobile SDK を(タグを通じてまたは生のコードを使用して)実装する必要があります。

プロパティ properties

イベント転送は、タグとは別に独自のプロパティストアを維持します。このプロパティは、Experience PlatformUI またはデータ収集 UI で、 イベント転送 をクリックします。

データ収集 UI のイベント転送プロパティ

すべてのイベント転送プロパティには、プラットフォームとして Edge がリストされています。Web とモバイルは、Platform Edge Network から受信したデータのみを処理するため区別されません。Platform Edge Network 自体は、web プラットフォームとモバイルプラットフォームの両方からイベントデータを受信できます。

拡張機能 extensions

イベント転送には、Core 拡張機能や Adobe Cloud Connector 拡張機能など、互換性のある拡張機能の独自のカタログがあります。左側のナビゲーションで「拡張機能」、「カタログ」の順に選択すると、UI にイベント転送プロパティで使用可能な拡張機能を表示できます。

データ収集 UI のイベント転送拡張機能

データ要素 data-elements

イベント転送で利用できるデータ要素のタイプは、それらを提供する互換性のある拡張機能のカタログに限定されます。

イベント転送では、データ要素自体はタグと同じように作成および設定されますが、Platform Edge Network からのデータを参照する方法については、いくつかの重要な構文上の違いがあります。

Platform Edge Network からのデータの参照 data-element-path

Platform Edge Network からデータを参照するには、そのデータへの有効なパスを提供するデータ要素を作成する必要があります。UI でデータ要素を作成するときは、拡張機能として​ コア ​を選択し、タイプとして​ パス ​を選択します。

データ要素の​ パス ​値は、パターン arc.event.{ELEMENT} に従う必要があります(例:arc.event.xdm.web.webPageDetails.URL)。データを送信するには、このパスを正しく指定する必要があります。

イベント転送のパスタイプデータ要素の例

ルール rules

イベント転送プロパティでのルールの作成はタグと同様に機能しますが、重要な違いは、イベントをルールコンポーネントとして選択できないことです。代わりに、イベント転送ルールはデータストリームから受け取ったすべてのイベントを処理し、特定の条件を満たした場合にそれらのイベントを宛先に転送します。

さらに、1 つのイベントに適用される 30 秒のタイムアウトがあります。このタイムアウトは、イベント転送プロパティ内のすべてのルール(したがってすべてのアクション)で処理されます。 つまり、1 つのイベントに対するすべてのルールとすべてのアクションは、この期間内に完了する必要があります。

データ収集 UI のイベント転送ルール

データ要素のトークン化 tokenization

タグルールでは、データ要素名の先頭と末尾に % を付けてデータ要素をトークン化します(例:%viewportHeight%)。イベント転送ルールでは、データ要素は代わりにデータ要素名の先頭に {{、末尾に }} を付けてトークン化します(例:{{viewportHeight}})。

イベント転送のパスタイプデータ要素の例

ルールアクションのシーケンス action-sequencing

イベント転送ルールのアクションセクションは常に順番に実行されます。例えば、ルールに 2 つのアクションがある場合、2 つ目のアクションは、前のアクションが完了するまで(また、エンドポイントからの応答が期待される場合は、そのエンドポイントが応答するまで)実行を開始しません。 ルールを保存する際に、アクションの順序が正しいことを確認します。この実行シーケンスは、タグルールで実行できるのと同様に、非同期で実行することはできません。

秘密鍵 secrets

イベント転送を使用すると、データの送信先のサーバーへの認証に使用できる秘密鍵を作成、管理、保存できます。 利用可能な秘密鍵のタイプと UI での実装方法については、秘密鍵のガイドを参照してください。

次の手順

このドキュメントでは、イベント転送の概要を説明しました。組織用にこの機能を設定する方法について詳しくは、はじめる前にを参照してください。

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743