Amazon S3 コネクタ構成ガイド

バッチ制限

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

• リクエストの最大数：100,000
• 最も古いリクエストからの最大時間：10分
• リクエストの最大サイズ：100 MB

構成

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

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

• 認証タイプ
  • 認証タイプを選択します。利用可能なオプションは、STS と アクセスキー です。
    • STS：Assume Role: ARN および Assume Role: セッション名 フィールドが必要です。
    • アクセスキー：AWS アクセスキー および AWS シークレットアクセスキー フィールドが必要です。
• リージョン
  • 必須。リージョンを選択します。
• STS - Assume Role: ARN
  • STS 認証に必要です。アサムロールを行うロールの Amazon リソース名 (ARN) を提供します。
  • 例：arn:aws:iam:222222222222:role/myrole。
  • 詳細については、AWS Identity and Access Management: IAM ロールへの切り替え (AWS API)を参照してください。
• STS - Assume Role: セッション名
  • ロールをアサムするセッションの名前。
  • 2文字から64文字の間である必要があります。
• STS - Assume Role: 外部ID
  • 第三者の外部識別子を提供します。
  • 詳細については、AWS Identity and Access Management: 第三者が所有する AWS アカウントへのアクセスを参照してください。
• アクセスキー - AWS アクセスキー
  • アクセスキー 認証に必要です。AWS アクセスキーを提供します。
• アクセスキー - AWS シークレットアクセスキー
  • アクセスキー 認証に必要です。AWS シークレットアクセスキーを提供します。

AWS S3 への接続を作成する

Tealiumは、バケットのリストを表示し、S3オブジェクトにイベントデータとオーディエンスデータをアップロードするために、AWS S3インスタンスへの接続を必要とします。認証には2つのオプションがあります：

• アクセスキーとアクセスシークレットを提供する。
• STS（セキュリティトークンサービス）の資格情報を提供する。

アクセスキーとシークレットの資格情報

AWS アクセスキーとシークレットを見つけるには：

1. AWS 管理コンソールにログインし、IAM（Identity and Access Management）サービスに移動します。
2. ユーザー をクリックし、次に ユーザーを追加 をクリックします。
3. ユーザー名を入力します。例：TealiumS3User。
4. 作成したユーザーにポリシーをアタッチします。
   1. 権限 タブで 既存のポリシーを直接アタッチ をクリックします。
   2. AmazonS3FullAccess ポリシーを検索してアタッチし、完全アクセスを許可します。特定のバケットへのアクセスを制限する場合は、次の例のようなポリシーを作成します。例では、YOUR_BUCKET_NAME は Tealium が S3 オブジェクトにイベントデータとオーディエンスデータをアップロードするために使用するバケットです：

   {
     "Version": "2012-10-17",
     "Statement": [
         {
               "Effect": "Allow",
               "Action": [
                  "s3:ListBucket",
                   "s3:PutObject",
                   "s3:GetObject",
                   "s3:ListBucketMultipartUploads",
                   "s3:ListMultipartUploadParts"
               ],
               "Resource": [
                   "arn:aws:s3:::YOUR_BUCKET_NAME",
                   "arn:aws:s3:::YOUR_BUCKET_NAME/*"
               ]
           }
       ]
   }
   

5. キーを作成します。
   1. セキュリティ認証情報 タブに移動し、アクセスキーを作成 をクリックします。
   2. アクセスキーID と シークレットアクセスキー をコピーし、安全に保存します。

STS 資格情報

STS 資格情報を見つけるには：

