Amazon S3

Airbridge supports Amazon S3 integration. Once set up, you can access raw event data collected by Airbridge SDKs and tracking links from Amazon S3. You can select which events and properties to send to Amazon S3, and data collected the previous day is sent daily around 4:00 AM KST.

Attention

For connections created or modified after May 14, 2026, ${VERSION} in the folder path is fixed at 3.0. Existing connections keep their current version as long as you don't change them.

You need permissions to create an Amazon S3 bucket, IAM policy, and IAM role in the AWS Management Console.

Amazon S3 integration takes 4 steps.

1. Connection setup: Enter bucket details, create the IAM policy and role, and test the connection.

2. Event selection: Choose events to send to Amazon S3.

3. Property selection: Choose properties for those events.

4. Review and add: Review your selections and add the connection.

To create a connection, find the following information in the AWS Management Console.

• Bucket name

• Region

• IAM role ARN

Find the bucket name and region in the Amazon S3 console, and the IAM role ARN in the IAM console.

Find your bucket name and region in the Amazon S3 console.

1. Sign in to the AWS Management Console and open the Amazon S3 console.

2. In [Buckets], find the name and region of the bucket you want to integrate with Airbridge. If you don't have a bucket or want to integrate a new one, click Create bucket. See the AWS S3 user guide for details.

Enter the bucket name and region you found into the Airbridge dashboard.

1. In the Airbridge dashboard, go to [Integrations]>[Third-party Integration] and click Amazon S3.

2. Click Add connection.

3. Enter the bucket name and region from the Amazon S3 console.

4. Choose CSV or Parquet as the integration format and click Submit.

5. Once your information is submitted correctly, the IAM policy you need will appear. Click Copy to copy the policy.

Create an IAM policy in the IAM console to grant access to your Amazon S3 resources.

1. Open the IAM console.

2. Go to [Access management]>[Policies] and click Create policy in the top right.

3. Click the [JSON] tab in the top right. Paste the policy you copied from the Airbridge dashboard into the policy editor and click Next in the bottom right.

4. In [Review and create], enter a policy name. Leave the other settings as they are. Click Create policy in the bottom right to finish.

Create an IAM role in the IAM console that can delegate access to AWS resources.

1. From the Airbridge dashboard, copy the account ID and external ID.

2. In the IAM console, go to [Access management]>[Roles] and click Create role.

3. In [Trusted entity type], select AWS account.

4. In [AWS account], select Another AWS account and enter the account ID from the Airbridge dashboard. Under options, select Require external ID and enter the external ID from the Airbridge dashboard. Click Next.

   

5. In [Add permissions], search for the policy you created for the Airbridge-Amazon S3 integration by name. Select the checkbox and click Next.

6. In [Role details], enter a role name. Leave the other settings as they are. Click Create role to finish.

Enter the IAM role ARN you found in the IAM console into the Airbridge dashboard.

1. In the IAM console, go to [Access management]>[Roles] and click the IAM role you created for the Airbridge-Amazon S3 integration.

2. Copy the ARN.

3. Paste the IAM role ARN into the Airbridge dashboard and click Submit.

Test whether the information you entered can connect to Amazon S3.

1. In the Airbridge dashboard, click Test connection.

2. If the test succeeds, click Next in the bottom right to move to event selection.

If the test fails, check the information you entered and try again. If you leave the page before completing the test, you'll need to restart the entire integration process.

Select events to send to Amazon S3. You can only select events that Airbridge has collected at least once.

1. Select events by category of app, web, and tracking link.

2. Click Next in the bottom right.

Note

Events newly collected after you add the connection won't be sent until you add them manually.

Select properties to send to Amazon S3 for the events you chose.

1. Select properties by category.

2. Click Next in the bottom right.

Note

Required properties can't be deselected.

Review your selected events and properties, then add the connection.

1. Review [Events to send] and [Properties to send]. To make changes, click Edit on the right.

2. Under [Data transfer status], check the transfer status by data source.

3. Click Save connection in the bottom right to create the connection.

You can check data transfer status on the following pages in the Airbridge dashboard.

See the table below for the specific meaning of each status message.

Regardless of your app's timezone setting, cloud storage receives the previous day's data daily around 4:00 AM KST. Once you complete the Amazon S3 integration, data is delivered to the following paths in your bucket starting the next day.

• App events:

  ${YOUR-BUCKET-NAME}/${YOUR-APP-NAME}/app/${VERSION}/date=${year}-${month}-${day}/

• Web events:

  ${YOUR-BUCKET-NAME}/${YOUR-APP-NAME}/web/${VERSION}/date=${year}-${month}-${day}/

• Tracking link events:

  ${YOUR-BUCKET-NAME}/${YOUR-APP-NAME}/tracking-link/${VERSION}/date=${year}-${month}-${day}/

Sent files contain only the properties you selected. Property changes can reorder columns in the file, so always use column names to identify data.

Attention

For connections created or modified after May 14, 2026, ${VERSION} in the folder path is fixed at 3.0. Existing connections keep their current version as long as you don't change them.

Refer to the sections below to edit or delete your integration.

If your Amazon S3 integration details change, follow these steps to update them.

1. In the Airbridge dashboard, go to [Integrations]>[Third-party Integration] and click Amazon S3.

2. Click the connection you want to update.

3. Click the field you want to edit and enter the new value.

4. When done, click Done.

If you change the bucket name, region, integration format, or IAM role ARN, you need to test the connection again.

1. In the Airbridge dashboard, go to [Integrations]>[Third-party Integration] and click Amazon S3.

2. Click the delete icon for the connection you want to remove.

3. Enter the confirmation phrase and click Delete.

Deleting a connection stops data transfer immediately. However, data already sent to Amazon S3 stays in your bucket.

You can check integration setup status under [Integrations]>[Integration Overview] in the Airbridge dashboard. If an error occurs, see the Check integration status guide for resolution steps.

Airbridge supports one cloud storage integration by default. Integrating with more than one storage requires additional charges.

Editing transfer settings (events or properties) changes the ${VERSION} in your Amazon S3 storage path to 3.0, so data can no longer be retrieved from the previous location. Check with your internal S3 administrator before switching to the 3.0 path.