Website logo
⌘K
🚀시작하기
📈사용 가이드
🛠️개발 가이드
플레어레인 홈페이지
플레어레인 콘솔
Docs in English
Docs powered by Archbee
개발 가이드
앱 푸시

iOS(아이폰) 연동하기

플레어레인을 사용하여 iOS(아이폰) 앱 푸시 알림을 코드 1줄로 구현할 수 있습니다.

1. 사전 준 비

타 푸시 솔루션과 함께 사용할 수 있습니다!

병행 사용을 위해서는 iOS: Swizzling 비활성화 가이드를 참고하여 몇 가지 작업을 추가해야합니다.

  • 플레어레인 관리자 에서 회원가입 후 프로젝트 생성


2. 인증 값 설정

아래 가이드를 참고하여 플레어레인에 푸시 발송에 필요한 인증 값을 입력합니다.

  • iOS: APNS 인증 정보 설정


3. CocoaPods을 사용하여 SDK 연동

  1. 내 Xcode 프로젝트에 CocoaPods 설치가 되어있는지 확인합니다. 처음일 경우 여기를 참고하세요
  2. Podfile 파일의 상단에 platform :ios, '12.0'혹은 그 이상을 입력합니다
  3. Podfile에 다음 코드를 추가합니다.
Podfile
target 'YOUR_PROJECT_NAME' do

  // 아래 줄 추가
  pod 'FlareLane', '1.4.0'
  
end


4. 터미널에서 pod install을 통해 설치 완료합니다. 5. <YOUR_PROJECT_NAME>.xcworkspace 파일을 열어 Xcode 프로젝트를 실행합니다.



4. Capability 추가

  1. 대상 PROJECT의 Deployment Target 을 12.0 혹은 그이상으로 입력합니다.
  2. 대상 TARGET의 Minimum Deployments 를 12.0 혹은 그 이상으로 입력합니다.
  3. 앱푸시 발송 권한을 추가합니다. Target 의 "Signing & Capabilites" 탭으로 들어와 좌상단의 "+ Capability" 를 클릭합니다.
  4. "Push Notifications" 를 선택하여 추가합니다

Apple Developer Program 에 가입된 Apple 계정만 Push Notifications Capability를 추가할 수 있습니다

Document image



5. 초기화 코드 작성

SwiftUI vs Storyboard. 우리 프로젝트의 User Interface는 무엇인가요?

SwiftUI 로 설정된 경우 4-1 부터

Storyboard 로 설정된 경우 4-2 부터 진행합니다.

5-1. (SwiftUI만) AppDelegate.swift 생성

SwiftUI 프로젝트는 AppDelegate.swift가 생성되어 있지 않기 때문에 먼저 파일 생성이 필요합니다.

AppDelegate.swift 파일을 새로 만들고 기존 <YOUR_PROJECT_NAME>App.swift 파일을 일부 수정합니다.

(추가)AppDelegate.swift
(기존)<YOUR_PROJECT_NAME>App.swift
import UIKit

class AppDelegate: NSObject, UIApplicationDelegate {
  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
    return true
  }
}



5-2. AppDelegate 내부 연동 코드 작성

AppDelegate 파일에 다음과 같은 초기화 코드를 입력합니다. 프로젝트 ID는 콘솔의 [프로젝트] 페이지에서 확인할 수 있습니다.

플레어레인 SDK가 제공하는 함수 리스트는 Mobile Push SDK Reference 에서 확인할 수 있습니다.

Switft(AppDelegate.swift)
Objective-C(AppDelegate.m)
// 1. SDK 사용을 위해 import 코드 추가
import FlareLane

class AppDelegate: UIResponder, UIApplicationDelegate {
  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {    

    // 2. 아래 init 코드 추가
    // 알림 권한 팝업 타이밍을 제어하려면 세 번째 파라미터를 false로 설정 후 적절한 시점에 .subscribe() 함수 실행
    FlareLane.initWithLaunchOptions(launchOptions, projectId: "PROJECT_ID", requestPermissionOnLaunch: true)
  }
}



6. 테스트

여기까지 모두 완료하셨으면 앱 빌드, 실행 시 자동으로 플레어레인 전체 기기 리스트에 추가됩니다.

실제 배포 전, 푸시를 실제 발송하여 기기에 잘 오는지, 푸시 클릭 시 통계에 잘 잡히는지 반드시 직접 확인하시기 바랍니다.



7. 추가 개발 연동

푸시 알림에 이미지 첨부를 하고 싶습니다.

  • [iOS] iOS: Rich Notification 을 참고하여 Notification Extension 세팅을 합니다.

초개인화 마케팅을 위해 고객 데이터를 연동합니다.

  • 고객 여정 자동화 및 메시지 개인화 등 초개인화 푸시 마케팅에 필요한 고객 데이터 연동을 진행합니다.

푸시 클릭 시 동작을 정의하고 싶습니다.

  • Mobile Push SDK Reference 내 setNotificationConvertedHandler 함수를 사용합니다.



PREVIOUS
안드로이드(Android) 연동하기
NEXT
리액트 네이티브(React Native) 연동하기
Docs powered by Archbee
TABLE OF CONTENTS
1. 사전 준 비
2. 인증 값 설정
3. CocoaPods을 사용하여 SDK 연동
4. Capability 추가
5. 초기화 코드 작성
5-1. (SwiftUI만) AppDelegate.swift 생성
5-2. AppDelegate 내부 연동 코드 작성
6. 테스트
7. 추가 개발 연동
푸시 알림에 이미지 첨부를 하고 싶습니다.
초개인화 마케팅을 위해 고객 데이터를 연동합니다.
푸시 클릭 시 동작을 정의하고 싶습니다.
Docs powered by Archbee