Digiteka Outstream est un SDK à intégrer dans des applications Android. Il permet d'intégrer une vidéo publicitaire n'importe où dans les vues mobiles, sans être restreint au contenu des articles.
Note: Il s'agit d'une procédure tant que le SDK n'est pas déployé sur un repo privé.
Intégrer l'AAR du SDK au projet Android.
1/ Ajouter ces lignes dans le build.gradle racine de l'application :
buildscript {
ext.kotlin_version = "1.4.32"
[...]
dependencies {
[...]
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
[...]
}
}
allprojects {
repositories {
[...]
flatDir {
dirs 'libs'
}
maven { url 'https://jitpack.io' }
}
}
2/ Ajouter ces lignes dans le build.gradle du module :
android {
[...]
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
dependencies {
[...]
// SDK
implementation 'com.github.digiteka.outstream-android-sdk:sdk:1.1'
// Required by Outstream SDK
implementation 'com.google.android.material:material:1.3.0'
implementation 'androidx.constraintlayout:constraintlayout:2.0.4'
implementation 'androidx.preference:preference:1.1.1'
implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
[...]
}
3/ Ajouter cette permission dans le manifest :
<uses-permission android:name="android.permission.INTERNET" />
Digiteka Outstream doit être instancié dans la classe Application d'un projet.
Elle est instanciée en fournissant une DTKConfig à la méthode init(), avec :
Digiteka.init(
this, Digiteka.DTKConfig(
"<Votre baseUrl>",
"<Votre mdtk>"
)
)
La OutstreamView peut être directement ajoutée dans les vues XML de l'application.
<com.digiteka.oustream.OutstreamView
android:id="@+id/myAd"
android:layout_width="match_parent"
android:layout_height="wrap_content" />
Pour initialiser la OustreamView, l'intégrateur devra appeler la méthode initConfig() de la vue, en lui passant la configuration suivante :
onClose() de la pub pour y associer des actions propres à l'application,Exemple en Kotlin :
val outstreamListener = object : OutstreamView.OutstreamViewListener {
override fun onClose() {
Toast.makeText(this@MainActivity, "OutstreamView closed", Toast.LENGTH_LONG).show();
}
}
val outstreamConfig = OutstreamView.OutstreamViewConfig(
"<Votre URL Referrer>",
<Votre Zone>,
outstreamViewListener = outstreamListener,
"<Votre adUnit (optionnel)>"
)
// Initialisation de la config
myAd.initConfig(outstreamConfig)
Le chargement de la pub dans le composant sera déclenché par l'intégrateur, via la méthode load().
// Chargement de la pub
myAd.load()
La consent string peut être mise à jour de façon forcée par l'intégrateur en la passant directement au SDK :
Digiteka.getInstance().config.consentString =
"CO9E0YNO9Yz7EAHABAFRA0CsAP_AAH_AAAAAGYtf_X9fb2vj-_5999t0eY1f9_63v-wzjgeNs-8NyZ_X_L4Xr2MyvB34pq4KmR4Eu3LBAQdlHGHcTQmQwIkVqTLsak2Mq7NKJ7JEilMbM2dYGG1vn8XTuZCY70_sf__z_3-_-___67YGXkEmGpfAQJCWMBJNmlUKIEIVxIVAOACihGFo0sNCRwU7K4CPUACABAYgIwIgQYgoxZBAAAAAElEQAkAwIBEARAIAAQArQEIACJAEFgBIGAQACoGhYARRBKBIQZHBUcogQFSLRQTzRgAA"