1. AWS 管理コンソール にログインし、IAM（Identity and Access Management）サービスに移動します。
2. ロール をクリックし、次に ロールを作成 をクリックします。
3. 信頼されたエンティティのタイプ で、AWS アカウントを選択します。
4. 他の AWS アカウント を選択し、Tealium アカウント ID 757913464184 を入力します。
5. オプション。外部 ID が必要 チェックボックスを選択し、使用する外部 ID を指定します。外部 ID は 256 文字までの長さであり、英数字 (A-Z, a-z, 0-9) およびハイフン (-)、アンダースコア (_)、ピリオド (.) などの記号を含むことができます。
6. ロールの名前を入力します。ロール名は TealiumS3 で始まる必要があります。例：TealiumS3-test。
7. ロールにポリシーをアタッチします。
   1. 権限 タブで 既存のポリシーを直接アタッチ をクリックします。
   2. AmazonS3FullAccess ポリシーを検索してアタッチし、完全アクセスを許可します。特定のバケットへのアクセスを制限する場合は、次の例のようなポリシーを作成します。例では、YOUR_BUCKET_NAME は Tealium が S3 オブジェクトにイベントデータとオーディエンスデータをアップロードするために使用するバケットです：

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "s3:ListBucket",
                   "s3:PutObject",
                   "s3:GetObject",
                   "s3:ListBucketMultipartUploads",
                   "s3:ListMultipartUploadParts"
               ],
               "Resource": [
                   "arn:aws:s3:::YOUR_BUCKET_NAME",
                   "arn:aws:s3:::YOUR_BUCKET_NAME/*"
               ]
           }
       ]
   }
   

8. 信頼ポリシーを作成します。
   1. 信頼関係 タブに移動し、信頼関係を編集 をクリックします。
   2. 信頼ポリシーが作成したロールを使用する特定の外部 ID を許可し、Tealium の本番アカウント ID が 757913464184 であることを確認します。
   3. Tealium への接続のための EXTERNAL_ID 値を構成します。ID は 256 文字までの長さであり、英数字 (A-Z, a-z, 0-9) およびハイフン (-)、アンダースコア (_)、ピリオド (.) などの記号を含むことができます。

       {
           "Version": "2012-10-17",
           "Statement": [
               {
                   "Effect": "Allow",
                   "Principal": {
                       "AWS": "arn:aws:iam::757913464184:root"
                   },
                   "Action": "sts:AssumeRole",
                   "Condition": {
                       "StringEquals": {
                           "sts:ExternalId": "EXTERNAL_ID"
                   }
               }
           }
       ]
   }
   

バケットを作成する

S3 バケットは AWS S3 内の保存コンテナであり、データを保存および整理するために使用されます。コネクタ構成ウィンドウで、構成ステップで バケットを作成 をクリックすることで新しいバケットを作成できます。

1. コネクタ構成画面で バケットを作成 をクリックします。
2. バケット名を入力します。
3. 作成 をクリックします。

アクション

アクション名	AudienceStream	EventStream
すべてのイベントデータを送信	✗	✓
カスタムイベントデータを送信	✗	✓
ログイベントを送信	✗	✓
すべての訪問データを送信	✓	✗
カスタム訪問データを送信	✓	✗

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

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

すべてのイベントデータを送信

パラメータ

パラメータ	説明
バケット	Amazon S3バケットを選択するか、カスタム値を入力してください。
ファイルパス	データを追加したいS3オブジェクトのパスを指定してください。
ファイルパスサフィックス	現在のタイムスタンプなどの属性をファイルパスに動的に追加したい場合は、ここで選択してください。複数のサフィックス値を入力すると、アンダースコア文字で区切られます。
レコードサフィックス	各レコードの末尾に追加するサフィックスとしてのデリミタ。 デフォルトは Newline です。 利用可能なオプションは Newline と No Delimiter です。
既存のファイルを上書き	このチェックボックスを選択すると、現在のデータで既存のS3オブジェクトを置き換えます。選択されていない場合、コネクタはデータを追加します。許可されている最大ファイルサイズは200MBです。その限界に達すると、これ以上データは追加されません。
属性名を印刷	デフォルトでは属性キーが使用されます。代わりに属性名をキーとして使用したい場合は、このチェックボックスを有効にしてください。属性名が更新されるとペイロード名も更新されることに注意してください。
バッチの有効期限	有効期限（TTL）は分単位です。1から60の間でなければなりません。デフォルトは10分です。

カスタムイベントデータの送信

パラメータ

パラメータ	説明
バケット	Amazon S3バケットを選択するか、カスタム値を入力してください。
ファイルパス	データを追加したいS3オブジェクトのパスを指定してください。

メッセージデータ

