

**지원 종료 공지:** 2026년 10월 30일에 Amazon Pinpoint에 대한 지원이 AWS 종료됩니다. 2026년 10월 30일 이후에는 Amazon Pinpoint 콘솔 또는 Amazon Pinpoint 리소스(엔드포인트, 세그먼트, 캠페인, 여정, 분석)에 더 이상 액세스할 수 없습니다. 자세한 내용은 [Amazon Pinpoint 지원 종료](https://docs.aws.amazon.com/console/pinpoint/migration-guide)를 참조하세요. **참고:** SMS, 음성, 모바일 푸시, OTP 및 전화번호 검증과 관련된 APIs는이 변경의 영향을 받지 않으며 AWS 최종 사용자 메시징에서 지원됩니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon Pinpoint를 사용한 이벤트 스트리밍
<a name="analytics-streaming"></a>

Amazon Pinpoint는 이벤트 데이터라고 *하는 참여 및 애플리케이션 사용 데이터를* 지원되는 로 스트리밍하여 더 많은 분석 및 스토리지 옵션을 AWS 서비스 제공할 수 있습니다. *이벤트 데이터*를 사용하여 개별 이벤트를 확인하여 문제를 해결하거나 개별 고객 이벤트를 볼 수 있습니다. *Amazon Pinpoint 개발자 안내서*의 [Kinesis로 Amazon Pinpoint 이벤트 스트리밍](https://docs.aws.amazon.com/pinpoint/latest/developerguide/event-streams.html)을 참조하세요.

애플리케이션은 Amazon Pinpoint와 통합되면 사용자가 시작한 세션 횟수와 같은 이벤트를 보고합니다. Amazon Pinpoint는 콘솔에서 해당 애플리케이션에 대한 분석 차트 및 지표에 이 데이터를 제공합니다. 또한 분석 데이터에는 Amazon Pinpoint에서 생성된 캠페인 이벤트(예: 캠페인이 메시지를 전송한 디바이스 수)도 표시됩니다.

Amazon Pinpoint는 90일 동안 이 데이터를 유지합니다. 이 데이터를 무기한 유지하거나 사용자 지정 쿼리 및 도구를 사용하여 분석하려면 Amazon Kinesis로 이벤트 데이터를 전송하도록 Amazon Pinpoint를 구성할 수 있습니다.

**Topics**
+ [Amazon Kinesis 소개](#analytics-streaming-about-kinesis)
+ [Amazon Pinpoint 이벤트를 Kinesis로 스트리밍](#analytics-streaming-kinesis)

## Amazon Kinesis 소개
<a name="analytics-streaming-about-kinesis"></a>

Kinesis 플랫폼은 AWS에서 스트리밍 데이터를 로드하고 분석하는 데 사용할 수 있는 서비스를 제공합니다. Amazon Kinesis Data Streams 또는 Amazon Data Firehose로 애플리케이션, 캠페인 및 여정 이벤트를 스트리밍하도록 Amazon Pinpoint를 구성할 수 있습니다. 이벤트를 스트리밍함으로써 다음과 같이 데이터 분석에 보다 유연한 옵션을 사용할 수 있습니다.
+ 데이터를 하나의 모음으로 분석할 수 있도록 여러 애플리케이션의 이벤트를 한 스트림에 수렴
+  AWS 쿼리 서비스를 사용하여 이벤트 분석. 예를 들어 Amazon Managed Service for Apache Flink를 사용하여 스트리밍 데이터를 대상으로 SQL 쿼리를 실행할 수 있습니다.

### Amazon Kinesis Data Streams 소개
<a name="analytics-streaming-about-kinesis-streams"></a>

Amazon Kinesis Data Streams는 스트리밍 데이터를 처리 또는 분석하는 사용자 지정 애플리케이션을 구축하는 데 사용할 수 있는 서비스입니다. 예를 들어, 사용자 지정 대시보드에서 이벤트 데이터를 사용하거나 이벤트를 기반으로 알림을 생성하거나, 이벤트에 동적으로 대응하려는 경우 이벤트를 Kinesis Data Streams로 스트리밍하면 유용합니다.

자세한 내용은 [Amazon Kinesis Data Streams 개발자 안내서](https://docs.aws.amazon.com/streams/latest/dev/)를 참조하세요.

### Amazon Data Firehose 소개
<a name="analytics-streaming-about-kinesis-firehose"></a>

Amazon Data Firehose는 스트리밍 데이터를 Amazon Simple Storage Service(Amazon S3), Amazon Redshift 또는 Amazon OpenSearch Service(OpenSearch Service)를 포함한 AWS 데이터 스토어로 전송하는 데 사용할 수 있는 서비스입니다. 예를 들어, 다음과 같은 경우 이벤트를 Firehose로 스트리밍하면 유용합니다.
+ 자체 분석 애플리케이션 및 도구를 사용하여 Amazon S3, Amazon Redshift 또는 OpenSearch Service의 이벤트를 분석
+ Amazon Athena를 사용하여 이 데이터에 대한 SQL 쿼리를 작성할 수 있도록 Amazon S3에 이벤트를 전송
+ 장기 보관을 위해 이벤트 데이터를 Amazon S3에 백업

자세한 내용은 [Amazon Data Firehose 개발자 안내서](https://docs.aws.amazon.com/firehose/latest/dev/)를 참조하세요.

## Amazon Pinpoint 이벤트를 Kinesis로 스트리밍
<a name="analytics-streaming-kinesis"></a>

Kinesis 플랫폼은 AWS에서 스트리밍 데이터를 로드하고 분석하는 데 사용할 수 있는 서비스를 제공합니다. Amazon Pinpoint에서 Amazon Kinesis Data Streams로 애플리케이션, 캠페인 및 여정 이벤트를 보내 외부 애플리케이션 또는 서드 파티 분석 도구에서 처리하도록 구성할 수 있습니다. Amazon Data Firehose를 사용하여이 이벤트 데이터를 AWS 데이터 스토어(예: Amazon Redshift)로 스트리밍하도록 Amazon Pinpoint를 구성할 수도 있습니다.

### 사전 조건
<a name="analytics-streaming-kinesis-prerequisites"></a>

이 섹션의 절차를 완료하기 전에 Amazon Pinpoint를 사용하는 계정과 동일한 계정에 Amazon Kinesis 스트림 또는 Firehose 전송 스트림을 생성합니다. Kinesis 스트림 생성에 대한 자세한 내용은 *Amazon Kinesis Data Streams 개발자 안내서*의 [데이터 스트림 생성 및 업데이트](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html)를 참조하세요. Firehose 전송 스트림 생성에 대한 자세한 내용은 *Amazon Data Firehose 개발자 안내서*의 [Amazon Data Firehose 전송 스트림 생성](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html)을 참조하세요.

필요할 경우 스트림으로 데이터를 보내기 위한 권한을 부여하는 IAM 역할을 생성할 수 있습니다. 이 역할을 생성하지 않을 경우 Amazon Pinpoint가 대신 생성할 수 있습니다. 이 정책을 수동으로 생성하는 방법에 대한 자세한 내용은 *Amazon Pinpoint 개발자 안내서*의 [Kinesis로 이벤트를 스트리밍하기 위한 IAM 역할](https://docs.aws.amazon.com/pinpoint/latest/developerguide/permissions-streams.html)을 참조하세요.

### 이벤트 스트리밍 설정
<a name="analytics-streaming-kinesis-setup"></a>

Amazon Pinpoint에서 다음 단계를 완료하여 이벤트 스트리밍을 설정합니다.

**참고**  
Amazon Kinesis 스트림을 아직 생성하지 않았다면 Amazon Kinesis 콘솔([https://console.aws.amazon.com/kinesis](https://console.aws.amazon.com/kinesis))로 이동합니다. 스트림 생성에 대한 자세한 내용은 [Amazon Kinesis Data Streams 개발자 안내서](https://docs.aws.amazon.com/streams/latest/dev/) 또는 [Amazon Data Firehose 개발자 안내서](https://docs.aws.amazon.com/firehose/latest/dev/)를 참조하세요.  
스트림을 설정하고 스트림으로 전송할 권한이 있는지 확인합니다. 권한에 대한 자세한 내용은 [Kinesis로 이벤트를 스트리밍하기 위한 IAM 역할](/pinpoint/latest/developerguide/permissions-streams.html)을 참조하세요.

**이벤트 스트리밍을 설정하려면**

1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) Amazon Pinpoint 콘솔을 엽니다.

1. **모든 프로젝트** 페이지에서 데이터 스트리밍을 설정하려는 프로젝트를 선택합니다.

1. 탐색 창의 **설정** 아래에서 **이벤트 스트림**을 선택합니다.

1. **서비스** 섹션에서 **편집**을 선택합니다.

1. **Amazon Kinesis로 스트리밍**을 선택합니다.

1. **스트림 유형 선택** 아래에서 다음 옵션 중 하나를 선택합니다.
   + **Amazon Kinesis Data Stream으로 이벤트 전송** – Amazon Pinpoint 이벤트 데이터를 분석을 위해 외부 애플리케이션으로 보내려면 이 옵션을 선택합니다.
   + **Amazon Data Firehose 스트림으로 이벤트 전송** - Amazon Redshift와 같은 AWS 데이터 스토어로 이벤트 데이터를 보내려면이 옵션을 선택합니다.

1. **Amazon Kinesis 스트림**에서 데이터를 내보내는 데 사용할 Amazon Kinesis 스트림을 선택합니다.
**참고**  
Amazon Kinesis 스트림을 아직 생성하지 않았다면 Amazon Kinesis 콘솔([https://console.aws.amazon.com/kinesis](https://console.aws.amazon.com/kinesis))로 이동합니다. 스트림 생성에 대한 자세한 내용은 [Amazon Kinesis Data Streams 개발자 안내서](https://docs.aws.amazon.com/streams/latest/dev/) 또는 [Amazon Data Firehose 개발자 안내서](https://docs.aws.amazon.com/firehose/latest/dev/)를 참조하세요.

1. **IAM 역할** 아래에서 다음 옵션 중 하나를 선택합니다.
   + **기존 역할 사용** - Amazon Pinpoint가 이미 계정에 있는 IAM 역할을 수임하도록 하려면 이 옵션을 선택합니다. 선택한 역할은 `firehose:PutRecordBatch` 작업을 허용해야 합니다. 이 작업을 허용하는 정책의 예는 *Amazon Pinpoint 개발자 안내서*의 [권한 정책](https://docs.aws.amazon.com/pinpoint/latest/developerguide/permissions-streams.html#permissions-streams-permissionspolicies)을 참조하세요.
   + **자동으로 역할 생성** – 필요한 권한이 있는 IAM 역할을 자동으로 생성하려면 이 옵션을 선택합니다. 이 역할은 Amazon Pinpoint가 7단계에서 선택한 스트림으로 데이터를 보내도록 승인합니다.

1. **저장**을 선택합니다.

Amazon Pinpoint는 프로젝트에 대한 이벤트를 수신하면 이 데이터를 Kinesis 스트림으로 전송합니다. Amazon Pinpoint가 이벤트에 대해 전송하는 데이터에 대한 자세한 내용은 *Amazon Pinpoint 개발자 안내서*의 [Kinesis로 Amazon Pinpoint 이벤트 스트리밍](https://docs.aws.amazon.com/pinpoint/latest/developerguide/event-streams.html)을 참조하세요.