Amazon S3 Submission Export Integration Guide

This guide walks you through configuring a submission export integration from Digioh to Amazon S3. This allows your submission data to be delivered securely to an S3 bucket on a scheduled basis.

Step 1: Create the Amazon S3 Integration

1. Navigate to Integrations in the Digioh dashboard.

2. Select the API form post from the Integration Page..

3. In the Update Integration form, enter the following:

   • Integration Name

   • Form Post URL:
     This should match the S3 bucket endpoint:

https://your-bucket-name.s3.amazonaws.com

(Use the appropriate region/bucket name for your environment.)

• • Post Type: Select JSON Raw from the dropdown.
    

4. Click Update Integration to save.

Step 2: Configure Integration Advanced Settings

After saving, click into the integration to set authentication and headers:

1. HTTP Method:

   POST

2. Basic Auth Username:
   Your AWS Access Key ID

3. Basic Auth Password:
   Your AWS Secret Access Key

4. Header Configuration:

   Header Key	Header Value
   AWS Region	Your region ("us-east-1")
   Bucket Name	your-bucket-name

   Additional headers can be left blank unless specifically required for your infrastructure.

These credentials must be valid for S3 upload permissions. We recommend scoping them to only the bucket and object path required for export.

Step 3: Create a Submission Export Job

1. Go to Integrations > Pipelines > Add Job

2. Fill in the following:

   • Name: S3 Submissions Export(PROD)

• • Submission Source: Choose Lightbox.

  • Destination Type: Select S3

  • Connection: Select the integration you just created (e.g., S3 CSV Export(prod))

Step 4: Define Export Data

1. Filter Campaign IDs:
   Enter the IDs of the campaigns whose submissions should be exported (comma-separated). Example: 123456, 654321

2. Columns:
   This defines the fields in your exported CSV. Use the following structure for submission data and custom fields:

   Date,Lightbox ID,Lightbox Name,Email,Opt In,Web Source,Search Engine,Country,City,State,Postal Code,IP Address,Device Type,Operating System,Submit Url,Referring Url,Landing Url,1.Comfort,2.Style,3.Location,4.Options,5.Availability,6.Email Opt-in

3. Notification Emails:
   Enter the email addresses that should receive export status updates. Example: analytics-team@example.com

4. Path on Destination (optional):
   Define the folder path within the S3 bucket (e.g. /digioh/exports). Leave blank to export to the root.

Step 5: Test and schedule the Job

Test first! Before you do this, you can click on "Run" to do a test. You can fill in a timestamp to add a "Start date" until today for the date range:

If it's all working well, you can proceed with the scheduling setup:

1. Status:
   Set to Active

2. Interval:
   Select SCHEDULE

3. CRON Schedule (UTC):
   Use the format:

   0 17 * * 1-5

   This schedules the job to run at 5:00 PM UTC, Monday through Friday.

4. Click Save to finish the setup.

Here's a full example:

Summary

Need Help?

If you're unsure about S3 permissions, export formatting, or access to Digioh Connect, contact support@digioh.com or your Customer Success Manager!