아마존 S3

에어브릿지는 아마존 S3(Amazon S3) 연동을 지원합니다. 연동을 완료하면 에어브릿지 앱·웹 SDK와 트래킹 링크로 수집된 이벤트의 원본 데이터를 아마존 S3에서 확인할 수 있습니다. 아마존 S3로 전송할 이벤트와 프로퍼티를 직접 선택할 수 있으며, 전날 수집된 데이터는 매일 KST(한국표준시) 오전 4시 경에 전송됩니다.

주의하세요

2026년 5월 14일 이후 새로 생성되거나 수정된 커넥션은 폴더 경로의 ${VERSION} 값이 3.0으로 고정됩니다. 기존에 연동되어 있던 커넥션의 경우, 변경사항이 없으면 버전 값이 유지됩니다.

AWS 매니지먼트 콘솔에서 아마존 S3 버킷, IAM 정책, IAM 역할을 생성할 수 있는 권한이 필요합니다.

아마존 S3 연동은 4단계로 진행됩니다.

1. 커넥션 설정: 버킷 정보를 입력하고 IAM 정책 및 역할을 생성한 다음 커넥션을 테스트합니다.

2. 이벤트 선택: 아마존 S3로 전송할 이벤트를 선택합니다.

3. 프로퍼티 선택: 전송할 이벤트의 프로퍼티를 선택합니다.

4. 요약 확인 및 커넥션 추가: 선택한 이벤트와 프로퍼티를 확인하고 커넥션을 추가합니다.

커넥션을 생성하려면 AWS 매니지먼트 콘솔에서 아래 정보를 확인해야 합니다.

• 버킷 이름

• 리전

• IAM 역할 ARN

버킷 이름과 리전은 아마존 S3 콘솔에서, IAM 역할 ARN은 IAM 콘솔에서 확인할 수 있습니다.

아마존 S3 콘솔에서 버킷 이름과 리전을 확인합니다.

1. AWS 매니지먼트 콘솔에 로그인하고 아마존 S3 콘솔로 이동하세요.

2. [버킷]에서 에어브릿지와 연동할 버킷의 이름과 리전을 확인하세요. 버킷이 없거나 새로운 버킷을 연동하고 싶다면 '버킷 만들기'를 클릭하세요. 자세한 과정은 AWS S3 사용 설명서를 참고해 주세요.

아마존 S3 콘솔에서 확인한 버킷 이름과 리전을 에어브릿지 대시보드에 입력합니다.

1. 에어브릿지 대시보드의 [연동]>[서드파티 연동]에서 'Amazon S3'를 클릭하세요.

2. '커넥션 추가'를 클릭하세요.

3. 아마존 S3 콘솔에서 확인한 버킷 이름과 리전을 입력하세요.

4. CSV와 Parquet 중 원하는 연동 포맷을 선택하고 '등록'을 클릭하세요.

5. 모든 정보를 정확하게 등록하면 IAM 정책 생성에 필요한 정책을 확인할 수 있습니다. '복사'를 클릭해서 정책을 복사하세요.

IAM 콘솔에서 아마존 S3 리소스에 대한 접근 권한을 부여하는 IAM 정책을 생성합니다.

1. IAM 콘솔로 이동하세요.

2. [액세스 관리]>[정책]에서 오른쪽 상단의 '정책 생성'을 클릭하세요.

3. 오른쪽 상단의 [JSON] 탭을 클릭하세요. 에어브릿지 대시보드에서 복사한 정책을 정책 편집기에 입력하고 오른쪽 하단의 '다음'을 클릭하세요.

4. [검토 및 생성]에서 원하는 정책 이름을 입력하세요. 그밖의 설정은 변경하지 마세요. 오른쪽 하단의 '정책 생성'을 클릭하면 정책 생성이 완료됩니다.

IAM 콘솔에서 AWS 리소스에 대한 접근 권한을 위임할 수 있는 IAM 역할을 생성합니다.

1. IAM 콘솔의 [액세스 관리]>[역할]에서 '역할 생성'을 클릭하세요.

2. [신뢰할 수 있는 엔터티 유형]에서 'AWS 계정'을 선택하세요.

3. [AWS 계정]에서 '다른 AWS 계정'을 선택하고 에어브릿지 대시보드에서 복사한 계정 ID를 입력하세요. 옵션으로 '외부 ID 필요'를 선택하고 에어브릿지 대시보드에서 복사한 외부 ID를 입력하세요. '다음'을 클릭하세요.

4. [AWS 계정]에서 '다른 AWS 계정'을 선택하고 에어브릿지 대시보드에서 복사한 계정 ID를 입력하세요. 옵션으로 '외부 ID 필요'를 선택하고 에어브릿지 대시보드에서 복사한 외부 ID를 입력하세요. '다음'을 클릭하세요.

   

5. [권한 추가]에서 에어브릿지와 아마존 S3를 연동하기 위해 생성한 정책의 이름을 검색하세요. 체크 박스를 클릭하고 '다음'을 클릭하세요.

6. [역할 세부 정보]에서 원하는 역할 이름을 입력하세요. 그밖의 설정은 변경하지 마세요. '역할 생성'을 클릭하면 역할 생성이 완료됩니다.

IAM 콘솔에서 확인한 IAM 역할 ARN을 에어브릿지 대시보드에 입력합니다.

