Initialiser le SDK Android
Les partenaires de Rokt peuvent utiliser le SDK Android pour afficher des emplacements superposés 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é à l'aide de Maven et Gradle.
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. En gros, ces étapes sont les suivantes :
- Configurer un espace de travail et activer le référentiel Gradle de Rokt
- Ajouter le plugin Rokt Placement
- Ajouter le module SDK Android de Rokt
- 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.
Avant de commencer
Ce guide suppose que vous êtes familier avec Gradle et savez comment installer un plugin pour le développement Android.
Configuration du SDK Android
- Configurez un espace de travail et activez le dépôt Gradle Rokt. Pour configurer un dépôt, suivez les instructions de Gradle.
- 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 supérieur, où les paramètres du dépôt qui étaient auparavant dans le fichier build.gradle de niveau supérieur sont 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"
}
}
}
- Ajoutez le module Rokt Android SDK à
build.gradle
pour le module.
// fichier => build.gradle (Module : ...)
dependencies {
...
// Remarque : 3.15.5 reflète la dernière version du Rokt Android SDK.
implementation 'com.rokt:roktsdk:3.15.5'
...
}
- Initialisez le SDK Rokt avant de l'utiliser dans une activité. Nous vous recommandons d'appeler la méthode
init
depuis la classeLauncherActivity
.
Contactez Rokt pour obtenir l'identifiant de compte Rokt associé à votre compte. Pour tester votre intégration, vous pouvez utiliser l'identifiant de compte Rokt ci-dessous, mais vous devez le remplacer par votre identifiant de compte Rokt unique avant de le lancer en production.
Identifiant de compte de test : 222
- Java
- Kotlin
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 afficher votre intégration :
// 1) Remplacez l'identifiant de tag d'intégration de test (222) par votre identifiant de tag Rokt unique
// 2) Remplacez Y.Y.Y par la version de l'application
Rokt.init("222", "Y.Y.Y", this@LauncherActivity)
...
}
}
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 afficher votre intégration :
// 1) Remplacez l'identifiant de tag d'intégration de test (222) par votre identifiant de tag Rokt unique
// 2) Remplacez Y.Y.Y par la version de l'application
Rokt.INSTANCE.init("222", "Y.Y.Y", LauncherActivity.this)
...
}
}
Étapes suivantes
Les étapes suivantes dépendent de votre cas d'utilisation pour l'intégration. Consultez ces sujets pour en savoir plus :