Konfigurowanie zbierania i wykorzystywania danych przez Analytics

Wybierz platformę: iOS+ Android


Na tej stronie opisujemy funkcje Google Analytics, które pozwalają Ci kontrolować zbieranie i wykorzystywanie danych Analytics.

Wyłączanie Analytics zbierania danych

W niektórych przypadkach możesz chcieć tymczasowo lub na stałe wyłączyć zbieranie danych Analytics, np. aby uzyskać zgodę użytkowników lub spełnić obowiązki prawne. Google Analytics oferuje kilka opcji wyłączania i dezaktywowania zbierania danych Analytics. Razem obsługują wiele typowych zastosowań.

Tymczasowe wyłączenie zbierania

Jeśli chcesz tymczasowo wyłączyć zbieranie danych Analytics, np. aby uzyskać zgodę użytkownika przed rozpoczęciem zbierania danych, możesz ustawić wartość FIREBASE_ANALYTICS_COLLECTION_ENABLED na NO (wartość logiczna) w pliku Info.plist aplikacji. Na przykład w źródłowym pliku XML:

<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key><false/>

Aby ponownie włączyć zbieranie danych, np. po wyrażeniu zgody przez użytkownika, wywołaj metodę instancji setAnalyticsCollectionEnabledAnalytics. Przykład:

Swift

Uwaga: ta usługa Firebase nie jest dostępna na platformie watchOS.
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

Uwaga: ta usługa Firebase nie jest dostępna na platformie watchOS.
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

Jeśli z jakiegokolwiek powodu musisz ponownie wstrzymać zbieranie danych, możesz zadzwonić pod numer podany poniżej. Zbieranie danych zostanie wstrzymane do momentu ponownego włączenia tej funkcji.

Swift

Uwaga: ta usługa Firebase nie jest dostępna na platformie watchOS.
Analytics.setAnalyticsCollectionEnabled(false)

Objective-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);

Wartość ustawiona przez metodę setAnalyticsCollectionEnabled jest zachowywana w różnych uruchomieniach aplikacji i zastępuje wartość parametru FIREBASE_ANALYTICS_COLLECTION_ENABLED w pliku Info.plist aplikacji. Gdy ustawisz wartość parametru setAnalyticsCollectionEnabled, zbieranie danych przez Analytics pozostanie w tym stanie do momentu ponownego wywołania parametru setAnalyticsCollectionEnabled, nawet jeśli użytkownik zamknie i ponownie otworzy aplikację.

Trwałe wyłączenie zbierania

Jeśli chcesz trwale wyłączyć zbieranie danych w Analytics w danej wersji aplikacji, ustaw w pliku Info.plist aplikacji wartość FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED na YES (wartość logiczna). Ustawienie FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED na wartość YES (logiczną) ma wyższy priorytet niż wszystkie wartości parametru FIREBASE_ANALYTICS_COLLECTION_ENABLED w pliku Info.plist aplikacji, a także wszystkie wartości ustawione za pomocą parametru setAnalyticsCollectionEnabled.

Aby ponownie włączyć zbieranie danych, usuń symbol FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED z Info.plist. Ustawienie wartości FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED na NO (wartość logiczna) nie ma wpływu i działa tak samo, jak gdyby w pliku Info.plist nie było ustawienia FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED.

Wyłączanie zbierania identyfikatora IDFA

Jeśli moduł FirebaseAnalytics został zainstalowany w aplikacji za pomocą SPM lub CocoaPods i chcesz wyłączyć zbieranie identyfikatora IDFA (identyfikatora reklamowego urządzenia) w aplikacji na urządzenia Apple, upewnij się, że w aplikacji nie ma platformy AdSupport.

Aby zainstalować Firebase bez możliwości zbierania identyfikatorów IDFA, użyj tego kodu zamiast zależności FirebaseAnalytics:

Swift Package Manager

  .target(
    name: "MyTargetName",
    dependencies: [
      .product(name: "FirebaseAnalyticsCore", package: "Firebase"),
      // ...
    ]
  ),

CocoaPods

pod 'FirebaseAnalytics/Core'

Więcej informacji o IDFA znajdziesz w dokumentacji Apple:

Wyłączanie zbierania identyfikatora IDFV

Jeśli chcesz wyłączyć zbieranie identyfikatora IDFV (Identifier for Vendor) w aplikacji na iOS, ustaw wartość GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED na NO (Boolean) w pliku Info.plist aplikacji.

Kontrolowanie zbierania danych na potrzeby reklam spersonalizowanych

Jeśli Google Analyticspołączysz projekt z kontem reklamowym lub w inny sposób włączysz integrację z reklamami albo wyrazisz zgodę na udostępnianie danych, Twoje dane Analytics mogą być wykorzystywane w reklamach spersonalizowanych. Oznacza to na przykład, że możesz używać zebranych zdarzeń, takich jak first_open, do tworzenia i wdrażania list odbiorców na potrzeby remarketingu, chyba że wskażesz, że takie dane nie są dostępne na potrzeby reklam spersonalizowanych.

Za pomocą jednej z tych opcji możesz programowo określać, czy dane Analytics użytkownika mają być używane do reklam spersonalizowanych:

Wyłączanie funkcji reklam spersonalizowanych za pomocą właściwości użytkownika

Interfejs API trybu uzyskiwania zgody Google to zalecany sposób włączania i wyłączania reklam spersonalizowanych.

Jeśli jednak Twoja aplikacja nie korzysta jeszcze z trybu uzyskiwania zgody, możesz kontrolować personalizację za pomocą tej opcji.

Aby domyślnie wyłączyć personalizację reklam, ustaw w pliku Info.plist aplikacji wartość GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS na NO (wartość logiczna).

Ponowne włączanie funkcji reklam spersonalizowanych za pomocą właściwości użytkownika

Jeśli do kontrolowania personalizacji reklam używasz parametru AnalyticsUserPropertyAllowAdPersonalizationSignals, możesz ponownie włączyć personalizację reklam za pomocą metody setUserProperty, jak pokazano poniżej:

Swift

Uwaga: ta usługa Firebase nie jest dostępna na platformie watchOS.
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

Objective-C

Uwaga: ta usługa Firebase nie jest dostępna na platformie watchOS.
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);

Jeśli zdecydujesz się tymczasowo wyłączyć zbieranie danych analitycznych (np. do czasu, aż użytkownik wyrazi zgodę) i chcesz kontrolować funkcje reklam spersonalizowanych po ponownym włączeniu zbierania danych analitycznych dla użytkownika, upewnij się, że wywołanie określające to ustawienie poprzedza wywołanie ponownego włączenia zbierania danych analitycznych. Przykład:

Swift

Uwaga: ta usługa Firebase nie jest dostępna na platformie watchOS.
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

Uwaga: ta usługa Firebase nie jest dostępna na platformie watchOS.
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, ...);
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

Potwierdź ustawienia

Gdy sygnały personalizacji reklam zostaną wyłączone w przypadku użytkownika za pomocą jednego z mechanizmów opisanych powyżej, kolejne pakiety zdarzeń rejestrowane na urządzeniu tego użytkownika będą zawierać właściwość użytkownika o nazwie non_personalized_ads i wartości 1, co oznacza, że zdarzenia w tym pakiecie nie są dostępne na potrzeby reklam spersonalizowanych. Wyłączenie reklam spersonalizowanych nie wpływa na wykorzystywanie danych do celów pomiarowych, w tym do raportowania i atrybucji.

Wyświetlanie zmian w konfiguracji

Po wprowadzeniu zmian w ustawieniach Google Analytics pakiet SDK pobierze te zmiany. Proces jest szybki i bezproblemowy, dzięki czemu możesz szybko przetestować zmiany. Wprowadzenie zmian w Analytics może potrwać kilka minut. Jeśli aplikacja jest aktywna, pełny proces wdrażania może zająć do godziny.