Configurare Assurance

Oltre all'installazione generale di SDK, iOS richiede anche il seguente codice aggiuntivo per avviare la sessione di Assurance per l'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.

Oltre all'installazione generale di SDK, Android richiede anche il seguente codice aggiuntivo per avviare la sessione di Assurance per l'app.

1. In Android Studio, nella visualizzazione Android, passa a app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication.

2. Aggiungi il codice seguente a fun handleDeeplink(deeplink: String?):

   code language-kotlin
   // Called when the app in background is opened with a deep link. if (deeplink.isNullOrEmpty()) { Log.w("Luma", "Deeplink is null or empty") return } Log.i("Luma", "Handling deeplink: $deeplink") Assurance.startSession(deeplink)

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

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.

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.

{modal="regular"}

1. Apri il progetto in Android Studio.
2. Selezionare build.gradle.kts (Modulo :app) nel Navigator.
3. Assicurati di utilizzare un identificatore bundle univoco e di sostituire il valore com.adobe.luma.tutorial.android per namespace in android
4. Assicurati di utilizzare lo stesso identificatore del bundle unique e di sostituire com.adobe.luma.tutorial.android per applicationId in defaultConfig in android

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.android.

{modal="regular"}

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.

   {modal="regular"}

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 un browser o un 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. Nell'app di esempio, il collegamento profondo è lumatutorialswiftui://.

1. Vai alla visualizzazione Android del progetto in Android Studio.

2. Seleziona app > manifesti > AndroidManifest.xml nel navigatore.

3. Assicurati che l'elemento XML manifest > application > activity sia simile al seguente:

   code language-xml

   <activity android:name=".MainActivity" android:exported="true" android:theme="@style/Theme.LumaAndroid"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> <intent-filter android:label="@string/app_name"> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:scheme="lumatutorialandroid" android:host="default" /> </intent-filter> </activity>

Assicurati di specificare un android:scheme (ad esempio. lumatutorialandroid) e android:host (ad esempio default) per definire l'URL di base.

Per ulteriori informazioni sui collegamenti profondi in Android, consulta Creare collegamenti profondi al contenuto dell'app.

Assurance funziona aprendo un URL tramite un browser o un 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. Nell'app di esempio, il collegamento profondo è lumatutorialandroid://default.

In Xcode:

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

   Facoltativamente, potrebbe essere utile pulire la build, soprattutto quando vengono visualizzati risultati imprevisti. Seleziona Pulisci cartella build… 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"}

6. Seleziona Continua.

Nel browser:

1. Passa all’interfaccia utente di Data Collection.

2. Seleziona Assurance dalla barra a sinistra.

3. Seleziona Crea nuova sessione e l'opzione Connessione collegamento profondo.

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.
   {modal="regular"}

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.

     {modal="regular"}

   Se utilizzi un simulatore:

   1. Seleziona Copia collegamento.

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

      {modal="regular"}

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 che galleggia sulla tua app.

     {width="300"}

   • Gli aggiornamenti di Experience Cloud vengono inclusi nell’interfaccia utente di Assurance e mostrano:

     1. Eventi esperienza provenienti dall’app.

     2. Dettagli di un evento selezionato.

     3. Il dispositivo e la timeline.

        {modal="regular"}

10. Seleziona Continua per passare alla schermata iniziale.

In Android Studio:

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

   Facoltativamente, potrebbe essere utile pulire la build, soprattutto quando vengono visualizzati risultati imprevisti. Selezionare Pulisci progetto dal menu Genera di Android Studio.

2. Nella finestra di dialogo Consenti a Luma Android di inviarti notifiche, seleziona Consenti.

   {width="300"}

3. Seleziona Mostra finestra di dialogo autorizzazioni.

   {width="300"}

4. In Consentire a Luma Android di accedere alla posizione di questo dispositivo?…

   {width="300"}

   • Seleziona Preciso.
   • Seleziona Durante l'utilizzo dell'app.

5. Nella schermata introduttiva dell'app, seleziona Apri impostazioni dispositivo.

6. Nella schermata Autorizzazione posizione, seleziona Consenti in qualsiasi momento. Quindi seleziona ← per tornare alla schermata dell'app introduttiva.

   {width="300"}

7. Seleziona Continua per passare alla schermata iniziale.

Nel browser:

1. Passa all’interfaccia utente di Data Collection.

2. Seleziona Assurance dalla barra a sinistra.

3. Seleziona Crea nuova sessione e l'opzione Connessione collegamento profondo.

4. Seleziona Inizio.

5. Fornisci un Nome sessione come Luma Mobile App Session e l'URL di base, ovvero android:scheme e android:host definiti in AndroidManifest.xml in Android Studio, separati da ://. Esempio: lumatutorialandroid://default

6. Seleziona Avanti.
   {modal="regular"}

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.

     {modal="regular"}

   Se utilizzi un simulatore:

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

   {modal="regular"}

   Quando in Chrome viene richiesto di Passare a Luma Android, selezionare Continua.

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 che galleggia sulla tua app.

     {width="300"}

   • Gli aggiornamenti di Experience Cloud vengono inclusi nell’interfaccia utente di Assurance e mostrano:

     1. Eventi esperienza provenienti dall’app.

     2. Dettagli di un evento selezionato.

     3. Il dispositivo e la timeline.

        {modal="regular"}

{modal="regular"}

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 aggiorna le dipendenze del pacchetto.

{modal="regular"}

Se sono presenti estensioni obsolete, consulta la documentazione di Android Studio su come aggiornare i moduli di dipendenza per il progetto.