Last updated 24 oct. 2023

Ajouter un emplacement

Le SDK Rokt pour Flutter peut être utilisé pour afficher l'emplacement de superposition par-dessus le contenu de votre application.

Avant de commencer

Assurez-vous que le SDK Rokt Flutter a déjà été intégré dans votre application.

Emplacements de superposition

Importer le SDK

Importez le SDK dans le fichier dart de votre application :

import 'package:rokt_sdk/rokt_sdk.dart';

Exécution du SDK

Exécutez le SDK au point souhaité en ajoutant les attributs clients appropriés. L'emplacement Rokt s'affichera ensuite après un court délai configurable via la plateforme Rokt.

Vous pouvez dicter quels attributs clients sont inclus dans votre intégration Rokt. Plus d'informations sur les champs de données disponibles peuvent être trouvées sur la page attributs. Si vous souhaitez intégrer plus d'attributs, vous pouvez ajouter des lignes de code supplémentaires pour chaque nouvel attribut aux exemples ci-dessous.

void executeRokt() {
    // Remplacez RoktExperience par votre nom de vue
    RoktSdk.execute(
                    viewName: "RoktExperience",
                    attributes: {"email": "j.smith@example.com",
                        "firstname": "Jenny",
                        "lastname": "Smith",
                        "mobile": "(555)867-5309",
                        "postcode": "90210",
                        "country": "US"},
                    onLoad: () {
                        // Callback facultatif lorsque l'emplacement Rokt se charge
                    },
                    onUnLoad: () {
                        // Callback facultatif lorsque l'emplacement Rokt se décharge
                    },
                    onShouldShowLoadingIndicator: () {
                        // Callback facultatif pour afficher un indicateur de chargement
                    },
                    onShouldHideLoadingIndicator: () {
                        // Callback facultatif pour masquer un indicateur de chargement
                    });
}

remarque

Le NomDeVue ("RoktExperience") peut être modifié lors de l'exécution du SDK à plusieurs endroits pour afficher une expérience différente en fonction du contexte dans lequel le SDK est exécuté dans l'application. Si vous modifiez le NomDeVue, travaillez avec l'équipe Rokt pour vous assurer que les ajustements correspondants sont effectués dans le système Rokt.

Emplacements intégrés

Importez le SDK

Importez le SDK Rokt dans le fichier JavaScript :

import 'package:rokt_sdk/rokt_sdk.dart';

Ajoutez RoktWidget à votre vue

Ajoutez RoktWidget à la fonction build de votre vue. Le widget Rokt sera injecté dans cet espace réservé lorsque la méthode execute est appelée :

const RoktWidget(placeholderName: "RoktEmbedded1")

Veuillez vous assurer que la vue est créée dans la zone visible de l'écran, puis appelez showWidget. RoktWidget dispose d'un rappel pour notifier lorsque le widget est créé, ce qui peut être utilisé.

RoktWidget(placeholderName: "RoktEmbedded1", onWidgetCreated: () { showWidget() })

Exécution du SDK Rokt Flutter

Exécutez le SDK à l'endroit souhaité en envoyant les attributs client appropriés. L'emplacement Rokt s'affiche ensuite après un court délai configurable via la plateforme Rokt.

Vous pouvez dicter quels attributs client sont inclus dans votre intégration Rokt. Plus d'informations sur les champs de données disponibles peuvent être trouvées sur la page des attributs. Si vous souhaitez intégrer plus d'attributs, vous pouvez ajouter des lignes de code supplémentaires pour chaque nouvel attribut aux exemples ci-dessous.

void executeRokt() {
    // Remplacez RoktExperience par votre nom de vue
    RoktSdk.execute(
                    viewName: "RoktEmbeddedExperience",
                    attributes: {"email": "j.smith@example.com",
                        "firstname": "Jenny",
                        "lastname": "Smith",
                        "mobile": "(555)867-5309",
                        "postcode": "90210",
                        "country": "US"},
                    onLoad: () {
                        // Callback facultatif lorsque l'emplacement Rokt se charge
                    },
                    onUnLoad: () {
                        // Callback facultatif lorsque l'emplacement Rokt se décharge
                    },
                    onShouldShowLoadingIndicator: () {
                        // Callback facultatif pour afficher un indicateur de chargement
                    },
                    onShouldHideLoadingIndicator: () {
                        // Callback facultatif pour masquer un indicateur de chargement
                    });
}

remarque

Le ViewName ("RoktEmbeddedExperience") peut être modifié lors de l'exécution du SDK à plusieurs endroits. Cette configuration vous permet d'afficher une expérience différente en fonction du contexte dans lequel le SDK est exécuté dans l'application. Si vous modifiez le ViewName ou le placeholderName ("RoktEmbedded1"), veuillez travailler avec l'équipe Rokt pour vous assurer que les ajustements correspondants sont effectués dans le système Rokt.