Amazon S3 connection

Overview

Create a live outbound connection to your Amazon Web Services (AWS) S3 storage to periodically export CSV data files from Adobe Experience Platform into your own S3 buckets.

Export type and frequency

Refer to the table below for information about the destination export type and frequency.

Item Type Notes
Export type Profile-based You are exporting all members of a segment, together with the desired schema fields (for example: email address, phone number, last name), as chosen in the select profile attributes screen of the destination activation workflow.
Export frequency Batch Batch destinations export files to downstream platforms in increments of three, six, eight, twelve, or twenty-four hours. Read more about batch file-based destinations.

Amazon S3 profile-based export type

Connect to the destination

IMPORTANT

To connect to the destination, you need the Manage Destinations access control permission. Read the access control overview or contact your product administrator to obtain the required permissions.

To connect to this destination, follow the steps described in the destination configuration tutorial. In the destination configuration workflow, fill in the fields listed in the two sections below.

Authenticate to destination

To authenticate to the destination, fill in the required fields and select Connect to destination.

  • Amazon S3 access key and Amazon S3 secret key: In Amazon S3, generate an access key - secret access key pair to grant Platform access to your Amazon S3 account. Learn more in the Amazon Web Services documentation.
  • Encryption key: Optionally, you can attach your RSA-formatted public key to add encryption to your exported files. Your public key must be written as a Base64-encoded string.

    • Example: ----BEGIN PGP PUBLIC KEY BLOCK---- {Base64-encoded string} ----END PGP PUBLIC KEY BLOCK----. See below an example of a correctly formatted PGP key, with the middle part shortened for brevity.

      PGP key

Fill in destination details

To configure details for the destination, fill in the required and optional fields below. An asterisk next to a field in the UI indicates that the field is required.

  • Name: enter a name that will help you identify this destination.
  • Description: enter a description of this destination.
  • Bucket name: enter the name of the Amazon S3 bucket to be used by this destination.
  • Folder path: enter the path to the destination folder that will host the exported files.
TIP

In the connect destination workflow, you can create a custom folder in your Amazon S3 storage per exported segment file. Read Use macros to create a folder in your storage location for instructions.

Enable alerts

You can enable alerts to receive notifications on the status of the dataflow to your destination. Select an alert from the list to subscribe to receive notifications on the status of your dataflow. For more information on alerts, see the guide on subscribing to destinations alerts using the UI.

When you are finished providing details for your destination connection, select Next.

Required Amazon S3 permissions

To successfully connect and export data to your Amazon S3 storage location, create an Identity and Access Management (IAM) user for Platform in Amazon S3 and assign permissions for the following actions:

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

Activate segments to this destination

IMPORTANT

To activate data, you need the Manage Destinations, Activate Destinations, View Profiles, and View Segments access control permissions. Read the access control overview or contact your product administrator to obtain the required permissions.

See Activate audience data to batch profile export destinations for instructions on activating audience segments to this destination.

Exported data

For Amazon S3 destinations, Platform creates a .csv file in the storage location that you provided. For more information about the files, see Activate audience data to batch profile export destinations in the segment activation tutorial.

On this page