This page provides information about downstream integration options for AWS S3 connectors. To perform downstream integration with AWS S3 connectors, consider the following options:

• The native setup by Acquia
• A client-hosted cloud storage connection

Both methods receive data structured as CSV files.

Capabilities¶

• Native Acquia CDP-hosted setup
  Create a fully managed Amazon Cloud Storage integration with an Acquia CDP-hosted destination connector to receive and process CDP data through file drops.
• Native client-hosted setup
  Create a client-hosted destination connector to receive transferred data from your CDP into your Amazon Cloud Storage.

Native CDP-hosted setup¶

Creating an instance¶

1. Sign in to the CDP user interface.
2. Click Integrations > Instances.

3. Click Add Instance.

   The system displays the Create Instance page.

4. In Name, enter the name for your instance.

5. In Instance Type, select the preferred instance type.

   The system displays additional fields depending on the instance type.

6. Click Save.

   The system auto-populates values in the fields in the Instance Credentials section.

7. Copy the credentials from each field by clicking the square icon at the right of the field.

Creating Acquia CDP-hosted integration¶

1. In Name, enter the name for your instance.

2. In Instance Type, select AWS S3.

3. Click Save.

   The system creates the instance and auto-populates values in the following fields:

   • Bucket Name

   • Folder Name

   • Secret Key

   • Access Key

Take a back up of these credentials in a secure location, as they cannot be viewed again in the system.

Native client-hosted setup¶

Creating a client-hosted integration¶

1. Sign in to the CDP user interface.
2. Click Integrations > Output Connectors.
3. Click Add Integration.
4. On the Add Integration page, select S3 Output Connector and click Next.
5. Specify the name and description for the connector, and click Next.

6. Select S3 External.

   

7. In AWS S3 Bucket Name, specify the name of your S3 bucket.

8. In AWS S3 Bucket Folder Name, specify the folder name that contains your S3 bucket.

9. In AWS Access Key, specify your AWS access key.

10. In AWS Secret Key, specify your AWS secret key.

11. To test the connection with the external S3 instance, click Test Connection.
12. Click Next.
13. In Basic Parameters, do the following:
    1. Select a delimiter from the available options.

    2. Define whether you want to enable AWS server side encryption.

    3. Select a date and time format from the available options.

       
14. In Advanced Parameters, do the following:
    1. Select a date and time format for the output file name.

    2. Define whether you want to enable PGP encryption to your output file. If yes, then enter the PGP public key.

    3. Specify the extension for non-CSV format output files.

    4. Define whether you want to enable PGP encryption to your output file. If yes, then specify the number of parts in which you want to split the file.

       

15. Click Save.

    The system saves the output connector in the Unpublished state.

16. To publish the connector, Click Publish.

    The system saves the output connector in the Active state. You can use the connector for further processing.

Setting up parameters¶

1. In Basic Parameters, do the following:
   1. Select a delimiter from the available options.

   2. Define whether you want to enable AWS server side encryption.

   3. Select a date and time format from the available options.
2. In Advanced Parameters, do the following:
   1. Select a date and time format for the output file name.
   2. Define whether you want to enable PGP encryption to your output file. If yes, then enter the PGP public key.
   3. Specify whether you want to use a non-traditional CSV format.
   4. Define whether you want to split your output file. If yes, then specify the number of parts in which you want to split the file.

3. Click Save.

   The system saves the output connector in the Unpublished state.

4. To publish the connector, Click Publish.

   The system saves the output connector in the Active state. You can use the connector for further processing.

Verifying destination¶

Any integration setup created is added under Action.

1. Sign in to your CDP user interface.

2. Navigate to Actions > Campaigns+.
3. Proceed to Step 6 in the Campaign Builder to add a destination channel.

4. On the Destination(s) page, click Add new destination channel.

   

   The system displays a list of destinations that are configured for your environment.

5. Select a destination channel to export the audience and content.

   For example, Secure File Transfer Protocol (SFTP), Data Management Platform (DMP), Email Service Provider (ESP), and Social Media.

6. To use the Search Bar and Category Filter:

   1. In the Destination(s) page, enter keywords in the search bar to quickly find your desired destination.

   2. Apply the category filter to narrow down the list of available options.

7. Search for Your AWS S3 Integration Setup

   1. Type in Your Integration name to locate your configured integration.

   2. If the setup is correctly configured, the integration name must display in the search results.

8. Verify the configuration.

   • After the AWS S3 integration displays, confirm that it matches your intended setup.

   • Ensure that all the required parameters and settings are correctly applied before proceeding.

Important consideration¶

This solution is designed for companies that plan to export records to cloud storage through Amazon Web Services (AWS) S3 integration. It provides up to 10 connectors and automatically generates user accounts.