Konfigurowanie trybu uzyskiwania zgody w aplikacjach

Ta strona jest przeznaczona dla deweloperów, którzy używają w swojej aplikacji pakietu SDK Google Analytics dla Firebase i chcą zintegrować tryb uzyskiwania zgody. Wprowadzenie do trybu uzyskiwania zgody znajdziesz w omówieniu trybu uzyskiwania zgody.

Google Analytics udostępnia tryb uzyskiwania zgody, który pozwala dostosowywać działanie pakietu SDK na podstawie stanu zgody użytkowników. Tryb uzyskiwania zgody możesz wdrożyć w sposób podstawowy lub zaawansowany. Jeśli nie wiesz, czy wdrożyć podstawowy czy zaawansowany tryb uzyskiwania zgody, dowiedz się więcej o podstawowym i zaawansowanym trybie uzyskiwania zgody i zapoznaj się z wytycznymi obowiązującymi w Twojej firmie.

Zanim zaczniesz

Aby zarządzać zgodą użytkowników, musisz zaimplementować:

  • Pakiet SDK Google Analytics dla Firebase

  • Baner z ustawieniami uzyskiwania zgody użytkowników na przetwarzanie danych

Aby skonfigurować tryb uzyskiwania zgody:

  1. Ustaw domyślny stan zgody użytkownika.

Domyślnie nie są ustawione żadne wartości trybu uzyskiwania zgody. Aby ustawić domyślny stan zgody użytkownika w aplikacji:

  1. Otwórz plik AndroidManifest.xml aplikacji.

  2. Dodaj pary klucz-wartość trybu uzyskiwania zgody. Klucz opisuje typ zgody, a wartość wskazuje stan zgody. Wartościami mogą być true, co oznacza, że użytkownik wyraził zgodę, lub false, co oznacza, że użytkownik nie wyraził zgody. Ustaw te opcje:

    • google_analytics_default_allow_analytics_storage
    • google_analytics_default_allow_ad_storage
    • google_analytics_default_allow_ad_user_data
    • google_analytics_default_allow_ad_personalization_signals

  3. Zapisz zmiany. Następnie zaimplementuj mechanizm aktualizowania wartości dotyczących zgody użytkownika.

Aby na przykład skonfigurować domyślnie wszystkie prośby o zgodę na przetwarzanie danych dotyczące wszystkich parametrów:

<meta-data android:name="google_analytics_default_allow_analytics_storage" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_storage" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_user_data" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_personalization_signals" android:value="true" />

Aby zaktualizować wartości zgody po uruchomieniu aplikacji, wywołaj metodę setConsent.

Wartość ustawiona przez metodę setConsent zastępuje ustawienie domyślne i jest stosowana przez wszystkie uruchomienia aplikacji. Wartość pozostaje w tym stanie do chwili ponownego wywołania funkcji setConsent, nawet jeśli użytkownik zamknie i ponownie otworzy aplikację. setConsent aktualizuje tylko określone przez Ciebie parametry.

Jeśli użytkownik wycofa wcześniej udzielone zgody na korzystanie z Analytics lub przechowywania danych w Google Ads, Google Analytics usunie wszystkie właściwości użytkownika, w tym zgodę na przetwarzanie danych ad_personalization. Aby zachować wybór użytkownika dotyczący zgody użytkownika na personalizację reklam, przywróć poprzednią wartość na potrzeby personalizacji reklam za pomocą polecenia setConsent (Kotlin+KTX | Java) .

Poniższy przykład pokazuje, jak metoda setConsent aktualizuje różne wartości zgody na granted:

Java

// Set consent types.
Map<ConsentType, ConsentStatus> consentMap = new EnumMap<>(ConsentType.class);
consentMap.put(ConsentType.ANALYTICS_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_USER_DATA, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_PERSONALIZATION, ConsentStatus.GRANTED);

mFirebaseAnalytics.setConsent(consentMap);

Kotlin

Firebase.analytics.setConsent {
  analyticsStorage(ConsentStatus.GRANTED)
  adStorage(ConsentStatus.GRANTED)
  adUserData(ConsentStatus.GRANTED)
  adPersonalization(ConsentStatus.GRANTED)
}