Amazon S3 integration

Amazon S3 is one of the most popular cloud file storage services. You can connect your Amazon S3 storage directly with Bloomreach for both data imports and exports.

How the integration works

The Amazon S3 integration lets Bloomreach connect directly to your Amazon S3 storage via the REST API over HTTP. You can import or export data to or from this storage. The integration also enables Adform retargeting.

You can choose the exact region and bucket where Bloomreach looks for files. The integration includes the following features:

• For imports and exports: regex file lookup, new file uploaded trigger, and selection rules for imports.
• For exports only: dynamic file naming.

Set up the integration

Create the integration

1. Go to Data & Assets > Integrations.
2. Click Add new integration in the upper right corner.
3. Select Amazon S3 for Exports or Amazon S3 for Imports from the list by clicking the + sign.

   

4. Accept the terms and conditions and click Continue.

📘

Note

If you don't see the Integrations button, contact your access administrator to enable this function.

Generate access tokens

To complete the integration, create access tokens through Amazon AWS. You configure each user's unique access level in AWS.

For imports only, your access token requires these permissions:

• s3:ListBucket
• s3:GetObject

For imports and exports, your access token requires these permissions:

• s3:ListBucket
• s3:GetObject
• s3:PutObject
• s3:DeleteObject

Connect these permissions to your access token for the AWS integration. You can use the S3 console to update an object's Access Control List (ACL) or configure bucket policies to grant the necessary access and permissions. This ensures imports and exports work correctly with Amazon S3.

📘

Security tip

Use the minimum access level needed for your use case. For imports only, use the AWS read-only policy with s3:ListBucket and s3:GetObject permissions.

Save your credentials

Save your Access key ID and Secret access key. You'll use these when importing or exporting data with your Amazon S3 integration.

🚧

Important

Keep your credentials secure and don't share them. Store them in a safe location where your team can access them when needed.

Use your integration

Use for imports

1. Go to Imports.
2. Click Select a File storage integration.
3. Choose Amazon S3.
4. Click the + sign to access your integration.

Use for exports

1. Go to Data Export.
2. Click Select a File storage integration.
3. Choose Amazon S3.
4. Click the + sign to access your integration.

Supported file formats

For imports

• CSV files
• XML files

For exports

• CSV files
• JSON files
• JSON lines files

Use cases

Import scenarios

• One-time imports: Import historical data or one-time campaign segments.
• Regular imports: Sync with internal tools like your CRM.

Export scenarios

• One-time exports: Export data for a specific time period.
• Regular exports: Set up daily data exports.
• Tool synchronization: Export data such as consents, events, or segments to internal or campaign tools.

Automated integrations

Adform integration: Export customers to custom audiences in Adform. Bloomreach handles this automatically.

Troubleshoot common issues

Connection problems

• Check your credentials: Make sure your Access Key ID and Secret Access Key are correct.
• Verify permissions: Ensure your AWS user has the right access level for your bucket.
• Confirm region settings: Double-check that you've selected the correct AWS region. Contact Bloomreach support if you run S3 on a custom region.

File import issues

• File format: Make sure your file is in a supported format.
• File location: Check that your file is in the correct bucket and folder path.
• File size: Large files may take longer to process or may need to be split into smaller chunks.

📘

Note

Contact Bloomreach support if you continue to experience issues.

Related resources

• Data imports: Learn more about importing data into Bloomreach.
• Data exports: Understand how to use the Data Exports feature.
• AWS S3 documentation: Visit Amazon's official S3 documentation for bucket setup help.