Dokumentation Mobile SDK Places Service-Anleitung

Recommendations to test Places-Service test-validate-loc-svc

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:

Viele Kunden und Organisationen werden POIs auf der ganzen Welt definieren. Daher ist es wichtig, eine Möglichkeit zu haben, zu simulieren und zu testen, wie der Places Service mit Ihrer Anwendung interagiert. Diese Informationen helfen Ihnen zu verstehen, wie Sie die Ein- und Ausstiege des Places-Service testen und validieren können, die auf der Grundlage der definierten POIs und des aktuellen Speicherorts eines Benutzers korrekt ausgelöst werden.

Da Umgebungsvariablen ein Faktor für Standortsignal und -genauigkeit sein können, empfehlen wir, zunächst Grundlagenergebnisse zu ermitteln, indem lokal mit Entwickler-Tools und simulierten Standorteinträgen gearbeitet wird. Das Ziel besteht darin, sicherzustellen, dass 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 in der Places Service-Benutzeroberfläche erstellt wurden und die neuesten Versionen der Places-Erweiterung installiert und korrekt konfiguriert sind. Bei der aktiven Regionsüberwachung wird auch von einer Lösung zur Regionsüberwachung ausgegangen. Weitere Informationen finden Sie unter Places-Erweiterung, CoreLocation-Dokumentation für iOS oder Dokumentation zum Android-Standort.

Schritt

Beschreibung

Erwartetes Ergebnis

Vergewissern Sie sich, dass die richtigen Manifestschlüssel eingegeben wurden, damit Android Zugriff auf den Tracking-Speicherort gewährt.

Bestätigt

Bestätigen Sie, dass Standortaktualisierungen in iOS konfiguriert sind. Stellen Sie außerdem sicher, dass Sie über die entsprechenden PLIST-Schlüssel in iOS verfügen, um die Benutzerberechtigung zum Nachverfolgen des Speicherorts anzufordern.

Bestätigt

Überprüfen Sie, welcher Überwachungsmodus für iOS festgelegt ist. Der kontinuierliche Modus ermöglicht eine höhere Genauigkeit und Persistenz, führt aber auch zu einer höheren Akkulaufzeit.

Wesentliche Änderungen oder kontinuierliche Änderungen

Wenn Sie mehr als eine POIs-Bibliothek verwenden, überprüfen Sie, ob die entsprechenden Bibliotheken in der Places-Erweiterung für das Experience Platform Launch ausgewählt wurden.

Bestätigt

Vergewissern Sie sich, dass die neuesten Versionen von Mobile Core und Places Erweiterungen über Gradle oder CocoaPods mit der App gebündelt wurden.

Bestätigt - Weitere Informationen zu aktuellen Updates finden Sie unter Versionshinweise.

Vergewissern Sie sich, dass die richtigen Umgebungen für Tests konfiguriert sind. Die ID der Launch-Umgebung sollte mit Ihrer Launch-Entwicklungsumgebung übereinstimmen.

Bestätigt

Erstellen Sie GPX-Dateien für jeden POI, den Sie testen möchten. GPX-Dateien können in einer lokalen Entwicklungsumgebung verwendet werden, um einen Standorteintrag zu simulieren. Informationen zum Erstellen und Verwenden von GPX-Dateien finden Sie unter:
GPX-Dateien für iOS Simulator [geschlossen]
https://mapstogpx.com/mobiledev.php
LOCATION TESTING IN MOBILE APPS

GPX-Dateien werden im App-Projekt erstellt und geladen.

Ohne weitere Maßnahmen sollten Sie in der Lage sein, die Anwendung von Android Studio oder XCode aus zu starten und den entsprechenden Warnhinweis anzuzeigen, um Zugriff auf den Tracking-Speicherort anzufordern. Klicken Sie auf Immer zulassen Berechtigung.

Es wird empfohlen, ein echtes Gerät zu verwenden, das mit Ihrem Computer verbunden ist, anstatt den Gerätesimulator zu verwenden.

Die Eingabeaufforderung für die Standortanfrage sollte bei der Anwendung angezeigt werden, die über die IDE geladen wurde

Sobald die Standortberechtigung akzeptiert wurde. Die Places SDK ruft den aktuellen Speicherort des Geräts ab, und der Überwachungscode der Region sollte mit der Überwachung der 20 nächstgelegenen POIs vom aktuellen Speicherort beginnen

Siehe das Protokollbeispiel unter der Tabelle.

Das Wechseln zwischen verschiedenen Speicherorten in XCode oder Android Studio sollte Eintrittsereignisse für bestimmte POIs erzeugen. Die folgenden Protokolle werden bei Eintritt in einen POI erwartet.

