Skip to content

SDK の初期セットアップ

このリファレンス記事では、Flutter 向け Braze SDK のインストール方法について説明します。以下の手順に従って、Braze Flutter SDK をインストールします。これには、Dart で記述された Flutter アプリでインテグレーターが Braze API を使用できるようにするパッケージが含まれています。

このプラグインには、基本的な分析機能が用意されており、iOS と Android 両方のアプリ内メッセージとコンテンツカードを1つのコードベースで統合できます。

前提条件

インストールを完了するには、アプリ識別子 API キーと SDK エンドポイントが必要です。どちらもダッシュボードの [設定の管理] の下にあります。

これらの手順を実行する前に、Flutter SDK をインストールしてセットアップします。マシンとプロジェクトで、必要な最小限の Flutter バージョンと Dart バージョン (こちらに記載) が実行されていることを確認します。

ステップ 1:Braze ライブラリーを統合する

コマンドラインから Braze Flutter SDK パッケージを追加します。

1

flutter pub add braze_plugin

これにより、適切な行がpubspec.yaml に追加されます。

ステップ 2:ネイティブセットアップを完了する

Braze サーバーに接続するには、プロジェクトの android/res/values フォルダで braze.xml ファイルを作成します。以下のコードを貼り付けて、API 識別子キーとエンドポイントを値で置き換えます。

```xml <?xml version=”1.0” encoding=”utf-8”?>

YOUR_APP_IDENTIFIER_API_KEY YOUR_CUSTOM_ENDPOINT_OR_CLUSTER 
1
2
3
4
5
6

必要な権限をファイル `AndroidManifest.xml` に追加します。

```xml
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

AppDelegate.swift ファイルの先頭にBraze SDK インポートを追加します。

1
2

import BrazeKit
import braze_plugin

同じファイルで、application(_:didFinishLaunchingWithOptions:) メソッドで Braze 構成オブジェクトを作成し、API キーとエンドポイントをアプリの値に置き換えます。次に、構成を使用して Braze インスタンスを作成し、簡単にアクセスできるよう AppDelegate で静的プロパティを作成します。

```swift static var braze:Braze? = nil

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

return true } ```

Import BrazeKit at the top of the AppDelegate.m file: ```objc @import BrazeKit; ```

同じファイルで、application:didFinishLaunchingWithOptions: メソッドで Braze 構成オブジェクトを作成し、API キーとエンドポイントをアプリの値に置き換えます。次に、構成を使用して Braze インスタンスを作成し、簡単にアクセスできるよう AppDelegate で静的プロパティを作成します。

```objc - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { // Setup Braze BRZConfiguration *configuration = [[BRZConfiguration alloc] initWithApiKey:@”" 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} を使用してユーザーを検索します。そこで、セッションとデバイスデータがロギングされていることを確認できます。

  GitHub でこのページを編集
「このページはどの程度役に立ちましたか?」
New Stuff!