- 기기 정보를 노티플라이에 등록하여 푸시 알림 수신 및 인앱 팝업 노출 (인앱 팝업은 Foreground 상태에서만 표시됩니다)
- 이벤트 및 유저 정보를 노티플라이와 연동하여 캠페인 타깃팅 및 분석 활용
- 유저 행동 데이터를 기반으로 한 이벤트 로깅 및 성과 측정
Android 인앱 팝업은 Android 11(API 30) 이상에서만 지원됩니다.
시작하기 전에
- Firebase 프로젝트 연동 완료
노티플라이 iOS SDK는 푸시 발송을 위해 Firebase Cloud Messaging을 사용합니다.
👉 Firebase 프로젝트 연동 가이드
- iOS APNs 인증 등록
👉 APNs 인증서 등록
- iOS는
Runner.xcworkspace파일을 반드시 Xcode로 열어야 정상적으로 빌드됩니다.
1. 플러그인 셋업
Plugin 설치
pubspec.yaml에는 다음과 같이 추가됩니다. 현재 최신 버전은 아래와 같습니다: iOS 설정
1. Capability 설정
-
Xcode에서
Runner.xcworkspace을 엽니다. (.xcodeproj로는 노티플라이 SDK 사용 불가) - iOS Deployment Target/Target의 Minimum Deployments을 13.0 이상으로 설정하고, Podfile의 최소 버전도 동일하게 지정합니다.
-
Push Notification 및 Background Mode (Remote notification, Background fetch)를 활성화합니다.


