Last updated 5 déc. 2024

Ajouter un placement

Le SDK Rokt Cordova peut être utilisé par les partenaires Rokt pour afficher des placements en superposition, ou par les annonceurs Rokt pour enregistrer des conversions pour des campagnes.

Avant de commencer

Assurez-vous que le SDK Rokt Cordova a été intégré dans votre application.

Exécuter le SDK Rokt Cordova

exécutez le SDK Rokt Cordova pour afficher votre placement. successCallback renvoie un paramètre de message qui vous permet de suivre les événements du SDK.

RoktSDK.execute(
    "RoktExperience",
    {
        "email" : "j.smith@example.com",
        "firstname": "Ginger",
        "lastname": "Smith",
        "mobile": "(555)867-5309",
        "postcode": "90210",
        "country": "US"
    },
    function(msg) {
        console.log(msg);
        
        // msg peut être l'un de ceux-ci
        // 1. onLoad - votre placement se charge
        // 2. onUnload - votre placement se décharge
        // 3. onShouldHideLoadingIndicator - appel pour afficher un indicateur de chargement
        // 4. onShouldShowLoadingIndicator - appel pour cacher un indicateur de chargement
    },
    function(err) {
        console.log(err);
    }
);

Callbacks

Le SDK Rokt Cordova prend en charge les callbacks via les résultats du plugin Cordova. Vous pouvez écouter les valeurs de callback dans une fonction passée à la fonction execute :

RoktSDK.execute(
    "RoktExperience",
    {
        "email" : "j.smith@example.com",
        "firstname": "Ginger",
        "lastname": "Smith",
        "mobile": "(555)867-5309",
        "postcode": "90210",
        "country": "US"
    },
    function(callbackValue) {
        switch (callbackValue) {
            case "onLoad":
            // onLoad
            case "onUnload":
            // onUnload
            case "onShouldShowLoadingIndicator":
            // onShouldShowLoadingIndicator
            case "onShouldHideLoadingIndicator":
            // onShouldHideLoadingIndicator
            default:
            // default
        }
    },
    function(err) {
        console.log(err);
    }
);

Types de callback

onLoad

Le rappel onLoad sera appelé lorsque le placement sera chargé et interactif.

onShouldShowLoadingIndicator

Le rappel onShouldShowLoadingIndicator sera appelé lors d'un appel d'exécution réussi, juste avant que le SDK ne déclenche un appel au backend Rokt. Il peut être utilisé pour afficher des vues de progression des indicateurs de chargement pendant l'attente du chargement du placement.

onShouldHideLoadingIndicator

Le rappel onShouldHideLoadingIndicator sera appelé lorsque le SDK obtient une réponse de succès ou d'échec du backend Rokt. Il peut être utilisé pour annuler les vues de progression ou les indicateurs de chargement.

onUnload

Le rappel onUnload sera appelé lorsque le SDK ferme le placement. Il sera également déclenché si l'appel d'exécution échoue.

Utilisation des configurations d'application

Les applications peuvent désormais envoyer des paramètres de configuration de leur propre environnement d'application. Cela permet au SDK Rokt d'utiliser des configurations personnalisées de l'application au lieu de se fier uniquement aux valeurs par défaut du système.

// si l'application ne prend en charge que le mode clair.
const roktConfig = new RoktSDK.RoktConfigBuilder()
    .withColorMode(RoktSDK.COLOR_MODE.LIGHT)
    .build();
RoktSdk.executeWithConfig(
    // autres paramètres,
    roktConfig,
))

Objet ColorMode

Valeur	Description
LIGHT	L'application est en mode clair
DARK	L'application est en mode sombre
SYSTEM	L'application utilise le mode couleur du système