パラメータ	説明
ファイルパスサフィックス	現在のタイムスタンプなどの属性をファイルパスに動的に追加したい場合は、ここで選択してください。複数のサフィックス値を入力すると、アンダースコア文字で区切られます。
レコードサフィックス	各レコードの末尾に追加するサフィックスとしてのデリミタ。 デフォルトは Newline です。 利用可能なオプションは Newline と No Delimiter です。
既存のファイルを上書き	選択された場合、現在のデータで既存のS3オブジェクトを置き換えます。選択されていない場合は、代わりにデータを追加します。
バッチの有効期限	有効期限（TTL）は分単位です。1から60の間でなければなりません。デフォルトは10分です。
テンプレート変数	テンプレートのデータ入力としてテンプレート変数を提供します。使用例や詳細については、コネクターテンプレート変数を参照してください。 ドット表記でネストされたテンプレート変数に名前を付けます。例：items.name. ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
テンプレート	イベントパラメータで参照されるテンプレートを提供します。詳細については、コネクタテンプレートについてを参照してください。 テンプレートは、例えば {{SomeTemplateName}} のように、サポートされているフィールドに名前でダブルカーリーブレースで注入されます。

全訪問データの送信

パラメータ

パラメータ	説明
バケット	Amazon S3バケットを選択するか、カスタム値を入力してください。
ファイルパス	データを追加したいS3オブジェクトのパスを指定してください。
ファイルパスサフィックス	現在のタイムスタンプなどの属性をファイルパスに動的に追加したい場合は、ここで選択してください。複数のサフィックス値を入力すると、アンダースコア文字で区切られます。
レコードサフィックス	各レコードの末尾に追加するサフィックスとしてのデリミタ。 デフォルトは Newline です。 利用可能なオプションは Newline と No Delimiter です。
既存のファイルを上書き	このチェックボックスを選択すると、現在のデータで既存のS3オブジェクトを置き換えます。選択されていない場合、コネクタはデータを追加します。許可されている最大ファイルサイズは200MBです。その限界に達すると、これ以上データは追加されません。
属性名を印刷	デフォルトでは属性キーが使用されます。代わりに属性名をキーとして使用したい場合は、このチェックボックスを有効にしてください。属性名が更新されるとペイロード名も更新されることに注意してください。
バッチの有効期限	有効期限（TTL）は分単位です。1から60の間でなければなりません。デフォルトは10分です。
全訪問イベントを含む	現在の訪問データを訪問データに含めるために選択します。

カスタム訪問データの送信

パラメータ

パラメータ	説明
バケット	Amazon S3バケットを選択するか、カスタム値を入力してください。
ファイルパス	データを追加したいS3オブジェクトのパスを指定してください。

メッセージデータ

パラメータ	説明
ファイルパスサフィックス	現在のタイムスタンプなどの属性をファイルパスに動的に追加したい場合は、ここで選択してください。複数のサフィックス値を入力すると、アンダースコア文字で区切られます。
レコードサフィックス	各レコードの末尾に追加するサフィックスとしてのデリミタ。 デフォルトは Newline です。 利用可能なオプションは Newline と No Delimiter です。
既存のファイルを上書き	選択された場合、現在のデータで既存のS3オブジェクトを置き換えます。選択されていない場合は、代わりにデータを追加します。
バッチの有効期限	有効期限（TTL）は分単位です。1から60の間でなければなりません。デフォルトは10分です。
テンプレート変数	テンプレートのデータ入力としてテンプレート変数を提供します。使用例や詳細については、コネクターテンプレート変数を参照してください。 ドット表記でネストされたテンプレート変数に名前を付けます。例：items.name. ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
テンプレート	イベントパラメータで参照されるテンプレートを提供します。詳細については、コネクタテンプレートについてを参照してください。 テンプレートは、例えば {{SomeTemplateName}} のように、サポートされているフィールドに名前でダブルカーリーブレースで注入されます。

ログイベントの送信

パラメータ

パラメータ	説明
バケット	Amazon S3バケットを選択するか、カスタム値を入力してください。
ファイルパス	データを追加したいS3オブジェクトのパスを指定してください。
ファイルパスサフィックス	現在のタイムスタンプなどの属性をファイルパスに動的に追加したい場合は、ここで選択してください。複数のサフィックス値を入力すると、アンダースコア文字で区切られます。
レコードサフィックス	各レコードの末尾に追加するサフィックスとしてのデリミタ。 デフォルトは Newline です。 利用可能なオプションは Newline と No Delimiter です。