Configura Assurance

Scopri come configurare Adobe Experience Platform Assurance in un’app mobile.

Assurance, formalmente noto come Project Griffon, è progettato per aiutarti a ispezionare, verificare, simulare e convalidare come raccolgi dati o distribuisci esperienze nella tua app mobile.

Assurance consente di controllare gli eventi SDK non elaborati generati da Adobe Experience Platform Mobile SDK. Tutti gli eventi raccolti dall’SDK sono disponibili per il controllo. Gli eventi SDK vengono caricati in una vista a elenco, ordinati in ordine cronologico. Ogni evento dispone di una vista dettagliata che fornisce ulteriori dettagli. Sono inoltre disponibili viste aggiuntive per sfogliare la configurazione dell’SDK, gli elementi dati, gli stati condivisi e le versioni delle estensioni SDK. Ulteriori informazioni su Assurance nella documentazione del prodotto.

Prerequisiti

  • L'app con gli SDK installati e configurati è stata configurata.

Obiettivi di apprendimento

In questa lezione verranno fornite le seguenti informazioni:

  • Conferma che la tua organizzazione disponga dell’accesso (e richiedilo in caso contrario).
  • Imposta l’URL di base.
  • Aggiungi il codice iOS specifico richiesto.
  • Connettersi a una sessione.

Conferma accesso

Assicurati che la tua organizzazione abbia accesso a Assurance. Come utente, devi essere aggiunto al profilo per Adobe Experience Platform. Per ulteriori informazioni, consulta Accesso utente nella guida Assurance.

Implementazione

Oltre all'installazione generale di SDK, completata nella lezione precedente, iOS richiede anche la seguente aggiunta per avviare la sessione Assurance per la tua app.

  1. Passa a Luma > Luma > SceneDelegate nel Navigatore progetti Xcode.

  2. Aggiungi il codice seguente a func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>:

    code language-swift
    // Called when the app in background is opened with a deep link.
    if let deepLinkURL = URLContexts.first?.url {
        // Start the Assurance session
        Assurance.startSession(url: deepLinkURL)
    }
    

    Questo codice avvia una sessione di garanzia quando l’app è in background e viene aperta utilizzando un collegamento profondo.

Ulteriori informazioni sono disponibili qui.

Definisci identificatore bundle

Devi fornire un identificatore univoco del bundle per l’app.

  1. Apri il progetto in Xcode.

  2. Selezionare Luma nel Navigatore progetti.

  3. Selezionare la destinazione Luma.

  4. Selezionare la scheda Firma e funzionalità.

  5. Definisci un identificatore bundle.

    note important
    IMPORTANT
    Assicurati di utilizzare un identificatore bundle univoco e sostituisci l'identificatore bundle com.adobe.luma.tutorial.swiftui, in quanto ogni identificatore bundle deve essere univoco. In genere si utilizza un formato DNS inverso per le stringhe ID bundle, come com.organization.brand.uniqueidentifier. La versione finale di questa esercitazione, ad esempio, utilizza com.adobe.luma.tutorial.swiftui.

    Funzionalità di firma Xcode {modal="regular"}

Configurare un URL di base

  1. Vai al progetto in Xcode.

  2. Selezionare Luma nel Navigatore progetti.

  3. Selezionare la destinazione Luma.

  4. Selezionare la scheda Informazioni.

  5. Per aggiungere un URL di base, scorri verso il basso fino a Tipi di URL e seleziona il pulsante +.

  6. Imposta Identificatore per l'identificatore del bundle desiderato e Schemi URL a tua scelta.

    url di garanzia

    note important
    IMPORTANT
    Assicurati di utilizzare un identificatore bundle univoco e sostituisci l'identificatore bundle com.adobe.luma.tutorial.swiftui, in quanto ogni identificatore bundle deve essere univoco. In genere si utilizza un formato DNS inverso per le stringhe ID bundle, come com.organization.brand.uniqueidentifier. È possibile utilizzare lo stesso identificatore del bundle utilizzato in Definisci identificatore del bundle.
    Analogamente, utilizzare uno schema URL univoco e sostituire lumatutorialswiftui già fornito con lo schema URL univoco.

Per ulteriori informazioni sugli schemi URL in iOS, consulta la documentazione di Apple.

Assurance funziona aprendo un URL, tramite il browser o il codice QR. Tale URL inizia con l’URL di base che apre l’app e contiene parametri aggiuntivi. Questi parametri univoci vengono utilizzati per connettere la sessione.

