Usa luoghi

Scopri come utilizzare il servizio di geolocalizzazione Places nella tua app.

Il servizio Adobe Experience Platform Data Collection Places è un servizio di geolocalizzazione che consente alle app mobili dotate di awareness della posizione di contestualizzare quest’ultima. Il servizio utilizza interfacce SDK avanzate e facili da usare, associate a un database flessibile di punti di interesse (POI).

Prerequisiti

  • Tutte le dipendenze del pacchetto sono presenti nel progetto Xcode.
  • Estensioni registrate in AppDelegate.
  • MobileCore configurato per utilizzare l'appId di sviluppo.
  • SDK importati.
  • L'app è stata creata ed eseguita correttamente con le modifiche precedenti.

Obiettivi di apprendimento

In questa lezione, potrai

  • Scopri come definire i punti di interesse nel servizio Places.
  • Aggiorna la proprietà tag con l’estensione Places.
  • Aggiorna lo schema per acquisire eventi di geolocalizzazione.
  • Convalidare l'impostazione in Assurance.
  • Aggiorna l’app per registrare l’estensione Luoghi.
  • Implementa il tracciamento della geolocalizzazione dal servizio Places nell’app.

Configurazione

Affinché il servizio Places funzioni all’interno dell’app e nell’SDK di Mobile, devi effettuare alcune impostazioni.

Definisci luoghi

È possibile definire alcuni punti di interesse nel servizio Places.

  1. Nell'interfaccia utente di Data Collection, selezionare Places.
  2. Seleziona Altro .
  3. Dal menu di scelta rapida, selezionare Gestisci librerie.
    Gestisci librerie
  4. Nella finestra di dialogo Gestisci librerie, seleziona Nuovo.
  5. Nella finestra di dialogo Crea libreria immetti un Nome, ad esempio Luma.
  6. Seleziona Conferma.
    Crea libreria
  7. Per chiudere la finestra di dialogo Gestisci librerie, selezionare Chiudi.
  8. Di nuovo in Gestione POI, seleziona Importa POI.
  9. Seleziona Inizio nella finestra di dialogo Importa luoghi.
  10. Seleziona Luma dall'elenco delle librerie,
  11. Seleziona Avanti.
    Seleziona libreria
  12. Scarica il file ZIP Luma POIs ed estrailo in una posizione sul computer.
  13. Nella finestra di dialogo Importa luoghi, trascina il file luma_pois.csv estratto su Scegli il file CSV - Trascina e rilascia il file. Dovresti trovare Convalida completata - Il file CSV è stato convalidato correttamente.
  14. Selezionare Inizia importazione. Dovresti vedere Operazione completata - Sono stati aggiunti 6 nuovi POI.
  15. Seleziona Fine.
  16. In Gestione POI, dovresti notare che sei nuovi store Luma sono stati aggiunti all'elenco. Puoi passare dalla visualizzazione Elenco alla visualizzazione Mappa .
    Elenco luoghi .

Estensione Install Places

  1. Passa a Tag, individua la proprietà del tag mobile e apri la proprietà.

  2. Seleziona Estensioni.

  3. Seleziona Catalogo.

  4. Cerca l'estensione Places.

  5. Installa l’estensione.

    Aggiungi estensione Decisioning

  6. Nella finestra di dialogo Installa estensione:

    1. Selezionare Luma dall'elenco Seleziona una libreria.

    2. Verifica di aver scelto la tua libreria di lavoro, ad esempio Build iniziale.

    3. Seleziona Salva nella libreria e genera da Salva nella libreria.

      Installa estensione Luoghi .

  7. La libreria viene ricreata.

Verifica lo schema

Verifica se lo schema, come definito in Crea schema, incorpora i gruppi di campi e le classi necessari per raccogliere i dati dei punti di interesse e di geolocalizzazione.

  1. Passa all'interfaccia di Data Collection e seleziona Schemi dalla barra a sinistra.
  2. Seleziona Sfoglia dalla barra superiore.
  3. Seleziona lo schema per aprirlo.
  4. Nell'editor schema, selezionare Evento esperienza del consumatore.
  5. È presente un oggetto placeContext con oggetto e campi per acquisire i dati di interazione e geolocalizzazione dei punti di interesse.
    Posizioni schema .

Aggiornare la proprietà tag

L’estensione Luoghi per i tag fornisce funzionalità per monitorare gli eventi di geolocalizzazione e consente di attivare azioni basate su tali eventi. Puoi utilizzare questa funzionalità per ridurre al minimo la codifica API da implementare nell’app.

Elementi dati

