Adobe Experience Platform
Adobe Experience Platformは、Adobe Real-Time CDP、Adobe Customer Journey Analytics、およびAdobe Journey Optimizer全体で顧客体験管理を強化する中央集権的かつ接続されたデータ基盤です。Adobe Experience Platformは、パフォーマンスマーケティングストリーム、顧客の旅、データ収集、タグ、および分析ワークフローを管理するためのクライアントに多様な製品とサービスを提供します。
このガイドでは、RoktイベントAPI統合をAEP内で設定し、リファラルなどのマーケティング活動を顧客のコンバージョン（例：購入、サブスクリプション、アプリケーションのダウンロード）などのビジネス価値を推進する成果に接続するために、包括的で強化されたコンバージョンデータをRoktに簡単に送信するために必要な手順を説明します。
統合設定
認証
RoktイベントAPI転送拡張機能での認証には、Roktパブリックキー、Roktシークレット、およびアカウントIDが必要です。これらの資格情報を取得するには、アカウントマネージャーにお問い合わせください。
拡張機能の設定
拡張機能は、作業するためのデータ要素タイプとルールを提供します。Rokt Event API - サーバーサイド拡張機能をインストールするには、まずイベント転送プロパティを作成する必要があります。詳細については、イベント転送プロパティを作成する ドキュメントを参照してください。
データ収集内のイベント転送タブに移動し、https://experience.adobe.com でRokt Event API拡張機能を検索してインストールをクリックします。
インストールをクリックすると、RoktアカウントID、Rokt公開鍵、Roktシークレットの入力を求められます。これらはシークレットとして保存し、データ要素として参照することをお勧めします。
データ要素の設定
データ要素は、他の場所に存在するデータを参照する簡単な方法です。ルールや拡張機能の設定内で使用できるショートカットを作成します。基になるデータの場所が変更されたとき、それに応じて新しい場所を指すように更新でき、個々のルールや拡張機能を更新する必要がありません。データ要素についてもっと読むには、データ要素 をご覧ください。
データ要素は以下のいずれかにすることができます：
- カスタムコード
- あなたのarc内の属性へのパス (Adobeリクエストコンテキスト)
- シークレット
- IP
ルールの設定
ルールは、デプロイされたサーバーサイドイベント転送プロパティの動作を制御するルールコンポーネント（イベント、条件、およびアクション）のコレクションです。 ルール について詳しく学びましょう。
- 新しいルールを作成し、ユニークな名前を付けて、アクションをトリガーする条件を追加します。
- Rokt Event API拡張を選択し、Send Eventアクションを選択して、アクションを設定します。
上記で定義したデータ要素を使用して、Event APIレスポンスのフィールドに値を設定します。
- イベントデータには、
Conversionイベントに関するデータ（イベントが発生した時間やリクエストのユニーク識別子（クライアントイベントID）など）が含まれている必要があります。 - オブジェクトデータには、コンバージョンイベントに関するユーザー識別プロパティ（メール、emailsha256、passbackconversiontrackingidのいずれか1つ以上）が含まれている必要があります。
- 顧客情報データセクションには、Event API拡張経由で送信できる他の属性が含まれている必要があります（3つの必須ユーザー識別プロパティのいずれかを送信する場合は、
{}を生のJSONとして使用してください）。
- Roktフィールドマッピングを追加する
コンバージョンと関連メタデータが正しい形式でRoktに送信されるようにするためには、以下の要素をキャプチャし、最終的にRoktで受信する必要があります（完全なリストについては、公開ドキュメントを参照してください）：
| パラメータ | 説明 | 必須 / 推奨 |
|---|---|---|
| イベントID | イベントを一意に識別するために使用される識別子 | 必須 |
| イベント時間 | UTCでのイベントの時間 | 必須 |
| メール | プレーンテキストとして渡されたメール、すべて小文字でトレーリングスペースなし | 次のいずれかが必要です: email, emailsha256, passbackconversiontrackingid. |
| EmailSHA256 | メールアドレスのSHA-256ハッシュ、すでにハッシュ化済み | 上記を参照 |
| Passback Conversion Tracking ID | コンバージョンイベントを元のクリックにマッチさせるためにRoktが生成したID | 上記を参照 |
| モバイル | コンバージョン顧客の携帯電話番号 | 推奨 |
| 名 | 顧客の名 | 推奨 |
| 姓 | 顧客の姓 | 推奨 |
受け入れられた機能の完全なリストは、ドロップダウン内の顧客情報データセクションにあります。
- 保存をクリックします。
Extension Configuration & Rule Actionの構成が完了しました。クライアントサイドのタグ拡張およびXDM（Experience Data Model）スキーマデータストリームからのイベントは、特定の条件が満たされるときにコンバージョンデータをRoktに転送するように構成できます。