Configurare la modalità di consenso per le app

Questa pagina è rivolta agli sviluppatori che utilizzano l'SDK Google Analytics for Firebase nella propria app e vogliono integrare la modalità di consenso. Per un'introduzione alla modalità di consenso, leggi la panoramica sulla modalità di consenso.

Google Analytics offre la modalità di consenso per modificare il comportamento dell'SDK in base allo stato del consenso degli utenti. Puoi implementare la modalità di consenso in modo di base o avanzato. Se non sai se implementare la modalità di consenso di base o avanzata, scopri di più sulla modalità di consenso di base o avanzata e consulta le linee guida della tua azienda.

Importante: se il parametro di consenso ad_storage o analytics_storage è impostato su negato, tramite uno stato del consenso predefinito o il metodo setConsent, i dati di analisi associati a una determinata istanza di app verranno reimpostati definitivamente in futuro. Ad esempio, se i dati di analisi vengono reimpostati per tutte le istanze dell'app, il numero di utenti può risultare aumentato in modo artificioso.

• iOS: puoi evitare questo problema eseguendo l'aggiornamento alla versione 10.23.0 o successive.
• Android: i dispositivi con Google Play Services hanno ricevuto automaticamente un aggiornamento e tali dispositivi non sono più soggetti a questo problema. Non è richiesta alcuna ulteriore azione da parte tua.

Se la tua app viene eseguita su dispositivi senza Google Play Services, potrai aggiornare l'SDK Android nella prossima release 22.0.1 per evitare questo comportamento. Fino ad allora, puoi evitare che il problema si verifichi su questi dispositivi seguendo questa procedura:

1. Non impostare valori predefiniti per ad_storage e analytics_storage nel manifest dell'app.
2. Disabilita la raccolta di Analytics prima di impostare lo stato del consenso ad_storage e analytics_storage dell'istanza dell'app.
3. Una volta ricevuto il consenso affermativo, riattiva la raccolta di Analytics, che non reimposterà i dati di analisi.

Se vuoi reimpostare l'analisi per un'istanza di app, utilizza l'API creata appositamente. Puoi vedere un esempio relativo ad Android qui.

Modalità di consenso avanzata Modalità di consenso di base

iOS Android

Importante: la modalità di consenso per le app è stata aggiornata il 30 ottobre 2023 e ora contiene due parametri aggiuntivi. Se utilizzi già la modalità di consenso, esegui l'upgrade alla versione 2 della modalità di consenso. Scopri di più sugli aggiornamenti alla modalità di consenso per il traffico nello Spazio economico europeo (SEE) di Google.

Prima di iniziare

Prima di poter gestire il consenso degli utenti, devi implementare:

• SDK Google Analytics per Firebase

• Un banner delle impostazioni del consenso per acquisire il consenso degli utenti

  Suggerimento: se non vuoi implementare le impostazioni del consenso autonomamente, valuta la possibilità di utilizzare una piattaforma di gestione del consenso (CMP).

Configurare la modalità di consenso

Per configurare la modalità di consenso, devi:

1. Prima che un utente conceda il consenso: disattiva temporaneamente la raccolta di Analytics.
2. Imposta lo stato del consenso predefinito.
3. Aggiorna lo stato del consenso in base all'interazione dell'utente con le impostazioni relative al consenso.
4. Riattiva la raccolta di Analytics.

Disattivare temporaneamente la raccolta di Analytics

Un'implementazione di base della modalità di consenso significa bloccare il caricamento dell'SDK Google Analytics per Firebase finché un utente non concede il consenso.

Per disattivare temporaneamente la raccolta di Analytics, imposta il valore di firebase_analytics_collection_enabled su false nel AndroidManifest.xml della tua app nel tag dell'applicazione. Ad esempio:

<meta-data android:name="firebase_analytics_collection_enabled" android:value="false" />

Impostare lo stato del consenso predefinito

Per impostazione predefinita, non viene impostato alcun valore della modalità di consenso. Per impostare lo stato del consenso predefinito per la tua app:

1. Apri il file AndroidManifest.xml della tua app.

2. Aggiungi le coppie chiave-valore per la modalità di consenso. La chiave descrive il tipo di consenso e il valore indica lo stato del consenso. I valori possono essere true, che indica che il consenso è stato concesso, oppure false, che indica che il consenso è stato negato. Imposta quanto segue:

   • google_analytics_default_allow_analytics_storage
   • google_analytics_default_allow_ad_storage
   • google_analytics_default_allow_ad_user_data
   • google_analytics_default_allow_ad_personalization_signals

3. Salva le modifiche. Successivamente, implementa il meccanismo per aggiornare i valori del consenso.

Ad esempio, per impostare per impostazione predefinita tutte le autorizzazioni concesse per tutti i parametri:

<meta-data android:name="google_analytics_default_allow_analytics_storage" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_storage" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_user_data" android:value="true" />
<meta-data android:name="google_analytics_default_allow_ad_personalization_signals" android:value="true" />

Riattiva la raccolta di Analytics

Dopo che un utente ha dato il consenso, attiva di nuovo la raccolta di Analytics utilizzando il metodo setAnalyticsCollectionEnabled().

Il valore impostato dal metodo setAnalyticsCollectionEnabled persiste per tutte le esecuzioni dell'app e sostituisce il valore FIREBASE_ANALYTICS_COLLECTION_ENABLED nel file AndroidManifest.xml dell'app. Dopo aver impostato un valore per setAnalyticsCollectionEnabled, la raccolta di Analytics rimane in questo stato fino a quando setAnalyticsCollectionEnabled non viene richiamata di nuovo, anche se un utente chiude e riapre la tua app.

Per aggiornare la raccolta di Analytics:

setAnalyticsCollectionEnabled(true);

Aggiorna consenso

Per aggiornare i valori del consenso dopo l'avvio di un'app, chiama il metodo setConsent.

Il valore impostato dal metodo setConsent sostituisce l'impostazione predefinita e persiste per tutte le esecuzioni dell'app. Il valore rimane in questo stato fino a quando setConsent non viene richiamato, anche se un utente chiude e riapre l'app. setConsent aggiorna solo i parametri specificati da te.

Se un utente ritira il consenso concesso in precedenza per Analytics o l'archiviazione di annunci, Google Analytics elimina tutte le proprietà utente, incluso il consenso per ad_personalization. Per mantenere la scelta dell'utente relativa al consenso per la personalizzazione degli annunci, ripristina il valore precedente per la personalizzazione degli annunci utilizzando setConsent (Kotlin+KTX | Java) .

L'esempio seguente mostra il metodo setConsent che aggiorna i diversi valori del consenso in granted:

Java

// Set consent types.
Map<ConsentType, ConsentStatus> consentMap = new EnumMap<>(ConsentType.class);
consentMap.put(ConsentType.ANALYTICS_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_STORAGE, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_USER_DATA, ConsentStatus.GRANTED);
consentMap.put(ConsentType.AD_PERSONALIZATION, ConsentStatus.GRANTED);

mFirebaseAnalytics.setConsent(consentMap);

Kotlin

Firebase.analytics.setConsent {
  analyticsStorage(ConsentStatus.GRANTED)
  adStorage(ConsentStatus.GRANTED)
  adUserData(ConsentStatus.GRANTED)
  adPersonalization(ConsentStatus.GRANTED)
}