In questa pagina vengono descritte le funzionalità offerte da Google Analytics che consentono di controllare la raccolta e l'utilizzo dei dati di Analytics.
Disattiva la raccolta dei dati di Analytics
In alcuni casi, potresti voler disattivare temporaneamente o definitivamente la raccolta di Analytics, ad esempio per raccogliere il consenso degli utenti finali o per adempiere ai requisiti legali obblighi di sicurezza. Google Analytics offre diverse opzioni per la disattivazione e disattivazione della raccolta Analytics. Se usati insieme, supportano molti casi d'uso tipici.
Disattivare temporaneamente la raccolta
Se vuoi disattivare temporaneamente la raccolta di Analytics, ad esempio per ricevere
consenso dell'utente finale prima di raccogliere i dati, puoi impostare il valore
da FIREBASE_ANALYTICS_COLLECTION_ENABLED
a NO
(valore booleano) nel campo
Info.plist
file. Ad esempio, visualizzato nel file 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 di 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 di nuovo la raccolta, puoi chiamare il numero riportato di seguito e la raccolta verrà sospesa fino a quando non la riattivi.
Swift
Analytics.setAnalyticsCollectionEnabled(false)
Objective-C
[FIRAnalytics setAnalyticsCollectionEnabled:NO];
Unity
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);
Il valore impostato dal metodo setAnalyticsCollectionEnabled
viene mantenuto nell'app
eseguite ed esegue l'override del valore per FIREBASE_ANALYTICS_COLLECTION_ENABLED
nel file Info.plist
dell'app. Dopo aver impostato un valore per
setAnalyticsCollectionEnabled
, la raccolta di Analytics rimane in questo stato
fino a quando setAnalyticsCollectionEnabled
non viene richiamato, anche se un utente chiude
e riapre l'app.
Disattiva 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
dell'app, nonché su qualsiasi
valore impostato con setAnalyticsCollectionEnabled
.
Per riattivare la raccolta, rimuovi FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED
da
il tuo Info.plist
. L'impostazione di FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED
su NO
(booleano) non ha alcun effetto e ha 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 'Firebase/Analytics'
al Podfile della tua app e vuoi disattivare la raccolta dell'IDFA (l'identificatore pubblicitario di un dispositivo) nella tua app per Apple, assicurati che il framework AdSupport non sia incluso nella tua app.
Per installare Firebase senza la funzionalità di raccolta IDFA, utilizza la seguente
subspec al posto di pod 'Firebase/Analytics'
:
pod 'Firebase/AnalyticsWithoutAdIdSupport'
Scopri di più sull'IDFA nella documentazione di Apple:
Disattiva raccolta IDFV
Se vuoi disattivare la raccolta dell'IDFV (Identifier For Vendor) nella tua app per Apple, imposta il valore di GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED
su NO
(booleano) nel file Info.plist
dell'app.
Controllare la raccolta dei dati per la pubblicità personalizzata
Se hai collegato il tuo progetto Google Analytics a un account Google Ads o attivato un'integrazione di annunci o attivato la condivisione dei dati, i tuoi dati di Analytics potrebbero essere idonei per l'utilizzo nella pubblicità personalizzata.
Ciò significa, ad esempio, che puoi utilizzare gli eventi raccolti come first_open
per creare ed eseguire il deployment di elenchi dei segmenti di pubblico per il remarketing, a meno che non indichi che
tali 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 dell'utente in merito al consenso. Implementa l'API per la modalità di consenso di Google.
Attiva o disattiva la personalizzazione degli annunci a livello di 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 tua proprietà Analytics.
Disattivare le funzionalità della pubblicità personalizzata tramite una proprietà utente
API per la modalità di consenso di Google è il metodo 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 la seguente opzione.
Per disattivare la pubblicità personalizzata per impostazione predefinita, imposta il valore
Da GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS
a NO
(booleano)
nel file Info.plist
dell'app.
Riattivare le funzionalità della pubblicità personalizzata tramite una proprietà utente
Se usi il parametro AnalyticsUserPropertyAllowAdPersonalizationSignals
per controllare la personalizzazione degli annunci, puoi riattivarla con il
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, fino a quando 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 di 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 a fini di misurazione, inclusi i report e l'attribuzione.
Visualizzare le modifiche alla configurazione
Dopo aver apportato le modifiche alle impostazioni di Google Analytics, l'SDK scarica le modifiche. La procedura è rapida e semplice, quindi puoi testare rapidamente le modifiche. Quando apporti modifiche in Analytics, il deployment nell'app potrebbe richiedere alcuni minuti. Se l'app è pubblicata, la procedura di deployment completa potrebbe richiedere fino a un'ora.