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
Konfigurowanie trybu uzyskiwania zgody
Aby skonfigurować tryb uzyskiwania zgody:
- Zanim użytkownik udzieli zgody: tymczasowo wyłącz zbieranie danych przez Analytics.
- Ustaw domyślny stan zgody użytkownika.
- Zaktualizuj stan zgody użytkownika na podstawie interakcji użytkownika z Twoimi ustawieniami uzyskiwania zgody.
- Ponownie włącz zbieranie danych przez Analytics.
Tymczasowe wyłączenie zbierania danych przez Analytics
Podstawowa implementacja trybu uzyskiwania zgody oznacza zablokowanie wczytywania pakietu SDK Google Analytics dla Firebase do czasu udzielenia zgody przez użytkownika.
Aby tymczasowo wyłączyć gromadzenie danych przez Analytics, ustaw wartośćFIREBASE_ANALYTICS_COLLECTION_ENABLED
na false
(wartość logiczna) w pliku Info.plist
aplikacji. Na przykład wyświetlany w źródłowym pliku XML:
<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key><false/>
Ustawianie domyślnego stanu zgody użytkownika
Domyślnie nie są ustawione żadne wartości trybu uzyskiwania zgody. Aby ustawić domyślny stan zgody użytkownika w aplikacji:
- Otwórz plik info.plist aplikacji.
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ę, lubfalse
, 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
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:
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>
Ponownie włącz zbieranie danych w Analytics
Gdy użytkownik udzieli zgody, ponownie włącz zbieranie danych w Analytics za pomocą metody instancji setAnalyticsCollectionEnabled()
.
Wartość ustawiona przez metodę setAnalyticsCollectionEnabled
pozostaje bez zmian po wszystkich uruchomieniach aplikacji i zastępuje wartość firebase_analytics_collection_enabled
w pliku Info.plist
aplikacji. Gdy ustawisz wartość setAnalyticsCollectionEnabled
, kolekcja Analytics pozostanie w tym stanie do momentu ponownego wywołania setAnalyticsCollectionEnabled
, nawet jeśli użytkownik zamknie i ponownie otworzy Twoją aplikację.
Aby zaktualizować kolekcję Analytics:
Swift
swift
Analytics.setAnalyticsCollectionEnabled(true)
Objective-C
obj-c
[FIRAnalytics setAnalyticsCollectionEnabled:YES];
Zaktualizuj zgodę użytkownika
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ą poleceniasetConsent
(Swift | Obj-C) .
Poniższy przykład pokazuje, jak metoda setConsent
aktualizuje różne wartości zgody na granted
:
Swift
Analytics.setConsent([
.analyticsStorage: .granted,
.adStorage: .granted,
.adUserData: .granted,
.adPersonalization: .granted,
])
Objective-C
[FIRAnalytics setConsent:@{
FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
FIRConsentTypeAdStorage : FIRConsentStatusGranted,
FIRConsentTypeAdUserData : FIRConsentStatusGranted,
FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];
Jeśli użytkownik zdecyduje się cofnąć swoją zgodę, zaktualizuj odpowiednio stany zgody
i ponownie wyłącz zbieranie danych przez Analytics za pomocą metody setAnalyticsCollectionEnabled()
.
Przejdź na tryb uzyskiwania zgody (wersja 2)
W ramach stałego budowania ekosystemu reklamy cyfrowej zapewniającego ochronę prywatności zaostrzamy egzekwowanie polityki w zakresie zgody użytkownika z UE.
Dowiedz się więcej o aktualizacjach trybu uzyskiwania zgody w przypadku ruchu w Europejskim Obszarze Gospodarczym (EOG).
Oprócz przechowywania reklam i danych analitycznych użytkownicy trybu uzyskiwania zgody muszą wysyłać 2 nowe parametry:
Zaktualizuj plik info.plist aplikacji, aby zawierał:
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/> <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>
Zaktualizuj wywołania związane z prośbą o zgodę na wykorzystanie danych, aby zawierały parametry danych użytkowników reklam i personalizacji reklam:
Swift
Analytics.setConsent([ .analyticsStorage: .granted, .adStorage: .granted, .adUserData: .granted, .adPersonalization: .granted, ])
Objective-C
[FIRAnalytics setConsent:@{ FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted, FIRConsentTypeAdStorage : FIRConsentStatusGranted, FIRConsentTypeAdUserData : FIRConsentStatusGranted, FIRConsentTypeAdPersonalization : FIRConsentStatusGranted, }];
Weryfikacja ustawień dotyczących wyrażania zgody
Aby sprawdzić, czy ustawienia dotyczące uzyskiwania zgody działają zgodnie z oczekiwaniami, wyświetl konsolę debugowania Xcode swojej aplikacji.
Aby to zrobić:
- Włącz szczegółowe logowanie na urządzeniu.
W konsoli debugowania Xcode odszukaj:
ad_storage
analytics_storage
ad_user_data
ad_personalization
Jeśli na przykład włączono Pamięć reklam, zobaczysz taki komunikat:
ad_storage is granted.