Amazon S3 接続 s3-connection

宛先の変更ログ changelog

API または UI を使用した Amazon S3 ストレージへの接続 connect-api-or-ui

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

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

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

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

でハイライト表示されたAmazon S3 プロファイルベースの書き出しタイプ

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

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

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

オーディエンスデータ を書き出すと、Experience Platformは、指定されたストレージの場所に .csv、parquet または .json ファイルを作成します。 ファイルについて詳しくは、Audience Activation チュートリアルの ​ 書き出しでサポートされるファイル形式 ​ の節を参照してください。

データセット を書き出すと、Experience Platformは、指定されたストレージの場所に .parquet または .json ファイルを保存します。 ファイルについて詳しくは、データセットの書き出しチュートリアルの ​ データセットの書き出しが成功したことを確認する ​ の節を参照してください。

宛先への接続 connect

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

宛先に対する認証 authenticate

宛先に対して認証するには、必須フィールドに入力し、「宛先に接続」を選択します。 Amazon S3 の宛先では、次の 2 つの認証方法をサポートしています。

S3 アクセスキーと秘密鍵による認証

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

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

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

これを行うには、AWS コンソールで、Amazon S3 バケットに書き込むための ​ 必要な権限を持つ ​Adobeの想定ロールを作成する必要があります。

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

S3 顧客アカウントでのユーザーロールの作成

Adobeが想定する役割を指定

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

ARN は、AWS コンソールでロールを作成した後、メインページに表示されます。 この 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 を使用した宛先アラートの購読についてのガイドを参照してください。

宛先接続への詳細の入力を終えたら「次へ」を選択します。

必要な 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 アドレス ​ の記事を参照してください。