2. AppDelegate.swift 설정
- 파일 위치
AppDelegate.swift 파일은 다음 경로에 있습니다:
notifly_sdkimport 추가
AppDelegate.swift수정
FlutterAppDelegate의 관련 메서드를 override 하여 Notifly 연동 코드를 추가합니다.
| 메서드 이름 | 설명 |
|---|---|
application(_:didFinishLaunchingWithOptions:) | UNNotificationCenter의 delegate를 self로 설정 |
application(_:didRegisterForRemoteNotificationsWithDeviceToken:) | APNs 토큰을 노티플라이에 등록 |
application(_:didFailToRegisterForRemoteNotificationsWithError:) | APNs 등록 실패 시 노티플라이에 알림 |
userNotificationCenter(_:didReceive:withCompletionHandler:) | 푸시 알림 클릭 이벤트 전달 |
userNotificationCenter(_:willPresent:withCompletionHandler:) | Foreground 상태의 푸시 표시 처리 |
- Swift
AppDelegate.swift
(권장) iOS Notification Service Extension 설정
notifly-sdk 버전 1.3.0 이상부터 지원됩니다. 주요 기능
- 푸시 알림에 이미지 및 비디오 첨부 가능
- 유저의 푸시 수신 여부를 추적하여 캠페인 성과를 세부적으로 분석 가능
초기화 코드 추가
앱 진입점(예: main.dart)에 노티플라이 Plugin 초기화 코드를 추가합니다. 환경변수dotenv등을 사용할 수 있습니다.
main.dart
NOTIFLY_PROJECT_ID, NOTIFLY_USERNAME, NOTIFLY_PASSWORD는 설정 페이지에서 확인할 수 있습니다. 2. 유저 정보 등록
노티플라이는 유저 식별자(userId)와 유저 프로퍼티(params)를 기반으로 개인화 마케팅 캠페인을 수행합니다.등록된 유저 정보는 세그먼트 분류, 푸시 발송, 이메일 및 카카오 알림톡 등의 타깃팅에 활용됩니다.
1. 유저 ID 등록 (Notifly.setUserId())
userId는 앱 내부의 로그인 유저 식별자와 매핑됩니다.노티플라이는 이 값을 기준으로 유저 이벤트를 추적하고 캠페인을 개인화합니다.
Parameters
로그인 유저 ID. 로그아웃 시
null로 설정하여 해제유저 ID 해제
로그아웃 시에는setUserId(null)을 호출하여 유저 등록을 해제하는 것이 권장됩니다. 이 호출은 현재 기기와 유저 간 연결을 해제합니다.
따라서, 동일한 유저 데이터를 유지하려면 서버 또는 앱 내부에서 별도로 관리해야 합니다.
- Dart
setUserId
2. 유저 프로퍼티 등록
setUserProperties는 유저의 속성 정보를 등록합니다.이 정보는 세그먼트 타깃팅, 메시지 개인화, 발송 채널 선택 등에 사용됩니다.
유저 속성 key-value 쌍.
$email, $phone_number 등 사전 정의된 키 지원$email: 이메일 캠페인용 주소$phone_number: 문자/카카오 캠페인용 전화번호- 기타 커스텀 필드:
"plan","tier","country"등 자유롭게 설정 가능
- Dart
setUserProperties
3. 이벤트 로깅
유저 행동을 기록하여 캠페인 트리거, 세그먼트 조건, 성과 분석 등에 활용할 수 있습니다.예를 들어 버튼 클릭, 페이지 진입, 구매 완료 같은 유저 행동을 이벤트로 수집합니다.
Parameters
이벤트 이름 (예: “click_button”, “purchase_completed”)
이벤트에 대한 추가 속성. 예: “plan”: “premium”, “duration”: 120
세그먼트 분류 시 기준으로 사용할 키 목록 (최대 1개까지 지원)
segmentationEventParamKeys를 활용하여 이벤트 변수 (eventParams)를 발송 대상 설정 등에 활용할 수 있습니다. 최대 1개의 Key만 지정할 수 있습니다.- Dart
trackEvent
4. 내부 유저 ID 확인
getNotiflyUserId() 메서드는 노티플라이가 내부적으로 관리하는 고유 User ID를 반환합니다.이는
setUserId() 로 등록한 유저 ID와는 별개의 식별자이며, 일반적인 상황에서는 사용할 필요가 없습니다.다만 외부 CRM 또는 서드파티 서비스와의 연동 과정에서 내부 User ID 값이 필요한 경우 활용할 수 있습니다.
5. (Only Web) Web Push Notification 설정
Flutter Web에서 웹 푸시 알림을 사용하는 경우에만 아래 단계를 진행하세요.모바일(iOS/Android)에서는 이 섹션을 건너뛰어도 됩니다.
1. Service Worker 등록
웹 푸시 알림 수신을 위해 Service Worker를 등록해야 합니다.- Flutter 프로젝트의
web/폴더 내에notifly-service-worker.js파일을 생성합니다. - 다음 코드를 추가합니다:
web/notifly-service-worker.js
이 파일은 브라우저 백그라운드에서 푸시 알림을 수신/표시하는 핵심 역할을 합니다.
2. 웹 푸시 권한 요청
웹 푸시 알림은 브라우저에서 유저의 명시적 권한이 필요합니다.- 자동 권한 요청 (기본)
- 노티플라이 콘솔 → 설정 → 웹 푸시 알림 설정 → “권한 요청 팝업 자동 노출”을 ON으로 설정합니다.
- ON 상태에서는 웹사이트 방문 시 자동으로 권한 요청 팝업이 표시됩니다.
- 수동 권한 요청 (선택적 호출)

- 콘솔에서 “자동 노출” 옵션을 OFF로 설정하면, 앱 코드에서 직접 권한 요청 시점을 제어할 수 있습니다.
- 이 경우 아래 메서드를 호출하세요.
requestPermission()은 콘솔 설정에서 “자동 권한 요청”이 OFF인 경우에만 동작합니다. 3. 권한 동작 방식
- 유저가 아직 권한을 설정하지 않은 경우, 팝업이 표시됩니다.

- 유저가 이미 승인한 경우, 팝업은 다시 표시되지 않습니다.
- 유저가 거부한 경우, 브라우저 정책상 팝업이 다시 표시되지 않습니다.
6. 연동 테스트
SDK 설치 후 아래 페이지에서 실제 이벤트 및 푸시 수신 여부를 테스트하세요.👉 SDK 연동 Test
7. 심화 연동
FAQ
이미 Firebase Cloud Messaging을 사용 중인데 어떻게 해야 할까요?
이미 Firebase Cloud Messaging을 사용 중인데 어떻게 해야 할까요?
노티플라이 Android SDK는 기존 앱에서 사용하고 있을 수 있는 Firebase Cloud Messaging과 함께 사용하실 수 있습니다.