1. IAM 콘솔의 [액세스 관리]>[역할]에서 에어브릿지와 아마존 S3를 연동하기 위해 생성한 IAM 역할의 이름을 클릭하세요.

2. ARN을 복사하세요.

3. 에어브릿지 대시보드에 IAM 역할 ARN을 입력하고 '등록'을 클릭하세요.

입력한 정보로 아마존 S3과 연동할 수 있는지 테스트합니다.

1. 에어브릿지 대시보드에서 '커넥션 테스트'를 클릭하세요.

2. 연결에 성공하면 오른쪽 하단의 '다음'을 클릭해서 이벤트 선택 단계로 이동하세요.

커넥션 테스트에 실패하면 입력한 정보가 올바른지 확인하고 다시 테스트해 주세요. 커넥션 테스트를 완료하지 않고 페이지를 떠나면 모든 연동 과정을 처음부터 다시 진행해야 합니다.

아마존 S3로 전송할 이벤트를 선택합니다. 에어브릿지에 한 번이라도 수집된 이벤트만 선택할 수 있습니다.

1. 전송할 이벤트를 앱, 웹, 트래킹 링크 등 카테고리별로 선택하세요.

2. 오른쪽 하단의 '다음'을 클릭하세요.

알립니다

커넥션을 생성한 이후 최초로 발생한 이벤트는 전송 대상으로 추가하기 전까지는 전송되지 않습니다.

선택한 이벤트에 대해 아마존 S3로 전송할 프로퍼티를 선택합니다.

1. 전송할 프로퍼티를 카테고리별로 선택하세요.

2. 오른쪽 하단의 '다음'을 클릭하세요.

알립니다

필수 프로퍼티는 선택을 해제할 수 없습니다.

선택한 이벤트와 프로퍼티를 확인하고 커넥션을 추가합니다.

1. [전송 이벤트 목록]과 [전송 프로퍼티 목록]을 확인하세요. 수정이 필요하면 오른쪽 끝에 있는 '수정하러 가기'를 클릭하세요.

2. [데이터 전송 상태]에서 데이터 소스별 전송 상태를 확인하세요.

3. 오른쪽 하단의 '적용'을 클릭하면 커넥션이 생성됩니다.

데이터 전송 상태는 에어브릿지 대시보드의 아래 페이지에서 확인할 수 있습니다.

데이터 전송 상태 메시지의 구체적인 의미는 아래 표를 참고하세요.

에어브릿지는 항상 KST(한국표준시) 오전 4시 경에 앱 타임존 기준 전날 데이터를 전송합니다. 아마존 S3 연동 설정을 완료하면 다음 날부터 데이터가 연동한 버킷의 아래 위치로 전송됩니다.

• 앱 이벤트:

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

• 웹 이벤트:

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

• 트래킹 링크 이벤트:

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

전송되는 파일에는 선택한 프로퍼티만 포함됩니다. 프로퍼티 선택을 변경하면 파일의 열 순서가 변경될 수 있으므로, 항상 열 이름을 기준으로 데이터를 확인하세요.

주의하세요

2026년 5월 14일 이후 새로 생성되거나 수정된 커넥션은 폴더 경로의 ${VERSION} 값이 3.0으로 고정됩니다. 기존에 연동되어 있던 커넥션의 경우, 변경사항이 없으면 버전 값이 유지됩니다.

연동 정보를 수정하거나 삭제하려면 아래 내용을 참고하세요.

아마존 S3 연동 정보가 변경됐다면 아래 순서에 따라 수정해야 합니다.

1. 에어브릿지 대시보드의 [연동]>[서드파티 연동]에서 'Amazon S3'를 클릭하세요.

2. 아마존 S3 연동 정보가 변경된 커넥션을 클릭하세요.

3. 수정하고 싶은 연동 정보를 클릭하고 새로운 값을 입력하세요.

4. 입력을 마치면 '수정 완료'를 클릭하세요.

버킷 이름, 리전, 연동 포맷, IAM 역할 ARN을 수정한 경우 커넥션 테스트를 다시 진행해야 합니다.

1. 에어브릿지 대시보드의 [연동]>[서드파티 연동]에서 'Amazon S3'를 클릭하세요.

2. 삭제할 커넥션의 삭제 아이콘을 클릭하세요.

3. 확인 문구를 입력하고 '삭제'를 클릭하세요.

커넥션을 삭제하면 즉시 데이터 전송이 중단됩니다. 단, 커넥션을 삭제해도 이미 아마존 S3로 전송된 데이터는 아마존 S3에서 삭제되지 않습니다.

연동 설정 상태는 에어브릿지 대시보드 [연동]>[연동 현황]에서 확인할 수 있습니다. 연동 설정에 오류가 발생한 경우 연동 상태 확인하기 가이드를 참고해 조치해 주세요.

에어브릿지가 기본으로 연동을 지원하는 데이터 스토리지 개수는 1개입니다. 2개 이상 스토리지에 연동하려면 추가 비용이 발생합니다.

이벤트와 프로퍼티를 포함한 데이터 전송 조건을 수정하면, 아마존 S3 저장 경로의 ${VERSION} 값이 3.0으로 변경되어 기존 위치에서 데이터를 추출할 수 없게 됩니다. 새로운 경로인 3.0을 사용해도 문제가 없는지 사내 S3 담당자와 사전에 확인하세요.