EcommAndroid

Intégrer en utilisant le SDK Android

Les partenaires de Rokt peuvent utiliser le SDK Android pour afficher des placements en superposition ou intégrés, tandis que les marques Rokt peuvent l'utiliser pour enregistrer des conversions pour leurs campagnes. Le SDK Android de Rokt est déployé en utilisant Maven et Gradle.

remarque

Le SDK Android de Rokt contient des règles ProGuard et ne nécessite pas de configuration supplémentaire.

Tous les cas d'utilisation du SDK suivent les mêmes étapes initiales pour intégrer et initialiser le SDK. À un niveau général, ces étapes sont :

1. Configurer un espace de travail et activer le dépôt Gradle de Rokt
2. Ajouter le plugin Rokt Placement
3. Ajouter le module SDK Android de Rokt
4. Initialiser le SDK Android de Rokt

Après avoir suivi ces étapes, la méthode execute du SDK peut ensuite être utilisée de différentes manières pour répondre au cas d'utilisation requis.

remarque

Ce guide suppose que vous êtes familier avec Gradle et que vous savez comment installer un plugin pour le développement Android.

Configuration du SDK Android

1. Configurez un espace de travail et activez le dépôt Gradle de Rokt.
2. Ajoutez l'URL du dépôt du plugin Rokt Widget dans le fichier build.gradle du projet.

 // fichier => build.gradle (Projet : ....)

allprojects {
    repositories {
        google()
        mavenCentral()
        maven {
            url "https://rokt-eng-us-west-2-mobile-sdk-artefacts.s3.amazonaws.com"
        }
    }
}

Ou si vous utilisez Gradle 7.0.0 et au-delà, où les paramètres du dépôt qui étaient auparavant dans le fichier build.gradle de niveau supérieur se trouvent maintenant dans le fichier settings.gradle, ajoutez ce qui suit dans le fichier settings.gradle.

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()   
        maven {
            url "https://rokt-eng-us-west-2-mobile-sdk-artefacts.s3.amazonaws.com"
        }
    }
}

3. Ajoutez le module Rokt Android SDK à build.gradle pour le module.

 // fichier => build.gradle (Module : ...)

dependencies {
    ...
    // Remarque : 3.11.0 reflète la dernière version du SDK Android de Rokt.
    implementation 'com.rokt:roktsdk:3.11.0'
    ...
}

4. Initialisez le SDK Rokt avant de l'utiliser dans n'importe quelle activité. Nous recommandons d'appeler la méthode init depuis la classe LauncherActivity.

attention

Contactez Rokt pour obtenir l'ID de compte Rokt associé à votre compte. Pour tester votre intégration, vous pouvez utiliser l'ID de compte Rokt ci-dessous, mais vous devez le remplacer par votre ID de compte Rokt unique avant de lancer en production.

ID de compte de test : 222

Java

import com.rokt.roktsdk.Rokt

public class LauncherActivity: Activity {
    override fun onCreate(savedInstanceState: Bundle"?") {
        ...
        // Ce qui suit révélera une intégration de démonstration. Pour voir votre intégration :
        // 1) Remplacez l'ID de tag de test d'intégration (222) par votre ID de tag Rokt unique
        // 2) Remplacez Y.Y.Y par la version de l'application
        Rokt.init("222", "Y.Y.Y", this@LauncherActivity)
        ...
    }
}

Kotlin

import com.rokt.roktsdk.Rokt;

public class LauncherActivity extends Activity {
    override fun onCreate(savedInstanceState: Bundle"?") {
        ...
        // Ce qui suit révélera une intégration de démonstration. Pour voir votre intégration :
        // 1) Remplacez l'ID de balise de test d'intégration (222) par votre ID de balise Rokt unique
        // 2) Remplacez Y.Y.Y par la version de l'application
        Rokt.INSTANCE.init("222", "Y.Y.Y", LauncherActivity.this)
        ...
    }
}