Amazon S3 接続

最終更新日: 2024-02-12
  • トピック:
  • Destinations
    このトピックの詳細を表示
  • 作成対象:
  • Admin
    User

宛先の変更ログ

 変更ログを表示
リリース月 更新タイプ 説明
2024年1月 機能とドキュメントの更新 Amazon S3 宛先コネクタで、新しい想定されるロール認証タイプがサポートされるようになりました。 詳しくは、 認証セクション.
2023年7月 機能とドキュメントの更新 2023 年 7 月のExperience Platformリリースに伴い、 Amazon S3 の宛先には、次に示す新しい機能が用意されています。

次に接続: Amazon S3 API または UI を介したストレージ

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

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

オーディエンスの起源 サポートあり 説明
Segmentation Service Experience Platform セグメント化サービス.
カスタムアップロード CSV ファイルから Experience Platform に読み込まれたオーディエンス。

書き出しのタイプと頻度

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

項目 タイプ メモ
書き出しタイプ プロファイルベース 宛先のアクティベーションワークフローのプロファイル属性選択画面で選択した目的のスキーマフィールド(例:メールアドレス、電話番号、姓)と共に、セグメントのすべてのメンバーを書き出します。
書き出し頻度 バッチ バッチ宛先では、ファイルが 3 時間、6 時間、8 時間、12 時間、24 時間の単位でダウンストリームプラットフォームに書き出されます。 詳しくは、バッチ(ファイルベース)宛先を参照してください。

Amazon S3 のプロファイルベースの書き出しタイプで、UU で強調表示されています。

宛先への接続

重要

宛先に接続するには、 宛先の表示 および 宛先の管理 アクセス制御権限. 詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。

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

宛先に対する認証

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

  • アクセスキーと秘密鍵の認証
  • 想定される役割認証

アクセスキーと秘密鍵の認証

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

アクセスキーおよび秘密鍵認証を選択する際の必須フィールドの画像。

  • Amazon S3アクセスキーAmazon S3秘密鍵:Amazon S3 で access key - secret access key ペアを生成して、Amazon S3 アカウントに Platform アクセス権を付与します。詳しくは、Amazon Web Services に関するドキュメントを参照してください。

  • 暗号化キー:必要に応じて、RSA 形式の公開鍵を添付して、書き出したファイルに暗号化を追加できます。正しい形式の暗号化キーの例については、以下の画像を参照してください。

    UI での正しく書式設定された PGP キーの例を示す画像。

想定される役割

想定される役割認証を選択する際の必須フィールドの画像。

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

これをおこなうには、AWSコンソールで、とのAdobeを想定するユーザーを作成する必要があります 必要な権限 を使用してAmazon S3 バケットに書き込みます。 の作成 信頼済みエンティティ AWSのAdobeアカウント 670664943635. 詳しくは、 AWSのロール作成に関するドキュメント.

  • Role:AWSで作成した役割の ARN を、Adobeユーザーに貼り付けます。 このパターンは、次のようになります。 arn:aws:iam::800873819705:role/destinations-role-customer.
  • 暗号化キー:必要に応じて、RSA 形式の公開鍵を添付して、書き出したファイルに暗号化を追加できます。正しい形式の暗号化キーの例については、以下の画像を参照してください。

宛先の詳細を入力

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

  • 名前:この宛先を識別するのに役立つ名前を入力します。
  • 説明:この宛先の説明を入力します。
  • バケット名:この宛先が使用する Amazon S3 バケット名を入力します。
  • フォルダーパス:書き出したファイルをホストする保存先フォルダーのパス。
  • ファイルタイプ:書き出したファイルに使用する形式Experience Platformを選択します。 選択時に、 CSV オプションを選択する場合は、 ファイル形式設定オプションの設定.
  • 圧縮形式:書き出したファイルにExperience Platformが使用する圧縮タイプを選択します。
  • マニフェストファイルを含める:書き出しの場所や書き出しサイズなどに関する情報を含むマニフェスト JSON ファイルを書き出しに含める場合は、このオプションをオンに切り替えます。 マニフェストの名前は、形式を使用して付けられます manifest-<<destinationId>>-<<dataflowRunId>>.json. を表示します。 サンプルマニフェストファイル. マニフェストファイルには、次のフィールドが含まれます。
    • flowRunId: データフローの実行 書き出されたファイルを生成した
    • scheduledTime:ファイルが書き出されたときの UTC 時刻 (UTC)。
    • exportResults.sinkPath:書き出されたファイルが格納されるストレージの場所のパス。
    • exportResults.name:書き出されたファイルの名前。
    • size:書き出されるファイルのサイズ(バイト単位)。
ヒント

宛先の接続ワークフローでは、書き出したオーディエンスファイルごとにAmazon S3 ストレージにカスタムフォルダーを作成できます。 手順については、マクロを使用して、ストレージの場所にフォルダーを作成するを参照してください。

アラートの有効化

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

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

必要な Amazon S3 権限

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

  • s3:DeleteObject
  • s3:GetBucketLocation
  • s3:GetObject
  • s3:ListBucket
  • s3:PutObject
  • s3:ListMultipartUploadParts

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

重要
  • データをアクティブ化するには、 宛先の表示, 宛先のアクティブ化, プロファイルの表示、および セグメントを表示 アクセス制御権限. アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
  • 書き出す idID グラフを表示 アクセス制御権限.
    ワークフローでハイライト表示された ID 名前空間を選択して、宛先に対するオーディエンスをアクティブ化します。

詳しくは、 プロファイルの一括書き出し先に対するオーディエンスデータのアクティブ化 を参照してください。

データセットを書き出し

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

書き出したデータ

Amazon S3 の宛先の場合、Platform には、指定したストレージの場所にデータファイルが作成されます。ファイルについて詳しくは、 プロファイルの一括書き出し先に対するオーディエンスデータのアクティブ化 ( audience activation チュートリアル)を参照してください。

このページ