Orte verwenden
Erfahren Sie, wie Sie den Geolocation-Dienst Places in Ihrer App verwenden.
Der Datenerfassungs-Places-Dienst von Adobe Experience Platform ist ein Geolocation-Dienst, mit dem mobile Apps mit Standorterkennung den Standortkontext verstehen können. Der Dienst verwendet umfangreiche und benutzerfreundliche SDK-Schnittstellen, die von einer flexiblen Datenbank mit Zielpunkten (POIs) begleitet werden.
Voraussetzungen
- Alle Paketabhängigkeiten sind im Xcode-Projekt vorhanden.
- Registrierte Erweiterungen in AppDelegate.
- MobileCore für die Verwendung Ihrer Entwicklungs-AppId konfiguriert.
- Importierte SDKs
- Die App wurde erfolgreich erstellt und mit den oben genannten Änderungen ausgeführt.
Lernziele
In dieser Lektion werden Sie
- Erfahren Sie, wie Sie Zielpunkte im Places-Dienst definieren.
- Aktualisieren Sie Ihre Tag-Eigenschaft mit der Places-Erweiterung.
- Aktualisieren Sie Ihr Schema, um Geolocation-Ereignisse zu erfassen.
- Validieren Sie die Einrichtung in "Assurance".
- Aktualisieren Sie Ihre App, um die Places-Erweiterung zu registrieren.
- Implementieren Sie das Geolocation-Tracking aus dem Places-Dienst in Ihre App.
Einrichten
Damit der Places-Dienst in Ihrer App und im Mobile SDK funktioniert, müssen Sie einige Einstellungen vornehmen.
Festlegen von Orten
Sie definieren einige Zielpunkte im Places-Dienst.
- Wählen Sie in der Datenerfassungs-Benutzeroberfläche die Option Orte.
- Auswählen .
- Wählen Sie im Kontextmenü die Option Bibliotheken verwalten.
- Im Bibliotheken verwalten Dialogfeld auswählen Neu.
- Im Bibliothek erstellen Dialogfeld eingeben Name, beispielsweise
Luma
. - Auswählen Bestätigen.
- So schließen Sie die Bibliotheken verwalten Dialogfeld auswählen Schließen.
- Zurück in POI-Verwaltung auswählen POIs importieren.
- Auswählen Starten im Importorte angezeigt.
- Auswählen Luma aus der Liste der Bibliotheken,
- Klicken Sie auf Weiter.
- Laden Sie die Luma POIs-ZIP-Datei und extrahieren Sie es an eine Stelle auf Ihrem Computer.
- Im Importorte Dialogfeld, ziehen und legen Sie die extrahierte
luma_pois.csv
in CSV-Datei auswählen - Datei ziehen und ablegen. Sie sollten Validierung erfolgreich - CSV-Datei erfolgreich validiert. - Auswählen Import beginnen. Sie sollten Erfolg - 6 neue Zielpunkte wurden erfolgreich hinzugefügt.
- Klicken Sie auf Fertig.
- In POI-Verwaltung, sollten Sie sehen, dass sechs neue Luma-Stores zur Liste hinzugefügt werden. Sie können zwischen
und
Landkartenansicht.
.
Installieren der Places-Erweiterung
-
Navigieren Sie zu Tags und suchen Sie Ihre mobile Tag-Eigenschaft und öffnen Sie die Eigenschaft .
-
Auswählen Erweiterungen.
-
Auswählen Katalog.
-
Suchen Sie nach Orte -Erweiterung.
-
Installieren Sie die -Erweiterung.
-
Im Installieren der Erweiterung dialog:
-
Auswählen Luma aus dem Bibliothek auswählen Liste.
-
Stellen Sie sicher, dass Sie Ihre Arbeitsbibliothek ausgewählt haben, z. B. Ursprünglicher Build.
-
Auswählen In Bibliothek speichern und erstellen von In Bibliothek speichern.
.
-
-
Ihre Bibliothek ist neu aufgebaut.
Prüfen des Schemas
Überprüfen Sie, ob Ihr Schema wie in Schema erstellen, enthält die erforderlichen Feldergruppen und Klassen zur Erfassung von POI- und Geolocation-Daten.
- Navigieren Sie zur Datenerfassungsoberfläche und wählen Sie Schemas über die linke Leiste.
- Auswählen Durchsuchen aus der oberen Leiste.
- Wählen Sie Ihr Schema aus, um es zu öffnen.
- Wählen Sie im Schema-Editor Ereignis für Kundenerlebnisse.
- Sie sehen eine placeContext -Objekt mit Objekt und Feldern zum Erfassen von POI-Interaktionen und Geolocation-Daten.
.
Tag-Eigenschaft aktualisieren
Die Places-Erweiterung für Tags bietet Funktionen zum Überwachen von Geolocation-Ereignissen und ermöglicht den Trigger von Aktionen, die auf diesen Ereignissen basieren. Mit dieser Funktion können Sie die API-Codierung minimieren, die Sie in der App implementieren müssen.
Datenelemente
Erstellen Sie zunächst mehrere Datenelemente.
-
Rufen Sie Ihre Tag-Eigenschaft in der Datenerfassungs-Benutzeroberfläche auf.
-
Auswählen Datenelemente über die linke Leiste.
-
Wählen Sie Datenelement hinzufügen aus.
-
Im Datenelement erstellen Bildschirm, geben Sie einen Namen ein, beispielsweise
Name - Entered
. -
Auswählen Orte aus dem Erweiterung Liste.
-
Auswählen Name aus dem Datenelementtyp Liste.
-
Auswählen Aktueller POI darunter TARGET.
-
Auswählen In Bibliothek speichern.
-
Wiederholen Sie die Schritte 4 bis 8 anhand der Informationen aus der unten stehenden Tabelle, um zusätzliche Datenelemente zu erstellen.
table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 Name Erweiterung Datenelementtyp TARGET Name - Exited
Places Name Letzter ausgesetzter POI Category - Current
Places Kategorie Aktueller POI Category - Exited
Places Kategorie Letzter ausgesetzter POI City - Current
Places Stadt Aktueller POI City - Exited
Places Stadt Letzter ausgesetzter POI Sie sollten über die folgende Liste von Datenelementen verfügen.
Regeln
Als Nächstes definieren Sie Regeln für die Verwendung dieser Datenelemente.
-
Wählen Sie in der Tag-Eigenschaft Regeln über die linke Leiste.
-
Auswählen Regel hinzufügen.
-
Im Regel erstellen Bildschirm einen Namen für die Regel eingeben, z. B.
POI - Entry
. -
Auswählen darunter EREIGNISSE.
-
Auswählen Orte aus dem Erweiterung Liste und Auswahl POI eingeben aus dem Ereignistyp Liste.
-
Wählen Sie Änderungen beibehalten aus.
.
-
-
Auswählen darunter AKTIONEN.
-
Auswählen Mobile Core aus dem Erweiterung Liste auswählen Daten anhängen von Aktionstyp die Liste. Diese Aktion hängt Payload-Daten an.
-
Im JSON-Payload, fügen Sie die folgende Payload ein:
code language-json { "xdm": { "eventType": "location.entry", "placeContext": { "geo": { "city": "{%%City - Current%%}" }, "POIinteraction": { "poiDetail": { "name": "{%%Name - Current%%}", "category": "{%%Category - Current%%}" }, "poiEntries": { "value": 1 } } } } }
Sie können auch
{%% ... %%}
Platzhalterwerte für Datenelemente in der JSON durch Auswahl der . In einem Popup-Dialogfeld können Sie jedes von Ihnen erstellte Datenelement auswählen. -
Wählen Sie Änderungen beibehalten aus.
-
-
Auswählen neben dem Mobile Core - Daten anhängen Aktion.
- Auswählen Adobe Experience Platform Edge Network aus dem Erweiterung Liste und Auswahl Weiterleiten von Ereignissen an Edge Network. Diese Aktion stellt sicher, dass das Ereignis und zusätzliche Payload-Daten an das Platform Edge Network weitergeleitet werden.
- Wählen Sie Änderungen beibehalten aus.
-
Um die Regel zu speichern, wählen Sie In Bibliothek speichern.
Erstellen wir eine weitere Regel
-
Im Regel erstellen Bildschirm einen Namen für die Regel eingeben, z. B.
POI - Exit
. -
Auswählen darunter EREIGNISSE.
- Auswählen Orte aus dem Erweiterung Liste und Auswahl Ausstiegspunkt aus dem Ereignistyp Liste.
- Wählen Sie Änderungen beibehalten aus.
-
Auswählen darunter AKTIONEN.
-
Auswählen Mobile Core von Erweiterung Liste auswählen Daten anhängen von Aktionstyp Liste.
-
Im JSON-Payload, fügen Sie die folgende Payload ein:
code language-json { "xdm": { "eventType": "location.exit", "placeContext": { "geo": { "city": "{%%City - Exited%%}" }, "POIinteraction": { "poiExits": { "value": 1 }, "poiDetail": { "name": "{%%Name - Exited%%}", "category": "{%%Category - Exited%%}" } } } } }
-
Wählen Sie Änderungen beibehalten aus.
-
-
Auswählen neben dem Mobile Core - Daten anhängen Aktion.
- Auswählen Adobe Experience Platform Edge Network aus dem Erweiterung Liste und Auswahl Weiterleiten von Ereignissen an Edge Network.
- Wählen Sie Änderungen beibehalten aus.
-
Um die Regel zu speichern, wählen Sie In Bibliothek speichern.
Um sicherzustellen, dass alle Änderungen in Ihrem Tag veröffentlicht werden
- Auswählen Ursprünglicher Build als Bibliothek, die erstellt werden soll.
- Auswählen Build.
Validieren der Einrichtung in der Zuverlässigkeitserklärung
So überprüfen Sie Ihre Einrichtung in Assurance:
- Navigieren Sie zur Benutzeroberfläche "Assurance".
- Wenn nicht bereits in der linken Leiste verfügbar, wählen Sie Konfigurieren Wählen Sie in der linken Leiste neben Veranstaltungen und Karte und Simulieren darunter PLACES SERVICE.
- Wählen Sie Speichern aus.
- Auswählen Karte und Simulieren in der linken Leiste.
- Verschieben Sie die Karte an die Position eines Ihrer POIs.
- Auswählen Laden-POIs simulieren. Ihr POI wird anhand eines Kreises und einer Nadel identifiziert.
- Wählen Sie Ihren POI aus.
- Wählen Sie im Popup-Fenster
Eintrittsereignis simulieren.
- Auswählen Veranstaltungen über die linke Leiste aus, und Sie sollten die simulierten Ereignisse sehen.
Implementieren von Places in Ihrer App
Wie in den vorherigen Lektionen erläutert, bietet die Installation einer mobilen Tag-Erweiterung nur die Konfiguration. Als Nächstes müssen Sie das Places SDK installieren und registrieren. Wenn diese Schritte nicht klar sind, überprüfen Sie die SDKs installieren Abschnitt.
-
Stellen Sie in Xcode sicher, dass AEP Places wird zur Liste der Pakete in Package-Abhängigkeiten hinzugefügt. Siehe Swift Package Manager.
-
Navigieren Sie zu Luma > Luma > AppDelegate im Xcode-Projektnavigator.
-
Sichern
AEPPlaces
ist Teil Ihrer Importliste.code language-swift import AEPPlaces
-
Sichern
Places.self
ist Teil des Arrays von Erweiterungen, die Sie registrieren.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 ]
-
Navigieren Sie zu Luma > Luma > Utils > MobileSDK im Xcode-Projektnavigator und suchen Sie die
func processRegionEvent(regionEvent: PlacesRegionEvent, forRegion region: CLRegion) async
-Funktion. Fügen Sie den folgenden Code hinzu:code language-swift // Process geolocation event Places.processRegionEvent(regionEvent, forRegion: region)
Diese
Places.processRegionEvent
Die API übermittelt die Geolocation-Informationen an den Places-Dienst. -
Navigieren Sie zu Luma > Luma > Views > Location > GeofenceSheet im Projektnavigator von Xcode.
- Geben Sie für die Schaltfläche "Entry"den folgenden Code ein
code language-swift // Simulate geofence entry event Task { await MobileSDK.shared.processRegionEvent(regionEvent: .entry, forRegion: region) }
- Geben Sie für die Schaltfläche Beenden den folgenden Code ein
code language-swift // Simulate geofence exit event Task { await MobileSDK.shared.processRegionEvent(regionEvent: .exit, forRegion: region) }
Validieren mit Ihrer App
-
Öffnen Sie Ihre App auf einem Gerät oder im Simulator.
-
Navigieren Sie zu Standort Registerkarte.
-
Verschieben Sie die Karte (ziehen Sie sie), um sicherzustellen, dass sich der blaue mittlere Kreis über einem der POIs befindet, z. B. London.
-
Tippen {width="20"} bis die Kategorie und der Name in der Beschriftung an der roten Stelle mit dem Pin erscheinen.
-
Tippen Sie auf die Bezeichnung des POI, wodurch sich der Nächster POI Blatt.
{width="300"}
-
Drücken Sie die Einstieg oder Beenden -Schaltflächen zum Simulieren von Geofence-Einstiegs- und Geofence-Ausstiegsereignissen aus der App.
{width="300"}
-
Sie sollten die Ereignisse in der Assurance-Benutzeroberfläche sehen.
Nächste Schritte
Sie sollten jetzt über alle Tools verfügen, um Ihre Geolocation-Funktionalität in der App um weitere Funktionen zu erweitern. Nachdem Sie die Ereignisse an das Edge Network weitergeleitet haben, nachdem Sie die App für Experience Platformsollten die Erlebnisereignisse angezeigt werden, die für das in der App verwendete Profil angezeigt werden.
Im Abschnitt Journey Optimizer dieses Tutorials sehen Sie, dass Erlebnisereignisse zum Trigger von Journey verwendet werden können (siehe Push-Benachrichtigung und In-App-Messaging mit Journey Optimizer). Beispielsweise das übliche Beispiel, bei dem Sie dem App-Benutzer eine Push-Benachrichtigung mit einer Produktwerbung senden, wenn dieser Benutzer den Geofence eines physischen Stores betritt.
Sie haben eine Implementierung der Funktionen für Ihre App gesehen, die hauptsächlich vom Places-Dienst sowie von den Datenelementen und Regeln gesteuert wird, die Sie in Ihrer Tag-Eigenschaft definiert haben. Minimieren Sie daher den Code in Ihrer App. Alternativ können Sie dieselben Funktionen direkt in Ihrer App implementieren, indem Sie die Edge.sendEvent
API (siehe Veranstaltungen für weitere Informationen) mit einer XDM-Payload, die eine placeContext
-Objekt.
Weiter: Zuordnen von Daten zu Adobe Analytics