AWS Firehose コネクタ構成ガイド

必要条件

• AWS アカウント。
• （必須）firehose:PutRecord 権限。
• （オプション）firehose:ListDeliveryStreams 権限。
• データを送信するデリバリーストリーム。

サポートされるアクション

アクション名	オーディエンスにトリガー	ストリームにトリガー
デリバリーストリームへのイベントデータ送信	✗	✓
デリバリーストリームへの訪問データ送信	✓	✗
デリバリーストリームへのカスタマイズデータ送信（高度）	✓	✓
デリバリーストリームへのコネクタ障害データ送信	✗	✓
デリバリーストリームへのカスタマイズデータ送信（バッチ処理）	✓	✓
デリバリーストリームへのイベントデータ送信（バッチ処理）	✗	✓

構成

コネクタマーケットプレイスに移動し、新しい AWS Firehose コネクタを追加します。コネクタの追加方法については、コネクタ概要の記事を参照してください。

ベンダーを構成するには、以下の手順に従います：

1. 構成タブで、コネクタインスタンスのタイトルを提供します。

2. IAM ユーザーのアクセスキーとシークレットキーを提供します。

   IAM ユーザーインスタンスに添付されたポリシーステートメントには firehose:PutRecord 権限が含まれている必要があり、Tealium のルートアカウント (arn:aws:iam::757913464184:root) に External ID 条件で許可されている必要があります。Firehose のポリシーの詳細については、AWS: Amazon Data Firehose でのアクセス制御を参照してください。

3. API コールを行いたいリージョンを選択します。

4. Assume Role Parameters: 必要な権限が IAM ユーザーに構成されていない場合のみ必要です。IAM ロール名には TealiumFirehose プレフィックスが含まれている必要があります。詳細については、AWS: IAM ロールへの切り替えを参照してください。

• ARN: (必須) ロールを引き受けるために割り当てられた Amazon リソース名。
• セッション名: (必須) 引き受けたロールセッションの一意の識別子。
• External ID: (オプション) 第三者が顧客のアカウントでロールを引き受ける際に使用する一意の識別子。詳細については、AWS: 第三者所有の AWS アカウントへのアクセスを参照してください。

1. Test Connection をクリックして、提供された認証情報で API 接続性を確認します。

アクション構成：パラメータとオプション

Next をクリックするか、Actions タブに移動します。ここでアクションのトリガー構成を行います。

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

アクション：デリバリーストリームへのイベントデータ送信

パラメータ

パラメータ	説明
デリバリーストリーム	(必須) データを送信するデリバリーストリームを選択します。利用可能なストリームを確認するには、firehose:ListDeliveryStreams 権限が必要です。
レコードサフィックス	訪問データの個々のレコードを識別するために追加する値を選択します。
属性名の表示	メッセージペイロード内の各イベントデータ属性の名前を表示するオプションを選択します。

オプション：レコードサフィックス

オプション	説明
改行 (\\n)	訪問データオブジェクトの最後にリターン文字を追加します。
区切り文字なし	選択された場合、訪問データオブジェクトに何も追加されません。

アクション：デリバリーストリームへの訪問データ送信

パラメータ

パラメータ	説明
デリバリーストリーム	(必須) データを送信するデリバリーストリームを選択します。利用可能なストリームを確認するには、firehose:ListDeliveryStreams 権限が必要です。
レコードサフィックス	訪問データの個々のレコードを識別するために追加する値を選択します。
現在の訪問データを含む	ペイロードに現在の訪問データを追加します。これには、現在の訪問イベントデータが除外されていない場合のイベント訪問データが含まれます。
現在の訪問イベントデータを除外	現在の訪問データからイベントデータを除外します。
属性名の表示	メッセージペイロード内の各訪問データ属性の名前を表示するオプションを選択します。

オプション：レコードサフィックス

オプション	説明
改行 (\\n)	訪問データオブジェクトの最後にリターン文字を追加します。
区切り文字なし	選択された場合、訪問データオブジェクトに何も追加されません。

アクション：デリバリーストリームへのカスタマイズデータ送信（高度）

パラメータ

パラメータ	説明
デリバリーストリーム	(必須) データを送信するデリバリーストリームを選択します。利用可能なストリームを確認するには、firehose:ListDeliveryStreams 権限が必要です。
レコードサフィックス	訪問データの個々のレコードを識別するために追加する値を選択します。
メッセージデータ	(必須) カスタムメッセージ本体を構築します。属性を単一レベルの JSON 形式で名前にマッピングするか、二重中括弧で囲まれたテンプレート名を参照し、カスタムメッセージ定義 オプションを選択します。
メッセージテンプレート変数	属性をテンプレート変数名にマッピングします。テンプレート変数は、すべてのテンプレートの置換およびレンダリングに使用できます。詳細については、コネクターテンプレート変数を参照してください。
メッセージテンプレート	レンダリングに使用する1つ以上のテンプレートを提供します。通常、単一のテンプレートがメッセージデータの構築に使用されます。構文と拡張についての詳細は、コネクタテンプレートについてを参照してください。

オプション：レコードサフィックス

オプション	説明
改行 (\\n)	訪問データオブジェクトの最後にリターン文字を追加します。
区切り文字なし	選択された場合、訪問データオブジェクトに何も追加されません。

アクション：デリバリーストリームへのカスタマイズデータ送信（バッチ処理）

バッチ制限

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

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

パラメータ

パラメータ	説明
デリバリーストリーム	データを送信するデリバリーストリームを選択します。利用可能なストリームを確認するには、firehose:ListDeliveryStreams 権限が必要です。Amazon Kinesis Data Firehose デリバリーストリームには制限があります。詳細については、AWS: Amazon Data Firehose のクォータを参照してください。
レコードサフィックス	各レコードの最後に追加されるサフィックスで、区切り文字として使用されます。デフォルト：改行 (\n)

カスタムメッセージ定義

パラメータ	説明
メッセージテンプレート変数	属性をテンプレート変数名にマッピングします。テンプレート変数は、すべてのテンプレートの置換およびレンダリングに使用できます。詳細については、コネクターテンプレート変数を参照してください。
メッセージテンプレート	レンダリングに使用する1つ以上のテンプレートを提供します。通常、単一のテンプレートがメッセージデータの構築に使用されます。詳細については、コネクタテンプレートについてを参照してください。

アクション：デリバリーストリームへのイベントデータ送信（バッチ処理）

バッチ制限

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

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

パラメータ

パラメータ	説明
デリバリーストリーム	データを送信するデリバリーストリームを選択します。利用可能なストリームを見るには、firehose:ListDeliveryStreams 権限が必要です。Amazon Kinesis Data Firehose デリバリーストリームには制限があります。詳細については、AWS: Amazon Data Firehose クォータを参照してください。
レコードサフィックス	各レコードの末尾に追加されるサフィックスで、デリミタとして使用されます。デフォルト：改行 (\n)
属性名の印刷	属性名が更新された場合、ペイロード内の名前が更新を反映します。

ベンダー文書

• AWS: Amazon Data Firehoseとは？
• AWS: Amazon Data Firehose クォータ
• AWS: Amazon Data Firehoseでのアクセス制御
• AWS: IAMロールへの切り替え (AWS API)
• AWS: 第三者が所有するAWSアカウントへのアクセス