AWS Kinesis Streams（Tealium提供のクレデンシャル）コネクタ構成ガイド

コネクタアクション

アクション名	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）を見つけます。
2. ポリシー > ポリシー作成に移動します。これが最初に作成するポリシーの場合は、開始をクリックしてポリシー作成をクリックします。
3. KinesisストリームのARNを入力します。
4. {} JSONをクリックします。
5. 次のポリシーを入力し、ステップ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. 次のステップをクリックします。
2. ポリシー名の下で、TealiumKinesisと入力します。
3. ポリシー作成をクリックします。
4. ロール > ロール作成に移動します。
5. 信頼されたエンティティタイプで、AWSアカウントを選択します。
6. 他のAWSアカウントを選択します。
7. アカウントIDの下で、757913464184を入力します。
8. 次へ: 権限をクリックします。
9. TealiumKinesisポリシーを選択します。
10. 次へ: レビューをクリックします。
11. 名前にTealiumUserと入力します。
12. ロール作成をクリックします。

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

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

詳細については、Controlling Access to Amazon Kinesis Data Streams Resources Using IAMおよびCreate an IAM Policy and Userを参照してください。

構成の構成

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

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

• リージョン
  必須：リージョンを選択します。
• Assume Role: ARN
  オプション：引き受けるロールのAmazonリソースネーム（ARN）を提供します。例：arn:aws:iam::222222222222:role/myrole 参照：Switching to an IAM Role。
• Assume Role: セッション名
  必須：引き受けるロールセッションの識別子を提供します。長さの制約：最小2、最大64。
• Assume Role: 外部ID
  オプション：外部識別子を提供します。参照：How to Use an External ID。

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

アクション

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

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

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

パラメータ

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

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

パラメータ

パラメータ	説明
ストリーム名	データを送信するストリームを選択します。IAMポリシーがkinesis:ListStreams権限を付与していない場合は、カスタム値を手動で入力します。
パーティションキー	（必須）パーティションキーは、ストリーム内のシャードにデータをグループ化します。
シーケンス番号の順序	Kinesisデータストリームのシャード内のデータレコードのシーケンス番号。
明示的ハッシュキー	パーティションキーをハッシュするために使用されるキー。
訪問データに現在の訪問データを含める	ペイロードに現在の訪問データを追加します。これには、現在の訪問イベントデータが除外されていない場合のイベント訪問データが含まれます。
現在の訪問イベントデータを除外	現在の訪問データからイベントデータを除外します。
属性名の印刷	属性名が更新された場合、ペイロード内の名前が更新を反映します。

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

パラメータ

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

アクション構成 - Kinesis Streamへのバッチイベントデータ送信

バッチ制限

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

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

パラメータ

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

アクション構成 - Kinesis Streamへのバッチ訪問データ送信

バッチ制限

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

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

パラメータ

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

アクション構成 - Kinesisストリームにバッチカスタマイズデータを送信（詳細）

バッチ制限

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

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

パラメータ

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