Pređi na glavni sadržaj

Prvi koraci - Android

OptSens SDK je jedna Gradle zavisnost. Dodajte je, pozovite OptSens.configure sa svojim SDK ID-jem i prikažite baner. Isti SDK radi na telefonu, tabletu, Android TV-u i Fire TV-u.

Zahtevi

  • SDK je dostupan na Pro, Business i Custom planovima.
  • Android 5.0 (API nivo 21) ili noviji.
  • SDK sam deklariše INTERNET dozvolu. Za telefon ili tablet ne dodajete ništa u svoj manifest.

Preuzmite svoj SDK ID

  1. U svojoj OptSens kontrolnoj tabli kliknite na Dodaj domen u gornjoj navigaciji i dodajte svoju aplikaciju. Pogledajte Dodajte svoju aplikaciju za ceo tok (izbor platforme, unos identifikatora aplikacije, izbor plana).
  2. Prođite kroz vođeno podešavanje. U koraku Integracija kopirajte svoj SDK ID. Dostupan je i na stranici Integracija u kontrolnoj tabli u svakom trenutku.

Dodajte SDK

SDK je objavljen na Maven Central-u. Dodajte Maven Central u svoje repozitorijume:

// settings.gradle.kts
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
}
}

Dodajte zavisnost u modul svoje aplikacije. Ona za vas povlači i mehanizam za saglasnost:

// app/build.gradle.kts
dependencies {
implementation("com.optsens:optsens-ui:1.0.0")
}

Inicijalizujte OptSens

Pozovite OptSens.configure jednom, rano u aktivnosti, sa svojim SDK ID-jem. Prikažite baner kada posetilac još treba da odluči i postavite plutajuće dugme da kasnije može ponovo da otvori svoj izbor:

import com.optsens.sdk.core.OptSens
import com.optsens.sdk.ui.OptSensBanner
import com.optsens.sdk.ui.OptSensWidget

OptSens.configure(this, "YOUR_SDK_ID") { result ->
result.onSuccess { status ->
if (status.shouldCollectConsent) {
OptSensBanner.showFirstLayer(this)
}
OptSensWidget.attach(this)
}
}

configure preuzima konfiguraciju banera, utvrđuje region posetioca i upisuje ključeve saglasnosti na uređaj. Nije potrebna Application klasa. Za razliku od veba, plutajuće dugme se ne dodaje samo: OptSensWidget.attach ga postavlja (pogledajte Plutajuće dugme).

Android TV i Fire TV

Isti SDK radi na Android TV-u i Fire TV-u. Da bi se jedan build instalirao i na telefon i na TV, označite dodirni ekran kao opcioni i deklarišite leanback podršku u svom manifestu:

<uses-feature android:name="android.hardware.touchscreen" android:required="false" />
<uses-feature android:name="android.software.leanback" android:required="false" />

SDK prepoznaje televizor u toku rada i prikazuje baner za velike ekrane sa navigacijom daljinskim upravljačem. Detalje potražite u odeljku Televizori.

Nakon integracije

  1. Pokrenite aplikaciju. Baner se prikazuje pri prvom pokretanju kada je saglasnost potrebna.
  2. Potvrdite integraciju iz koraka Provera aplikacije u kontrolnoj tabli.
  3. Kontrolišite sopstveni analitički i oglasni kod pomoću OptSens.hasConsent i prosledite saglasnost Google-u i svojim partnerima.

Dalje: Prikazivanje banera.