ConsentManager SDK RODO/CCPA dla Android TV
Połączenia ConsentManager SDK dla Android TV aplikacje wdrażają i zapewniają funkcjonalność informowania użytkownika o ochronie danych oraz pytania i zbierania zgody od użytkownika. Umożliwia programistom aplikacji łatwą integrację ConsentManager do swojej aplikacji Android TV.
Obsługiwane standardy
Połączenia ConsentManager SDK RODO/CCPA dla Android TV obsługuje następujące standardy branżowe:
- IAB TCF v1
- IAB TCF v2
- IAB USPrywatność v1
- ConsentManager niestandardowi dostawcy/cele
- Tryb dodatkowej zgody Google (ciąg Google AC)
Jak to działa?
- Zintegruj SDK z aplikacją i skonfiguruj ustawienia SDK
- Gdy SDK zostanie zintegrowany z aplikacją, SDK udostępni funkcje dla programisty aplikacji w celu pobrania danych dotyczących zgody
- Gdy tylko aplikacja się uruchomi, SDK automatycznie pobierze informacje z ConsentManager serwery w celu przygotowania SDK do jego użycia.
- Zaleca się, aby przy starcie aplikacji tworzyła instancję klasy
CMPConsentTool. Po utworzeniu SDK automatycznie wyświetli ekran zgody, jeśli to konieczne. - Gdy aplikacja chce przetwarzać dane osobowe, powinna „zapytać” SDK, czy została wyrażona zgoda na konkretny cel i dostawcę.
Instalacja
Gradle
Krok 1. Dodaj repozytorium jitpack do głównego pliku build.gradle na końcu repozytoriów:
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}Krok 2. Dodaj zależność do swoich aplikacji build.gradle
dependencies {
implementation 'org.bitbucket.consentmanager:android-tv-consentmanager:1.0.0'
}Maven
Krok 1. Dodaj repozytorium jitpack do swojego build.gradle na końcu repozytoriów:
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>Krok 2. Dodaj zależność do swoich aplikacji build.gradle
<dependency>
<groupId>org.bitbucket.consentmanager</groupId>
<artifactId>android-tv-consentmanager</artifactId>
<version>1.0.0</version>
</dependency>Korzystanie z biblioteki
Uprawnienia
Ten pakiet SDK wymaga następujących uprawnień, upewnij się, że dodałeś je do pliku AndroidManifest.xml:
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />Zainicjuj narzędzie zgody
Za pomocą aplikacji startowej (zazwyczaj funkcji viewDidAppear) musisz utworzyć instancję klasy CMPConsentTool. Spowoduje to automatyczne pobranie niezbędnych danych z naszego serwera i określenie, czy ekran akceptacji ma być wyświetlany, czy nie. Jeśli tak, SDK automatycznie wyświetli w tym momencie ekran zgody, zbierze dane i przekaże je do aplikacji. Instancję można następnie wykorzystać w celu uzyskania szczegółów zgody z SDK w celu wykorzystania jej w aplikacji.
Aby zainicjować ConsentTool, przejdź do wybranej klasy i utwórz instancję CMPConsentTool, jak pokazano poniżej:
//...
import net.consentmanager.tvsdk.CMPConsentTool;
//...
public class MainActivity extends AppCompatActivity {
private CMPConsentTool consentTool;
//...
@Override
protected void onCreate(Bundle savedInstanceState) {
//..
consentTool = CMPConsentTool.createInstance(this, 123456, "consentmanager.mgr.consensu.org", "MyFavouriteApp", "");
//.. You can also instantiate the consentmanager with the advertisement id:
// consentTool = CMPConsentTool.createWIthIDFA(this,123456,"www.consentmanager.mgr.consensu.org", "myFavouriteApp", "EN", "38400000-8cf0-11bd-b23e-10b96e40000d");
}
//...
}
Aby utworzyć instancję CMPConsentTool, musisz skonfigurować instancję. Musisz podać CMP-ID, domenę serwera , nazwę aplikacji i język. CMP-ID i domenę serwera można znaleźć w swoim ConsentManager konto pod Menu > Pobierz kod. Nazwy aplikacji można użyć do rozróżnienia różnych aplikacji w ConsentManager raportowanie. Jako język możesz użyć pustego ciągu ("") do automatycznego wykrywania lub dwuliterowego kodu języka ("EN", "DE", "FR" itd.).
Wartości konfiguracyjne można wstawiać na różne sposoby:
a) Konfiguracja SDK poprzez Manifest
Dodaj następujące wiersze do pliku AndroidManifest.xml w sekcji <application ...> ... </application>:
<meta-data android:name="com.consentmanager.sdk.ID" android:value="1234567" />
<meta-data android:name="com.consentmanager.sdk.SERVER_DOMAIN" android:value="consentmanager.mgr.consensu.org" />
<meta-data android:name="com.consentmanager.sdk.APP_NAME" android:value="MyFavouriteApp" />
<meta-data android:name="com.consentmanager.sdk.LANGUAGE" android:value="EN" />Jeśli używasz tego sposobu konfiguracji, utwórz instancję CMPConsentTool przez:
consentTool = CMPConsentTool.createInstance(this);b) Konfiguracja SDK przez CMPConfig
Dodaj następujące wiersze do swojego kodu:
CMPConfig conf = CMPConfig.createInstance(1234567, "consentmanager.mgr.consensu.org", "MyFavouriteApp", "EN");
consentTool = CMPConsentTool.createInstance(this, conf);c) Konfiguracja SDK przez createInstance()
Dodaj następujący wiersz do swojego kodu:
consentTool = CMPConsentTool.createInstance(this, 1234567, "consentmanager.mgr.consensu.org", "MyFavouriteApp", "EN");Korzystanie z SDK
Zobacz przykłady dla Android SDK.
