Recommendations per testare il servizio Luoghi

Molti clienti e organizzazioni definiranno i POI in tutto il mondo, pertanto è importante avere un modo per simulare e verificare in che modo i Servizi Luoghi interagiscono con la tua applicazione. Queste informazioni sono utili per verificare e convalidare le voci e le uscite del servizio Luoghi che vengono attivate correttamente in base ai POI definiti e alla posizione corrente di un utente.

Poiché le variabili ambientali possono essere un fattore di segnalazione e precisione della posizione, è consigliabile stabilire i risultati della linea di base prima lavorando localmente con gli strumenti di sviluppo e le voci di posizione simulate. L'obiettivo è convalidare il corretto funzionamento di tutti gli eventi di posizione. Una volta convalidati correttamente gli eventi di posizione, è possibile sottoporre a test le integrazioni della soluzione (ad esempio, Analytics, Target e Campaign). Per facilitare le attività di test, è necessario configurare Slack Webhooks con un postback e caricare i file GPX nel singolo ambiente di sviluppo.

IMPORTANTE

Questo piano presuppone che siano stati creati dei punti di interesse nell’interfaccia utente 🔗 del servizio Luoghi e che le versioni più recenti dell’estensione Luoghi e Monitor Luoghi siano state installate e configurate correttamente. Per ulteriori informazioni, consultate Estensione 🔗 Luoghi e EstensioneMonitor luoghi.

Passaggio Descrizione Risultato previsto
1 Verificate che siano state immesse le chiavi manifest corrette affinché Android conceda l'accesso alla posizione di tracciamento. Per ulteriori informazioni, vedi Aggiungere le autorizzazioni al manifesto. Confermato
1a Confermare la configurazione degli aggiornamenti della posizione in iOS. Verificate inoltre di disporre delle chiavi plist appropriate in iOS per richiedere l'autorizzazione dell'utente al tracciamento della posizione. Per ulteriori informazioni, consultate Attivare gli aggiornamenti di posizione in background. Confermato
2 Verificare quale modalità di monitoraggio è impostata per iOS. La modalità continua consente una maggiore precisione e persistenza, ma anche una maggiore durata della batteria. Per ulteriori informazioni, consultate Modalità di monitoraggio (solo iOS). Modifiche significative o continue
3 Se utilizzate più librerie POI, verificate che nell’estensione Luoghi siano state selezionate le librerie appropriate, ad Experience Platform Launch. Confermato
4 Verificate che le versioni più recenti delle estensioni Mobile Core e Places/Places Monitor siano state incluse nell'app tramite Gradle o CocoaPods. Confermato: per ulteriori informazioni sugli aggiornamenti recenti, consulta le note sulla versione.
5 Verificate che gli ambienti corretti siano configurati per il test. L'ID dell'ambiente Launch deve corrispondere all'ambiente di sviluppo Launch. Confermato
6 Create file GPX per ciascun POI da verificare. I file GPX possono essere utilizzati nell'ambiente di sviluppo locale per simulare una voce di posizione. Per informazioni sulla creazione e l'utilizzo di file GPX, consultate le seguenti sezioni:
File GPX per iOS Simulator [closed]
https://mapstogpx.com/mobiledev.
phpLOCATION TESTING IN MOBILE APPS		 I file GPX vengono creati e caricati nel progetto dell'app.
7 Senza fare altro, dovresti essere in grado di avviare l'applicazione da Android Studio o XCode e visualizzare l'avviso appropriato per richiedere l'accesso per il percorso di tracciamento. Fate clic sull'autorizzazione Consenti sempre .

