React Native 앱용 푸시 알림을 설정하는 방법
학습 내용
Klaviyo의 React Native SDK(소프트웨어 개발 키트)를 사용해 모바일 푸시 푸시 알림을 전송하는 방법을 알아보세요.
SDK(소프트웨어 개발 키트)란 무엇인가요?
SDK(소프트웨어 개발 키트)는 개발자가 앱에 추가하는 사전 구축 코드 패키지로, Klaviyo 같은 외부 서비스에 연결할 수 있게 해 줘요. 앱과 동일한 프레임워크용으로 제작된 SDK(소프트웨어 개발 키트)를 사용해 보세요. React Native 앱의 경우 Klaviyo의 React Native SDK(소프트웨어 개발 키트)를 사용해 보세요.
React Native란 무엇인가요?
React Native는 iOS와 Android 모두에서 사용할 수 있는 모바일 앱을 만들 수 있게 해주는 하이브리드 프레임워크예요. JavaScript로 작성되었으며, 두 플랫폼에서 단일 코드 베이스를 활용할 수 있어요. React Native 앱은 다른 앱과 마찬가지로 자연스럽게 보여요.
Klaviyo의 React Native SDK(소프트웨어 개발 키트)를 사용하면 React Native로 빌드된 앱에 Klaviyo를 연결할 수 있어요.
시작하기 전에 알아야 할 것
React Native 앱에서 푸시 알림을 설정하기 전에 다음을 완료해야 해요:
- iOS, Android 또는 둘 다를 위한 자체 React Native 앱이 있어요.
- 모바일 앱에 React Native SDK(소프트웨어 개발 키트)를 설치해 주세요.
또한 React Native SDK(소프트웨어 개발 키트) 문서에 안내된 대로, 해당되는 경우 네이티브 iOS SDK(소프트웨어 개발 키트) 및 Android SDK(소프트웨어 개발 키트) 의 일부도 설정해야 해요.
푸시 알림 설정
위의 요구 사항을 충족하면 앱에서 지원하는 각 플랫폼(iOS, Android 또는 둘 다)에 대해 Klaviyo에서 푸시 알림을 구성해 주세요. 앱이 두 플랫폼을 모두 지원하는 경우 아래의 두 설정 가이드를 모두 완료해 주세요.
자세한 안내는 다음 설정 가이드를 확인해 주세요:
푸시 알림 전송을 테스트해 보세요.
Klaviyo 계정에서 푸시 알림을 구성하고 모바일 앱에 Klaviyo React Native SDK(소프트웨어 개발 키트)가 설치되어 있는지 확인한 후에는 다음을 진행해 주세요:
- Klaviyo에서 프로필을 쉽게 찾을 수 있도록 이메일 주소 또는 전화번호로 모바일 앱에 로그인해 주세요.
- 메시지가 표시되면 앱에서 푸시 알림을 활성화하세요. 메시지가 표시되지 않으면, 기기의 설정 앱에서 해당 앱의 푸시 알림이 활성화되어 있는지 확인하세요.
- Klaviyo에서 대상 > 프로필로 이동한 다음 테스트 프로필을 찾으세요. 프로필을 찾을 수 없다면 앱 개발자에게 문의해 앱에서 프로필 식별자를 Klaviyo로 전송하는지 확인해 보세요.
- 채널 동의에서 프로필이 모바일 푸시 푸시 알림을 구독하고 있는지 확인해 주세요.

- 내 프로필만 포함된 리스트 또는 세그먼트를 생성해 주세요.
- 푸시 알림 캠페인을 생성하고 해당 리스트 또는 세그먼트를 대상으로 선택해 주세요.
- 메시지 작성을 완료한 다음, 캠페인을 테스트 리스트 또는 세그먼트로 보내세요.
- 기기에서 알림이 표시되는지 확인해 주세요.
- 기기에서 알림을 탭하여 앱을 여세요.
- 프로필의 활동 피드를 확인해 Received Push 이벤트와 Opened Push 이벤트가 모두 표시되는지 확인해 주세요.
앱이 iOS와 Android를 모두 지원하는 경우, 각 플랫폼의 기기에서 테스트를 다시 실행하세요.
문제 해결
- Klaviyo에서 프로필에 푸시 토큰이 보이지 않는 이유는 무엇인가요? 이메일을 보낼 때 이메일 주소를 사용하는 것과 마찬가지로, 푸시 알림은 푸시 토큰으로 전송돼요. 특정 기기로 푸시 알림을 보낼 수 있으려면, 모바일 앱에서 기기의 푸시 토큰을 Klaviyo로 전달해야 해요. 앱 개발자에게 SDK(소프트웨어 개발 키트) 문서의 푸시 알림 섹션에 설명된 코드를 구현했는지 확인해 주세요.
- iOS 푸시 알림에서 이미지가 표시되지 않는 이유는 무엇인가요? iOS에서는 앱에 Notification Service Extension을 추가한 경우에만 리치 미디어가 표시돼요. 앱 개발자에게 SDK(소프트웨어 개발 키트) 문서의 Rich Push 섹션에 설명된 코드를 구현했는지 확인해 주세요.
- 알림을 탭해도 Opened Push 이벤트가 표시되지 않는 이유가 무엇인가요? 앱에서 Opened Push 이벤트를 Klaviyo에 보고하려면 푸시 오픈 트래킹이 구성되어 있어야 해요. SDK(소프트웨어 개발 키트) 문서의 오픈 이벤트 트래킹 섹션에 설명된 대로, 개발자와 협업하여 자동 트래킹을 설정하거나 앱의 네이티브 iOS 또는 Android 부분에 트래킹 코드를 구현해 주세요.
추가 자료
- 푸시 알림 동의에 대해 알아보기
- 캠페인에 푸시 알림을 사용하는 방법을 알아보세요.
- 푸시 알림에서 딥링크(웹사이트나 스토어가 아닌 앱으로 사용자를 직접 연결하는 링크 유형)를 사용하는 방법을 확인해 보세요.
추가 자료
- How to set up iOS push notifications
Learn how to set up push notifications in your Klaviyo account. After you've completed the steps in this article you'll be able to send push notifications in your flows and campaigns.
- How to set up Android push notifications
Learn how to set up push notifications for Android in your Klaviyo account. After you've completed the steps in this article you'll be able to send push notifications in your flows and campaigns.
- Introduction to mobile push notifications
Get familiar with mobile push notifications, including what they are, what they look like, and what information you need to start sending.