AWS 拡張機能の概要

Amazon Web Services (AWS) ​ は、分散コンピューティング、データベースストレージ、コンテンツ配信、顧客関係管理(CRM)やエンタープライズリソースプランニング(ERP)向けの SaaS (software-as-a-service)統合サービスなど、様々なサービスを提供するクラウドコンピューティングプラットフォームです。

AWS ​ イベント転送 ​ 拡張機能は、Amazon Kinesis Data Streams を活用して、イベントをAdobe Experience Platform Edge Networkから AWS に送信して、さらに処理できるようにします。 このガイドでは、拡張機能をインストールし、イベント転送ルールでその機能を使用する方法について説明します。

前提条件

この拡張機能を使用するには、既存の AWS データストリームを持つ Kinesis アカウントが必要です。 既存のデータストリームがない場合は、AWS 管理コンソールを使用した新しいデータストリームの作成 ​ に関する AWS のドキュメントを参照し ​ ください。

拡張機能のインストール install

AWS 拡張機能をインストールするには、データ収集 UI またはExperience Platform UI に移動し、左側のナビゲーションから「Event Forwarding」を選択します。 ここから、拡張機能を追加するプロパティを選択するか、代わりに新しいプロパティを作成します。

目的のプロパティを選択または作成したら、左側のナビゲーションで「Extensions」を選択し、「Catalog」タブを選択します。 AWS カードを検索し、「Install」を選択します。

データ収集 UI の Install 拡張機能に対して選択されている「AWS」ボタン

次の画面で、AWS アカウントの接続資格情報を指定する必要があります。 特に、AWS アクセスキー ID と秘密アクセスキーを指定する必要があります。 これらの値がわからない場合は、AWS のドキュメント ​ アクセスキー ID と秘密アクセスキーを取得する方法 ​ を参照してください。

拡張機能の設定ビューに追加されたアクセスキー ID と秘密アクセスキー。

IMPORTANT
アクセス資格情報の生成に使用する AWS アカウントにアクセスポリシーを添付する必要があります。 このポリシーは、Kinesis のデータストリームにデータを送信するためのアクセス権を付与するように設定する必要があります。 ポリシーの定義方法については、のポリシーの例​AWS に関する ​ ドキュメントの Kinesis Data Streams 例 2 を参照してください。

終了したら、「Save」を選択すると、拡張機能がインストールされます。

イベント転送ルールの設定 rule

拡張機能をインストールした後、新しいイベント転送 ​ ルール ​ を作成し、必要に応じてその条件を設定します。 ルールのアクションを設定する場合は、AWS 拡張機能を選択してから、アクションタイプとして「Send Data to Kinesis Data Stream」を選択します。

データ収集 UI でルールに対して選択されている Send Data to Kinesis Data Stream アクションタイプ

右側のパネルが更新され、データの送信方法に関する設定オプションが表示されます。 特に、​ 設定を表す様々なプロパティに ​ データ要素 Event Hub を割り当てる必要があります。

UI に表示される Send Data to Kinesis Data Stream アクションタイプの設定オプション

Kinesis Data Stream Details

入力
説明
Stream Name
このイベント転送ルールがデータレコードを送信するストリームの名前。
AWS Region
AWS データストリームが作成される Kinesis 領域。
Partition Key
データ ストリームにデータを送信するときに拡張機能が使用する ​ パーティション キー ​

Kinesis Data Streams は、ストリームに属するデータレコードを複数のシャードに分離します。 各データレコードと共に送信されるパーティションキーを使用して、特定のデータレコードが属するシャードを判断します。

顧客ごとに異なるので、顧客を配布するための良いパーティションキーは、顧客番号かもしれません。 パーティション キーが不適切な場合、近くの同じエリアに住んでいる可能性があるため、郵便番号が異なる可能性があります。 一般に、パーティションキーは異なる可能性のある値の範囲が最も大きいものを選択します。 パーティションキーの管理のベストプラクティスについては、AWS データストリームのスケーリング ​ に関する Kinesis の記事を参照してください ​

Data

入力
説明
Payload
このフィールドには、Kinesis データストリームに転送されるデータが JSON 形式で格納されます。

Raw」オプションでは、JSON オブジェクトを指定されたテキストフィールドに直接貼り付けることができます。または、データ要素アイコン( データセットアイコン )を選択して、ペイロードを表す既存のデータ要素のリストから選択します。

JSON Key-Value Pairs Editor オプションを使用して、UI エディターから各キーと値のペアを手動で追加することもできます。 各値は、生の入力で表すことも、代わりにデータ要素を選択することもできます。

終了したら、「Keep Changes」を選択して、アクションをルール設定に追加します。 ルールの設定が完了したら、「Save to Library」を選択します。

最後に、新しいイベント転送 ​ ビルド ​ を公開して、ライブラリに対する変更を有効にします。

次の手順

このガイドでは、Kinesis Data Streams イベント転送拡張機能を使用して AWS にデータを送信する方法について説明しました。 Experience Platformのイベント転送機能について詳しくは、​ イベント転送の概要 ​ を参照してください。

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