Questa pagina descrive le funzionalità offerte da Google Analytics che ti consentono di controllare la raccolta e l'utilizzo dei dati di Analytics.
Disattivare la raccolta dei dati Analytics
In alcuni casi, potresti voler disattivare temporaneamente o definitivamente la raccolta dei dati Analytics, ad esempio per raccogliere il consenso dell'utente finale o per adempiere agli obblighi di legge. Google Analytics offre diverse opzioni per disattivare e disabilitare la raccolta di Analytics. Utilizzati insieme, supportano molti casi d'uso tipici.
Disattivare temporaneamente la raccolta
Se vuoi disattivare temporaneamente la raccolta di Analytics, ad esempio per ottenere il consenso dell'utente finale prima di raccogliere i dati, puoi impostare il valore di FIREBASE_ANALYTICS_COLLECTION_ENABLED su NO (booleano) nel file Info.plist della tua app. Ad esempio, visualizzato nell'XML di origine:
<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key><false/>
Per riattivare la raccolta, ad esempio dopo che un utente finale ha fornito il consenso, chiama il metodo dell'istanza setAnalyticsCollectionEnabled di Analytics. Ad esempio:
Swift
Analytics.setAnalyticsCollectionEnabled(true)
Objective-C
[FIRAnalytics setAnalyticsCollectionEnabled:YES];
Unity
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);
Se per qualsiasi motivo devi sospendere nuovamente la raccolta, puoi chiamare il seguente numero e la raccolta verrà sospesa finché non la riattiverai.
Swift
Analytics.setAnalyticsCollectionEnabled(false)
Objective-C
[FIRAnalytics setAnalyticsCollectionEnabled:NO];
Unity
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);
Il valore impostato dal metodo setAnalyticsCollectionEnabled viene mantenuto durante le esecuzioni dell'app e sostituisce il valore di FIREBASE_ANALYTICS_COLLECTION_ENABLED nel file Info.plist dell'app. Una volta impostato un valore per
setAnalyticsCollectionEnabled, la raccolta di Analytics rimane in questo stato
finché non viene chiamato di nuovo setAnalyticsCollectionEnabled, anche se un utente chiude
e riapre l'app.
Disattivare definitivamente la raccolta
Se devi disattivare definitivamente la raccolta di Analytics in una versione della tua app, imposta FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED su YES (booleano) nel file Info.plist della tua app. L'impostazione di FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED su
YES (booleano) ha la priorità su qualsiasi valore per
FIREBASE_ANALYTICS_COLLECTION_ENABLED in Info.plist della tua app, nonché su qualsiasi
valore impostato con setAnalyticsCollectionEnabled.
Per riattivare la raccolta, rimuovi FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED dal tuo Info.plist. L'impostazione di FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED su NO
(booleano) non ha effetto e comporta lo stesso comportamento
dell'assenza di FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED nel file Info.plist.
Disattivare la raccolta dell'IDFA
Se hai installato Firebase tramite CocoaPods aggiungendo pod 'FirebaseAnalytics'
al Podfile della tua app e vuoi disattivare la raccolta dell'IDFA (l'identificatore pubblicità
di un dispositivo) nella tua app Apple, assicurati che il framework AdSupport
non sia incluso nella tua app.
Per installare Firebase senza alcuna funzionalità di raccolta IDFA, utilizza la seguente
sottospecifica al posto di pod 'FirebaseAnalytics':
pod 'FirebaseAnalytics/Core'
Scopri di più sull'IDFA nella documentazione di Apple:
Disattivare la raccolta dell'IDFV
Se vuoi disattivare la raccolta dell'IDFV (Identifier for Vendor) nella tua
app Apple, imposta il valore di GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED su NO
(booleano) nel file Info.plist della tua app.
Controllare la raccolta dei dati per la pubblicità personalizzata
Se hai collegato il tuo progetto Google Analytics a un account pubblicitario o
hai attivato un'integrazione pubblicitaria o hai attivato la
condivisione dei dati,
i tuoi dati Analytics potrebbero essere idonei all'utilizzo nella pubblicità personalizzata.
Ciò significa, ad esempio, che puoi utilizzare gli eventi raccolti, come first_open, per creare e implementare elenchi dei segmenti di pubblico per il remarketing, a meno che tu non indichi che questi dati non sono disponibili per la pubblicità personalizzata.
Puoi controllare in modo programmatico se i dati di Analytics di un utente devono essere utilizzati per la pubblicità personalizzata utilizzando una delle seguenti opzioni:
Consigliato: attiva o disattiva dinamicamente la personalizzazione degli annunci rispettando la scelta di consenso dell'utente. Implementa l'API per la modalità di consenso di Google.
Attiva o disattiva la personalizzazione degli annunci a livello utente: Controlla la personalizzazione degli annunci come proprietà utente.
Attiva o disattiva la personalizzazione degli annunci a livello di proprietà Analytics: Disattiva la personalizzazione degli annunci per regione geografica nella proprietà Analytics.
Disattivare le funzionalità di pubblicità personalizzata tramite una proprietà utente
L'API per la modalità di consenso di Google è il modo consigliato per attivare e disattivare la pubblicità personalizzata.Tuttavia, se la tua app non utilizza ancora la modalità di consenso, puoi controllare la personalizzazione con l'opzione seguente.
Per disattivare il comportamento pubblicitario personalizzato per impostazione predefinita, imposta il valore di
GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS su NO (booleano)
nel file Info.plist della tua app.
Riattivare le funzionalità pubblicitarie personalizzate tramite una proprietà utente
Se utilizzi il parametro AnalyticsUserPropertyAllowAdPersonalizationSignals per controllare la personalizzazione degli annunci, puoi riattivarla con il metodo setUserProperty come mostrato di seguito:
Swift
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Objective-C
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];
Unity
Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);
Se hai scelto di disattivare temporaneamente la raccolta dei dati di analisi (ad esempio, finché un utente finale non fornisce il consenso) e vuoi controllare le funzionalità pubblicitarie personalizzate dopo aver riattivato la raccolta dei dati di analisi per un utente, assicurati che la chiamata per specificare questa impostazione preceda la chiamata per riattivare la raccolta dei dati di analisi. Ad esempio:
Swift
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)
Objective-C
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];
Unity
Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, ...);
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);
Conferma le impostazioni
Quando gli indicatori di personalizzazione degli annunci sono stati disattivati per un utente tramite uno dei meccanismi definiti sopra, i bundle di eventi successivi registrati dal dispositivo dell'utente conterranno una proprietà utente denominata non_personalized_ads con un valore pari a 1 per indicare che gli eventi nel bundle non sono disponibili per la pubblicità personalizzata. La disattivazione della pubblicità personalizzata non influisce sull'utilizzo dei dati per scopi di misurazione, inclusi report e attribuzione.
Visualizzare le modifiche alla configurazione
Dopo aver apportato modifiche alle impostazioni di Google Analytics, l'SDK scarica le modifiche. La procedura è rapida e semplice, così puoi testare rapidamente le modifiche. Quando apporti modifiche in Analytics, il deployment nell'app potrebbe richiedere alcuni minuti. Se la tua app è pubblicata, il completamento dell'intero processo di deployment potrebbe richiedere fino a un'ora.