Innanzitutto, puoi creare diversi elementi dati.

  1. Passa alla proprietà tag nell’interfaccia utente di Data Collection.

  2. Seleziona Elementi dati dalla barra a sinistra.

  3. Selezionare Aggiungi elemento dati.

  4. Nella schermata Crea elemento dati, immettere un nome, ad esempio Name - Entered.

  5. Seleziona Luoghi dall'elenco Estensione.

  6. Selezionare Nome dall'elenco Tipo elemento dati.

  7. Seleziona Current POI sotto TARGET.

  8. Seleziona Salva nella libreria.
    Elemento dati

  9. Ripeti i passaggi da 4 a 8 utilizzando le informazioni della tabella seguente, per creare elementi di dati aggiuntivi.

    table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4
    Nome Estensione Tipo di elemento dati TARGET
    Name - Exited Places Nome Ultimo punto di interesse di uscita
    Category - Current Places Categoria POI corrente
    Category - Exited Places Categoria Ultimo punto di interesse di uscita
    City - Current Places Città POI corrente
    City - Exited Places Città Ultimo punto di interesse di uscita

    Dovresti disporre del seguente elenco di elementi dati.

    Elenco di elementi dati

Regole

Ora devi definire le regole da utilizzare con questi elementi dati.

  1. Nella proprietà tag, seleziona Regole dalla barra a sinistra.

  2. Seleziona Aggiungi regola.

  3. Nella schermata Crea regola, immetti un nome per la regola, ad esempio POI - Entry.

  4. Seleziona Aggiungi sotto EVENTI.

    1. Seleziona Luoghi dall'elenco Estensione e seleziona Inserisci POI dall'elenco Tipo evento.

    2. Seleziona Mantieni modifiche.

      Tag evento .

  5. Seleziona Aggiungi sotto AZIONI.

    1. Seleziona Mobile Core dall'elenco Extension, seleziona Allega dati da Action Type. Questa azione allega i dati del payload.

    2. Nel payload JSON, incolla il seguente payload:

      code language-json
      {
          "xdm": {
              "eventType": "location.entry",
              "placeContext": {
                  "geo": {
                      "city": "{%%City - Current%%}"
                  },
                  "POIinteraction": {
                      "poiDetail": {
                          "name": "{%%Name - Current%%}",
                          "category": "{%%Category - Current%%}"
                      },
                      "poiEntries": {
                          "value": 1
                      }
                  }
              }
          }
      }
      

      Puoi anche inserire {%% ... %%} valori segnaposto di elementi dati nel JSON selezionando Dati . Una finestra di dialogo a comparsa consente di scegliere qualsiasi elemento dati creato.

    3. Seleziona Mantieni modifiche.

      Azione tag

  6. Seleziona Aggiungi accanto all'azione Core mobile - Allega dati.

    1. Seleziona Edge Network Adobe Experience Platform dall'elenco Estensione e seleziona Inoltra evento all'Edge Network. Questa azione assicura che l’evento e i dati di payload aggiuntivi vengano inoltrati all’Edge Network di Platform.
    2. Seleziona Mantieni modifiche.
  7. Per salvare la regola, selezionare Salva nella libreria.

    Regola

Creiamo un’altra regola

  1. Nella schermata Crea regola, immetti un nome per la regola, ad esempio POI - Exit.

  2. Seleziona Aggiungi sotto EVENTI.

    1. Seleziona Luoghi dall'elenco Estensione e seleziona Esci da POI dall'elenco Tipo evento.
    2. Seleziona Mantieni modifiche.
  3. Seleziona Aggiungi sotto AZIONI.

    1. Selezionare Mobile Core dall'elenco Extension, selezionare Allega dati dall'elenco Action Type.

    2. Nel payload JSON, incolla il seguente payload:

      code language-json
      {
          "xdm": {
              "eventType": "location.exit",
              "placeContext": {
                  "geo": {
                      "city": "{%%City - Exited%%}"
                  },
                  "POIinteraction": {
                      "poiExits": {
                          "value": 1
                      },
                      "poiDetail": {
                          "name": "{%%Name - Exited%%}",
                          "category": "{%%Category - Exited%%}"
                      }
                  }
              }
          }
      }
      
    3. Seleziona Mantieni modifiche.

  4. Seleziona Aggiungi accanto all'azione Core mobile - Allega dati.

    1. Seleziona Edge Network Adobe Experience Platform dall'elenco Estensione e seleziona Inoltra evento all'Edge Network.
    2. Seleziona Mantieni modifiche.
  5. Per salvare la regola, selezionare Salva nella libreria.

    Regola

Per pubblicare tutte le modifiche apportate al tag

  1. Selezionare Build iniziale come libreria da compilare.
  2. Seleziona Build.
    Genera libreria

Convalida impostazione in Assurance

Per convalidare la configurazione in Assurance:

  1. Passa all’interfaccia utente Assurance.
  2. Se non è già disponibile nella barra a sinistra, seleziona Configura nella barra a sinistra e seleziona Aggiungi accanto a Eventi e Mappa e simula sotto PLACES SERVICE.
  3. Seleziona Salva.
  4. Seleziona Mappa e simula nella barra a sinistra.
  5. Sposta la mappa nella posizione di uno dei punti di interesse.
  6. Seleziona Ingranaggio Simula punti di interesse di caricamento. Il punto di interesse viene identificato mediante un cerchio e un pin.
  7. Seleziona il punto di interesse.
  8. Dal popup, selezionare Gear Simulate Entry Event.
    Simula evento di ingresso
  9. Seleziona Eventi dalla barra a sinistra per visualizzare gli eventi simulati.
    Convalida di AJO Decisioning

