Ajouter un emplacement (ancien)

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

Avant de commencer

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

Exécuter le SDK Rokt Cordova

execute le SDK Rokt Cordova pour afficher votre emplacement. successCallback retourne 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 emplacement se charge
        // 2. onUnload - votre emplacement se décharge
        // 3. onShouldHideLoadingIndicator - crochet pour afficher un indicateur de chargement
        // 4. onShouldShowLoadingIndicator - crochet pour masquer un indicateur de chargement
    },
    function(err) {
        console.log(err);
    }
);

Callbacks

Le SDK Cordova de Rokt 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 callback onLoad sera appelé lorsque le placement sera chargé et interactif.

onShouldShowLoadingIndicator

Le onShouldShowLoadingIndicator sera appelé après un appel execute réussi, juste avant que le SDK ne déclenche un appel vers le backend de Rokt. Il peut être utilisé pour afficher des vues de progression des indicateurs de chargement en attendant que le placement se charge.

onShouldHideLoadingIndicator

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

onUnload

Le callback onUnload sera appelé lorsque le SDK ferme le placement. Il sera également déclenché si l'appel execute échoue.

Utilisation des configurations d'application

Les applications peuvent désormais envoyer des paramètres de configuration depuis 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 paramètres 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 par défaut