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.
- Nell'interfaccia utente di Data Collection, selezionare Places.
- Seleziona .
- Dal menu di scelta rapida, selezionare Gestisci librerie.
- Nella finestra di dialogo Gestisci librerie, seleziona Nuovo.
- Nella finestra di dialogo Crea libreria immetti un Nome, ad esempio
Luma
. - Seleziona Conferma.
- Per chiudere la finestra di dialogo Gestisci librerie, selezionare Chiudi.
- Di nuovo in Gestione POI, seleziona Importa POI.
- Seleziona Inizio nella finestra di dialogo Importa luoghi.
- Seleziona Luma dall'elenco delle librerie,
- Seleziona Avanti.
- Scarica il file ZIP Luma POIs ed estrailo in una posizione sul computer.
- 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. - Selezionare Inizia importazione. Dovresti vedere Operazione completata - Sono stati aggiunti 6 nuovi POI.
- Seleziona Fine.
- In Gestione POI, dovresti notare che sei nuovi store Luma sono stati aggiunti all'elenco. Puoi passare dalla visualizzazione
alla visualizzazione
.
.
Estensione Install Places
-
Passa a Tag, individua la proprietà del tag mobile e apri la proprietà.
-
Seleziona Estensioni.
-
Seleziona Catalogo.
-
Cerca l'estensione Places.
-
Installa l’estensione.
-
Nella finestra di dialogo Installa estensione:
-
Selezionare Luma dall'elenco Seleziona una libreria.
-
Verifica di aver scelto la tua libreria di lavoro, ad esempio Build iniziale.
-
Seleziona Salva nella libreria e genera da Salva nella libreria.
.
-
-
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.
- Passa all'interfaccia di Data Collection e seleziona Schemi dalla barra a sinistra.
- Seleziona Sfoglia dalla barra superiore.
- Seleziona lo schema per aprirlo.
- Nell'editor schema, selezionare Evento esperienza del consumatore.
- È presente un oggetto placeContext con oggetto e campi per acquisire i dati di interazione e geolocalizzazione dei punti di interesse.
.
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.
-
Passa alla proprietà tag nell’interfaccia utente di Data Collection.
-
Seleziona Elementi dati dalla barra a sinistra.
-
Selezionare Aggiungi elemento dati.
-
Nella schermata Crea elemento dati, immettere un nome, ad esempio
Name - Entered
. -
Seleziona Luoghi dall'elenco Estensione.
-
Selezionare Nome dall'elenco Tipo elemento dati.
-
Seleziona Current POI sotto TARGET.
-
Seleziona Salva nella libreria.
-
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.
Regole
Ora devi definire le regole da utilizzare con questi elementi dati.
-
Nella proprietà tag, seleziona Regole dalla barra a sinistra.
-
Seleziona Aggiungi regola.
-
Nella schermata Crea regola, immetti un nome per la regola, ad esempio
POI - Entry
. -
Seleziona sotto EVENTI.
-
Seleziona Luoghi dall'elenco Estensione e seleziona Inserisci POI dall'elenco Tipo evento.
-
Seleziona Mantieni modifiche.
.
-
-
Seleziona sotto AZIONI.
-
Seleziona Mobile Core dall'elenco Extension, seleziona Allega dati da Action Type. Questa azione allega i dati del payload.
-
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 . Una finestra di dialogo a comparsa consente di scegliere qualsiasi elemento dati creato. -
Seleziona Mantieni modifiche.
-
-
Seleziona accanto all'azione Core mobile - Allega dati.
- 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.
- Seleziona Mantieni modifiche.
-
Per salvare la regola, selezionare Salva nella libreria.
Creiamo un’altra regola
-
Nella schermata Crea regola, immetti un nome per la regola, ad esempio
POI - Exit
. -
Seleziona sotto EVENTI.
- Seleziona Luoghi dall'elenco Estensione e seleziona Esci da POI dall'elenco Tipo evento.
- Seleziona Mantieni modifiche.
-
Seleziona sotto AZIONI.
-
Selezionare Mobile Core dall'elenco Extension, selezionare Allega dati dall'elenco Action Type.
-
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%%}" } } } } }
-
Seleziona Mantieni modifiche.
-
-
Seleziona accanto all'azione Core mobile - Allega dati.
- Seleziona Edge Network Adobe Experience Platform dall'elenco Estensione e seleziona Inoltra evento all'Edge Network.
- Seleziona Mantieni modifiche.
-
Per salvare la regola, selezionare Salva nella libreria.
Per pubblicare tutte le modifiche apportate al tag
- Selezionare Build iniziale come libreria da compilare.
- Seleziona Build.
Convalida impostazione in Assurance
Per convalidare la configurazione in Assurance:
- Passa all’interfaccia utente Assurance.
- Se non è già disponibile nella barra a sinistra, seleziona Configura nella barra a sinistra e seleziona accanto a Eventi e Mappa e simula sotto PLACES SERVICE.
- Seleziona Salva.
- Seleziona Mappa e simula nella barra a sinistra.
- Sposta la mappa nella posizione di uno dei punti di interesse.
- Seleziona Simula punti di interesse di caricamento. Il punto di interesse viene identificato mediante un cerchio e un pin.
- Seleziona il punto di interesse.
- Dal popup, selezionare
Simulate Entry Event.
- Seleziona Eventi dalla barra a sinistra per visualizzare gli eventi simulati.
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.
-
In Xcode, accertati che AEP Places sia aggiunto all'elenco dei pacchetti nelle dipendenze dei pacchetti. Consulta Gestione pacchetti Swift.
-
Passa a Luma > Luma > AppDelegate nel Navigator dei progetti Xcode.
-
Assicurarsi che
AEPPlaces
faccia parte dell'elenco delle importazioni.code language-swift import AEPPlaces
-
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 ]
-
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. -
Passa a Luma > Luma > Views > Location > GeofenceSheet nel Navigatore progetti di Xcode.
- Per il pulsante Immissione, immettere il codice seguente
code language-swift // Simulate geofence entry event Task { await MobileSDK.shared.processRegionEvent(regionEvent: .entry, forRegion: region) }
- 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
-
Apri l’app su un dispositivo o nel simulatore.
-
Passa alla scheda Posizione.
-
Sposta (trascina) la mappa per assicurarti che il cerchio blu centrale sia sopra uno dei punti di interesse, ad esempio Londra.
-
Tocca {width="20"} finché la categoria e il nome non vengono visualizzati nell'etichetta nella posizione rossa con il pin.
-
Tocca l'etichetta del punto di interesse, che apre il foglio POI nelle vicinanze.
{width="300"}
-
Premi i pulsanti Entrata o Uscita per simulare eventi di entrata recinto geografico e uscita recinto geografico dall'app.
{width="300"}
-
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.
Successivo: Mappa i dati su Adobe Analytics