AWS Kinesis Streams（Tealium提供の資格情報）コネクタの構成ガイド | サーバーサイドコネクタ

コネクタのアクション

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

AWSアカウントにTealiumのロールを追加する

コネクタを構成する前に、TealiumアカウントIDのためのロールを作成し、信頼されるエンティティとして構成する必要があります。

Identity and Access Management（IAM）コンソールで、KinesisストリームのAmazonリソース名（ARN）を詳細タブで見つけます。
ポリシー > ポリシーの作成に移動します。これが作成する最初のポリシーの場合は、開始をクリックしてポリシーの作成をクリックします。
KinesisストリームのARNを入力します。
{} JSONをクリックします。
以下のポリシーを入力し、ステップ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"
    }
  ]
}

次のステップをクリックします。
ポリシー名にTealiumKinesisを入力します。
ポリシーの作成をクリックします。
ロール > ロールの作成に移動します。
信頼されたエンティティのタイプで、AWSアカウントを選択します。
別のAWSアカウントを選択します。
アカウントIDに719386139886を入力します。
次: アクセス権限をクリックします。
TealiumKinesisポリシーを選択します。
次: 確認をクリックします。
名前にTealiumUserを入力します。
ロールの作成をクリックします。

Kinesisは、次のようなロールのARNを生成します。

arn:aws:kinesis:us-east-1:123456789:role/example

詳細については、IAMを使用したAmazon Kinesis Data Streamsリソースへのアクセス制御の管理とIAMポリシーとユーザーの作成を参照してください。

構成の構成

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

コネクタを追加した後、次の構成を構成します。

リージョン
必須：リージョンを選択します。
ロールを仮定：ARN
オプション：仮定するロールのAmazonリソース名（ARN）を指定します。例：arn:aws:iam::222222222222:role/myrole 参照：IAMロールへの切り替えを参照してください。
ロールを仮定：セッション名
必須：仮定されるロールセッションの識別子を指定します。長さの制約：最小長2、最大長64。
ロールを仮定：外部ID
オプション：外部識別子を指定します。参照：外部IDの使用方法を参照してください。

コネクタを構成した後、接続のテストをクリックして、コネクタがAmazonに接続できることを確認します。

アクション

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

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

アクション構成 - Kinesisストリームにイベントデータを送信する

パラメータ

パラメータ	説明
ストリーム名	データを送信するストリームを選択します。IAMポリシーが`kinesis:ListStreams`権限を付与していない場合は、カスタム値を手動で入力する必要があります。
パーティションキー	（必須）ストリーム内のシャードごとにデータをグループ化するパーティションキーです。
順序付けのためのシーケンス番号	Kinesisデータストリームのシャード内のデータレコードのシーケンス番号です。
明示的なハッシュキー	パーティションキーをハッシュするために使用されるキーです。
属性名の表示	属性名が更新された場合、ペイロード内の名前も更新されます。

アクション構成 - Kinesisストリームに訪問データを送信する

パラメータ

パラメータ	説明
ストリーム名	データを送信するストリームを選択します。IAMポリシーが`kinesis:ListStreams`権限を付与していない場合は、カスタム値を手動で入力する必要があります。
パーティションキー	（必須）ストリーム内のシャードごとにデータをグループ化するパーティションキーです。
順序付けのためのシーケンス番号	Kinesisデータストリームのシャード内のデータレコードのシーケンス番号です。
明示的なハッシュキー	パーティションキーをハッシュするために使用されるキーです。
現在の訪問データを含める	ペイロードに現在の訪問データを含めるかどうかを示す`true`/`false`の値です。
属性名の表示	属性名が更新された場合、ペイロード内の名前も更新されます。

アクション構成 - Kinesisストリームにカスタマイズされたデータを送信する（高度な構成）

パラメータ

パラメータ	説明
ストリーム名	データを送信するストリームを選択します。IAMポリシーが`kinesis:ListStreams`権限を付与していない場合は、カスタム値を手動で入力する必要があります。
パーティションキー	（必須）ストリーム内のシャードごとにデータをグループ化するパーティションキーです。
順序付けのためのシーケンス番号	Kinesisデータストリームのシャード内のデータレコードのシーケンス番号です。
明示的なハッシュキー	パーティションキーをハッシュするために使用されるキーです。
カスタムメッセージの定義	ログファイルに含めるカスタムメッセージです。
テンプレート変数	オプション。テンプレート変数をデータ入力として提供します（参照：テンプレート変数ガイド）。ドット表記法でネストされたテンプレート変数に名前を付けます（例：`items.name`）。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
テンプレート	オプション。メッセージデータ内で参照されるテンプレートを提供します（参照：テンプレートガイド）。テンプレートは、サポートされているフィールドに二重の中括弧で名前を挿入します（例：`{{SomeTemplateName}}`）

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

バッチ制限

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

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

パラメータ

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

アクション構成 - Kinesisストリームにバッチ処理された訪問データを送信する

バッチ制限

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

パラメータ

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

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

バッチ制限

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

パラメータ

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