Amazon S3

Use GrowthLoop audiences for file exports to Amazon S3.

Connect this destination to export audience membership as a CSV, for use in your own bucket and downstream tools.

This destination writes to your Amazon S3 bucket and is a good fit when you want to:

  • Use a file export rather than a paid-media or messaging API
  • Match contacts on a unique identifier

This maps to GrowthLoop Audiences:

Use it forAudiences
Dropping audience CSVs in an Amazon S3 bucket✓

If Adobe provisioned the bucket for Audience Manager onboarding, use Adobe Audience Manager instead.

Prerequisites

Make sure you have:

  • An S3 bucket for GrowthLoop audience exports.
  • An IAM user with a programmatic access key and a policy that grants write access to that bucket. Attach a policy like this, and replace the bucket ARN with yours:
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "s3:GetObjectVersionTagging",
                "s3:GetObjectAcl",
                "s3:GetObjectVersionAcl",
                "s3:DeleteObject",
                "s3:GetObjectAttributes",
                "s3:PutObject",
                "s3:GetObject",
                "s3:PutEncryptionConfiguration",
                "s3:GetEncryptionConfiguration",
                "s3:GetObjectTagging",
                "s3:GetObjectVersion",
                "s3:GetBucketACL"
            ],
            "Resource": [
                "arn:aws:s3:::test-export-from-fw",
                "arn:aws:s3:::test-export-from-fw/*"
            ]
        }
    ]
}

Set up Amazon S3 as a destination

  1. In GrowthLoop, click the Destinations tab on the left sidebar.
  2. Click New Destination in the top right corner.
  3. Search for S3 and click Add S3.
  4. Enter the required information, then click Create.
Amazon S3 destination setup form
FieldDescription
Destination NameName this destination in GrowthLoop. Use a name so your team recognizes its purpose, like "Amazon S3 Exports".
Sync FrequencySet the default export frequency (for example, daily or weekly). You can override this setting for individual exports.
BucketThe bucket name as it appears in the AWS S3 console.
AWS Access KeyAccess key for the IAM user.
AWS Access SecretSecret access key for that user.
AWS RegionThe AWS region for the bucket.
KMS Key (optional)KMS key ID if the bucket uses customer-managed encryption.
Columns to Export (optional)Comma-separated column list that limits the CSV to those fields, for example NAME,ADDRESS,CITY,STATE.
Prefix for Personalization Fields (optional)Prefix GrowthLoop adds to personalization field names. Leave blank for no prefix. If you set one, it must start with a letter and use up to 5 letters or numbers. The default value is fw.

GrowthLoop validates the connection. S3 then appears in your list of connected destinations.

Export to Amazon S3

From within GrowthLoop, export from an audience. See Export an audience if you need more information on these steps.

After building or selecting an audience, click Export, then search for your S3 destination.

Audience export modal with Amazon S3 selected

Map identifiers

Map Unique Identifier to the warehouse column that identifies each contact. You can also map custom attributes from the audience as additional fields.

Configure the export

Amazon S3 export settings including name, export type, and personalization fields
  • Name: GrowthLoop uses this in the S3 filename.
  • Export Type: Choose Export All Records for a full file on every run, or Export Updates (Deltas) to send a full file first and only changes after that.
  • Personalization Fields: Optional. Select the columns you want in the CSV.

Export behavior

This is what GrowthLoop writes when you export an audience.

BehaviorWhat happens
What GrowthLoop writesA CSV in the S3 bucket you configured. Direction is GrowthLoop → Amazon S3.
When it runsGrowthLoop sends the export as a batch on the next successful run. An export that starts Now runs within about 15 minutes.
File formatGrowthLoop writes a CSV to the bucket you configured.
FilenameThe export name is included in the object name.
Export All RecordsEach run writes the full audience.
Export Updates (Deltas)The first run writes the full audience. Later runs write only changes.
Columns to ExportIf you set this on the destination, GrowthLoop limits the CSV to those columns.

Confirm the export was successful

When the run finishes, confirm you can use the data in Amazon S3.

  • Audience export: Open the S3 bucket and look up the latest CSV.

In GrowthLoop, review counts on the audience Exports tab. See Export an audience for more information.

Congrats on successfully exporting to Amazon S3!

Troubleshooting

These are the issues we see most often. You can always email us at [email protected] for help.

ProblemCauseResolution
Connection fails to validateThe IAM user cannot write to the bucketConfirm the IAM user can PutObject on the bucket and prefix you configured
Files land in the wrong placeBucket or AWS Region does not match the AWS consoleConfirm Bucket and AWS Region match the bucket in the AWS console
Expected columns are missingColumns to Export or Personalization Fields omit those columnsCheck Columns to Export on the destination and Personalization Fields on the export

What’s Next

Export an audience after you connect a destination

Did this page help you?