Connessione a una sessione

In Xcode:

  1. Genera o ricompila ed esegui l'app nel simulatore o su un dispositivo fisico da Xcode, utilizzando Play .

    note tip
    TIP
    Facoltativamente, potresti voler "ripulire" la build, soprattutto quando vengono visualizzati risultati imprevisti. A tale scopo, selezionare Pulisci cartella di compilazione… dal menu Xcode Product.
  2. Nella finestra di dialogo Consenti all'app Luma di utilizzare la tua posizione, seleziona Consenti durante l'utilizzo dell'app.

    {width="300"}

  3. Nella finestra di dialogo "App Luma" desidera inviarti notifiche, seleziona Consenti.

    {width="300"}

  4. Seleziona Continua… per consentire all'app di tenere traccia dell'attività.

    {width="300"}

  5. Nella finestra di dialogo Consenti a "App Luma" di tenere traccia dell'attività tra app e siti Web di altre aziende, seleziona Consenti.

    {width="300"}

Nel browser:

  1. Passa all’interfaccia utente di Data Collection.

  2. Seleziona Assurance dalla barra a sinistra.

  3. Seleziona Crea sessione.

  4. Seleziona Inizio.

  5. Fornisci un Nome sessione come Luma Mobile App Session e l'URL di base, ovvero gli schemi URL immessi in Xcode, seguiti da :// Ad esempio: lumatutorialswiftui://

  6. Seleziona Avanti.
    sessione di creazione garanzia

  7. Nella finestra di dialogo modale Crea nuova sessione:

    Se si utilizza un dispositivo fisico:

    • Selezionare Scansiona codice QR. Per aprire l'app, usa la fotocamera sul tuo dispositivo fisico per scansionare il codice QR e toccare il collegamento.

      codice di controllo qualità affidabilità

    Se utilizzi un simulatore:

    1. Seleziona Copia collegamento.

    2. Copia il collegamento profondo utilizzando Copia e utilizza il collegamento profondo per aprire l'app con Safari nel simulatore.

      Collegamento alla copia di Assurance

  8. Al caricamento dell’app, viene visualizzata una finestra di dialogo modale in cui viene richiesto di immettere il PIN illustrato al punto 7.

    {width="300"}

    Immettere il PIN e selezionare Connetti.

  9. Se la connessione ha avuto esito positivo, vengono visualizzati i seguenti elementi:

    • Un’icona Assurance mobile sopra l’app.

      {width="300"}

    • Experienci Cloud di aggiornamenti disponibili nell’interfaccia utente Assurance, che mostrano:

      1. Eventi esperienza provenienti dall’app.

      2. Dettagli di un evento selezionato.

      3. Il dispositivo e la timeline.

        eventi di garanzia

In caso di problemi, consulta la documentazione tecnica e la documentazione generale.

Verificare le estensioni

Per verificare se l’app utilizza le estensioni più aggiornate:

  1. Seleziona Configura.

  2. Seleziona Aggiungi per 123 Versioni estensione.

  3. Seleziona Salva.

    Configurare le versioni dellestensione

  4. Seleziona 123 Versioni estensione per visualizzare una panoramica delle ultime estensioni disponibili e delle estensioni utilizzate nella tua versione dell'app.

    Versioni estensione

  5. Per aggiornare le versioni dell'estensione (ad esempio, Messaggistica e Ottimizza), selezionare il pacchetto (estensione) da Dipendenze pacchetto (ad esempio, AEPMessaging) e dal menu di scelta rapida selezionare Aggiorna pacchetto. Xcode aggiornerà le dipendenze del pacchetto.

NOTE
Dopo aver aggiornato le estensioni (pacchetti) in Xcode, chiudi ed elimina la sessione corrente e ripeti tutti i passaggi da Connessione a una sessione e Verifica le estensioni per garantire che Assurance segnali correttamente le estensioni corrette in una nuova sessione Assurance.
SUCCESS
Ora hai configurato l’app per utilizzare Assurance per il resto dell’esercitazione.
Grazie per aver dedicato il tuo tempo all’apprendimento dell’SDK di Adobe Experience Platform Mobile. Se hai domande, vuoi condividere commenti generali o suggerimenti su contenuti futuri, condividili in questo Experience League post di discussione della community

Successivo: Implementare il consenso

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