Siehe das Protokollbeispiel unter der Tabelle.

Nachdem der Regionsmonitor in der Nähe POIs gefunden hat, sollten Sie testen, indem Sie Pings an den Standort senden. Erstellen Sie in Launch eine neue Regel, die die Places-Erweiterung zum Trigger auf der Grundlage eines Geofencing-Eintrags verwendet. Erstellen Sie dann eine neue Aktion, indem Sie Mobile Core verwenden, um ein Postback zu senden. Wenn Sie eine Slack-Webhook-App erstellen, können Sie Standorteinträge und -austritte 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:
Aktueller POI-Name
Aktueller POI lat
Current POI long
Last Entered name
Last
Last Entered long
Last Exited name
Last Exited lat
Last Exited long
Timestamp

10b

Erstellen Sie eine neue Regel mit einem Ereignis = Orte → Eingabe des POI

10c

Erstellen einer Aktion = Mobile Core → Postback

10 T

Verwenden Sie die Webhook-URL für Ihre Slack-App, z. B. https://hooks.slack.com/services/TKN5FKS68/BNFP7SVD…

10e

Der Hauptteil des Posts sieht in etwa so aus:

{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 in der Launch-Benutzeroberfläche eine funktionierende Entwicklungsbibliothek auswählen.)

Starten und testen Sie Ihre Anwendung erneut, indem Sie zwischen den GPX-Speicherorten in der Entwicklungs-IDE wechseln.

Sie sollten jetzt Slack-Benachrichtigungen mit Einträgen für jeden POI sehen, wenn Sie verschiedene Speicherorte in Ihrer Entwicklungsumgebung auswählen.

QUICK SUMMARY POINT
Alle diese Tests können lokal durchgeführt werden, ohne einen bestimmten POI-Speicherort aufrufen zu müssen. Validierungstests helfen sicherzustellen, dass Ihre Anwendung korrekt konfiguriert ist und die richtigen Berechtigungen für den Speicherort erhalten hat.

Diese Validierung gibt Ihnen auch die Gewissheit, dass die definierten POIs korrekt mit Ihrer Implementierung zur regionalen Überwachung funktionieren. Nach diesem Schritt beginnen wir mit dem Testen von Nachrichten in Campaign, um zu sehen, ob die richtigen Nachrichten basierend auf POI-Ein- und Ausstiegen angezeigt werden.

Testen von In-App-Nachrichten in Adobe Campaign Standard mit dem Places-Service.

Konfigurieren Sie im Hauptdashboard der Kampagne eine neue In-App-Nachricht (Typ = Broadcast)

12a

Wählen Sie in Trigger Ereignistyp Orte - Eintrag als Trigger.

12b

Wählen Sie Orte benutzerdefinierte Metadaten als zusätzlichen Filter aus - verwenden Sie den POI-Typ = Zuletzt eingegebener POI.
Wir verwenden Zuletzt eingegeben als POI-Typ, da in den meisten Fällen Zuletzt eingegeben mit Aktueller POI übereinstimmt.

Aktueller POI  sollte nur in Fällen verwendet werden, in denen sich POI-Geofences überschneiden. In diesem Fall müssen diese POIs EINEN RANG erhalten. Anschließend zeigt der  Aktuelle POI  den POI an, der aus den 2 oder 3 Geofences, in denen sich ein Benutzer derzeit befindet, den höchsten Rang einnimmt.

12c

Wählen Sie einen benutzerdefinierten Metadatenschlüssel aus, mit dem Sie einschränken können, welche POIs eine Nachricht erhalten sollen.

12 T

Behalten Sie für Häufigkeit und Dauer nur ein oder zwei Tage bei, damit Sie den Trigger in einem kürzeren Zeitraum ablaufen lassen können, wenn Sie die Kriterien nicht mögen.

12e

Wählen Sie für Immer/Einmal oder Bis zum Durchklicken die Option IMMER aus, damit Sie über mehrere Standorte hinweg testen können.

Eine In-App-Nachricht wird IMMER angezeigt, wenn Sie eine Ortsänderung simulieren, die den entsprechenden Metadatenkriterien entspricht.

12f

Wählen Sie für die Anzeige eine andere Option als Lokale Benachrichtigung aus. Dadurch wird es einfacher, beim Testen mit der App im Vordergrund zu sehen.)

12g

In-App-Nachricht vorbereiten/bestätigen und bereitstellen

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 Campaign-Regeldatei auf das Gerät heruntergeladen werden kann.

Wechseln Sie in Ihrer Entwicklungsanwendung mithilfe der zuvor erstellten GPX-Dateien zwischen Speicherorten.

