AWS 拡張機能の概要

NOTE
Adobe Experience Platform Launch は、Adobe Experience Platform のデータ収集テクノロジースイートとしてリブランドされています。 その結果、製品ドキュメント全体でいくつかの用語が変更されました。用語の変更点の一覧については、次のドキュメントを参照してください。

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

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

前提条件

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

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

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

目的のプロパティを選択または作成したら、左側のナビゲーションで 拡張機能 を選択し、「カタログ」タブを選択します。 AWS カードを検索し、「インストール」を選択します。

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

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

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

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

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

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

拡張機能をインストールした後、新しいイベント転送 ルールを作成し、必要に応じてその条件を設定します。 ルールのアクションを設定する際に、AWS 拡張機能を選択してから、アクションタイプとして Kinesis データストリームにデータを送信 を選択します。

データ収集 UI でルールに対して選択されている「Kinesis データストリームにデータを送信 」アクションタイプ

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

UI に表示される Kinesis データストリームにデータを送信 アクションタイプの設定オプション

Kinesis データストリームの詳細

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

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

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

データ

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

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

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

完了したら、「変更を保持」を選択して、アクションをルール設定に追加します。 ルールの設定が完了したら、「ライブラリに保存」を選択します。

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

次の手順

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

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