Last updated 15 août 2024

Meilleures pratiques pour le SDK Android

Les performances des applications mobiles sont cruciales pour votre entreprise. Notre technologie se concentre sur l'amélioration de l'expérience de vos clients avec votre application. Ainsi, les performances de l'écran sont un élément central de nos solutions. Pour augmenter l'engagement et les taux de conversion, nous employons plusieurs approches pour minimiser les temps de chargement des écrans.

Composant Jetpack Compose

À partir de la version majeure 4 du SDK Android de Rokt, vous pouvez ajouter une mise en page Rokt en utilisant le composable RoktLayout. Cela supprime la nécessité d'appeler Rokt.execute et prend en charge une intégration déclarative plus moderne en utilisant Compose comme décrit dans Add a placement.

Ajouter le composant

import com.rokt.roktsdk.RoktLayout

@Composable
fun MainScreen(modifier: Modifier = Modifier) {
    Column(
        modifier = modifier
            .background(Color.LightGray)
            .padding(8.dp),
    ) {
        // si l'application ne prend en charge que le mode clair
        val config = remember {
            RoktConfig.Builder().colorMode(RoktConfig.ColorMode.LIGHT).build()
        }
        RoktLayout(
            sdkTriggered = true,
            viewName = "RoktExperience",
            attributes = mapOf(
                "email" to "j.smith@example.com",
                "firstname" to "Jenny",
                "lastname" to "Smith",
                "mobile" to "(323) 867-5309",
                "postcode" to "90210",
                "country" to "US"
            ),
            location = "RoktEmbedded1", // Si vous utilisez une mise en page intégrée
            onLoad = {},
            onUnload = {},
            config = config,
            onShouldShowLoadingIndicator = {},
            onShouldHideLoadingIndicator = {},
        )
    }
}

remarque

Vous pouvez utiliser le composable RoktLayout pour les mises en page intégrées et superposées.

Utilisation des configurations d'application

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

import com.rokt.roktsdk.Rokt

// si l'application ne prend en charge que le mode clair.
val roktConfig = RoktConfig.Builder().colorMode(RoktConfig.ColorMode.LIGHT).build()
Rokt.execute(
    // autres paramètres,
    config = 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

Utilisation des polices de caractères

Si vous utilisez vos propres polices de caractères comme décrit dans Initialize the Android SDK, vous devez transmettre une carte de références faibles à vos objets de police dans execute.

Java

import com.rokt.roktsdk.Rokt

class ConfirmationActivity : Activity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        ...

        // Inclure tous les attributs de consommateur appropriés
        val attributes = mapOf(
            "email" to "j.smith@example.com",
            "firstname" to "Jenny",
            "lastname" to "Smith",
            "mobile" to "(323) 867-5309",
            "postcode" to "90210",
            "country" to "US",
        )

        val fontTypefaces = mapOf(
            "Arial-Bold" to WeakReference(yourTypefaceObject),
        )

        Rokt.execute("RoktExperience",
            attributes,
            object : Rokt.RoktCallback {
                override fun onUnload(reason: Rokt.UnloadReasons) {
                }
                override fun onLoad() {
                }
                override fun onShouldHideLoadingIndicator() {
                }
                override fun onShouldShowLoadingIndicator() {
                }
            },
            fontTypefaces,
        )
        ...
    }
}

Kotlin

import com.rokt.roktsdk.Rokt;

class ConfirmationActivity : Activity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        ...

        Map<String,String> attributes = new HashMap<String, String>();

        attributes.put("email", "j.smith@example.com");
        attributes.put("firstname", "Jenny");
        attributes.put("lastname", "Smith");
        attributes.put("mobile", "(323) 867-5309");
        attributes.put("postcode", "90210");
        attributes.put("country", "US");

        Map<String, WeakReference<Typeface>> fontTypefaces = new HashMap<>();

        fontTypefaces.put("Arial-Bold", new WeakReference<>(yourTypefaceObject));

        Rokt.INSTANCE.execute("RoktExperience",
            attributes,
            new Rokt.RoktCallback() {
                @Override
                public void onLoad() {
                }
                @Override
                public void onUnload(Rokt.UnloadReasons unloadReasons) {
                }
                @Override
                public void onShouldHideLoadingIndicator() {
                }
                @Override
                public void onShouldShowLoadingIndicator() {
                }
            },
            fontTypefaces
        )
        ...
    }
}

Pour plus d'informations, voir how-to section.