Configurare la raccolta e l'utilizzo dei dati di Analytics

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 di Analytics ad esempio per raccogliere il consenso degli utenti finali o per adempiere agli obblighi legali. Google Analytics offre diverse opzioni per disattivare e disattivare la raccolta Analytics. Se utilizzate insieme, supportano molti casi d'uso tipici.

Disattivare temporaneamente la raccolta

Se vuoi disattivare temporaneamente la raccolta Analytics, ad esempio per ottenere il consenso degli utenti finali 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 nel codice 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 setAnalyticsCollectionEnabled metodo di istanza di Analytics. Ad esempio:

Analytics.setAnalyticsCollectionEnabled(true)

[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

Se devi sospendere di nuovo la raccolta per qualsiasi motivo, puoi chiamare quanto segue e la raccolta verrà sospesa finché non la riattivi.

Analytics.setAnalyticsCollectionEnabled(false)

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

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 dell'app. L'impostazione di FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED su YES (booleano) ha la priorità su tutti i valori di FIREBASE_ANALYTICS_COLLECTION_ENABLED nel file Info.plist dell'app, nonché su tutti i valori impostati con setAnalyticsCollectionEnabled.

Per riattivare la raccolta, rimuovi FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED da Info.plist. L'impostazione di FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED su NO (booleano) non ha alcun effetto e comporta lo stesso comportamento di quando FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED non è impostato nel file Info.plist.

Disattivare la raccolta dell'IDFA

Se hai installato il modulo FirebaseAnalytics nella tua app tramite SPM o CocoaPods e vuoi disattivare la raccolta dell'IDFA (l'identificatore pubblicitario di un dispositivo) nella tua app Apple, assicurati che il framework AdSupport non sia incluso nell'app.

Per installare Firebase senza funzionalità di raccolta dell'IDFA, utilizza quanto segue anziché la dipendenza FirebaseAnalytics:

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

pod 'FirebaseAnalytics/Core'

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

• Privacy dell'utente e utilizzo dei dati
• App Tracking Transparency

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 dell'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 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 e implementare elenchi di segmenti di pubblico per il remarketing, a meno che tu non indichi che questi dati non sono disponibili per la pubblicità personalizzata.

Puoi controllare a livello di programmazione se i dati di Analytics di un utente devono essere utilizzati per la pubblicità personalizzata utilizzando una delle seguenti opzioni:

• Consigliata: 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 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 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 l'attività pubblicitaria personalizzata per impostazione predefinita, imposta il valore di GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS su NO (booleano) nel file Info.plist dell'app.

Riattivare le funzionalità di pubblicità personalizzata tramite una proprietà utente

Se utilizzi il AnalyticsUserPropertyAllowAdPersonalizationSignals parametro per controllare la personalizzazione degli annunci, puoi riattivarla con il setUserProperty metodo come mostrato di seguito:

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

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

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

Se hai scelto di disattivare temporaneamente la raccolta di Analytics (ad esempio, finché un utente finale non fornisce il consenso) e vuoi controllare le funzionalità di pubblicità personalizzata dopo aver riattivato la raccolta di Analytics per un utente, assicurati che la chiamata per specificare questa impostazione preceda la chiamata per riattivare la raccolta di Analytics. Ad esempio:

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);

Confermare 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 in quel 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 senza interruzioni, quindi puoi testare rapidamente le modifiche. Quando apporti modifiche in Analytics, potrebbero essere necessari alcuni minuti per l'implementazione nell'app. Se l'app è attiva, la procedura di implementazione completa potrebbe richiedere fino a un'ora.