기본 정보
필수 사전 작업
중요: 모든 SDK는 Firebase Cloud Messaging(FCM)을 기반으로 동작합니다.
SDK를 설치하기 전에 반드시 Firebase 프로젝트를 생성하고 노티플라이와 연동해야 합니다.
빠른 시작 가이드
1
Firebase 연동
먼저 Firebase 프로젝트를 생성하고 노티플라이 콘솔과 연동합니다.
2
플랫폼별 SDK 설치
원하는 플랫폼의 SDK를 선택하여 설치합니다.
3
기본 설정
SDK 초기화 및 유저 식별자 설정을 완료합니다.
4
테스트
푸시 알림 및 인앱 팝업이 정상 작동하는지 확인합니다.
유저 속성과 이벤트 파라미터 키 규칙
setUserProperties의 커스텀 유저 속성 키와 trackEvent의 이벤트 파라미터 키는 정규식 ^[A-Za-z][A-Za-z0-9_]*$에 맞는 형식만 허용됩니다.
- 첫 글자는 영문 대소문자(
A–Z,a–z)여야 합니다. - 두 번째 글자부터는 영문 대소문자, 숫자(
0–9), 언더스코어(_)만 사용할 수 있습니다. - 공백, 한글, 마침표(
.), 달러 기호($), 캐럿(^) 등 기타 특수문자는 사용할 수 없습니다.
delivery_address나 productId2와 같은 이름을 사용해 주세요. $email, $phone_number처럼 노티플라이에서 제공하는 기본 유저 속성은 지정된 키를 그대로 사용합니다.
규칙을 벗어난 키로 전송한 데이터도 저장되지만, 일부 기능에서 사용이 제한될 수 있습니다. 예를 들어 delivery.address처럼 마침표(.)가 포함된 유저 속성은 캠페인 조건 설정에서 검색되지 않으며, 유저 리스트와 유저 상세 화면, 전체 유저 CSV 내보내기 결과에 표시되지 않습니다. 속성 관리에도 표시되지 않아 암호화를 설정할 수 없습니다. 유저 속성 관리
빠른 이동
Firebase 프로젝트 연동
Firebase 프로젝트 생성 및 노티플라이 연동 가이드
모바일 SDK
Android SDK
Java/Kotlin 네이티브 Android 앱 연동
iOS SDK
Swift/Objective-C 네이티브 iOS 앱 연동
React Native SDK
React Native 크로스 플랫폼 앱 연동
Flutter SDK
Flutter 크로스 플랫폼 앱 연동
웹 SDK
JavaScript SDK
웹 브라우저용 JavaScript SDK 연동
Google Tag Manager
GTM을 통한 간편한 웹 연동
심화 기능
푸시 알림 설정
아이콘, 동의, 클릭 이벤트 등 고급 설정
인앱 팝업
인앱 팝업 이벤트 리스너 구현
웹뷰 연동
하이브리드 앱 웹뷰 연동 가이드
테스트 및 검증
통합 테스트
SDK 연동 완료 후 테스트 방법 및 검증 절차
