통합 완료하기

이 단계를 수행하기 전에 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)

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

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

기존 사용자 지정 엔드포인트가 있는 경우:

• 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이고, 표준은 아니지만, 지연된 초기화를 사용할 수 있는 유효한 구현이 일부 있기 때문입니다.

Appboy의 sharedInstance(표준 구현)에 액세스하기 전에 didFinishLaunchingWithOptions: 위임에서 startWithApiKey:를 호출하면 Appboy.sharedInstance()?.changeUser("testUser")와 같은 선택적 체인을 사용하여 번거로운 확인 작업을 피할 수 있습니다. null이 아닌 sharedInstance를 가정하는 Objective-C 구현과 동등합니다.

추가 리소스

모든 SDK 메서드에 대한 추가 지침은 전체 iOS 클래스 문서에서 확인할 수 있습니다.