Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Configura la raccolta e l'utilizzo dei dati di Analytics

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Google Analytics offre funzionalità che consentono di controllare la raccolta e l'utilizzo dei dati di Analytics.

Disabilita la raccolta dei dati di Analytics

In alcuni casi, potresti voler disabilitare temporaneamente o permanentemente la raccolta dei dati di Analytics, ad esempio per raccogliere il consenso dell'utente finale o per adempiere ad obblighi di legge. Google Analytics offre più opzioni per disabilitare e disattivare la raccolta di Analytics. Usati insieme, supportano molti casi d'uso tipici.

Disattiva temporaneamente la raccolta

Se desideri disabilitare temporaneamente la raccolta di Analytics, ad esempio per ottenere il consenso dell'utente finale prima della raccolta dei 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 . Per esempio:

Veloce

Nota: questo prodotto Firebase non è disponibile sulla destinazione macOS.
Analytics.setAnalyticsCollectionEnabled(true)

Obiettivo-C

Nota: questo prodotto Firebase non è disponibile sulla destinazione macOS.
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Se hai bisogno di sospendere nuovamente la raccolta per qualsiasi motivo, puoi chiamare

Veloce

Nota: questo prodotto Firebase non è disponibile sulla destinazione macOS.
Analytics.setAnalyticsCollectionEnabled(false)

Obiettivo-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

e la raccolta è sospesa fino a quando non la riattivi. Il valore impostato dal metodo setAnalyticsCollectionEnabled persiste tra le esecuzioni dell'app e sovrascrive il valore per FIREBASE_ANALYTICS_COLLECTION_ENABLED nel file Info.plist dell'app. Dopo aver impostato un valore per setAnalyticsCollectionEnabled , la raccolta Analytics rimane in quello stato fino a quando setAnalyticsCollectionEnabled non viene richiamata, anche se un utente chiude e riapre l'app.

Disattiva definitivamente la raccolta

Se devi disattivare la raccolta di Analytics in modo permanente in una versione della tua app, imposta FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED su YES (Boolean) nel Info.plist file della tua app . L'impostazione di FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED su YES (Boolean) 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 dal tuo Info.plist . L'impostazione di FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED su NO (Boolean) non ha effetto e comporta lo stesso comportamento della mancata impostazione di FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED nel file Info.plist .

Disabilita la raccolta IDFA

Se hai installato Firebase tramite CocoaPods aggiungendo pod 'Firebase/Analytics' al Podfile della tua app e desideri disabilitare la raccolta dell'IDFA (identificatore pubblicitario di un dispositivo) nella tua app Apple, assicurati che il framework AdSupport non sia incluso nella tua app.

Per installare Firebase senza alcuna capacità di raccolta IDFA, utilizza le seguenti sottospecifiche al posto del pod 'Firebase/Analytics' :

pod 'Firebase/AnalyticsWithoutAdIdSupport'

Scopri di più sull'IDFA nella documentazione di Apple:

Disabilita la raccolta IDFV

Se desideri disabilitare la raccolta dell'IDFV (Identifier for Vendor) nella tua app Apple, imposta il valore di GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED su NO (Boolean) nel file Info.plist della tua app.

Configura l'utilizzo dei dati di Analytics

Disattiva le funzionalità pubblicitarie personalizzate

Se hai collegato il tuo progetto Google Analytics a un account pubblicitario o altrimenti abilitato un'integrazione degli annunci o hai attivato la condivisione dei dati , i tuoi dati Analytics potrebbero essere idonei per l'utilizzo nella pubblicità personalizzata. Ciò significa, ad esempio, che puoi utilizzare eventi raccolti come first_open per creare e distribuire elenchi di segmenti di pubblico per il remarketing, a meno che tu non indichi che tali dati non sono disponibili per la pubblicità personalizzata.

Per controllare a livello di codice se i dati di Analytics di un utente devono essere usati per la pubblicità personalizzata, imposta il comportamento predefinito appropriato nel file AndroidManifest.xml dell'app, quindi usa i metodi descritti di seguito per sovrascrivere tale comportamento predefinito.

Per impostare il comportamento pubblicitario personalizzato predefinito, imposta il valore di GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS su NO (Booleano) nel file Info.plist della tua app.

Puoi anche controllare se i dati raccolti dagli utenti finali possono essere utilizzati per la personalizzazione degli annunci tramite l' impostazione di personalizzazione degli annunci , che si trova nelle impostazioni della proprietà di Google Analytics.

Riattiva le funzionalità pubblicitarie personalizzate

Per riattivare le funzionalità pubblicitarie personalizzate per un utente in fase di esecuzione, ad esempio dopo che un utente finale ha fornito il consenso, utilizzare il metodo setUserProperty come mostrato di seguito:

Veloce

Nota: questo prodotto Firebase non è disponibile sulla destinazione macOS.
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

Obiettivo-C

Nota: questo prodotto Firebase non è disponibile sulla destinazione macOS.
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

Se hai scelto di disabilitare temporaneamente la raccolta di analisi (ad esempio, fino a quando un utente finale non fornisce il consenso) e desideri controllare le funzionalità pubblicitarie personalizzate dopo aver riattivato la raccolta di analisi per un utente, assicurati che la tua chiamata per specificare questa impostazione preceda la tua chiamata per riattivare la raccolta di analisi. Per esempio:

Veloce

Nota: questo prodotto Firebase non è disponibile sulla destinazione macOS.
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

Obiettivo-C

Nota: questo prodotto Firebase non è disponibile sulla destinazione macOS.
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Conferma le tue impostazioni

Quando i segnali di personalizzazione degli annunci sono stati disabilitati per un utente tramite uno dei meccanismi sopra definiti, i bundle di eventi successivi registrati dal dispositivo di quell'utente conterranno una proprietà utente denominata "non_personalized_ads" con un valore di 1 per indicare che gli eventi in quel bundle non sono disponibili per pubblicità personalizzata. La disabilitazione della pubblicità personalizzata non pregiudica l'utilizzo dei dati a fini di misurazione, inclusi i rapporti e l'attribuzione.

Visualizza le modifiche alla configurazione

Dopo aver apportato modifiche alle impostazioni di Google Analytics, l'SDK scarica le modifiche. Il processo è rapido e senza interruzioni, quindi puoi testare rapidamente le modifiche. Quando apporti modifiche in Analytics, potrebbero essere necessari alcuni minuti per la distribuzione nell'app. Se la tua app è attiva, il completamento del processo di distribuzione completo potrebbe richiedere fino a un'ora.