Adobe Experience Platform

Adobe Experience Platformは、Adobe Real-Time CDP、Adobe Customer Journey Analytics、Adobe Journey Optimizer全体で顧客体験管理を支える集中化された接続データ基盤です。Adobe Experience Platformは、パフォーマンスマーケティングストリーム、顧客ジャーニー、データ収集、タグ、分析ワークフローを管理するための多種多様な製品とサービスを提供しています。

このガイドでは、Rokt Event API統合をAEP内でセットアップし、包括的で充実したコンバージョンデータをRoktに簡単に送信し、マーケティング活動（例: 紹介）を顧客コンバージョン（例: 購入、サブスクリプション、アプリケーションのダウンロード）などのビジネス価値を促進する成果に結びつける手順を説明します。

統合セットアップ

認証

Rokt Event API Forwarding Extensionでの認証には、Rokt Public Key、Rokt Secret、およびAccount IDが必要です。これらの資格情報を取得するには、アカウントマネージャーにお問い合わせください。

拡張機能の設定

拡張機能は、使用するためのデータ要素タイプとルールを提供します。Rokt Event API - サーバーサイド拡張機能をインストールするには、まずイベント転送プロパティを作成する必要があります。詳細については、イベント転送プロパティの作成 ドキュメントを参照してください。

https://experience.adobe.com のデータ収集内のイベント転送タブに移動します。拡張カタログで Rokt Event API Extension を検索し、インストールをクリックします。

インストールをクリックすると、Rokt Account ID、Rokt Public Key、および Rokt Secret を入力するように求められます。これらを Secrets として保存し、データ要素として参照することをお勧めします。

データ要素の設定

データ要素は、他の場所に存在するデータを参照するための簡単な方法です。ルールや拡張機能の設定内で使用できるショートカットを作成します。基になるデータの場所が変更された場合でも、個々のルールや拡張機能を更新することなく、新しい場所を指すように更新できます。データ要素 についてさらに読む

データ要素は次のいずれかであることができます:

• カスタムコード
• arc (Adobe Request Context) 内の属性へのパス
• シークレット
• IP

ルールの設定

ルールは、デプロイされたサーバーサイドイベント転送プロパティの動作を制御するルールコンポーネント（イベント、条件、アクション）の集合です。ルールについて詳しく学ぶ。

1. 新しいルールを作成し、一意の名前を付け、アクションをトリガーする条件を追加します。

2. Rokt Event API Extensionを選択し、Send Eventアクションを選択してアクションを設定します。

上記で定義したデータ要素を使用して、Event APIレスポンスのフィールドを入力します。

• Event Dataには、Conversionイベントに関するデータ（イベントが発生した時間（コンバージョンが発生した時間）やリクエストの一意の識別子（Client Event ID）など）が含まれている必要があります。
• Object Dataには、コンバージョンイベントに関するユーザー識別プロパティ（少なくともemail、emailsha256、passbackconversiontrackingidのいずれか1つ）が含まれている必要があります。
• Customer Informationデータセクションには、Event API extensionを介して送信できる他の属性が含まれている必要があります（3つの必須ユーザー識別プロパティのうち少なくとも1つのみを送信する場合は、生のJSONに{}を使用）。

注記

Roktが広告キャンペーンを最適化するために使用できるイベントタイプのみを転送してください。

3. Roktフィールドマッピングを追加

コンバージョンと関連するメタデータが正しい形式でRoktに送信されるようにするため、以下の要素をキャプチャし、最終的にRoktに受信される必要があります（完全なリストについては、公開ドキュメントを参照してください）：

パラメータ	説明	必須 / 推奨
Event ID	イベントを一意に識別するために使用される識別子	必須
Event Time	UTCでのイベントの時間	必須
Email	プレーンテキストとして渡されたメール、すべて小文字で後続のスペースなし	次のいずれかが必要です: email, emailsha256, passbackconversiontrackingid.
EmailSHA256	すでにハッシュ化されたメールアドレスのSHA-256ハッシュ	上記を参照
Passback Conversion Tracking ID	コンバージョンイベントを元のクリックにマッチさせるために使用されるRokt生成のID	上記を参照
Mobile	コンバージョンした顧客の携帯電話番号	推奨
First Name	顧客の名	推奨
Last Name	顧客の姓	推奨
Confirmation Ref	確認参照ID	推奨
Conversion Type	異なるコンバージョンイベントを区別するために使用	推奨

受け入れ可能な機能の完全なリストは、ドロップダウン内の顧客情報データセクションにあります。

4. 保存をクリックします。

これで、拡張設定とルールアクションの設定が完了しました。クライアントサイドのタグ拡張とXDM (Experience Data Model) スキーマデータストリームからのイベントは、特定の条件が満たされた場合にRoktにコンバージョンデータを転送するように設定できます。