Last updated 5 déc. 2024

Initialiser le SDK Flutter

Le SDK de Rokt pour les applications Flutter peut être utilisé par les partenaires de Rokt pour afficher des placements superposés ou intégrés, ou par les annonceurs Rokt pour enregistrer des conversions pour les campagnes. Le SDK Rokt pour Flutter est déployé sur pub.dev.

Tous les cas d'utilisation du SDK suivent les mêmes étapes initiales pour intégrer et initialiser le SDK dans votre application. À un niveau élevé, ces étapes sont :

Intégrer le SDK dans votre application Flutter
Configurer pour les applications Android
Initialiser le SDK Rokt

Après avoir suivi ces étapes, la méthode execute du SDK peut ensuite être utilisée de diverses manières pour s'adapter au cas d'utilisation requis.

Intégrer le SDK dans votre application Flutter

Pour intégrer le SDK dans votre application Flutter, vous devez :

Ajouter rokt_sdk: ^4.6.1 aux dépendances du fichier pubspec.yaml.
Exécuter Flutter Pub Get via le terminal ou Android Studio.

Configurer pour Android

Pour configurer le SDK Flutter Rokt pour les applications Android, vous devez :

Définir le minSdkVersion et activer multidex dans android/app/build.gradle :

android {
    defaultConfig {
        minSdkVersion 21
        multidexEnabled true
    }
}

Cela signifie que l'application ne sera disponible que pour les utilisateurs exécutant Android SDK 19 ou supérieur.

Inclure l'implémentation de la dépendance appcompat

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

Le thème de android/app doit hériter de la famille de thèmes AppCompat, exemple :

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

Modifier l'activité parente de MainActivity en FlutterFragmentActivity

// chemin : android/app/src/main/kotlin/<votre-packaged>/MainActivity.kt
import io.flutter.embedding.android.FlutterFragmentActivity

class MainActivity : FlutterFragmentActivity()

Initialiser le SDK Rokt pour Flutter

Initialisez le SDK Rokt pour Flutter avant de l'utiliser. Nous recommandons d'appeler la méthode initialize tôt dans l'application.

attention

Contactez Rokt pour obtenir l'ID de compte Rokt associé à votre compte. Afin de tester votre intégration, vous pouvez utiliser l'ID de compte de test ci-dessous. N'oubliez pas, cependant, que cela doit être remplacé par votre ID de compte Rokt unique avant le lancement.

ID de compte Rokt de test : 222

import 'package:rokt_sdk/rokt_sdk.dart';

// Ce qui suit révélera une intégration de démonstration. Pour voir votre intégration :
// 1) Remplacez l'ID de tag de test d'intégration (222) par votre ID de tag Rokt unique
// 2) Remplacez 1.0.0 par la version de l'application
RoktSdk.initialize('222', appVersion: '1.0.0');

Recevoir l'état d'initialisation

Depuis la version 4.6.0, le SDK Rokt diffuse l'état d'initialisation via son EventChannel.

final EventChannel roktEventChannel = EventChannel('RoktEvents');

roktEventChannel.receiveBroadcastStream().listen((dynamic event) {
    if (event["event"] == "InitComplete") {
    debugPrint("Initialisation Rokt terminée avec statut ${event["status"]}");
    }
});

Débogage

Utilisez l'API RoktSdk.setLoggingEnabled(enable: true); pour activer les journaux de débogage du Rokt SDK.

Étapes suivantes

Vos étapes suivantes dépendent du cas d'utilisation de votre intégration. Consultez ces ressources pour plus d'informations :

Intégrer le SDK dans votre application Flutter​

Configurer pour Android​

Initialiser le SDK Rokt pour Flutter​

Recevoir l'état d'initialisation​

Débogage​

Étapes suivantes​