Implementare il consenso

Scopri come implementare il consenso in un’app mobile.

L’estensione per dispositivi mobili Adobe Experience Platform Consent abilita la raccolta delle preferenze di consenso dalla tua app mobile quando utilizzi Adobe Experience Platform Mobile SDK e l’estensione Edge Network. Ulteriori informazioni sull'estensione del consenso sono disponibili nella documentazione.

Prerequisiti

  • L'app con gli SDK installati e configurati è stata creata ed eseguita correttamente.

Obiettivi di apprendimento

In questa lezione verranno fornite le seguenti informazioni:

  • Richiedere il consenso all'utente.
  • Aggiorna l'estensione in base alla risposta dell'utente.
  • Scopri come ottenere lo stato di consenso corrente.

Richiedi consenso

Se hai seguito l'esercitazione fin dall'inizio, ricorda di aver impostato il consenso predefinito nell'estensione Consenso su In sospeso - Eventi di coda che si verificano prima che l'utente fornisca le preferenze di consenso.

Per iniziare a raccogliere i dati, devi ottenere il consenso dell’utente. In un’app reale, vorresti consultare le best practice sul consenso per la tua regione. In questa esercitazione, ottieni il consenso dell’utente semplicemente richiedendolo con un avviso:

iOS
  1. Desideri chiedere all’utente il consenso solo una volta. Il consenso per Mobile SDK viene combinato con l'autorizzazione richiesta per il tracciamento tramite il framework per la trasparenza del tracciamento delle app di Apple. In questa app, si presume che quando l’utente autorizza il tracciamento, acconsente alla raccolta di eventi.

  2. Passa a Luma > Luma > Utils > MobileSDK nel Navigatore progetti Xcode.

    Aggiungere il codice alla funzione updateConsent.

    code language-swift
    // Update consent
    let collectConsent = ["collect": ["val": value]]
    let currentConsents = ["consents": collectConsent]
    Consent.update(with: currentConsents)
    MobileCore.updateConfigurationWith(configDict: currentConsents)
    
  3. Passa a Luma > Luma > Views > General > DisclaimerView nel Navigatore progetti di Xcode. Il Navigatore progetti Xode è la visualizzazione che viene mostrata dopo l’installazione o la reinstallazione dell’applicazione e il primo avvio dell’app. All'utente viene richiesto di autorizzare il tracciamento in base al framework per la trasparenza del tracciamento delle app di Apple. Se l’utente autorizza, aggiorna anche il consenso.

    Aggiungere il codice seguente alla chiusura di ATTrackingManager.requestTrackingAuthorization { status in.

    code language-swift
    // Add consent based on authorization
    if status == .authorized {
       // Set consent to yes
       MobileSDK.shared.updateConsent(value: "y")
    }
    else {
       // Set consent to yes
       MobileSDK.shared.updateConsent(value: "n")
    }
    
Android
  1. Desideri chiedere all’utente il consenso solo una volta. In questa app, si presume che quando l’utente autorizza il tracciamento, acconsente alla raccolta di eventi.

  2. Passa a app > kotlin+java > com.adobe.luma.tutorial.android > modelli > MobileSDK nel navigatore di Android Studio.

    Aggiungere il codice alla funzione updateConsent(value: String).

    code language-kotlin
    // Update consent
    val collectConsent = mapOf("collect" to mapOf("val" to value))
    val currentConsents = mapOf("consents" to collectConsent)
    Consent.update(currentConsents)
    MobileCore.updateConfiguration(currentConsents)
    
  3. Passa a app > kotlin+java > com.adobe.luma.tutorial.android > visualizzazioni > DisclaimerView.kt nel navigatore di Android Studio.

    Aggiungere il codice seguente alla funzione DisclaimerView(navController: NavController) sotto // Set content to yes e // Set content to no.

    code language-kotlin
    // Add consent based on authorization
    if (status) {
       showPersonalizationWarning = false
    
       // Set consent to yes
       MobileSDK.shared.updateTrackingStatus(TrackingStatus.AUTHORIZED)
       MobileSDK.shared.updateConsent("y")
    } else {
       Toast.makeText(
             context,
             "You will not receive offers and location tracking will be disabled.",
             Toast.LENGTH_LONG
       ).show()
       showPersonalizationWarning = true
    
       // Set consent to no
       MobileSDK.shared.updateTrackingStatus(TrackingStatus.DENIED)
       MobileSDK.shared.updateConsent("n")
    }
    

Ottieni lo stato di consenso corrente

L’estensione per dispositivi mobili Consenso sopprime/termina/consente automaticamente il tracciamento in base al valore di consenso corrente. Puoi anche accedere autonomamente allo stato di consenso corrente:

iOS
  1. Passa a Luma > Luma > Utils > MobileSDK nel Navigatore progetti di Xcode.

    Aggiungere il codice seguente alla funzione getConsents:

    code language-swift
    // Get consents
    Consent.getConsents { consents, error in
       guard error == nil, let consents = consents else { return }
       guard let jsonData = try? JSONSerialization.data(withJSONObject: consents, options: .prettyPrinted) else { return }
       guard let jsonStr = String(data: jsonData, encoding: .utf8) else { return }
       Logger.aepMobileSDK.info("Consent getConsents: \(jsonStr)")
    }
    
  2. Passa a Luma > Luma > Views > General > HomeView nel Navigatore progetti di Xcode.

    Aggiungere il codice seguente al modificatore .task:

    code language-swift
    // Ask status of consents
    MobileSDK.shared.getConsents()
    

Nell’esempio precedente, stai semplicemente registrando lo stato del consenso nella console in Xcode. In uno scenario reale, è possibile utilizzarlo per modificare i menu o le opzioni visualizzati all'utente.

Android
  1. Passa a app > kotlin+java > com.adobe.luma.tutorial.android > modelli > MobileSDK nel navigatore di Android Studio.

    Aggiungere il codice seguente alla funzione getConsents():

    code language-kotlin
    // Get consents
    Consent.getConsents { callback ->
       if (callback != null) {
             val jsonStr = JSONObject(callback).toString(4)
             Log.i("MobileSDK", "Consent getConsents: $jsonStr")
       }
    }
    
  2. Passa a app > kotlin+java > com.adobe.luma.tutorial.android > visualizzazioni > HomeView.kt nel navigatore di Android Studio.

    Aggiungi il seguente codice a LaunchedEffect(unit):

    code language-kotlin
    // Ask status of consents
    MobileSDK.shared.getConsents()
    

Nell’esempio precedente, stai semplicemente registrando lo stato di consenso nella console in Android Studio. In uno scenario reale, è possibile utilizzarlo per modificare i menu o le opzioni visualizzati all'utente.

Convalidare con Assurance

  1. Elimina l’applicazione dal dispositivo o simulatore per reimpostare e inizializzare correttamente il tracciamento e il consenso.

  2. Per collegare il simulatore o il dispositivo ad Assurance, consulta la sezione istruzioni di installazione.

  3. Quando si passa nell'app dalla schermata Home alla schermata Products e si torna alla schermata Home, nell'interfaccia utente di Assurance dovrebbe essere visualizzato un evento Get Consents Response.

    convalida consenso {modal="regular"}

SUCCESS
Ora hai abilitato l’app per richiedere all’utente, al suo avvio iniziale dopo l’installazione (o la reinstallazione), di acconsentire all’utilizzo di Adobe Experience Platform Mobile SDK.
Grazie per aver dedicato tempo all'apprendimento di Adobe Experience Platform Mobile SDK. Se hai domande, vuoi condividere commenti generali o suggerimenti su contenuti futuri, condividili in questo post di discussione della community Experience League

Successivo: Raccolta dei dati del ciclo di vita

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b