Flutter SDKの初期化
RoktのFlutterアプリケーション用SDKは、Roktのパートナーがオーバーレイまたは埋め込み型配置を表示するため、またはRoktの広告主がキャンペーンのコンバージョンを記録するために使用できます。Flutter用のRokt SDKはpub.devにデプロイされています。
SDKのすべての使用ケースは、アプリケーションにSDKを統合し初期化するために同じ初期ステップに従います。これらのステップは、高レベルでは以下の通りです。
- FlutterアプリケーションへのSDKの統合
- Androidアプリケーション用の設定
- Rokt SDKの初期化
これらのステップに続いて、SDKのexecuteメソッドを必要な使用ケースに合わせて様々に使用できます。
FlutterアプリケーションへのSDKの統合
FlutterアプリケーションにSDKを統合するためには:
pubspec.yamlファイルの依存関係にrokt_sdk: ^4.7.0を追加します。- ターミナルまたはAndroid Studioで
Flutter Pub Getを実行します。
Android の設定
Android アプリケーション向けに Rokt Flutter SDK を設定するには、次の手順が必要です：
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からのデバッグログを有効にします。
次のステップ
次のステップは、統合のユースケースによって異なります。詳細については、次のリソースを確認してください: