Recommendations zum Testen des Places-Dienstes test-validate-loc-svc

Viele Kunden und Organisationen definieren Zielpunkte auf der ganzen Welt. Daher ist es wichtig, die Interaktion des Places-Dienstes mit Ihrer Anwendung zu simulieren und zu testen. Diese Informationen helfen Ihnen dabei, zu verstehen, wie Sie die Einstiege und Ausstiege des Places-Dienstes testen und überprüfen können, die basierend auf den definierten Zielpunkten und dem aktuellen Standort eines Benutzers korrekt ausgelöst werden.

Da Umgebungsvariablen ein Faktor für Standortsignal und Genauigkeit sein können, empfehlen wir, dass Sie zunächst Ausgangsergebnisse erstellen, indem Sie lokal mit Entwicklertools und simulierten Standorteinträgen arbeiten. Das Ziel besteht darin zu überprüfen, ob alle Standortereignisse ordnungsgemäß funktionieren. Nachdem die Standortereignisse korrekt validiert wurden, können Lösungsintegrationen (z. B. Analytics, Target und Campaign) getestet werden. Um Ihre Testaktivitäten zu unterstützen, sollten Sie Slack Webhooks mit einem Postback einrichten und GPX-Dateien in Ihre individuelle Entwicklungsumgebung laden.

IMPORTANT
In diesem Plan wird davon ausgegangen, dass POIs im Places Service-Benutzeroberfläche und die neuesten Versionen der Places-Erweiterung installiert und korrekt konfiguriert sind. Bei der aktiven Regionsüberwachung wird außerdem davon ausgegangen, dass eine Regionsüberwachungslösung implementiert ist. Weitere Informationen finden Sie unter Places-Erweiterung, Dokumentation zu CoreLocation für iOS oder Dokumentation zur Android-Position.
Schritt
Beschreibung
Erwartetes Ergebnis
1
Vergewissern Sie sich, dass die richtigen Manifestschlüssel für Android eingegeben wurden, um Zugriff auf den Tracking-Speicherort zu gewähren.
Bestätigt
1a
Bestätigen Sie, dass die Standortaktualisierungen in iOS konfiguriert sind. Stellen Sie außerdem sicher, dass Sie in iOS die entsprechenden plist-Schlüssel eingerichtet haben, um die Benutzerberechtigung zum Tracking des Standorts anzufordern.
Bestätigt
2
Überprüfen Sie, welcher Überwachungsmodus für iOS festgelegt ist. Der kontinuierliche Modus ermöglicht höhere Genauigkeit und Persistenz, aber auch eine höhere Akkulaufzeit.
Erhebliche Änderungen oder fortlaufend
3
Wenn Sie mehr als eine POIs-Bibliothek verwenden, überprüfen Sie, ob die entsprechenden Bibliotheken in der Places-Erweiterung für den Experience Platform Launch ausgewählt wurden.
Bestätigt
4
Vergewissern Sie sich, dass die neuesten Versionen der Mobile Core- und Places-Erweiterungen mit der App über Gradle oder CocoaPods gepackt wurden.
Bestätigt - Weitere Informationen zu den neuesten Aktualisierungen finden Sie unter Versionshinweise.
5
Vergewissern Sie sich, dass die richtigen Umgebungen für Tests konfiguriert sind. Die Launch-Umgebungs-ID sollte mit Ihrer Launch-Entwicklungsumgebung übereinstimmen.
Bestätigt
6
Erstellen Sie GPX-Dateien für jeden POI, den Sie testen möchten. GPX-Dateien können in der lokalen Entwicklungsumgebung verwendet werden, um einen Standorteintrag zu simulieren. Informationen zur Erstellung und Verwendung von GPX-Dateien finden Sie unter folgenden Themen:
GPX-Dateien für iOS Simulator [geschlossen]
https://mapstogpx.com/mobiledev.php
SPEICHERTESTS IN MOBILE APPS
GPX-Dateien werden im App-Projekt erstellt und geladen.
7
Ohne andere Aktionen sollten Sie in der Lage sein, die Anwendung von Android Studio oder XCode aus zu starten und den entsprechenden Warnhinweis anzuzeigen, um den Zugriff für den Tracking-Speicherort anzufordern. Klicken Sie auf Immer zulassen Berechtigung.

Es wird empfohlen, anstelle des Gerätemeditors ein echtes Gerät zu verwenden, das mit Ihrem Computer verbunden ist.
Die Eingabeaufforderung zur Standortanforderung sollte in der Anwendung angezeigt werden, die über IDE geladen wird
8
Sobald die Berechtigung Standort akzeptiert wurde. Das Places-SDK ruft die aktuelle Position des Geräts ab und der Regions-Überwachungscode sollte mit der Überwachung der 20 nächstgelegenen POIs vom aktuellen Standort beginnen
Siehe Protokollbeispiel unter der Tabelle.
9
Beim Wechseln zwischen verschiedenen Positionen in XCode oder Android Studio sollten Eintrittsereignisse für bestimmte POIs generiert werden. Die folgenden Logs werden beim Einstieg in einen POI erwartet.
Siehe Protokollbeispiel unter der Tabelle.
10
Nachdem der Regionsmonitor nahe gelegene POIs gefunden hat, sollten Sie testen, indem Sie Standortpfade senden. Erstellen Sie in Launch eine neue Regel, die die Places-Erweiterung für den Trigger basierend auf einem Geofeneintrag verwendet. Erstellen Sie dann eine neue Aktion, indem Sie mit Mobile Core einen Postback senden. Wenn Sie eine Slack Webhook-App erstellen, können Sie Standorteinstiege und -ausstiege anzeigen. Informationen zum Erstellen einer Slack-Webhook-App finden Sie unter Senden von Nachrichten mit eingehenden Webhooks.
10a
Stellen Sie in Launch sicher, dass Sie Datenelemente für die Places-Erweiterung hinzugefügt haben, darunter Folgendes:
Aktueller POI-Name
Aktueller POI-Wert
Aktuelle POI-Zeit
Nachname eingeben
Zuletzt eingegeben
Letzte Eingabe lang
Last Exit name
Zuletzt beendet
Letzte Ausstiegsdauer
Zeitstempel
10b
Erstellen Sie eine neue Regel mit Ereignis = Places → POI eingeben
10c
Erstellen einer Aktion = Mobile Core → Postback
10d
Verwenden Sie die Webhook-URL für Ihre Slack-App, z. B. https://hooks.slack.com/services/TKN5FKS68/BNFP7SVD…
10e
Der Post-Körper würde Folgendem ähneln: {text: User is in POI - {%%Last Entered POI Name%%} in {%%Last Entered POI City%%} additional information: Radius:{%%Last Entered POI Radius%%} Timestamp: {%%timestamp%%}}.
Stellen Sie sicher, dass Sie die spezifischen Datenelemente verwenden, die Sie hier erstellt haben.
10f
Stellen Sie sicher, dass Sie alle neuen Datenelement- und Regeländerungen in Launch veröffentlichen. (Sie sollten oben rechts auf der Launch-Oberfläche eine funktionierende Entwicklungsbibliothek auswählen.)
11
Starten und testen Sie Ihre Anwendung erneut, indem Sie zwischen den GPX-Speicherorten in der Entwickler-IDE wechseln.
Sie sollten jetzt Slack-Benachrichtigungen mit Einträgen für jeden POI sehen, wenn Sie verschiedene Orte in Ihrer Entwicklungsumgebung auswählen.
SCHNELLER ZUSAMMENFASSUNGSPUNKT
All diese Tests können lokal durchgeführt werden, ohne dass ein bestimmter POI-Standort erforderlich ist. Mithilfe von Validierungstests kann sichergestellt werden, dass Ihre Anwendung korrekt konfiguriert ist und über die richtigen Berechtigungen für den Speicherort verfügt.

