Amazon S3 接続 s3-connection

宛先の変更ログ changelog

APIまたはUIを介してAmazon S3 ストレージに接続する connect-api-or-ui

サポートされるオーディエンス supported-audiences

この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。

オーディエンスのデータタイプ別にサポートされるオーディエンス：

書き出しのタイプと頻度 export-type-frequency

宛先の書き出しタイプと頻度については、次の表を参照してください。

でハイライト表示されました

データセットの書き出し export-datasets

この宛先では、データセットの書き出しをサポートしています。 データセットの書き出しを設定する方法について詳しくは、チュートリアルを参照してください。

書き出されたデータのファイル形式 file-format

オーディエンスデータ​を書き出すと、Experience Platformは、指定した保存場所に.csv、parquet、または.json個のファイルを作成します。 ファイルについて詳しくは、オーディエンスアクティベーションのチュートリアルの「​ サポートされている書き出し用ファイル形式」セクションを参照してください。

データセット​を書き出すと、Experience Platformは、指定したストレージの場所に.parquetまたは.json個のファイルを作成します。 ファイルについて詳しくは、データセットの書き出しチュートリアルの「成功したデータセットの書き出しを検証する」セクションを参照してください。

宛先への接続 connect

この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つの節でリストされているフィールドに入力します。

宛先に対する認証 authenticate

宛先に対して認証を行うには、必須フィールドに入力し、Connect to destination​を選択します。 Amazon S3の宛先は、次の2つの認証方法をサポートしています。

S3 アクセスキーと秘密鍵を使用した認証 s3-access-key-secret-key-auth

この認証方法は、Amazon S3 アクセスキーと秘密鍵を入力して、Experience PlatformがAmazon S3 プロパティにデータを書き出せるようにする場合に使用します。

S3 で想定される役割による認証 assumed-role-authentication

アカウントキーと秘密鍵をアドビと共有したくない場合は、この認証タイプを使用します。代わりに、Experience Platformはロールベースのアクセスを使用してAmazon S3の場所に接続します。

これを行うには、AWS コンソールで、Adobe S3 バケットへの書き込みに必要な権限を持つAmazonの役割を想定する必要があります。

必要な権限を持つポリシーを作成

S3顧客アカウントでユーザーの役割を作成

Adobeが​を引き受ける役割を提供する

AWSでロールを作成した後、ロール ARNをAdobeに提供する必要があります。 ARNは、次のパターンに従います：arn:aws:iam::800873819705:role/destinations-role-customer

AWS コンソールでロールを作成した後、メインページでARNを見つけることができます。 宛先の作成時にこのARNを使用します。

役割の権限と信頼関係の確認

役割に次の設定があることを確認します。

代替案：特定のAdobe ユーザーに制限（オプション）

Adobe アカウント全体を許可しない場合は、特定のAdobe ユーザーのみにアクセスを制限できます。 これを行うには、次の設定で信頼ポリシーを編集します。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::670664943635:user/destinations-adobe-user"
            },
            "Action": "sts:AssumeRole",
            "Condition": {}
        }
    ]
}

詳しくは、AWSのロールの作成に関するドキュメント ​を参照してください。

宛先の詳細を入力 destination-details

宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横のアスタリスクは、そのフィールドが必須であることを示します。

アラートの有効化 enable-alerts

アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。

宛先接続の詳細の提供が完了したら、Next​を選択します。

必要な Amazon S3 権限 required-s3-permission

Amazon S3 ストレージの場所に正常に接続してデータを書き出すには、Amazon S3 で Experience Platform の IAM（Identity and Access Management）ユーザーを作成し、次のアクションに対する権限を割り当てます。

IAMが想定する役割の認証に必要な最小権限 minimum-permissions-iam-user

IAM役割を顧客として設定する場合、役割に関連付けられた権限ポリシーに、バケットのターゲットフォルダーに対する必要なアクションと、バケットのルートに対するs3:ListBucket アクションが含まれていることを確認します。 この認証タイプの最小権限ポリシーの例を以下に示します。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:GetObject",
                "s3:DeleteObject",
                "s3:GetBucketLocation",
                "s3:ListMultipartUploadParts"
            ],
            "Resource": "arn:aws:s3:::bucket/folder/*"
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Allow",
            "Action": [
                "s3:ListBucket"
            ],
            "Resource": "arn:aws:s3:::bucket"
        }
    ]
}

この宛先に対してオーディエンスをアクティブ化 activate

この宛先に対するオーディエンスのアクティブ化の手順については、​ バッチプロファイル書き出し宛先に対するオーディエンスデータのアクティブ化を参照してください。

データの正常な書き出しの検証 exported-data

データが正常に書き出されたかどうかを確認するには、Amazon S3 ストレージを確認し、書き出されたファイルに想定されるプロファイル母集団が含まれていることを確認してください。

IP アドレスの許可リスト ip-address-allow-list

Adobe IPを契約許可リストに追加する必要がある場合は、「IP アドレス契約」を参照してください。