È consigliabile utilizzare un dispositivo reale collegato al computer invece di utilizzare il simulatore del dispositivo.		 La richiesta di posizione deve essere visualizzata nell'applicazione caricata tramite IDE
8 Una volta accettata l'autorizzazione Posizione. L’SDK Luoghi recupererà la posizione corrente del dispositivo e l’estensione Luoghi monitor inizierà a monitorare i 20 POI più vicini dalla posizione corrente Vedere l'esempio di registro sotto la tabella.
9 La commutazione tra diverse posizioni nello studio XCode o Android dovrebbe produrre eventi di ingresso per POI specifici. Al momento dell’accesso a un POI sono previsti i seguenti registri. Vedere l'esempio di registro sotto la tabella.
10 Dopo aver visualizzato i punti di interesse vicini nel monitor Luoghi, è necessario eseguire il test inviando i punti di interesse. In Avvia, crea una nuova regola che utilizza l'estensione Luoghi per l'attivazione in base a una voce di geotrecinto. Quindi crea una nuova azione utilizzando Mobile Core per inviare un postback. La creazione di un'app Webhook Slack consente di visualizzare le voci e le uscite di posizione. Per informazioni sulla creazione di un'app Webhook per Slack, consultate Invio di messaggi tramite webhooks in arrivo.
10a In Launch, accertati di aver aggiunto elementi di dati per l’estensione Places, tra cui:
Nome POI corrente
Nome POI
Ultimo POI corrente
lungoUltimo
nome inseritoUltimo
ultimo inserito
lungoUltimo
nome uscitoUltimo
ultimo
nome uscito
10b Creare una nuova regola con Evento = Luoghi → Inserisci POI
10c Creare un'azione = Mobile Core → Postback
10d Utilizzate l'URL Webhook per l'app Slack, ad esempio https://hooks.slack.com/services/TKN5FKS68/BNFP7SVD…
10e Il corpo del posto sarebbe simile a: {text: User is in POI - {%%Last Entered POI Name%%} in {%%Last Entered POI City%%} additional information: Radius:{%%Last Entered POI Radius%%} Timestamp: {%%timestamp%%}}.
Assicurarsi di utilizzare gli elementi dati specifici creati qui.
10f Assicurati di pubblicare tutte le modifiche apportate ai nuovi elementi dati e alle regole in Launch. (selezionare una libreria di sviluppo funzionante in alto a destra nell'interfaccia di Launch).
11 Avviate e verificate di nuovo l'applicazione capovolgendo le posizioni della GPX nell'IDE sviluppatore. È ora necessario visualizzare notifiche di Slack che mostrano le voci per ciascun POI quando si selezionano diverse posizioni nell’ambiente di sviluppo.
RAPIDO
PUNTO RIEPILOGO: tutti i test possono essere condotti localmente senza dover recarsi in una posizione POI specifica. I test di convalida consentono di garantire che l'applicazione sia configurata correttamente e che abbia ricevuto le autorizzazioni corrette per il percorso.

Questa convalida garantisce inoltre che i POI definiti funzionino correttamente con l’estensione Places Monitor. Dopo questo passaggio, inizieremo a testare i messaggi in Campaign per verificare se i messaggi corretti vengono visualizzati in base alle voci e alle uscite del POI.
Test messaggi in-app Adobe Campaign Standard con il servizio Places.
12 Nel dashboard principale della campagna configurate un nuovo messaggio in-app (tipo = trasmesso)
12a Negli attivatori, selezionare Tipo di evento Luoghi - Immissione come attivatore.
12b Selezionate Places Custom metadata come filtro aggiuntivo. Usate il tipo POI = Ultimo POI immesso.
Usiamo Last Entered come tipo POI perché nella maggior parte dei casi, Last Entered sarà lo stesso di Current POI.

Current POI​devono essere utilizzati solo nei casi in cui vi sono aree geografiche POI sovrapposte. In questo caso, questi POI devono essere CLASSIFICATI e quindi Current POI​verrà visualizzato il POI di primo livello tra le 2 o 3 aree geografiche in cui un utente potrebbe trovarsi attualmente.
12c Selezionate una chiave di metadati personalizzata che vi aiuterà a limitare l’ambito del POI a cui verrà inviato un messaggio.
12d Per la frequenza e la durata, mantenete uno o due giorni, in modo che, se non vi piacciono i criteri, possiate scadere il trigger in un periodo di tempo più breve.
12e Per il click-through Always/Once o Fino a, selezionate SEMPRE in modo da poter eseguire il test in più posizioni. Un messaggio in-app viene visualizzato SEMPRE quando simulate una modifica di posizione che soddisfa i criteri di metadati appropriati.
12f Per la visualizzazione, selezionare un'opzione diversa da Notifica locale. Questo semplifica la visualizzazione dei test con l'app in primo piano.
12g Prepara/conferma e distribuisci il messaggio in-app.
13 Nell'ambiente di sviluppo, per assicurarsi che vengano scaricate nuove regole di campagna, chiudete e avviate nuovamente l'applicazione. Non dimenticare che le applicazioni devono essere avviate completamente di nuovo perché il nuovo file delle regole di Campaign sia scaricato sul dispositivo.
14 Nell'applicazione di sviluppo, cambiare posizione utilizzando i file GPX creati in precedenza. Dovresti visualizzare il messaggio in-app in base ai criteri precedenti impostati.
15 Per il test successivo, in sostanza copieremo gli stessi passaggi di prima, ma questa volta testeremo la NOTIFICA LOCALE. Il risultato previsto è che le notifiche locali vengono visualizzate ogni volta che vengono soddisfatti i criteri di corrispondenza.
16 Configura un nuovo messaggio in-app (tipo = trasmissione).
16a Nei trigger, selezionare Places event type - Entry as the trigger.
16b Selezionate i metadati Personalizzato luoghi come filtro aggiuntivo - utilizzate POI type = Last Entered POI.
16c Selezionate una chiave di metadati personalizzata che vi aiuterà a limitare l’ambito del POI a cui verrà inviato un messaggio.
16d Per la frequenza e la durata, mantenete solo uno o due giorni, in modo che, se non vi piacciono i criteri, possiate scadere il trigger in un periodo di tempo più breve.
16e Per il click-through Always/Once o Fino a ALWAYS.
16f Per il tipo di visualizzazione, selezionare Local Notification.
16g Prepara/conferma e distribuisci il messaggio in-app.
17 Nell'ambiente di sviluppo, collegate il dispositivo e premete Play sulla build. Dopo aver stabilito che la posizione funziona, eseguite in background l'applicazione e continuate a cambiare posizione in Xcode o Android Studio. Dovreste comunque vedere i layout della console che indicano la modifica della posizione e le notifiche locali visualizzate in base ai criteri impostati nell'attivatore. (potrebbe verificarsi un ritardo di 1-2 secondi). Il risultato previsto è che le notifiche locali vengono visualizzate ogni volta che i criteri corrispondenti vengono soddisfatti.
SINTESI PUNTO
A questo punto, dovremmo vedere i POI nel nostro ambiente locale. Dovremmo inoltre visualizzare messaggi da Campaign basati sul lavoro POI. In caso di errori, verificate se una notifica di Slack non è stata rilasciata. Se non è presente messaggio di Slack, controllare la console dell’applicazione perché potrebbe non essere stata registrata una nuova voce di posizione. Se i risultati sono positivi, possiamo essere certi che l'applicazione funziona correttamente e che anche il servizio di messaggistica Places Service e Campaign funziona correttamente.
TEST IN SITO
Non è necessario modificare molto durante il test sul posto. Mantenere attivo il postback di rallentamento dovrebbe facilitare la comprensione se il dispositivo sta ottenendo una voce e un'uscita per la posizione.
18 Effettuare test con dispositivi che iniziano con wifi e cellulare disabilitato e quindi attivano una volta nella regione POI. In caso di errore, accertatevi di ricevere una voce relativa al geotrecinto e una notifica nel Slack . Qual è la marca temporale nella notifica del Slack ?
19 Eseguire il test con solo cellulare abilitato e con il wifi spento.
20 Eseguire test con cellulare e wifi acceso.
I test on-site SUMMARY POINT
devono corrispondere al test di sviluppo. Tenere presente che alcuni fattori ambientali possono essere utilizzati per determinare la posizione degli utenti, come la durata del tempo trascorso in una recinzione geografica POI, la disponibilità del segnale cellulare e la forza dei punti di accesso wifi nelle vicinanze.

Esempi di registro

Passaggio 8: Registri iOS e Android previsti durante un aggiornamento della posizione

iOS

[AdobeExperienceSDK DEBUG <com.adobe.placesMonitor>]: Authorization status changed: Always
[AdobeExperienceSDK DEBUG <Places>]: Requesting 20 nearby POIs for device location (<lat>, <longitude>)
[AdobeExperienceSDK DEBUG <Places>]: Response from Places Query Service contained <n> nearby POIs
[AdobeExperienceSDK DEBUG <com.adobe.placesMonitor>]: Received a new list of POIs from Places: (
<ACPPlacePoi: 0x600002b75a40> Name: <poi name>; ID:<poi id>; Center: (<lat>, <long>); Radius: <radius>
..
..)

Android

PlacesMonitor - All location settings are satisfied to monitor location
PlacesMonitor - PlacesMonitorInternal : New location obtained: <latitude> <longitude> Attempting to get the near by pois
PlacesExtension - Dispatching nearby places event with n POIs
PlacesMonitor - Attempting to Monitor POI with id <poi id> name <poi name> latitude <lat> longitude <longitude>
PlacesMonitor - Attempting to Monitor POI with id <poi id> name <poi name> latitude <lat> longitude <longitude>
PlacesMonitor - Attempting to Monitor POI with id <poi id> name <poi name> latitude <lat> longitude <longitude>
...
...
PlacesMonitor - Successfully added n fences for monitoring

Passaggio 9: Registri iOS e Android previsti durante un evento

iOS

[AdobeExperienceSDK TRACE <Places>]: Dispatching Places region entry event for place ID <poiId>

Android

PlacesExtension -  Dispatching Places Region Event for <poi name> with eventType entry

In questa pagina