Implementare Places nell’app

Come descritto nelle lezioni precedenti, l’installazione di un’estensione tag per dispositivi mobili fornisce solo la configurazione. Ora devi installare e registrare l’SDK Places. Se questi passaggi non sono chiari, controlla la sezione Installare gli SDK.

NOTE
Se hai completato la sezione Installare gli SDK, l'SDK Luoghi è già installato e puoi saltare questo passaggio.
  1. In Xcode, accertati che AEP Places sia aggiunto all'elenco dei pacchetti nelle dipendenze dei pacchetti. Consulta Gestione pacchetti Swift.

  2. Passa a Luma > Luma > AppDelegate nel Navigator dei progetti Xcode.

  3. Assicurarsi che AEPPlaces faccia parte dell'elenco delle importazioni.

    code language-swift
    import AEPPlaces
    
  4. Assicurarsi che Places.self faccia parte dell'array di estensioni che si sta registrando.

    code language-swift
    let extensions = [
        AEPIdentity.Identity.self,
        Lifecycle.self,
        Signal.self,
        Edge.self,
        AEPEdgeIdentity.Identity.self,
        Consent.self,
        UserProfile.self,
        Places.self,
        Messaging.self,
        Optimize.self,
        Assurance.self
    ]
    
  5. Passa a Luma > Luma > Utils > MobileSDK nel navigatore progetti Xcode e trova la funzione func processRegionEvent(regionEvent: PlacesRegionEvent, forRegion region: CLRegion) async. Aggiungi il seguente codice:

    code language-swift
    // Process geolocation event
    Places.processRegionEvent(regionEvent, forRegion: region)
    

    Questa API Places.processRegionEvent comunica le informazioni di geolocalizzazione al servizio Places.

  6. Passa a Luma > Luma > Views > Location > GeofenceSheet nel Navigatore progetti di Xcode.

    1. Per il pulsante Immissione, immettere il codice seguente
    code language-swift
    // Simulate geofence entry event
    Task {
        await MobileSDK.shared.processRegionEvent(regionEvent: .entry, forRegion: region)
    }
    
    1. Per il pulsante Esci, immetti il codice seguente
    code language-swift
    // Simulate geofence exit event
    Task {
        await MobileSDK.shared.processRegionEvent(regionEvent: .exit, forRegion: region)
    }
    

Convalida tramite l’app

  1. Apri l’app su un dispositivo o nel simulatore.

  2. Passa alla scheda Posizione.

  3. Sposta (trascina) la mappa per assicurarti che il cerchio blu centrale sia sopra uno dei punti di interesse, ad esempio Londra.

  4. Tocca {width="20"} finché la categoria e il nome non vengono visualizzati nell'etichetta nella posizione rossa con il pin.

  5. Tocca l'etichetta del punto di interesse, che apre il foglio POI nelle vicinanze.

    {width="300"}

  6. Premi i pulsanti Entrata o Uscita per simulare eventi di entrata recinto geografico e uscita recinto geografico dall'app.

    {width="300"}

  7. Dovresti visualizzare gli eventi nell’interfaccia utente Assurance.

Passaggi successivi

Ora dovresti disporre di tutti gli strumenti necessari per iniziare ad aggiungere ulteriori funzionalità alla funzionalità di geolocalizzazione nell’app. Dopo aver inoltrato gli eventi all'Edge Network, dopo aver configurato l'app per l'Experience Platform, dovresti vedere gli eventi esperienza visualizzati per il profilo utilizzato nell'app.

Nella sezione Journey Optimizer di questo tutorial, vedrai che gli eventi di esperienza possono essere utilizzati per attivare i percorsi (vedi notifica push e messaggistica in-app con Journey Optimizer). Ad esempio, il solito esempio di invio all’utente dell’app di una notifica push con una promozione di prodotto quando l’utente entra nel recinto geografico di un negozio fisico.

Hai visto un’implementazione delle funzionalità dell’app, principalmente guidata dal servizio Places e dagli elementi dati e regole definiti nella proprietà tag. Di conseguenza, la riduzione a icona del codice nell’app. In alternativa, puoi implementare la stessa funzionalità direttamente nell'app utilizzando l'API Edge.sendEvent (vedi Eventi per ulteriori informazioni) con un payload XDM contenente un oggetto placeContext popolato.

SUCCESS
Ora hai abilitato l’app per i servizi di geolocalizzazione utilizzando l’estensione Places nell’SDK di Experience Platform Mobile.
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: Mappa i dati su Adobe Analytics

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