Flutter SDKを初期化する
RoktのFlutterアプリケーション用SDKは、Roktのパートナーがオーバーレイまたは埋め込みプレースメントを表示するため、またはRoktの広告主がキャンペーンのコンバージョンを記録するために使用できます。RoktのFlutter用SDKはpub.devにデプロイされています。
SDKのすべてのユースケースは、アプリケーションにSDKを統合し初期化するための同じ初期ステップに従います。高レベルで、これらのステップは次のとおりです:
- SDKをFlutterアプリケーションに統合すること
- Androidアプリケーションのための設定
- Rokt SDKを初期化すること
これらのステップに従った後、SDKのexecute
メソッドは、必要なユースケースに応じてさまざまな方法で使用できます。
SDKをFlutterアプリケーションに統合する
SDKをFlutterアプリケーションに統合するには、次のことを行う必要があります:
pubspec.yaml
ファイルのdependenciesにrokt_sdk: ^4.6.1
を追加します。- ターミナルまたはAndroid Studioを介して
Flutter Pub Get
を実行します。
Androidの構成
Rokt Flutter SDKをAndroidアプリケーションに構成するには、以下の手順を行う必要があります:
android/app/build.gradle
でminSdkVersion
を設定し、multidex
を有効にします:
android {
defaultConfig {
minSdkVersion 21
multidexEnabled true
}
}
これは、アプリがAndroid SDK 19以降を実行しているユーザーのみが利用可能であることを意味します。
- appcompatの依存関係を含めて実装します
implementation 'androidx.appcompat:appcompat:x.x.x'
android/appのテーマはAppCompatテーマファミリーから拡張する必要があります。例:
<style name="NormalTheme" parent="Theme.AppCompat.DayNight.DarkActionBar"/>
- MainActivityの親アクティビティをFlutterFragmentActivityに変更します
// path: android/app/src/main/kotlin/<your-package>/MainActivity.kt
import io.flutter.embedding.android.FlutterFragmentActivity
class MainActivity : FlutterFragmentActivity()
Flutter用のRokt SDKの初期化
FlutterのRokt SDKを使用する前に初期化します。アプリケーション内で早い段階でinitialize
メソッドを呼び出すことをお勧めします。
あなたのアカウントに関連付けられたRoktアカウントIDについては、Roktにお問い合わせください。統合のテストを行うためには、下記のテストアカウントIDを使用できます。ただし、公開前にこれをあなたのユニークなRoktアカウントIDに置き換える必要があることを忘れないでください。
テストRoktアカウントID: 222
import 'package:rokt_sdk/rokt_sdk.dart';
// 以下はデモ統合を公開します。あなたの統合を表示するには:
// 1) 統合テストタグID(222)をあなたのユニークなRoktタグIDに置き換えてください
// 2) 1.0.0をアプリケーションバージョンに置き換えてください
RoktSdk.initialize('222', appVersion: '1.0.0');
初期化ステータスの受信
4.6.0
バージョンから、Rokt SDKはEventChannel
を通じて初期化ステータスをブロードキャストします。
final EventChannel roktEventChannel = EventChannel('RoktEvents');
roktEventChannel.receiveBroadcastStream().listen((dynamic event) {
if (event["event"] == "InitComplete") {
debugPrint("Rokt初期化がステータス${event["status"]}で完了しました");
}
});
デバッグ
RoktSdk.setLoggingEnabled(enable: true);
API を使用して Rokt SDK からのデバッグログを有効にします。
次のステップ
あなたの次のステップは、統合のユースケースに依存します。詳細については、次のリソースを確認してください: