--- title: AWS Kinesis Streams（Tealium提供のクレデンシャル）コネクタ構成ガイド description: この記事では、AWS Kinesis Streams（Tealium提供のクレデンシャル）コネクタの構成方法について説明します。 url: https://docs.tealium.com/ja/server-side-connectors/aws-kinesis-streams-tealium-provided-credentials-connector/ --- ## コネクタアクション | アクション名 | AudienceStream | EventStream | | --- | :---: | :---: | | Kinesis Streamへのイベントデータ送信 | ✗ | ✓ | | Kinesis Streamへの訪問データ送信 | ✓ | ✗ | | Kinesis Streamへのカスタマイズデータ送信（高度） | ✓ | ✓ | | Kinesis Streamへのバッチイベントデータ送信 | ✗ | ✓ | | Kinesis Streamへのバッチ訪問データ送信 | ✓ | ✗ | | Kinesis Streamへのバッチカスタマイズデータ送信（高度） | ✓ | ✓ | ## AWSアカウントにTealiumロールを追加 コネクタを構成する前に、TealiumアカウントID用のロールを作成し、信頼されたエンティティとして構成する必要があります： 1. **Identity and Access Management**（IAM）コンソールで、**詳細**タブでKinesisストリームのAmazonリソースネーム（ARN）を見つけます。 1. **ポリシー > ポリシー作成**に移動します。これが最初に作成するポリシーの場合は、**開始**をクリックして**ポリシー作成**をクリックします。 1. KinesisストリームのARNを入力します。 1. **{} JSON**をクリックします。 1. 次のポリシーを入力し、ステップ1からのARNで`arn:aws:kinesis:us-east-1:123456789:stream/example`を置き換えます。 ``` { "Version": "2023-06-01", "Statement": [ { "Effect": "Allow", "Action": [ "kinesis:PutRecord", "kinesis:PutRecords" ], "Resource": "arn:aws:kinesis:us-east-1:123456789:stream/example" } ] } ``` 1. **次のステップ**をクリックします。 1. **ポリシー名**の下で、**TealiumKinesis**と入力します。 1. **ポリシー作成**をクリックします。 1. **ロール > ロール作成**に移動します。 1. **信頼されたエンティティタイプ**で、**AWSアカウント**を選択します。 1. **他のAWSアカウント**を選択します。 1. **アカウントID**の下で、`757913464184`を入力します。 1. **次へ: 権限**をクリックします。 1. **TealiumKinesis**ポリシーを選択します。 1. **次へ: レビュー**をクリックします。 1. 名前に**TealiumUser**と入力します。 1. **ロール作成**をクリックします。 Kinesisは次のようなロールのARNを生成します： ``` arn:aws:kinesis:us-east-1:123456789:role/example ``` 詳細については、[Controlling Access to Amazon Kinesis Data Streams Resources Using IAM](https://docs.aws.amazon.com/streams/latest/dev/controlling-access.html)および[Create an IAM Policy and User](https://docs.aws.amazon.com/streams/latest/dev/tutorial-stock-data-kplkcl-iam.html)を参照してください。 ## 構成の構成 コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタを追加する一般的な手順については、[About Connectors](https://docs.tealium.com/about-connectors/)を参照してください。 コネクタを追加した後、次の構成を構成します： * **リージョン** 必須：リージョンを選択します。 * **Assume Role: ARN** オプション：引き受けるロールのAmazonリソースネーム（ARN）を提供します。例：`arn:aws:iam::222222222222:role/myrole` 参照：[Switching to an IAM Role](http://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-api.html)。 * **Assume Role: セッション名** 必須：引き受けるロールセッションの識別子を提供します。長さの制約：最小2、最大64。 * **Assume Role: 外部ID** オプション：外部識別子を提供します。参照：[How to Use an External ID](http://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user_externalid.html)。 コネクタを構成した後、**接続テスト**をクリックして、コネクタがAmazonに接続できることを確認します。 ## アクション アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。 次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。 ### アクション構成 - Kinesis Streamへのイベントデータ送信 #### パラメータ | **パラメータ** | **説明** | | --- | --- | | ストリーム名 | データを送信するストリームを選択します。IAMポリシーが`kinesis:ListStreams`権限を付与していない場合は、カスタム値を手動で入力します。 | | パーティションキー | （必須）パーティションキーは、ストリーム内のシャードにデータをグループ化します。 | | シーケンス番号の順序 | Kinesisデータストリームのシャード内のデータレコードのシーケンス番号。 | | 明示的ハッシュキー | パーティションキーをハッシュするために使用されるキー。 | | 属性名の印刷 | 属性名が更新された場合、ペイロード内の名前が更新を反映します。 | ### アクション構成 - Kinesis Streamへの訪問データ送信 #### パラメータ | **パラメータ** | **説明** | | --- | --- | | ストリーム名 | データを送信するストリームを選択します。IAMポリシーが`kinesis:ListStreams`権限を付与していない場合は、カスタム値を手動で入力します。 | | パーティションキー | （必須）パーティションキーは、ストリーム内のシャードにデータをグループ化します。 | | シーケンス番号の順序 | Kinesisデータストリームのシャード内のデータレコードのシーケンス番号。 | | 明示的ハッシュキー | パーティションキーをハッシュするために使用されるキー。 | | 訪問データに現在の訪問データを含める | ペイロードに現在の訪問データを追加します。これには、現在の訪問イベントデータが除外されていない場合のイベント訪問データが含まれます。 | | 現在の訪問イベントデータを除外 | 現在の訪問データからイベントデータを除外します。 | | 属性名の印刷 | 属性名が更新された場合、ペイロード内の名前が更新を反映します。 | ### アクション構成 - Kinesis Streamへのカスタマイズデータ送信（高度） #### パラメータ | **パラメータ** | **説明** | | --- | --- | | ストリーム名 | データを送信するストリームを選択します。IAMポリシーが`kinesis:ListStreams`権限を付与していない場合は、カスタム値を手動で入力します。 | | パーティションキー | （必須）パーティションキーは、ストリーム内のシャードにデータをグループ化します。 | | シーケンス番号の順序 | Kinesisデータストリームのシャード内のデータレコードのシーケンス番号。 | | 明示的ハッシュキー | パーティションキーをハッシュするために使用されるキー。 | | カスタムメッセージ定義 | ログファイルに含めるカスタムメッセージ。 | | テンプレート変数 | オプション。 | | テンプレート | オプション。 | ### アクション構成 - Kinesis Streamへのバッチイベントデータ送信 #### バッチ制限 このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、[Batched Actions](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかのしきい値が満たされるか、プロファイルが公開されるまでキューに入れられます： * 最大リクエスト数：500 * 最古のリクエストからの最大時間：10分 * リクエストの最大サイズ：5 MB #### パラメータ | **パラメータ** | **説明** | | --- | --- | | ストリーム名 | データを送信するストリームを選択します。IAMポリシーが`kinesis:ListStreams`権限を付与していない場合は、カスタム値を手動で入力します。 | | パーティションキー | （必須）パーティションキーは、ストリーム内のシャードにデータをグループ化します。 | | 明示的ハッシュキー | パーティションキーをハッシュするために使用されるキー。 | | 属性名の印刷 | 属性名が更新された場合、ペイロード内の名前が更新を反映します。 | ### アクション構成 - Kinesis Streamへのバッチ訪問データ送信 #### バッチ制限 このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、[Batched Actions](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかのしきい値が満たされるか、プロファイルが公開されるまでキューに入れられます： * 最大リクエスト数：500 * 最古のリクエストからの最大時間：10分 * リクエストの最大サイズ：5 MB #### パラメータ | **パラメータ** | **説明** | | --- | --- | | ストリーム名 | データを送信するストリームを選択します。IAMポリシーが `kinesis:ListStreams` 権限を付与していない場合は、カスタム値を手動で入力してください。 | | パーティションキー | （必須）パーティションキーは、ストリーム内のシャードにデータをグループ化します。 | | 明示的ハッシュキー | パーティションキーをハッシュするために使用されるキーです。 | | 現在の訪問データを含む | ペイロードに現在の訪問データを含むかどうかを示す `true`/`false` 値です。 | | 属性名を印刷 | 属性名が更新された場合、ペイロードの名前が更新を反映します。 | ### アクション構成 - Kinesisストリームにバッチカスタマイズデータを送信（詳細） #### バッチ制限 このアクションは、バッチリクエストを使用してベンダーへの大量データ転送をサポートします。詳細については、[バッチアクション](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかのしきい値に達するか、プロファイルが公開されるまでキューに入れられます： * 最大リクエスト数：500 * 最古のリクエストからの最大時間：10分 * リクエストの最大サイズ：5 MB #### パラメータ | **パラメータ** | **説明** | | --- | --- | | ストリーム名 | データを送信するストリームを選択します。IAMポリシーが `kinesis:ListStreams` 権限を付与していない場合は、カスタム値を手動で入力してください。 | | パーティションキー | （必須）パーティションキーは、ストリーム内のシャードにデータをグループ化します。 | | 明示的ハッシュキー | パーティションキーをハッシュするために使用されるキーです。 | | カスタムメッセージ定義 | ログファイルに含めるカスタムメッセージです。 | | テンプレート変数 | 任意。 | | テンプレート | 任意。 |