초기 SDK 설정

이 참조 문서에서는 Flutter용 Braze SDK를 설치하는 방법을 설명합니다. 다음 지침에 따라 통합자가 Dart로 작성된 Flutter 앱에서 Braze API를 사용할 수 있도록 지원하는 패키지가 포함된 Braze Flutter SDK를 설치합니다.

이 플러그인은 기본적인 분석 기능을 제공하며, 이를 통해 단일 코드베이스에서 iOS 및 Android용 인앱 메시지와 콘텐츠 카드를 통합할 수 있습니다.

전제 조건

설치를 완료하려면 앱 식별자 API 키 및 SDK 엔드포인트가 필요합니다. 둘 다 대시보드의 설정 관리 아래에 있습니다.

이 단계를 수행하기 전에 Flutter SDK를 설치하고 설정합니다. 기계와 프로젝트가 여기에 명시된 최소 필수 Flutter 및 Dart 버전을 실행 중인지 확인합니다.

1단계: Braze 라이브러리 통합

명령줄에서 Braze Flutter SDK 패키지를 추가합니다.

1
flutter pub add braze_plugin

그러면 pubspec.yaml 에 적절한 줄이 추가됩니다.

2단계: 기본 설정 완료

• android
• ios

1
2
3
4
5
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="com_braze_api_key">YOUR_APP_IDENTIFIER_API_KEY</string>
<string translatable="false" name="com_braze_custom_endpoint">YOUR_CUSTOM_ENDPOINT_OR_CLUSTER</string>
</resources>

1
2
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

1
2
import BrazeKit
import braze_plugin

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
static var braze: Braze? = nil

func application(
  _ application: UIApplication,
  didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil
) -> Bool {
  // Setup Braze
  let configuration = Braze.Configuration(
    apiKey: "<BRAZE_API_KEY>",
    endpoint: "<BRAZE_ENDPOINT>"
  )
  // - Enable logging or customize configuration here
  configuration.logger.level = .info
  let braze = BrazePlugin.initBraze(configuration)
  AppDelegate.braze = braze

  return true
}

1
@import BrazeKit;

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  // Setup Braze
  BRZConfiguration *configuration =
      [[BRZConfiguration alloc] initWithApiKey:@"<BRAZE_API_KEY>"
                                      endpoint:@"<BRAZE_ENDPOINT>"];
  // - Enable logging or customize configuration here
  configuration.logger.level = BRZLoggerLevelInfo;
  Braze *braze = [BrazePlugin initBraze:configuration];
  AppDelegate.braze = braze;

  [self.window makeKeyAndVisible];
  return YES;
}

#pragma mark - AppDelegate.braze

static Braze *_braze = nil;

+ (Braze *)braze {
  return _braze;
}

+ (void)setBraze:(Braze *)braze {
  _braze = braze;
}

3단계: 사용량

플러그인을 Dart 코드로 가져오려면 다음을 사용하세요:

1
import 'package:braze_plugin/braze_plugin.dart';

그런 다음, 샘플 앱에서와 같이 new BrazePlugin()을 호출하여 Braze 플러그인 인스턴스를 초기화합니다.

기본 통합을 테스트하십시오

이 시점에서는 대시보드에서 세션 통계를 확인하여 SDK가 통합되었는지 확인할 수 있습니다. 어느 플랫폼에서든 애플리케이션을 실행하면 대시보드( 개요 섹션)에 새 세션이 표시됩니다.

앱에서 다음 코드를 호출하여 특정 사용자에 대한 세션을 열 수 있습니다.

1
2
BrazePlugin braze = BrazePlugin();
braze.changeUser("{some-user-id}");

그런 다음, 대시보드의 오디언스 > 사용자 검색에서 {some-user-id}로 사용자를 검색합니다. 여기에서 세션 및 디바이스 데이터가 기록되었는지 확인할 수 있습니다.