Amazon S3

Setting up your Amazon S3 bucket destination.

Creating a Amazon S3 Destination

You can create a new Amazon S3 destination from your DCN by going to the Integrations -> Destinations section in your navigation menu or by using the CLI. (see above tab).

To add your Amazon S3 bucket, you will need to enter the name of this destination (this is how your destination will appear in the listing), the Amazon S3 bucket URL, region, access ID and secret key.

The <access-id> and <secret-key> are required and should specify the AWS access ID and secret associated with a service account having at least write permissions to the specified bucket (s3:PutObject).

Finally, if you created the destination using your DCN UI you will be redirected to the destinations listing. If you used the CLI, you will be able to export directly from the at the command line.

Exporting Audiences to S3 buckets

To export to your S3 bucket, navigate to the audience you want to export and click "Export" in the top right. From there you will be asked to select your preferred Amazon S3 bucket export destination from a list of all available destinations.

Here you can select what format to export your audience as, both CSV or TSV formats are supported. In addition to the format, you can choose to export either IDs or ID clusters, as well as which IDs to export and various export options. At the bottom of the export page, you can set the name of the file that will be exported to your Amazon S3 bucket bucket.

What Can I Export to Amazon S3?

You can export IDs only or ID clusters. All ID types are supported by this destination type. Exports to this destination also have the following optional settings:

  • Include the header row.

  • Include values prefixed with type indicator.

  • ID type in second column.

  • Export an additional METADATA file

How will my Export Appear in Amazon S3?

Your export will appear in your Amazon S3 bucket with the file name you set during export creation.

If you choose to re-export an audience with the same name, it will overwrite the existing file in your storage bucket. However, if you opt for a filename that does not currently exist, a new file will be created upon export.

Last updated