

**지원 종료 공지:** 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="integrate"></a>

Amazon Pinpoint를 클라이언트 코드와 통합하면 사용자를 파악하고 사용자의 관심을 끌 수 있습니다.

통합한 후 사용자가 애플리케이션을 실행하면 애플리케이션이 Amazon Pinpoint 서비스에 연결하여 *엔드포인트*를 추가하거나 업데이트합니다. 엔드포인트는 메시지를 전송할 수 있는 대상을 나타냅니다(예: 사용자 디바이스, 이메일 주소 또는 전화번호).

또한 애플리케이션은 사용 데이터 또는 *이벤트*를 제공할 수 있습니다. Amazon Pinpoint 콘솔에서 이벤트 데이터를 보고 사용자 수, 사용자의 애플리케이션 사용 빈도, 애플리케이션 사용 시점 등을 파악할 수 있습니다.

애플리케이션에서 제공한 엔드포인트 및 이벤트 정보로 특정 대상 또는 *세그먼트*에 맞춰 메시징 캠페인을 맞춤화할 수 있습니다. 또한 캠페인을 생성하지 않고 간단한 수신자 목록에 직접 메시지를 전송할 수도 있습니다.

이 섹션의 주제를 참조하여 Amazon Pinpoint를 모바일 또는 웹 애플리케이션과 통합합니다. 이러한 주제에는 JavaScript, Android, Swift, 또는 Flutter 애플리케이션과의 통합을 위한 코드 예제 및 절차가 나와 있습니다. 앱 통합을 시작하려면 [AWS Amplify를 사용하여 프런트엔드 애플리케이션을 Amazon Pinpoint에 연결](integrate-sdk.md) 단원을 참조하십시오.

