경고

앱보이키트 (Objective-C 소프트웨어 개발 키트라고도 함)는 더 이상 지원되지 않으며 Swift SDK. 새로운 기능, 버그 수정, 보안 업데이트 또는 기술 지원은 더 이상 제공되지 않지만 메시징 및 분석은 정상적으로 계속 작동합니다. 자세한 내용은 새로운 Braze Swift 소프트웨어 개발 키트 소개 를 참조하세요.

통합 완료

이 단계를 수행하기 전에 Carthage, CocoaPods, 스위프트 패키지 매니저 또는 수동 통합을 사용하여 SDK를 통합했는지 확인하세요.

1단계: 앱 델리게이트 업데이트

• objective-c
• swift

1
#import "Appboy-iOS-SDK/AppboyKit.h"

1
#import "AppboyKit.h"

1
2
3
[Appboy startWithApiKey:@"YOUR-APP-IDENTIFIER-API-KEY"
          inApplication:application
      withLaunchOptions:launchOptions];

1
import Appboy_iOS_SDK

1
import AppboyKit

1
Appboy.start(withApiKey: "YOUR-APP-IDENTIFIER-API-KEY", in:application, withLaunchOptions:launchOptions)

참고

sharedInstance 싱글턴은 startWithApiKey:가 호출되기 전까지 nil입니다. 이는 Braze 기능을 사용하기 위한 전제 조건입니다.

경고

반드시 애플리케이션의 메인 스레드에서 Braze를 초기화하세요. 비동기적으로 초기화하면 기능이 정상적으로 작동하지 않을 수 있습니다.

2단계: 데이터 클러스터 지정하기

참고

2019년 12월부터 커스텀 엔드포인트는 더 이상 제공되지 않습니다. 기존에 보유한 커스텀 엔드포인트가 있는 경우 계속 사용할 수 있습니다. 자세한 내용은 사용 가능한 엔드포인트 목록 을 참조하세요.

컴파일 타임 엔드포인트 구성(권장)

기존에 보유한 커스텀 엔드포인트가 있는 경우:

• Braze iOS SDK v3.0.2부터 Info.plist 파일을 사용하여 커스텀 엔드포인트를 설정할 수 있습니다. Info.plist 파일에 Braze 사전을 추가합니다. Braze 사전 내에 Endpoint 문자열 하위 항목을 추가하고 값을 커스텀 엔드포인트 URL의 권한(예: https://sdk.iad-01.braze.com이 아닌 sdk.iad-01.braze.com)으로 설정합니다. Braze iOS SDK v4.0.2 이전에는 Braze 대신 Appboy 사전 키를 사용해야 합니다.

Braze 담당자가 이미 올바른 엔드포인트를 안내해 드렸을 것입니다.

런타임 엔드포인트 구성

기존에 보유한 커스텀 엔드포인트가 있는 경우:

• Braze iOS SDK v3.17.0 이상부터 startWithApiKey:inApplication:withLaunchOptions:withAppboyOptions:에 전달되는 appboyOptions 파라미터 내의 ABKEndpointKey를 통해 엔드포인트를 재정의하여 설정할 수 있습니다. 값을 커스텀 엔드포인트 URL의 권한(예: https://sdk.iad-01.braze.com이 아닌 sdk.iad-01.braze.com)으로 설정합니다.

SDK 통합 완료

이제 Braze가 애플리케이션에서 데이터를 수집하고 있으며, 기본 통합이 완료되었습니다. 커스텀 이벤트 추적, 푸시 메시징, 그리고 Braze 기능의 전체 스위트를 활성화하려면 다음 문서를 참조하세요.

시작 시 Braze 커스터마이징

시작 시 Braze를 커스터마이징하려면, Braze 초기화 메서드 startWithApiKey:inApplication:withLaunchOptions:withAppboyOptions:를 사용하고, Braze 시작 키의 선택적 NSDictionary를 전달할 수 있습니다.

• objective-c
• swift

1
2
3
4
[Appboy startWithApiKey:@"YOUR-APP-IDENTIFIER-API-KEY"
          inApplication:application
      withLaunchOptions:launchOptions
      withAppboyOptions:appboyOptions];

1
2
3
4
Appboy.start(withApiKey: "YOUR-APP-IDENTIFIER-API-KEY",
                 in:application,
                 withLaunchOptions:launchOptions,
                 withAppboyOptions:appboyOptions)

이 메서드는 다음 매개변수와 함께 호출됩니다:

• YOUR-APP-IDENTIFIER-API-KEY – Braze 대시보드에서 확인할 수 있는 앱 식별자 API 키입니다.
• application – 현재 앱입니다.
• launchOptions – application:didFinishLaunchingWithOptions:에서 가져오는 NSDictionary 옵션입니다.
• appboyOptions – Braze의 시작 구성 값이 포함된 선택적 NSDictionary입니다.

Braze 시작 키 목록은 Appboy.h를 참조하세요.

Appboy.sharedInstance()와 Swift 널 가능성

일반적인 관행과 다소 다르게, Appboy.sharedInstance() 싱글턴은 옵셔널입니다. 이는 startWithApiKey:가 호출되기 전에는 sharedInstance가 nil이며, 지연 초기화를 사용할 수 있는 비표준이지만 유효한 구현이 존재하기 때문입니다.

didFinishLaunchingWithOptions: 델리게이트에서 Appboy의 sharedInstance에 접근하기 전에 startWithApiKey:를 호출하면(표준 구현), Appboy.sharedInstance()?.changeUser("testUser")와 같이 옵셔널 체이닝을 사용하여 번거로운 검사를 피할 수 있습니다. 이는 널이 아닌 sharedInstance를 가정한 Objective-C 구현과 동일한 동작을 합니다.

추가 리소스

SDK 메서드에 대한 추가 안내를 제공하는 전체 iOS 클래스 설명서를 이용할 수 있습니다.