Configurare la modalità di consenso per le app

Questa pagina è dedicata 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 della 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 e avanzata e consulta le linee guida della tua azienda.

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

Per configurare la modalità di consenso, devi:

  1. Imposta lo stato del consenso predefinito.

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

  1. Apri il file info.plist della tua app.

  2. Aggiungi le coppie chiave-valore della modalità di consenso. La chiave descrive il tipo di consenso e il valore indica lo stato del consenso. I valori possono essere true, il che significa che il consenso è stato concesso, o false, il che significa che il consenso è stato negato.

    In conformità agli aggiornamenti alla modalità di consenso per il traffico nello Spazio economico europeo (SEE), è possibile impostare un valore di eu_consent_policy per ad_user_data e ad_personalization, il che significa che il consenso viene negato solo per gli utenti nelle regioni soggette alle Norme relative al consenso degli utenti dell'UE.

    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 il consenso per tutti i parametri:

<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>

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 viene mantenuto durante le esecuzioni dell'app. Il valore rimane in questo stato finché non viene chiamato di nuovo setConsent, anche se un utente chiude e riapre l'app. setConsent aggiorna solo i parametri specificati.

Se un utente ritira il consenso precedentemente concesso per l'archiviazione di Analytics o degli annunci, Google Analytics elimina tutte le proprietà utente, incluso il consenso per ad_personalization. Per mantenere la scelta del consenso dell'utente per la personalizzazione degli annunci, ripristina il valore precedente per la personalizzazione degli annunci utilizzando setConsent (Swift | Obj-C) .

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

Swift

Analytics.setConsent([
  .analyticsStorage: .granted,
  .adStorage: .granted,
  .adUserData: .granted,
  .adPersonalization: .granted,
])

Objective-C

[FIRAnalytics setConsent:@{
  FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdUserData : FIRConsentStatusGranted,
  FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];

Se un utente decide di revocare il consenso, assicurati di aggiornare gli stati del consenso di conseguenza

Nell'ambito del nostro costante impegno verso un ecosistema pubblicitario digitale che rispetti la privacy, stiamo rafforzando l'applicazione delle nostre Norme relative al consenso degli utenti dell'UE.

Scopri di più sugli aggiornamenti alla modalità di consenso per il traffico nello Spazio economico europeo (SEE) di Google.

Gli utenti della modalità di consenso devono inviare due nuovi parametri oltre all'archiviazione degli annunci e all'archiviazione di Analytics:

  1. Aggiorna il file Info.plist della tua app in modo da includere:

    <key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA</key> <true/>
<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS</key> <true/>

  2. Aggiorna le chiamate al consenso in modo da includere i parametri per i dati utente degli annunci e la personalizzazione degli annunci:

    Swift

    Analytics.setConsent([
.analyticsStorage: .granted,
.adStorage: .granted,
.adUserData: .granted,
.adPersonalization: .granted,
])

    Objective-C

    [FIRAnalytics setConsent:@{
  FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdStorage : FIRConsentStatusGranted,
  FIRConsentTypeAdUserData : FIRConsentStatusGranted,
  FIRConsentTypeAdPersonalization : FIRConsentStatusGranted,
}];

Puoi verificare che le impostazioni per il consenso funzionino come previsto visualizzando la console di debug Xcode per la tua app.

Procedi nel seguente modo:

  1. Attiva il logging dettagliato sul tuo dispositivo.

  2. Nella console di debug Xcode, cerca:

    • ad_storage
    • analytics_storage
    • ad_user_data
    • ad_personalization

    Ad esempio, se l'archiviazione degli annunci è attivata, vedrai il seguente messaggio:

    ad_storage is granted.