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) コンソールで、Details タブのKinesisストリームのAmazon Resource Name (ARN)を探します。
2. Policies > Create Policy に移動します。これが最初に作成するポリシーの場合は、Get Started と Create Policy をクリックします。
3. Kinesis StreamのARNを入力します。
4. {} JSON をクリックします。
5. 次のポリシーを入力し、arn:aws:kinesis:us-east-1:123456789:stream/example をステップ1のARNに置き換えます。

{
  "Version": "2023-06-01",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "kinesis:PutRecord",
        "kinesis:PutRecords"
                ],
      "Resource": "arn:aws:kinesis:us-east-1:123456789:stream/example"
    }
  ]
}

6. Next Step をクリックします。
7. Policy Name の下に、TealiumKinesis を入力します。
8. Create Policy をクリックします。
9. Roles > Create Role に移動します。
10. Trusted entity type の下で、AWS Account を選択します。
11. Another AWS account を選択します。
12. Account ID の下に、757913464184 を入力します。
13. Next: Permissions をクリックします。
14. TealiumKinesis ポリシーを選択します。
15. Next: Review をクリックします。
16. 名前には、TealiumUser を入力します。
17. Create Role をクリックします。

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を参照してください。

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

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

コネクタの構成が完了したら、Test Connection をクリックして、コネクタがAmazonに接続できることを確認します。

アクション

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

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

アクション構成 - 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にバッチ処理されたビジターデータを送信

バッチ制限

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

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

パラメータ

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

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

バッチ制限

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

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

パラメータ

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