Diese Validierung gibt Ihnen auch die Gewissheit, dass die definierten Zielpunkte ordnungsgemäß mit Ihrer Implementierung der regionalen Überwachung funktionieren. Danach werden wir mit dem Testen von Nachrichten in Campaign beginnen, um zu sehen, ob die richtigen Nachrichten basierend auf POI-Einstiegen und -Ausstiegen angezeigt werden.
Testen von Adobe Campaign Standard-In-App-Nachrichten mit dem Places-Dienst.
12
Konfigurieren Sie im Hauptkampagnen-Dashboard eine neue In-App-Nachricht (Typ = broadcast).
12a
Wählen Sie in Trigger Places-Ereignistyp - Einstieg als Trigger.
12b
Auswählen Places Benutzerdefinierte Metadaten als zusätzlichen Filter - verwenden Sie POI-Typ = Letzter eingegebener POI.
Wir verwenden Zuletzt eingegeben als POI-Typ, da in den meisten Fällen Zuletzt eingegeben entspricht Aktueller POI.

Aktueller POI ​ ​sollte nur in Fällen verwendet werden, in denen sich die POI-Geozäune überschneiden. In diesem Fall müssen diese POIs RANKED sein und dann die​ ​ Aktueller POI ​ ​zeigt den POI mit dem höchsten Rang von den 2 oder 3 Geofenräumen an, in denen sich ein Benutzer derzeit befindet.
12c
Wählen Sie einen benutzerdefinierten Metadatenschlüssel aus, mit dem Sie eingrenzen können, welche Zielpunkte eine Nachricht erhalten.
12d
Halten Sie für Häufigkeit und Dauer nur ein oder zwei Tage ein, damit Sie den Trigger in einem kürzeren Zeitraum ablaufen können, wenn Ihnen das Kriterium nicht gefällt.
12e
Wählen Sie für "Immer/Einmal"oder "Bis"die Option IMMER damit Sie mehrere Orte testen können.
Eine In-App-Nachricht wird IMMER angezeigt, wenn Sie eine Standortänderung simulieren, die den entsprechenden Metadatenkriterien entspricht.
12f
Wählen Sie für die Anzeige eine andere Option als "Lokale Benachrichtigung". Dies erleichtert das Testen mit der App im Vordergrund.)
12g
Bereiten Sie die In-App-Nachricht vor/bestätigen und stellen Sie sie bereit.
13
Beenden Sie in Ihrer Entwicklungsumgebung die Anwendung, um sicherzustellen, dass neue Kampagnenregeln heruntergeladen werden, und starten Sie sie erneut.
Vergessen Sie nicht, dass die Anwendungen vollständig neu gestartet werden müssen, damit die neue Datei mit den Campaign-Regeln auf das Gerät heruntergeladen werden kann.
14
Wechseln Sie in Ihrer Entwicklungsanwendung die Speicherorte mithilfe der zuvor erstellten GPX-Dateien.
Sie sollten sehen, dass die In-App-Nachricht basierend auf den zuvor festgelegten Kriterien angezeigt wird.
15
Für den nächsten Test werden wir im Wesentlichen dieselben Schritte wie zuvor kopieren, aber diesmal testen wir die LOKALE BENACHRICHTIGUNG.
Das erwartete Ergebnis ist, dass die lokalen Benachrichtigungen bei jeder Erfüllung der Kriterien angezeigt werden.
16
Konfigurieren Sie eine neue In-App-Nachricht (Typ = broadcast).
16a
Wählen Sie in Trigger Places-Ereignistyp - Einstieg als Trigger.
16b
Wählen Sie die benutzerdefinierten Places-Metadaten als zusätzlichen Filter aus - verwenden Sie POI-Typ = Letzter eingegebener POI.
16c
Wählen Sie einen benutzerdefinierten Metadatenschlüssel aus, mit dem Sie eingrenzen können, welche Zielpunkte eine Nachricht erhalten.
16d
Bewahren Sie für Häufigkeit und Dauer nur ein oder zwei Tage auf, damit Sie den Trigger in kürzerer Zeit ablaufen können, wenn Ihnen das Kriterium nicht gefällt.
16e
Für immer/Einmal oder Bis zum Clickthrough IMMER.
16f
Wählen Sie für den Anzeigetyp Lokale Benachrichtigung.
16g
Bereiten Sie die In-App-Nachricht vor/bestätigen und stellen Sie sie bereit.
17
Verbinden Sie Ihr Gerät in der Entwicklungsumgebung und drücken Sie die Play auf dem Build. Nachdem Sie festgestellt haben, dass der Speicherort funktioniert, hinterlegen Sie die Anwendung im Hintergrund und fahren Sie mit dem Umschalten von Standorten in Xcode oder Android Studio fort. Es sollten weiterhin Konsolenauslesen angezeigt werden, die auf die Standortänderung hinweisen. Abhängig von den in Ihrem Trigger festgelegten Kriterien sollten auch lokale Benachrichtigungen angezeigt werden. (Es kann eine Verzögerung von 1 bis 2 Sekunden geben.)
Das erwartete Ergebnis ist, dass lokale Benachrichtigungen jedes Mal angezeigt werden, wenn die entsprechenden Kriterien erfüllt werden.
ZUSAMMENFASSUNGSPUNKT
Zu diesem Zeitpunkt sollten wir POI-Einträge in unserer lokalen Umgebung sehen. Wir sollten auch Nachrichten von Campaign sehen, die auf der POI-Arbeit basieren. Wenn Fehler auftreten, überprüfen Sie, ob eine Slack-Benachrichtigung nicht gesendet wurde. Wenn keine Fehlermeldung angezeigt wird, überprüfen Sie die Anwendungskonsole, da ein neuer Standorteintrag möglicherweise nicht aufgezeichnet wurde. Wenn die Ergebnisse erfolgreich sind, können wir ziemlich sicher sein, dass die Anwendung ordnungsgemäß funktioniert und dass der Places-Dienst und der Campaign-Messaging-Dienst ebenfalls ordnungsgemäß funktionieren.
ON-SITE-TESTS
Beim Testen am Standort sollte sich nicht viel ändern. Die Aktivierung des Slack-Postbacks hilft dabei zu verstehen, ob das Gerät einen Einstieg und einen Ausstieg für den Standort erhält.
18
Führen Sie Tests mit Geräten durch, die mit WLAN und Mobilgeräten mit Behinderung beginnen, und aktivieren Sie dann einmal im POI-Bereich.
Wenn ein Fehler auftritt, notieren Sie sich, ob Sie einen Geofeneintrag und eine Benachrichtigung in Slack erhalten. Was ist der Zeitstempel in der Slack-Benachrichtigung?
19
Führen Sie den Test mit nur zellulärer Aktivierung und ausgeschaltetem WLAN durch.
20
Führen Sie einen Test mit eingeschaltetem Handy und WLAN durch.
ZUSAMMENFASSUNGSPUNKT
Vor-Ort-Tests sollten eng mit den Entwicklungstests übereinstimmen. Beachten Sie, dass bei der Bestimmung des Benutzerstandorts einige Umgebungsfaktoren zum Tragen kommen können, z. B. die Dauer der Besuchszeit für einen POI-GeoZaun, die Verfügbarkeit von Zellensignalen und die Stärke nahegelegener WLAN-Zugangspunkte.

Protokollbeispiele

Schritt 8: Erwartete iOS- und Android-Protokolle während einer Standortaktualisierung

iOS

[AdobeExperienceSDK DEBUG <Places>]: Requesting 20 nearby POIs for device location (<lat>, <longitude>)
[AdobeExperienceSDK DEBUG <Places>]: Response from Places Query Service contained <n> nearby POIs

Android

PlacesExtension - Dispatching nearby places event with n POIs

Schritt 9 : Erwartete iOS- und Android-Protokolle während eines Ereignisses

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
recommendation-more-help
475fad96-f29f-4dca-a109-68bf0557e825