Die In-App-Nachricht sollte nun basierend auf den zuvor festgelegten Kriterien angezeigt werden.

Beim nächsten Test werden wir im Wesentlichen die gleichen Schritte wie zuvor kopieren, aber dieses Mal werden wir die LOKALE BENACHRICHTIGUNG testen.

Als Ergebnis wird erwartet, dass die lokalen Benachrichtigungen jedes Mal angezeigt werden, wenn übereinstimmende Kriterien erfüllt sind.

Konfigurieren Sie eine neue In-App-Nachricht (Typ = Broadcast).

16a

Wählen Sie in Trigger Ereignistyp Orte - Eintrag als Trigger aus.

16b

Wählen Sie die benutzerdefinierten Platzierungen von Metadaten als zusätzlichen Filter aus - verwenden Sie POI-Typ = Zuletzt eingegebener POI.

16c

Wählen Sie einen benutzerdefinierten Metadatenschlüssel aus, mit dem Sie einschränken können, welche POIs eine Nachricht erhalten sollen.

16d

Behalten Sie für Häufigkeit und Dauer nur ein oder zwei Tage bei, damit Sie den Trigger in einem kürzeren Zeitraum ablaufen lassen können, wenn Sie die Kriterien nicht mögen.

16e

Für „Immer/Einmal“ oder „Bis zum Clickthrough“, IMMER.

16f

Wählen Sie für den Anzeigetyp die Option Lokale Benachrichtigung.

16g

In-App-Nachricht vorbereiten/bestätigen und bereitstellen

Verbinden Sie in der Entwicklungsumgebung Ihr Gerät und drücken Sie Play auf dem Build. Nachdem Sie festgestellt haben, dass der Speicherort funktioniert, führen Sie die Hintergrundanwendung aus und wechseln Sie weiter zwischen Speicherorten in Xcode oder Android Studio. Sie sollten weiterhin Konsolenlesevorgänge sehen, die den Speicherort-Wechsel anzeigen, und Sie sollten auch lokale Benachrichtigungen je nach den in Ihrem Trigger festgelegten Kriterien sehen. (Es kann eine Verzögerung von 1-2 Sekunden geben.)

Es wird erwartet, dass lokale Benachrichtigungen jedes Mal angezeigt werden, wenn die entsprechenden Kriterien erfüllt sind.

ZUSAMMENFASSUNGSPUNKT
In dieser Phase sollten POI-Einträge in unserer lokalen Umgebung angezeigt werden. Wir sollten auch Nachrichten von Campaign sehen, die auf der POI-Arbeit basieren. Wenn Fehler auftreten, überprüfen Sie, ob eine Slack-Benachrichtigung nicht ausgegeben wurde. Wenn keine Slack-Meldung angezeigt wird, überprüfen Sie die Anwendungskonsole, da u. U. kein neuer Standorteintrag aufgezeichnet wurde. Wenn die Ergebnisse erfolgreich sind, können wir ziemlich sicher sein, dass die Anwendung ordnungsgemäß funktioniert und dass der Places-Service und der Campaign-Messaging-Service ebenfalls ordnungsgemäß funktionieren.

TESTS VOR ORT
Beim Testen vor Ort sollte sich nicht viel ändern. Das Aufrechterhalten des Slack-Postbacks sollte Aufschluss darüber geben, ob das Gerät einen Ein- und Ausstieg für den Speicherort erhält.

Führen Sie Tests mit Geräten durch, die mit WiFi und Mobile deaktiviert beginnen, und aktivieren Sie dann einmal in der POI-Region.

Wenn ein Fehler auftritt, notieren Sie sich, ob Sie einen Geo-Fence-Eintrag und eine Benachrichtigung auf Slack erhalten. Wie lautet der Zeitstempel der Slack-Benachrichtigung?

Führen Sie den Test nur mit aktiviertem Mobiltelefon und ausgeschaltetem WLAN durch.

Führen Sie einen Test mit eingeschaltetem Handy und WiFi durch.

SUMMARY POINT
Tests vor Ort sollten eng mit den Entwicklungstests übereinstimmen. Denken Sie daran, dass bei der Bestimmung eines Benutzerstandorts einige Umgebungsfaktoren eine Rolle spielen können, z. B. die Dauer der in einem POI-Geozaun verbrachten Zeit, die Verfügbarkeit des Zellsignals und die Stärke der nahegelegenen WiFi-Zugriffspunkte.

Protokollbeispiele

Schritt 8 : Während einer Standortaktualisierung wurden iOS- und Android-Protokolle erwartet.

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 : Bei einem Ereignis werden iOS- und Android-Protokolle erwartet.

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