Konfigurowanie zbierania i wykorzystywania danych przez Analytics

Na tej stronie opisujemy funkcje, które Google Analytics udostępnia, aby umożliwić Ci kontrolowanie zbierania i wykorzystywania danych Analytics.

Wyłącz zbieranie danych Analytics

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

Tymczasowe wyłączenie zbierania danych

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 setAnalyticsCollectionEnabled klasy Analytics. Przykład:

Analytics.setAnalyticsCollectionEnabled(true)

[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

Jeśli z jakiegoś powodu musisz ponownie zawiesić zbieranie danych, możesz wywołać tę metodę, a zbieranie danych zostanie zawieszone do momentu ponownego włączenia.

Analytics.setAnalyticsCollectionEnabled(false)

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);

Wartość ustawiona przez metodę setAnalyticsCollectionEnabled jest zachowywana między uruchomieniami aplikacji i zastępuje wartość FIREBASE_ANALYTICS_COLLECTION_ENABLED w pliku Info.plist aplikacji. Gdy ustawisz wartość dla setAnalyticsCollectionEnabled, zbieranie danych przez Analytics pozostanie w tym stanie, dopóki nie zostanie ponownie wywołana funkcja setAnalyticsCollectionEnabled, nawet jeśli użytkownik zamknie i ponownie otworzy aplikację.

Trwałe dezaktywowanie kolekcji

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

Aby ponownie włączyć zbieranie danych, usuń FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED z Info.plist. Ustawienie FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED na NO (wartość logiczna) nie ma żadnego wpływu i powoduje takie samo działanie jak brak ustawienia FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED w pliku Info.plist.

Wyłączanie zbierania identyfikatorów IDFA

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

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

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

pod 'FirebaseAnalytics/Core'

Więcej informacji o IDFA znajdziesz w dokumentacji Apple:

• Prywatność użytkownika i wykorzystanie danych
• Zasady App Tracking Transparency

Wyłączanie zbierania identyfikatorów IDFV

Jeśli chcesz wyłączyć zbieranie identyfikatora IDFV (identyfikatora dostawcy) w aplikacji Apple, ustaw wartość GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED na NO (wartość logiczna) w pliku Info.plist aplikacji.

Kontrolowanie zbierania danych na potrzeby reklam spersonalizowanych

Jeśli masz projekt Google Analytics połączony z kontem reklamowym lub w inny sposób masz włączoną integrację z reklamami albo korzystasz z udostępniania danych, Twoje dane Analytics mogą być używane do reklam 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 do reklam spersonalizowanych.

Możesz programowo określać, czy dane Analytics użytkownika mają być używane do reklam spersonalizowanych, korzystając z tych opcji:

• Zalecane: dynamicznie włączaj lub wyłączaj personalizację reklam, uwzględniając wybór użytkownika dotyczący zgody. Zaimplementuj interfejs API trybu uzyskiwania zgody Google.

• Włączanie i wyłączanie personalizacji reklam na poziomie użytkownika: Zarządzanie personalizacją reklam jako właściwością użytkownika.

• Włącz lub wyłącz personalizację reklam na poziomie usługi w Analytics: Wyłączanie personalizacji reklam według regionu geograficznego w usłudze w Analytics.

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

Zalecanym sposobem włączania i wyłączania reklam spersonalizowanych jest interfejs API trybu uzyskiwania zgody Google.

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ć zachowanie reklam spersonalizowanych, ustaw wartość GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS na NO (wartość logiczna) w pliku Info.plist aplikacji.

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:

Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

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, upewnij się, że wywołanie określające to ustawienie poprzedza wywołanie ponownego włączenia zbierania danych analitycznych. Przykład:

Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

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

Potwierdź ustawienia

Gdy sygnały personalizacji reklam zostaną wyłączone dla użytkownika za pomocą jednego z mechanizmów opisanych powyżej, kolejne pakiety zdarzeń zarejestrowane 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 personalizacji reklam. Wyłączenie reklam spersonalizowanych nie wpływa na wykorzystanie danych do celów pomiarowych, w tym do raportowania i atrybucji.

Wyświetlanie zmian w konfiguracji

Gdy wprowadzisz zmiany w ustawieniach Google Analytics, pakiet SDK je pobierze. Proces jest szybki i bezproblemowy, dzięki czemu możesz szybko przetestować zmiany. Gdy wprowadzisz zmiany w usłudze Analytics, ich wdrożenie w aplikacji może potrwać kilka minut. Jeśli aplikacja jest już opublikowana, pełne wdrożenie może potrwać do godziny.