Integrate Wingify with Amazon S3

This article covers the following:

• Overview
• How Can Wingify-Amazon S3 Integration Help You?
• Before You Begin
• Create a Bucket in the AWS Dashboard
• Create an IAM Policy in the AWS Dashboard
• Create an IAM User and Generate Credentials
• Create an Amazon S3 Connection
• Export Data to Amazon S3
  • Specifications of Wingify Campaign Data Sent to Amazon S3
  • View Your Campaign ID in Wingify
• FAQs

Overview

Amazon Simple Storage Service (Amazon S3) is an object storage service that offers industry-leading scalability, data availability, security, and performance. Amazon S3 provides easy-to-use management features so you can organize your data and configure finely-tuned access controls to meet your specific business, organizational, and compliance requirements.

Amazon S3 users can access their data through a web browser or command-line interface and choose the geographical location where their data is stored. You can learn more about Amazon S3 here. 

Note: This integration is available to Enterprise accounts.

How Can Wingify-Amazon S3 Integration Help You?

• Ability to export Wingify campaign (including surveys) data daily
• Eliminates the need to download CSV from Wingify’s dashboard manually
• Use platforms like Amazon Redshift to leverage and understand your audience's journey in Wingify

Before You Begin

Ensure you have:

• An AWS account.
• Access to Amazon S3 and IAM in your AWS account.

Create a Bucket in the AWS Dashboard

Once you’ve enabled Amazon S3 in your Wingify account, create a bucket in your AWS dashboard:

1. Log in to your AWS account.

2. In your AWS dashboard, type S3 in the search bar and select Services > S3.

   

3. To create a bucket, click Create bucket.

   

4. In the UI that appears, enter the Bucket name.

   

5. To finalize your bucket creation, click Create bucket at the bottom of the page.

   

Create an IAM Policy in the AWS Dashboard

After you’ve created a bucket in your AWS account, create a policy in your AWS dashboard:

1. Log in to your AWS account.

2. In your AWS dashboard, type IAM in the search bar and select Services > IAM.

   

3. Go to Access Management > Policies.

   
   

4. To create a policy, click Create Policy.

   

5. In the UI that appears, go to the JSON tab and enter the following code snippet. Once done, click Next: Review. 

{

"Version": "2012-10-17",

"Statement": [
 {

"Effect": "Allow",

"Action": ["s3:ListBucket"],

"Resource": ["arn:aws:s3:::<specify the bucket name specified in Step-4 of the “Create a Bucket in the AWS Dashboard” procedure>"]
 },
 {

"Effect": "Allow",

"Action": [

"s3:PutObject",

"s3:GetObject",

"s3:DeleteObject"
   ],

"Resource": ["arn:aws:s3:::<specify the bucket name specified in Step-4 of the “Create a Bucket in the AWS Dashboard” procedure>/*"]
 }
]
}

6. In the UI that appears, enter your policy name and review your configurations. Once done, click Create policy.

   

Create an IAM User and Generate Credentials

After you’ve created a policy in your AWS account, add a user to your AWS dashboard:

1. Log in to your AWS account.

2. In your AWS dashboard, type IAM in the search bar and select Services > IAM.

   

3. To add a user, go to Access Management > Users.

   
   

4. To add a user, click Add user.

   

5. In the UI that appears, do the following:
   • In the User name field, specify the user name.
   • Select the Access type as Programmatic access.

   • Once done, click Next: Permissions.

     

6. From the list of policies that appears, select the one specified in Step-5 of the Create an IAM Policy in the AWS Dashboard procedure, and click Next: Tags.

   

7. Review your user configurations and Create user.

    
    

8. On successful creation of a user, the security credentials are generated, which you can download using the Download.csv button.

   

Create an Amazon S3 Connection

Wingify supports the following Amazon S3 connection type:

• Export data to Amazon S3 (Connector): Allows you to export Wingify campaign (including survey) data to your Amazon S3 bucket.

To create an Amazon S3 connection in your Wingify account:

1. Log in to your Wingify account.
2. Navigate to Configurations > Integrations.
3. Click the Amazon S3 integration tile and then click Create Connection.

All configured connections appear under Config > Active Connections on the Amazon S3 integration page.

Once the connection is created, enable the integration at the campaign level using the following steps:

1. Navigate to Web Experimentation.
2. Select the desired campaign, and go to Configuration > Integrations.
3. Select Amazon S3 from the list of available integrations.

Export Data to Amazon S3

Use this connection type to export your Wingify campaign data to your Amazon S3 bucket.

To configure the connection:

1. Click Create Connection and select Export data to Amazon S3.
2. Enter a name in the Connection Name field (e.g., "Amazon S3 connector").
3. In the Bucket name field, enter the bucket name configured under Amazon S3 (e.g., "wingify-integration").
4. In the Access key field, enter the access key configured under Amazon S3.
5. In the Secret key field, enter the secret key configured under Amazon S3.
6. Click Test Connection to validate if Wingify can write data to the specified bucket.
7. On successful validation, the connection results are displayed, showing the Bucket Path(s) where campaign data and metadata will be written, and the granted Permissions (e.g., Create Objects, Delete Objects).
8. Once validated, click Create Connection to finalize.

To edit an existing connection, click the vertical ellipsis (⋮) next to it and select Edit. This opens the Edit Connection panel pre-filled with the Connection Name, Bucket name, and masked Access key/Secret key. Click Test Connection to re-validate, then click Update Connection to save changes.

Specifications of Wingify Campaign Data Sent to Amazon S3

Upon successful setup, a CSV file is created in Amazon S3 for every campaign. The path where you can find the campaign data: bucketName/accountId/campaignId/yyyymmdd.csv.gz. The path where you can find the campaign’s metadata: bucketName/accountId/campaignId/meta.csv.gz. You can also find a sample campaign data and metadata file here.

View Your Campaign ID in Wingify

You can find the campaign ID directly in the Web Experimentation dashboard. The ID column displays the campaign ID for each campaign in the list.

Alternatively, to find your campaign ID at the campaign level, go to Review, scroll down to the Other Information section and check the Campaign ID.

FAQs

If the Amazon S3 configuration is not set up correctly, will my campaign data be synced?

No. Campaign data is synced only after the Amazon S3 configuration is successfully validated and the connection is created.

Need more help?

For more information or further assistance, contact Wingify Support.