개발자용 가이드
코드 1줄로 완성하는 세상에서 가장 쉽게 구현하는 푸시 마케팅 인프라
플레어레인은 개발자의 문제에서, 개발자에 의해 탄생했습니다. FCM 제공 기능이 워낙 빈약한 탓에 사소한 기능마저도 모두 자체 구현을 해야합니다.
플레어레인 도입은 우리 서비스, 회사, 마케터, 개발자 모두의 리소스를 절약하는 첫 걸음입니다. 푸시 발송, 운영, 분석 환경을 코드 1줄로 손쉽게 올인원 구축하고, 마케터가 좀 더 자유롭게 푸시 마케팅에 집중할 수 있도록 합니다.
연동 순서
1. SDK 연동
우리 서비스에 플레어레인 SDK를 연동하여 기기가 플레어레인에 자동으로 등록되도록 합니다.
앞서 선택한 채널에 따라 알맞은 SDK 연동 방법을 확인해보세요.
웹 푸시는 두 가지 방식(직접, 간접)을 제공합니다.
직접 푸시 방식은 매끄러운 구독 경험을 제공할 수 있지만 기술적 요구사항이 있고 연동 과정이 조금 복잡하여 자체 구축 사이트에 적합합니다.
간접 푸시 방식은 코드 복사-붙여넣기만으로 누구나 쉽게 구현할 수 있어 카페24, 아임웹 등 웹 빌더로 구축한 사이트에서 사용 가능합니다. 아래 표에서 구축한 빌더 가이드를 찾아 연동 작업을 이어가세요.
두 가지 방식의 차이가 조금 더 궁금하시다면 다음 링크를 확인해보세요.
웹 푸시 설정: 직접 푸시 vs 간접 푸시
앱 푸시 | 웹 푸시 |
Android 연동하기 | 자사웹(직접 푸시) 연동하기 |
iOS 연동하기 | 자사웹(간접 푸시) 연동하기 |
React Native, Expo 연동하기 | 카페24 연동하기 |
Flutter 연동하기 | 메이크샵 연동하기 |
| 고도몰5 연동하기 |
| shop by 연동하기 |
| 아임웹 연동하기 |
| 식스샵 연동하기 |
| oopy(우피) 연동하기 |
| WordPress 연동하기 |
| Wix 연동하기 |
2. 유저ID 및 태그 연동
최초 연동 시 플레어레인이 다루는 기본 단위는 '기기'입니다.
그러나 개인화된 푸시 마케팅을 원하신다면, 기기에 유저 정보를 추가로 제공해주셔야 합니다.
기기에 제공할 수 있는 값은 유저ID, 태그 2가지가 있습니다.
유저 ID 연동
전체가 아닌 특정 유저로 개별 푸시를 발송하고 싶다면, 기기에 유저 ID를 필수로 제공해야합니다.
기기에 유저 ID를 제공하여 우리 서비스 '유저'와 플레어레인 '기기'를 연결지을 수 있습니다.
우리 서비스에서 유저를 이미 분류하던 고유한 값(이메일, ID 등)을 유저 ID로 설정하세요.
연동 방법
로그인 시 유저ID를 지정하여 회원임을 지정합니다.
- 로그인 시 SDK 함수 실행: FlareLane.setUserId("USER_ID")
태그 연동
기기에 다양한 데이터를 제공할수록 더욱 세밀하게 기기들을 그룹지을 수 있습니다.
태그 값은 문자열(string) 혹은 숫자(number) 타입만 입력 가능합니다.
시간 표현은 millisecond 단위의 Unix Timestamp 값을 입력합니다. (ex. 1681721331085)
우리 서비스에서 취급하는 다양한 유저 정보는 '태그'로 삽입합니다. 세그먼트에서 태그 기준으로 기기들을 분류할 수 있습니다.
예를 들어 '김철수'라는 이름의 2건의 구매기록을 가진 24세의 남자 유저의 경우, 다음과 같은 형태로 설정할 수 있습니다.
연동 방법
- SDK 함수 실행(클라이언트): FlareLane.setTags({ key: value }})
3. 발송 API 연동
발송 API 구현 시 메시지 직접 입력 대신 템플릿 사용을 권장합니다. 추후 문구 변경이 필요할 때 코드 변경 없이 플레어레인 내에서 쉽게 변경이 가능합니다.
플레어레인은 자동 발송 메시지을 제공하지만, 가끔 자체 서버에서 푸시 발송을 해야만하는 상황도 있습니다
연동 방법
4. 알림함 구축
클라이언트에서 API를 직접 실행하지 마세요. API KEY 노출 위험이 있습니다.
일반적으로 푸시 알림을 닫으면 다시 볼 수 없는 단점이 있습니다. 그러나 플레어레인은 기기별 알림 수신 내역 API를 지원합니다.
우리 서비스만의 알림함을 구축하세요. 단지 UI만 구성하시면 됩니다!
연동 방법
기기 구독 상태 자동 관리
푸시 알림 수신이 불가능해지는 특정한 상황들(앱삭제, 유효하지 않은 토큰, 권한 초기화 등)이 있습니다.
플레어레인은 기기 관리의 편의를 위해, 아래와 같은 상황에서는 자동으로 구독 취소(isSubscribed=false) 처리됩니다.
푸시 발송 결과에 따른 구독 상태 업데이트
푸시 발송 후 수신되는 응답을 통해 자동으로 해당 기기를 구독 취소 처리합니다.
구체적인 수신 응답 기준은 각 발송 서버(FCM, APNS)로부터 받는 응답을 기준으로 아래와 같습니다.
FCM (docs)
- InvalidRegistration
- NotRegistered
APNS (docs)
- BadDeviceToken
- Unregistered (Apple 정책에 따르면 앱삭제 반영은 며칠 걸릴 수 있습니다)