Last updated 16 juil. 2024

Ajouter un emplacement

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 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

execute le SDK Rokt Cordova pour afficher votre emplacement. 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 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);
    }
);

Rappels

Le SDK Rokt Cordova prend en charge les rappels via les résultats du plugin Cordova. Vous pouvez écouter les valeurs de rappel 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 rappels

onLoad

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

onShouldShowLoadingIndicator

Le callback onShouldShowLoadingIndicator sera appelé après un appel d'exécution réussi, juste avant que le SDK ne déclenche un appel au 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 d'exécution é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 d'application au lieu de se fier uniquement aux paramètres par défaut du système.

// si l'application ne supporte 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 par défaut le mode de couleur du système