AWS Kinesis Streams コネクタ構成ガイド | サーバーサイドコネクタ

必要条件

Amazon Web Servicesアカウント
Identity and Access Management (IAM) ユーザーの資格情報
Kinesis Streams

コネクタアクション

アクション名	AudienceStream	EventStream
Kinesis Streamにイベントデータを送信	✗	✓
Kinesis Streamに訪問データを送信	✓	✗
Kinesis Streamにカスタマイズデータを送信（高度）	✓	✓
Kinesis Streamにバッチ処理されたイベントデータを送信	✗	✓
Kinesis Streamにバッチ処理された訪問データを送信	✓	✗
Kinesis Streamにバッチ処理されたカスタマイズデータを送信（高度）	✓	✓

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、About Connectorsを参照してください。

コネクタを追加した後、以下の構成を構成します：

アクセスキー
必須：IAMユーザーのアクセスキーを提供します。関連するIAMポリシー（IAMユーザーまたはAssumed Roleのいずれか）は、データを送信したいストリームとともにkinesis:PutRecord権限を付与する必要があります。参照：Kinesis Streams Resources Access。
シークレットキー
必須：IAMユーザーのシークレットキーを提供します。
リージョン
必須：リージョンを選択します。
Assume Role: ARN
オプション：引き受ける役割のAmazon Resource Name (ARN)を提供します。例：arn:aws:iam::222222222222:role/myrole。参照：Switching to an IAM Role。
Assume Role: Session Name
オプション：引き受けた役割のセッションの識別子を提供します。
Assume Role: External ID
オプション：外部識別子を提供します。参照：How to Use an External ID。

アクション

アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

アクション構成 - Kinesis Streamにイベントデータを送信

パラメータ

パラメータ	説明
Stream Name	データを送信するストリームを選択します。IAMポリシーが`kinesis:ListStreams`権限を付与していない場合、カスタム値を手動で入力する必要があります。
Partition Key	（必須）パーティションキーは、ストリーム内のシャードごとにデータをグループ化します。
Sequence Number For Ordering	Kinesisデータストリームのシャード内のデータレコードのシーケンス番号。
Explicit Hash Key	Partition Keyをハッシュするためのキー。
Print Attribute Names	属性名が更新された場合、ペイロード内の名前が更新を反映します。

アクション構成 - Kinesis Streamに訪問データを送信

パラメータ

パラメータ	説明
Stream Name	データを送信するストリームを選択します。IAMポリシーが`kinesis:ListStreams`権限を付与していない場合、カスタム値を手動で入力する必要があります。
Partition Key	（必須）パーティションキーは、ストリーム内のシャードごとにデータをグループ化します。
Sequence Number For Ordering	Kinesisデータストリームのシャード内のデータレコードのシーケンス番号。
Explicit Hash Key	Partition Keyをハッシュするためのキー。
Include Current Visit Data	現在の訪問データをペイロードに含めるかどうかを示す`true`/`false`値。
Print Attribute Names	属性名が更新された場合、ペイロード内の名前が更新を反映します。

アクション構成 - Kinesis Streamにカスタマイズデータを送信（高度）

パラメータ

パラメータ	説明
Stream Name	データを送信するストリームを選択します。IAMポリシーが`kinesis:ListStreams`権限を付与していない場合、カスタム値を手動で入力する必要があります。
Partition Key	（必須）パーティションキーは、ストリーム内のシャードごとにデータをグループ化します。
Sequence Number For Ordering	Kinesisデータストリームのシャード内のデータレコードのシーケンス番号。
Explicit Hash Key	Partition Keyをハッシュするためのキー。
Custom Message Definition	ログファイルに含めるカスタムメッセージ。
Template Variables	オプション。テンプレートのデータ入力としてテンプレート変数を提供します（参照：Template Variables Guide）。ネストされたテンプレート変数はドット表記法で名前を付けます（例：`items.name`）。ネストされたテンプレート変数は通常、データレイヤーリスト属性から作成されます。
Templates	オプション。メッセージデータで参照されるテンプレートを提供します（参照：Templates Guide）。テンプレートは、名前でダブルカーリーブレースを使用してサポートされるフィールドに挿入されます（例：`{{SomeTemplateName}}`）。

アクション構成 - Kinesis Streamにバッチ処理されたイベントデータを送信

バッチ制限

このアクションは、ベンダーへの大量のデータ転送をサポートするためにバッチリクエストを使用します。詳細については、Batched Actionsを参照してください。リクエストは、以下のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます：

リクエストの最大数：500
最も古いリクエストからの最大時間：10分
リクエストの最大サイズ：5MB

パラメータ

パラメータ	説明
Stream Name	データを送信するストリームを選択します。IAMポリシーが`kinesis:ListStreams`権限を付与していない場合、カスタム値を手動で入力する必要があります。
Partition Key	（必須）パーティションキーは、ストリーム内のシャードごとにデータをグループ化します。
Explicit Hash Key	Partition Keyをハッシュするためのキー。
Print Attribute Names	属性名が更新された場合、ペイロード内の名前が更新を反映します。

アクション構成 - Kinesis Streamにバッチ処理された訪問データを送信

バッチ制限

リクエストの最大数：500
最も古いリクエストからの最大時間：10分
リクエストの最大サイズ：5MB

パラメータ

パラメータ	説明
Stream Name	データを送信するストリームを選択します。IAMポリシーが`kinesis:ListStreams`権限を付与していない場合、カスタム値を手動で入力する必要があります。
Partition Key	（必須）パーティションキーは、ストリーム内のシャードごとにデータをグループ化します。
Explicit Hash Key	Partition Keyをハッシュするためのキー。
Include Current Visit Data	現在の訪問データをペイロードに含めるかどうかを示す`true`/`false`値。
Print Attribute Names	属性名が更新された場合、ペイロード内の名前が更新を反映します。

アクション構成 - Kinesis Streamにバッチ処理されたカスタマイズデータを送信（高度）

バッチ制限

リクエストの最大数：500
最も古いリクエストからの最大時間：10分
リクエストの最大サイズ：5MB

パラメータ

パラメータ	説明
Stream Name	データを送信するストリームを選択します。IAMポリシーが`kinesis:ListStreams`権限を付与していない場合、カスタム値を手動で入力する必要があります。
Partition Key	（必須）パーティションキーは、ストリーム内のシャードごとにデータをグループ化します。
Explicit Hash Key	Partition Keyをハッシュするためのキー。
Custom Message Definition	ログファイルに含めるカスタムメッセージ。
Template Variables	オプション。テンプレートのデータ入力としてテンプレート変数を提供します（参照：Template Variables Guide）。ネストされたテンプレート変数はドット表記法で名前を付けます（例：`items.name`）。ネストされたテンプレート変数は通常、データレイヤーリスト属性から作成されます。
Templates	オプション。メッセージデータで参照されるテンプレートを提供します（参照：Templates Guide）。テンプレートは、名前でダブルカーリーブレースを使用してサポートされるフィールドに挿入されます（例：`{{SomeTemplateName}}`）。