Flutter SDK の初期化 (レガシー)

Rokt の Flutter アプリケーション用 SDK は、Rokt のパートナーがオーバーレイまたは埋め込みプレースメントを表示するため、または Rokt の広告主がキャンペーンのコンバージョンを記録するために使用できます。Flutter 用 Rokt SDK は pub.dev にデプロイされています。

SDK のすべてのユースケースは、アプリケーションに SDK を統合し初期化するための同じ初期手順に従います。大まかに言うと、これらの手順は次のとおりです:

1. Flutter アプリケーションへの SDK の統合
2. Android アプリケーションの設定
3. Rokt SDK の初期化

これらの手順に従った後、SDK の execute メソッドを使用して、必要なユースケースに応じたさまざまな方法で利用できます。

Flutter アプリケーションへの SDK の統合

Flutter アプリケーションに SDK を統合するには、次の手順が必要です:

1. pubspec.yaml ファイルの dependencies に rokt_sdk: ^4.x.x を追加します。
2. ターミナルまたは Android Studio を使用して Flutter Pub Get を実行します。

Android 用の設定

Android アプリケーション用に Rokt Flutter SDK を設定するには、以下の手順を行います:

1. android/app/build.gradle で minSdkVersion を設定し、multidex を有効にします:

android {
    defaultConfig {
        minSdkVersion 21
        multidexEnabled true
    }
}

これにより、アプリは Android SDK 19 以上を実行しているユーザーのみが利用可能になります。

2. appcompat 依存関係をインクルードします

implementation 'androidx.appcompat:appcompat:x.x.x'

android/app のテーマは AppCompat テーマファミリーから拡張する必要があります。例:

<style name="NormalTheme" parent="Theme.AppCompat.DayNight.DarkActionBar"/>

3. MainActivity の親アクティビティを FlutterFragmentActivity に変更します

// path: android/app/src/main/kotlin/<your-package>/MainActivity.kt
import io.flutter.embedding.android.FlutterFragmentActivity

class MainActivity : FlutterFragmentActivity()

Flutter 用 Rokt SDK の初期化

Rokt SDK を使用する前に、Flutter 用に初期化してください。アプリケーション内で早い段階で initialize メソッドを呼び出すことをお勧めします。

注意

Rokt アカウントに関連付けられた 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 init completed with status ${event["status"]}");
    }
});

デバッグ

RoktSdk.setLoggingEnabled(enable: true); API を使用して、Rokt SDK からのデバッグログを有効にします。

次のステップ

次のステップは、統合のユースケースによって異なります。詳細については、以下のリソースを参照してください:

• プレースメントの追加
• コンバージョンの記録