イベント転送

このガイドでは、Adobe Experience Platform Edge Networkを使用したサーバーサイドイベント転送の実装について説明します。 Adobe Edge Networkを通じて収集されたリアルタイムのイベントデータを、Adobe以外の宛先（サードパーティの分析プラットフォーム、クラウドストレージエンドポイント、広告ネットワーク、カスタム webhookなど）に配信する必要があるソリューションアーキテクト、マーケティングテクノロジスト、実装エンジニア向けに設計されています。

イベント転送を設定するための実行可能なすべてのアプローチを紹介し、それらのトレードオフについて説明し、詳細な手順ガイダンスについては、Adobe Experience Leagueのドキュメントにリンクしています。

ユースケースの概要

Adobe Experience Platform Web SDK、モバイル SDK、またはServer APIを通じて行動データを収集する企業は、多くの場合、Google AnalyticsやSnowflakeなどの分析プラットフォーム、コンバージョン トラッキング用の広告ネットワーク、長期保存のためのデータウェアハウス、カスタム内部サービスなど、Adobe以外のシステムと同じイベントストリームを共有する必要があります。 従来、この必要なクライアントサイドのタグの急増は、ページの重みを増やし、遅延を引き起こし、プライバシーとガバナンスのリスクを生じさせていました。

イベント転送は、Edge Networkでサーバーサイドを操作することで、これを解決します。 訪問者インタラクションがWeb SDKまたはServer APIを介してイベントをトリガーすると、そのイベントはデータストリームを介してEdge Networkにルーティングされます。 イベント転送ルール – 専用のイベント転送プロパティで設定 – 受信イベントデータを評価し、1つ以上の設定された宛先に選択的に転送します。 このサーバーサイドのアプローチにより、クライアント側のタグの肥大化を減らし、ページパフォーマンスを向上させ、データガバナンスを一元化し、Adobeのエコシステムに残るデータを正確に制御することができます。

このパターンのターゲットオーディエンスには、データ収集用のAdobe Experience Platform Web SDKまたはServer APIを既にデプロイした（またはデプロイする予定の）組織が含まれ、クライアントサイドのJavaScript タグを追加せずにAdobe以外のエンドポイントにイベントデータを配布することで、その投資を拡張する組織が含まれます。

主なビジネス目標

このユースケースパターンでは、次のビジネス目標をサポートしています。

データ品質とガバナンスを改善する

クリーンで完全なコンプライアンスのデータを確保し、正確なターゲティング、無駄の削減、信頼性の高い分析を実現します。 イベント転送は、サーバー側でデータ配信を一元化し、外部システムと共有するデータの制御ポイントを組織に提供します。これにより、データ漏洩のリスクを軽減し、データがAdobe Edge Networkを離れる前にガバナンスポリシーが適用されます。

KPI:​効率、コスト削減

詳しくは、​ データ品質とガバナンスの改善を参照してください。

マーケティングテクノロジーの統合と近代化

統合されたスケーラブルなプラットフォームに移行することで、ツールの断片化と技術的負債を低減します。 イベント転送により、複数のクライアントサイドのベンダータグを単一のサーバーサイドのデータ配信メカニズムに置き換えることができるため、ページ読み込みのオーバーヘッドを減らし、テクノロジースタックを簡素化できます。

KPI: コスト削減、効率性、市場投入までの時間

詳しくは、​ マーケティングテクノロジーの統合と近代化を参照してください。

戦術的なユースケース

このユースケースパターンが当てはまる一般的な戦術的シナリオは次のとおりです。

主要業績評価指標

次のKPIは、このユースケースパターンの成功を測定するのに役立ちます。

ユースケースパターン

この節では、イベント転送の実装に使用されるパターンと関数チェーンについて説明します。

イベント転送 — Edge Networkを介して収集したリアルタイムのイベントデータを、分析、保存、広告のためにAdobe以外の宛先に転送します。

関数チェーン： データストリーム設定/ イベントルール定義/宛先マッピング / 転送実行> モニタリング

アプリケーション

このユースケースパターンでは、次のアプリケーションを使用します。

基本関数

このユースケースパターンでは、次の基本機能を使用する必要があります。 各機能について、ステータスは、通常それが必要か、事前設定が想定されているか、適用できないかを示します。

サポート機能

次の機能は、このユースケースパターンを強化しますが、コア実行には必要ありません。

アプリケーション関数

この計画では、アプリケーション機能カタログから次の機能を実行します。 関数は、番号付きのステップではなく実装フェーズにマッピングされます。

Adobe Experience Platform （AEP）

前提条件

実装を開始する前に、次の手順を確実に実行してください。

実装オプション

この節では、イベント転送を実装するために利用できるアプローチについて説明し、適切なオプションを選択する際のガイダンスを提供します。

オプション A：拡張機能ベースのイベント転送

適切にサポートされている宛先プラットフォーム（Meta、Google、AWS、Azure、Snowflakeなど）を使用している チームに最適 イベント転送拡張機能が用意されています。

仕組み：

拡張機能ベースのイベント転送では、Adobeまたはサードパーティパートナーが管理する事前定義済みの統合機能を利用できます。 各拡張機能は、特定の宛先向けに構築され、認証、ペイロードのフォーマット、エンドポイント通信を処理します。 実装者は、イベント転送プロパティに拡張機能をインストールし、認証資格情報を設定し、XDM データ要素を拡張機能のアクションフィールドにマッピングするルールを構築します。

このアプローチは、拡張機能が宛先のAPI要件を抽象化するため、カスタム開発を最小限に抑えます。 例えば、Meta Conversions API拡張機能は、XDM コマースイベントをMetaが想定する形式に変換し、PII フィールドのハッシュ、重複排除パラメーター、およびアクセストークン管理を処理します。 同様に、Google Cloud PlatformまたはAWS拡張機能は、それぞれのクラウドサービスの認証とペイロードの形式を処理します。

トレードオフは、拡張機能の可用性によって、サポートされる宛先が決まるということです。 ターゲット宛先に拡張機能が存在しない場合は、代わりにオプション B （カスタム Webhook）を使用する必要があります。

重要な考慮事項：

利点：

制限：

Experience League:

オプション B：カスタム Webhook （Fetch API）イベント転送

事前定義済みの拡張機能を使用せずにイベントを宛先に転送する必要がある、またはHTTP リクエストペイロード、ヘッダー、認証メカニズムを完全に制御する必要があるチームに最適：。

仕組み：

カスタム Webhook ベースのイベント転送では、Adobe Cloud Connector拡張機能（デフォルトで含まれています）を使用して、任意のエンドポイントに任意のHTTP リクエストを行います。 実装者は、受信XDM イベントから値を抽出および変換するためのデータ要素を定義し、Cloud Connectorの「Make Fetch Call」アクションタイプを使用してルールアクションを設定します。 このアクションを使用すると、HTTP メソッド、URL、ヘッダー、リクエスト本文を完全に制御できます。

リクエスト本文は、通常、データ要素とカスタムコードを使用して構築され、宛先のAPI仕様に従ってペイロードをフォーマットします。 このアプローチでは、REST API、Webhook、クラウド関数、内部サービスなど、HTTPでアクセス可能なあらゆるエンドポイントをサポートするため、最も柔軟性の高いオプションとなります。

トレードオフとは、より高い実装努力と継続的なメンテナンスのことです。 実装者は、宛先APIを理解し、認証を手動で処理し（例えば、認証ヘッダーの設定、トークンの更新の管理）、宛先APIが進化した場合にペイロード形式を維持する必要があります。

重要な考慮事項：

利点：

制限：

Experience League:

オプション C：ハイブリッド（拡張機能+カスタム Webhook）

一部の拡張機能が事前に構築され、他の拡張機能がカスタム統合を必要とする複数の宛先にイベントを転送する組織に最適：​組織。

仕組み：

ハイブリッドアプローチでは、拡張機能ベースの転送による適切にサポートされている配信先と、拡張機能が不足している配信先に対するカスタム Webhook アクションを組み合わせることができます。 単一のイベント転送プロパティには、複数のルールが含まれます。拡張アクションを使用するものもあれば（例：広告コンバージョンのトラッキング用のMeta Conversions API拡張機能）、Cloud Connector フェッチアクションを使用するものもあります（例：内部データレイクエンドポイントへの転送）。

このアプローチにより、不要なカスタム開発を最小限に抑えながら、カバーできる範囲を最大限に広げることができます。 各ルールは独立して動作するため、拡張機能ベースのルールは、事前に構築されたペイロード形式のメリットを受けながら、カスタムルールの柔軟性を維持できます。

重要な考慮事項：

利点：

制限：

Experience League:

オプションの比較

次の表に、3つの実装オプションを比較します。

適切なオプションの選択

まず、ターゲットの宛先を調べ、それぞれに事前定義済みのイベント転送拡張機能が存在するかどうかを確認します。

実装フェーズ

次のフェーズでは、イベント転送のエンドツーエンドの実装プロセスについて説明します。

フェーズ 1: データストリーム設定

アプリケーション関数： AEP: データストリーム設定

設定する内容： Web SDK、Mobile SDK、またはServer APIの実装からイベントを受け取り、イベント転送ルールで処理できるEdge Networkにルーティングするデータストリーム。 イベント転送が既存のデータ収集デプロイメントに追加されている場合は、既存のデータストリームでイベント転送を有効にします。

このフェーズの​決定ポイント：

UI ナビゲーション： Experience Platform > データ収集> データストリーム > データストリームの選択または作成

キー設定の詳細：

Experience League ドキュメント：

フェーズ 2: イベント転送プロパティと拡張機能

アプリケーション関数： AEP: イベント転送プロパティの設定

設定するもの： データ収集UIのイベント転送プロパティと、ターゲット宛先に必要な拡張機能。 イベント転送プロパティは、サーバーサイド転送ロジックを定義するすべてのルール、データ要素、および拡張機能のコンテナです。

このフェーズの​決定ポイント：

UI ナビゲーション： Experience Platform / データ収集/ イベント転送/ プロパティを作成（または既存の選択）

キー設定の詳細：

Experience League ドキュメント：

フェーズ 3: イベント ルールの定義

アプリケーション関数： AEP: イベント ルールの定義、AEP：宛先マッピング

設定するもの：​受信イベントデータを評価するルール、転送するイベントをフィルタリングする条件を適用するルール、宛先エンドポイントにデータを送信するアクションを定義するルール。 各ルールは、条件（実行するタイミング）とアクション（実行するアクション）で構成されます。 データ要素は、ルール条件とアクション設定で使用するために、XDM イベントペイロードから値を抽出および変換します。

このフェーズの​決定ポイント：

UI ナビゲーション： Experience Platform > データ収集/ イベント転送/ プロパティを選択/ データ要素/ ルール

キー設定の詳細：

オプションが異なる場所：

オプション A （拡張機能ベース）の​:

宛先拡張機能の事前定義済みアクションタイプを使用して、ルールアクションを設定します。 例えば、Meta Conversions API拡張機能は、「イベントを送信」アクションを提供し、XDM フィールドをMeta個のイベントパラメーター（event_name、event_time、user_data、custom_data）にマッピングします。 この拡張機能は、ペイロードのフォーマット、ハッシュ、API通信を処理します。

オプション B （カスタム Webhook）の​:

Cloud Connector拡張機能の「Make Fetch Call」アクションを使用してルールアクションを設定します。 宛先URL、HTTP メソッド（通常はPOST）、リクエストヘッダー（認証を含む）を指定し、データ要素やカスタムコードを使用してリクエスト本文を作成します。 宛先APIの想定されるペイロード形式を正確に一致させる責任があります。

オプション C （ハイブリッド）の場合：

宛先ごとに個別のルールを作成します。 拡張機能ベースのルールでは、拡張機能のアクションタイプを使用します。カスタムルールでは、Cloud Connectorの取得呼び出しを使用します。 すべてのルールは同じプロパティに共存し、受信する各イベントに対して独立して評価されます。

Experience League ドキュメント：

フェーズ 4：公開とアクティベーション

アプリケーション関数： AEP：転送実行

設定する内容： イベント転送ルールを開発からステージングから実稼動環境に昇格させる公開ワークフロー。 イベント転送では、Edge Networkでアクティブな設定を制御する環境とビルドアーティファクトを使用して、タグと同じライブラリベースの公開モデルを使用します。

このフェーズの​決定ポイント：

UI ナビゲーション： Experience Platform / データ収集/ イベント転送/ プロパティを選択/公開フロー

キー設定の詳細：

Experience League ドキュメント：

フェーズ 5：監視と検証

アプリケーション関数： AEP：監視

設定するもの： イベントが正常に転送されていることを確認し、エラーを診断し、イベント転送展開の運用状態を維持するためのダッシュボードと検証プロセスの監視。

このフェーズの​決定ポイント：

UI ナビゲーション： Experience Platform / データ収集/ イベント転送/ プロパティを選択/監視

キー設定の詳細：

Experience League ドキュメント：

実装に関する考慮事項

このセクションでは、実装を通じて考慮すべきガードレール、一般的な落とし穴、ベストプラクティス、トレードオフの決定について説明します。

ガードレールと制限

よくある落とし穴

ベストプラクティス

トレードオフの決定

関連ドキュメント

次のリソースでは、このガイドで取り上げるトピックに関する追加の詳細を提供します。

イベント転送

イベント転送拡張機能

データ収集とEdge Network