클라이언트 외부에서는 [지원되는 AWS SDK](sdk-general-information-section.md) 또는 [Amazon Pinpoint API](https://docs.aws.amazon.com/pinpoint/latest/apireference/)를 사용하여 엔드포인트를 가져오고, 이벤트 데이터를 내보내고, 고객 세그먼트를 정의하고, 캠페인을 실행하는 등의 작업을 수행할 수 있습니다.

**Topics**
+ [AWS SDK에서 Amazon Pinpoint 사용](sdk-general-information-section.md)
+ [AWS Amplify를 사용하여 프런트엔드 애플리케이션을 Amazon Pinpoint에 연결](integrate-sdk.md)
+ [애플리케이션에 Amazon Pinpoint 엔드포인트 등록](integrate-endpoints.md)
+ [애플리케이션에서 Amazon Pinpoint 이벤트 보고](integrate-events.md)

# AWS SDK에서 Amazon Pinpoint 사용
<a name="sdk-general-information-section"></a>

다양한 프로그래밍 언어에 대해 AWS 소프트웨어 개발 키트(SDK)을 사용할 수 있습니다. 각 SDK는 개발자가 선호하는 언어로 애플리케이션을 쉽게 구축할 수 있도록 하는 API, 코드 예제 및 설명서를 제공합니다.


| SDK 설명서 | 코드 예시 | 
| --- | --- | 
| [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp) | [AWS SDK for C\$1\$1 코드 예시](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp) | 
| [AWS CLI](https://docs.aws.amazon.com/cli) | [AWS CLI 코드 예시](https://docs.aws.amazon.com/code-library/latest/ug/cli_2_code_examples.html) | 
| [AWS SDK for Go](https://docs.aws.amazon.com/sdk-for-go) | [AWS SDK for Go 코드 예시](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/gov2) | 
| [AWS SDK for Java](https://docs.aws.amazon.com/sdk-for-java) | [AWS SDK for Java 코드 예시](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2) | 
| [AWS SDK for JavaScript](https://docs.aws.amazon.com/sdk-for-javascript) | [AWS SDK for JavaScript 코드 예시](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3) | 
| [AWS SDK for Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin) | [AWS SDK for Kotlin 코드 예시](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin) | 
| [AWS SDK for .NET](https://docs.aws.amazon.com/sdk-for-net) | [AWS SDK for .NET 코드 예시](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3) | 
| [AWS SDK for PHP](https://docs.aws.amazon.com/sdk-for-php) | [AWS SDK for PHP 코드 예시](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/php) | 
| [AWS Tools for PowerShell](https://docs.aws.amazon.com/powershell) | [AWS Tools for PowerShell 코드 예시](https://docs.aws.amazon.com/code-library/latest/ug/powershell_5_code_examples.html) | 
| [AWS SDK for Python (Boto3)](https://docs.aws.amazon.com/pythonsdk) | [AWS SDK for Python (Boto3) 코드 예시](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python) | 
| [AWS SDK for Ruby](https://docs.aws.amazon.com/sdk-for-ruby) | [AWS SDK for Ruby 코드 예시](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/ruby) | 
| [AWS SDK for Rust](https://docs.aws.amazon.com/sdk-for-rust) | [AWS SDK for Rust 코드 예시](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1) | 
| [AWS SDK for SAP ABAP](https://docs.aws.amazon.com/sdk-for-sapabap) | [AWS SDK for SAP ABAP 코드 예시](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap) | 
| [AWS SDK for Swift](https://docs.aws.amazon.com/sdk-for-swift) | [AWS SDK for Swift 코드 예시](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/swift) | 

Amazon Pinpoint 관련 예는 [AWS SDK를 사용한 Amazon Pinpoint용 코드 예제](service_code_examples.md) 섹션을 참조하세요.

**가용성 예제**  
필요한 예제를 찾을 수 없습니까? 이 페이지 하단의 **피드백 제공** 링크를 사용하여 코드 예시를 요청하세요.

# AWS Amplify를 사용하여 프런트엔드 애플리케이션을 Amazon Pinpoint에 연결
<a name="integrate-sdk"></a>

 AWS Amplify를 사용하여 앱을와 통합합니다 AWS. Swift 앱의 경우 Swift용 Amplify 설명서에서 [시작하기](https://docs.amplify.aws/gen1/swift/start/getting-started/introduction/) 섹션을 참조하세요. Android 앱의 경우 Android SDK 설명서의 [시작하기](https://docs.amplify.aws/gen1/android/start/getting-started/introduction/) 섹션을 참조하세요. React 네이티브 앱의 경우 Amplify JavaScript 설명서에서 [시작하기](https://docs.amplify.aws/gen1/react-native/start/getting-started/introduction/) 섹션을 참조하세요. Flutter 앱의 경우 Flutter SDK 설명서의 [시작하기](https://docs.amplify.aws/gen1/flutter/start/getting-started/introduction/) 섹션을 참조하세요. 이러한 주제는 다음 작업을 수행하는 데 도움이 됩니다.
+ 백엔드 리소스를 설정합니다.
+ Amplify 라이브러리를 사용하여 앱을 백엔드 리소스에 연결합니다.

분석, 인앱 메시징, 푸시 알림을 위해 프런트엔드 앱을 Amazon Pinpoint에 연결하는 방법을 자세히 알아보려면 [AWS Amplify](https://docs.amplify.aws/react/build-a-backend/) 섹션을 참조하세요.

## 다음 단계
<a name="integrate-sdk-next"></a>

 AWS Amplify를 애플리케이션과 통합한 후 코드를 업데이트하여 사용자의 디바이스를 엔드포인트로 등록합니다. 자세한 내용은 [애플리케이션에 Amazon Pinpoint 엔드포인트 등록](integrate-endpoints.md) 단원을 참조하십시오.

# 애플리케이션에 Amazon Pinpoint 엔드포인트 등록
<a name="integrate-endpoints"></a>

사용자가 세션을 시작하면(예: 모바일 앱 시작) 모바일 또는 웹 애플리케이션이 Amazon Pinpoint에 *엔드포인트를* 자동으로 등록(또는 업데이트)할 수 있습니다. 엔드포인트는 사용자가 세션을 시작한 디바이스를 나타냅니다. 여기에는 디바이스를 설명하는 속성이 들어 있으며, 사용자가 정의하는 사용자 지정 속성도 포함될 수 있습니다. 엔드포인트가 고객과 통신하는 다른 방법(예: 이메일 주소, 휴대폰 번호)을 나타낼 수도 있습니다.

애플리케이션이 엔드포인트를 등록하면 엔드포인트 속성을 기준으로 사용자를 분류할 수 있습니다. 그런 다음 맞춤형 메시징 캠페인에 이러한 세그먼트를 적용할 수 있습니다. 이와 함께 Amazon Pinpoint의 **분석** 페이지에서도 **새 엔드포인트 수** 및 **일별 활성 엔드포인트 수** 등 엔드포인트 등록 및 활동에 관한 차트를 볼 수 있습니다.

하나의 사용자 ID를 여러 엔드포인트에 할당할 수 있습니다. 사용자 ID는 사용자 한 명을 나타내고, 사용자 ID에 할당된 각 엔드포인트는 사용자의 디바이스 한 대를 나타냅니다. 엔드포인트에 사용자 ID를 할당한 뒤에는 콘솔에서 [**일별 활성 사용자**] 및 [**월별 활성 사용자**] 등의 사용자 활동에 관한 차트를 볼 수 있습니다.

## 시작하기 전 준비 사항
<a name="integrate-endpoints-before"></a>

아직 통합하지 않았다면 Android 또는 iOS용 AWS Mobile SDK를 통합하거나 AWS Amplify JavaScript 라이브러리를 애플리케이션과 통합합니다. 자세한 내용은 [AWS Amplify를 사용하여 프런트엔드 애플리케이션을 Amazon Pinpoint에 연결](integrate-sdk.md) 단원을 참조하십시오.

## Android 또는 iOS용 AWS 모바일 SDKs에 엔드포인트 등록
<a name="integrate-endpoints-mobile"></a>

Android 또는 iOS용 AWS Mobile SDKs를 사용하여 엔드포인트를 등록하고 사용자 지정할 수 있습니다. 자세한 내용과 코드 샘플은 다음 문서를 참조하십시오.
+ Android SDK 설명서의 [애플리케이션에서 엔드포인트 등록](https://docs.amplify.aws/gen1/swift/sdk/analytics/endpoints/)을 참조하십시오.
+ iOS SDK 설명서의 [애플리케이션에서 엔드포인트 등록](https://docs.amplify.aws/gen1/android/sdk/analytics/endpoints/)을 참조하십시오.

## AWS Amplify JavaScript 라이브러리에 엔드포인트 등록
<a name="integrate-events-amplify"></a>

 AWS Amplify JavaScript 라이브러리를 사용하여 앱에서 엔드포인트를 등록하고 업데이트할 수 있습니다. 자세한 내용과 코드 예제를 보려면 AWS Amplify JavaScript 설명서의 [엔드포인트 업데이트를](https://docs.amplify.aws/gen1/nextjs/build-a-backend/more-features/analytics/analytics-migration-guide/#analyticsupdateendpoint) 참조하세요.

## 다음 단계
<a name="integrate-endpoints-next"></a>

엔드포인트를 등록하도록 앱을 업데이트하면 사용자가 앱을 시작할 때 디바이스 정보와 사용자 지정 속성이 Amazon Pinpoint에 제공됩니다. 이러한 정보를 사용하여 대상 세그먼트를 정의할 수 있습니다. 콘솔을 사용하여 엔드포인트 지표와 사용자 ID가 할당된 사용자도 확인할 수 있습니다. [애플리케이션에서 Amazon Pinpoint 이벤트 보고](integrate-events.md)의 단계를 완료하여 사용 데이터를 보고하도록 앱을 업데이트할 수도 있습니다.

# 애플리케이션에서 Amazon Pinpoint 이벤트 보고
<a name="integrate-events"></a>

모바일 또는 웹 애플리케이션에서 AWS Mobile SDKs 또는 [Amazon Pinpoint 이벤트 API](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-events.html)를 사용하여 사용 데이터 또는 *이벤트를* Amazon Pinpoint에 보고할 수 있습니다. 이벤트를 보고하여 앱 세션 시간, 사용자의 구매 행동, 로그인 시도 또는 필요한 사용자 지정 이벤트 유형과 같은 정보를 캡처할 수 있습니다.

애플리케이션에서 이벤트를 보고하면 Amazon Pinpoint 콘솔에서 분석 결과를 볼 수 있습니다. [**Analytics**] 페이지의 차트는 다양한 사용자 행동 측면에 대한 측정치를 제공합니다. 자세한 내용은 *Amazon Pinpoint 사용 설명서*의 [Amazon Pinpoint 분석용 차트 참조](https://docs.aws.amazon.com/pinpoint/latest/userguide/analytics-charts.html) 섹션을 참조하세요.

이벤트 데이터를 Amazon Pinpoint 외부에서 분석 또는 저장하기 위해 Amazon Kinesis로 데이터를 스트리밍하도록 Amazon Pinpoint를 구성할 수 있습니다. 자세한 내용은 [Amazon Pinpoint를 사용하여 Kinesis 및 Firehose를 통해 앱 이벤트 데이터 스트리밍](event-streams.md) 단원을 참조하십시오.

 AWS Mobile SDKs 및 AWS Amplify JavaScript 라이브러리를 사용하여 Amazon Pinpoint API를 호출하여 다음 유형의 이벤트를 보고할 수 있습니다.

**세션 이벤트**  
사용자가 앱을 열고 닫는 시점과 빈도를 나타냅니다.  
애플리케이션이 세션 이벤트를 보고한 후 Amazon Pinpoint 콘솔의 **분석** 페이지를 사용하여 **세션**, **일별 활성 엔드포인트 수**, **7일 보존율** 등에 대한 차트를 봅니다.

**사용자 지정 이벤트**  
사용자 지정 이벤트 유형을 할당하여 정의한 비표준 이벤트입니다. 사용자 지정 이벤트에는 사용자 지정 속성과 지표를 추가할 수 있습니다.  
**분석** 페이지의 **이벤트** 탭에는 해당 앱이 보고한 모든 사용자 지정 이벤트의 지표가 표시됩니다.

**수익 창출 이벤트**  
애플리케이션에서 창출된 수익과 사용자가 구입한 항목 수를 보고합니다.  
**분석** 페이지의 **매출** 탭에는 **매출**, **유료 사용자**, **판매량** 등의 차트가 표시됩니다.

**인증 이벤트**  
사용자가 애플리케이션을 인증한 빈도를 나타냅니다.  
**분석** 페이지의 **사용자** 탭에는 **Sign-ins**(로그인 횟수), **Sign-ups**(가입 횟수) 및 **Authentication failures**(인증 실패 횟수) 등의 차트가 표시됩니다.

## 시작하기 전 준비 사항
<a name="integrate-events-before"></a>

아직 수행하지 않은 경우 다음 작업을 수행하십시오.
+ 앱을 AWS Amplify와 통합합니다. [AWS Amplify를 사용하여 프런트엔드 애플리케이션을 Amazon Pinpoint에 연결](integrate-sdk.md)을(를) 참조하세요.
+ 애플리케이션을 업데이트해 엔드포인트를 등록합니다. [애플리케이션에 Amazon Pinpoint 엔드포인트 등록](integrate-endpoints.md)을(를) 참조하세요.

## Android 또는 iOS용 AWS 모바일 SDKs를 사용하여 이벤트 보고
<a name="integrate-events-mobile-sdks"></a>

iOS 및 Android용 Mobile SDKs를 사용하여 AWS 모바일 앱이 Amazon Pinpoint에 이벤트를 보고하도록 할 수 있습니다.

이벤트를 기록하고 Amazon Pinpoint에 제출하도록 앱을 업데이트하는 방법에 대한 자세한 내용은 AWS Amplify 설명서의 다음 페이지를 참조하세요.
+ iOS SDK 설명서의 [분석](https://docs.amplify.aws/swift/build-a-backend/add-aws-services/analytics/)
+ Android SDK 설명서의 [분석](https://docs.amplify.aws/android/build-a-backend/add-aws-services/analytics/)

## AWS Amplify JavaScript 라이브러리를 사용하여 이벤트 보고
<a name="integrate-events-amplify"></a>

 AWS Amplify JavaScript 라이브러리를 사용하여 JavaScript 및 React Native 앱을 활성화하여 애플리케이션 사용 이벤트를 Amazon Pinpoint에 보고할 수 있습니다. 이벤트를 기록하고 Amazon Pinpoint에 제출하기 위해 앱을 업데이트하는 방법은 AWS Amplify JavaScript 설명서의 [분석](https://docs.amplify.aws/nextjs/build-a-backend/add-aws-services/analytics/) 섹션을 참조하세요.

## Amazon Pinpoint API를 사용하여 이벤트 보고
<a name="integrate-events-api"></a>

Amazon Pinpoint API 또는 AWS SDK를 사용하여 Amazon Pinpoint에 이벤트를 대량으로 제출할 수 있습니다. 자세한 내용은 *Amazon Pinpoint API 참조*의 [이벤트](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-events.html) 섹션을 참조하세요.

## 다음 단계
<a name="integrate-events-next"></a>

앱을 업데이트하여 이벤트를 보고하면 사용 데이터를 Amazon Pinpoint로 전송합니다. 콘솔에서 이러한 데이터를 확인하고 Amazon Kinesis로 스트리밍할 수 있습니다. 그런 다음 앱을 업데이트하여 Amazon Pinpoint를 사용해 보내는 푸시 알림을 처리하도록 할 수 있습니다. 자세한 내용은 [AWS End User Messaging Push 사용 설명서](https://docs.aws.amazon.com//push-notifications/latest/userguide/what-is-service.html)의 다음 주제를 참조하세요.
+ [푸시 알림 설정](https://docs.aws.amazon.com//push-notifications/latest/userguide/procedure-enable-push.html)
+ [Swift 푸시 알림 설정](https://docs.aws.amazon.com//push-notifications/latest/userguide/mobile-push.html#apns-setup)
+ [Android 푸시 알림 설정](https://docs.aws.amazon.com//push-notifications/latest/userguide/mobile-push.html#mobile-push-android)
+ [Flutter 푸시 알림 설정](https://docs.aws.amazon.com//push-notifications/latest/userguide/mobile-push.html#mobile-push-flutter)
+ [React Native 푸시 알림 설정](https://docs.aws.amazon.com//push-notifications/latest/userguide/mobile-push.html#mobile-push-react-native)
+ [프로젝트 만들기](https://docs.aws.amazon.com//push-notifications/latest/userguide/mobile-push.html#mobile-push-create-project)
+ [푸시 알림 처리](https://docs.aws.amazon.com//push-notifications/latest/userguide/mobile-push.html#integrate-push-services)