Dokumentation Experience Platform Tutorial für Mobile Apps

Verwenden von Orten

Letzte Aktualisierung: 5. Mai 2025

Themen:

Erstellt für:

Einsteiger
Fortgeschrittener
Entwickler

Erfahren Sie, wie Sie den Orte-Geolokalisierungs-Service in Ihrer App verwenden.

Der Datenerfassungs-Orte-Service von Adobe Experience Platform ist ein Geolocation-Service, der es mobilen Apps mit Standorterkennung ermöglicht, den Standortkontext zu verstehen. Der Service verwendet umfangreiche und benutzerfreundliche SDK-Benutzeroberflächen sowie eine flexible Datenbank mit POIs (Points of Interest).

Voraussetzungen

Alle Paketabhängigkeiten sind im Xcode-Projekt vorhanden.
Registrierte Erweiterungen in AppDelegate.
MobileCore wurde für die Verwendung Ihrer Entwicklungs-App-ID konfiguriert.
SDKs importiert.
Die App mit den oben genannten Änderungen wurde erfolgreich erstellt und ausgeführt.

Lernziele

In dieser Lektion werden Sie

Erfahren Sie, wie Sie im Places-Service Zielpunkte definieren.
Aktualisieren Sie Ihre Tag-Eigenschaft mit der Places-Erweiterung.
Aktualisieren Sie Ihr Schema, um Geolokalisierungsereignisse zu erfassen.
Überprüfen Sie das Setup in Assurance.
Aktualisieren Sie Ihre App, um die Places-Erweiterung zu registrieren.
Implementieren Sie das Geolokalisierungs-Tracking über den Places-Service in Ihrer App.

Einrichten

Damit der Places -Service in Ihrer App und in der mobilen SDK funktioniert, müssen Sie einige Einstellungen vornehmen.

Definieren von Orten

Einige interessante Punkte definieren Sie im Places-Service.

Wählen Sie in der Datenerfassungs-Benutzeroberfläche Orte.
Wählen Sie aus.
Wählen Sie im Kontextmenü die Option Bibliotheken verwalten aus.
Wählen im Dialogfeld " verwalten“ die Option Neu.
Geben Sie im Dialogfeld Bibliothek erstellen einen Namen ein, z. B. Luma.
Wählen Sie Bestätigen aus.
Um das Dialogfeld Bibliotheken verwalten zu schließen, wählen Sie Schließen aus.
Zurück in POI-Verwaltung wählen Sie POIs importieren.
Wählen Start im Dialogfeld Importplätze aus.
Wählen Sie Luma aus der Liste der Bibliotheken aus.
Klicken Sie auf Weiter.
Laden Sie die ZIP-Datei der Luma-POIs herunter und extrahieren Sie sie an einen Speicherort auf Ihrem Computer.
Ziehen Sie Dialogfeld " importieren“ die extrahierte luma_pois.csv-Datei per Drag-and-Drop auf CSV-Datei auswählen - Ziehen Sie die Datei per Drag-and-Drop. Sie sollten Validierung erfolgreich - (CSV-Datei erfolgreich validiert sehen.
Wählen Sie Import beginnen. Sie sollten Erfolg sehen 6 neue POIs erfolgreich hinzugefügt.
Wählen Sie Fertig aus.
In POI-) sollten Sie sehen, dass der Liste sechs neue Luma-Stores hinzugefügt werden. Sie können zwischen und Kartenansicht wechseln.
.

Installieren der Places-Erweiterung

Navigieren Sie zu Tags, suchen Sie die Eigenschaft für mobile Tags und öffnen Sie sie.
Wählen Sie Erweiterungen aus.
Wählen Sie Katalog aus.
Suchen Sie nach der Places-Erweiterung.
Installieren Sie die Erweiterung .
Im Dialogfeld Erweiterung installieren:
1. Wählen Sie Luma aus der Liste Bibliothek.
2. Stellen Sie sicher, dass Sie Ihre Arbeitsbibliothek ausgewählt haben, z. B „Initial Build.
3. Wählen Sie In Bibliothek speichern und erstellen unter In Bibliothek speichern.
  
  .
Die Bibliothek wurde neu erstellt.

Prüfen des Schemas

Überprüfen Sie, ob Ihr Schema, wie in Schema erstellen definiert, die erforderlichen Feldergruppen und Klassen zum Erfassen von POI- und Geolokalisierungsdaten enthält.

Navigieren Sie zur Datenerfassungs-Oberfläche und wählen Sie Schemata in der linken Leiste aus.
Wählen Durchsuchen in der oberen Leiste aus.
Wählen Sie Ihr Schema aus, um es zu öffnen.
Wählen Sie im Schema-Editor die Option Consumer Experience Event.
Es wird ein placeContext-Objekt mit Objekten und Feldern zur Erfassung von POI-Interaktions- und Geolokalisierungsdaten angezeigt.
.

Aktualisieren der Tag-Eigenschaft

Die Places -Erweiterung für Tags bietet Funktionen zum Überwachen von Geolokalisierungsereignissen und ermöglicht das 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

Zunächst erstellen Sie mehrere Datenelemente.

Wechseln Sie in der Datenerfassungs-Benutzeroberfläche zu Ihrer Tag-Eigenschaft.
Wählen Datenelemente in der linken Leiste aus.
Wählen Datenelement hinzufügen aus.
Geben Sie Bildschirm Datenelement erstellen einen Namen ein, z. B. Name - Entered.
Wählen Sie Places in der Liste Erweiterung aus.
Wählen Name in der Liste Datenelementtyp aus.
Wählen Aktueller POI unter TARGET aus.
Wählen Sie In Bibliothek speichern.
Wiederholen Sie die Schritte 4 bis 8 anhand der Informationen aus der folgenden Tabelle, um zusätzliche Datenelemente zu erstellen.

Name
Erweiterung
Datenelementtyp
ZIEL
Name - Exited
Places
Name
POI für letzten Austritt
Category - Current
Places
Kategorie
Aktueller POI
Category - Exited
Places
Kategorie
POI für letzten Austritt
City - Current
Places
Stadt
Aktueller POI
City - Exited
Places
Stadt
POI für letzten Austritt

Sie sollten über die folgende Liste von Datenelementen verfügen.

Regeln

Als Nächstes definieren Sie Regeln für die Arbeit mit diesen Datenelementen.

Wählen Sie in Ihrer Tag-Eigenschaft Regeln in der linken Leiste aus.
Wählen Sie Regel hinzufügen aus.
Geben im Bildschirm Regel einen Namen für die Regel ein, z. B. POI - Entry.
Wählen unter EREIGNISSE aus.
1. Wählen Sie Places aus der Liste Extension und wählen Sie Enter POI aus der Liste Event Type aus.
2. Wählen Sie Änderungen beibehalten aus.
  
  .

Wählen unter AKTIONEN aus.

Wählen Sie Mobile Core aus der Liste Erweiterung und wählen Sie Daten anhängen aus Aktionstyp der Liste aus. Diese Aktion hängt Payload-Daten an.

Fügen Sie in JSON Payload die folgende Payload ein:

{
    "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 die JSON einfügen, indem Sie die Option auswählen. In einem Popup-Dialogfeld können Sie jedes von Ihnen erstellte Datenelement auswählen.

Wählen Sie Änderungen beibehalten aus.

Wählen neben der Aktion Mobile Core - Daten) aus.
1. Wählen Sie Adobe Experience Platform-Edge Network aus der Liste Erweiterung und wählen Sie Ereignis an Edge Network weiterleiten. Dadurch wird sichergestellt, dass das Ereignis und die zusätzlichen Payload-Daten an das Platform-Edge Network weitergeleitet werden.
2. Wählen Sie Änderungen beibehalten aus.
Wählen Sie zum Speichern der Regel In Bibliothek speichern aus.

Erstellen wir eine weitere Regel

Geben im Bildschirm Regel einen Namen für die Regel ein, z. B. POI - Exit.
Wählen unter EREIGNISSE aus.
1. Wählen Sie Places aus der Liste Extension und wählen Sie Exit POI aus der Liste Event Type aus.
2. Wählen Sie Änderungen beibehalten aus.

Wählen unter AKTIONEN aus.

Wählen Sie Mobile Core aus der Liste Erweiterung und wählen Sie Daten anhängen aus der Liste Aktionstyp aus.

Fügen Sie in JSON Payload die folgende Payload ein:

{
    "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.

Wählen neben der Aktion Mobile Core - Daten) aus.
1. Wählen Sie Adobe Experience Platform-Edge Network aus der Liste Erweiterung und wählen Sie Ereignis an Edge Network weiterleiten.
2. Wählen Sie Änderungen beibehalten aus.
Wählen Sie zum Speichern der Regel In Bibliothek speichern aus.

So stellen Sie sicher, dass alle Änderungen im Tag veröffentlicht werden

Wählen Sie Anfänglicher Build als zu erstellende Bibliothek aus.
Wählen Sie Erstellen aus.

Überprüfen des Setups in Assurance

So validieren Sie das Setup in Assurance:

Navigieren Sie zur Assurance-Benutzeroberfläche.
Falls noch nicht in der linken Leiste verfügbar, wählen Sie Konfigurieren in der linken Leiste und wählen Sie neben Ereignisse und Zuordnen und Simulieren unter PLACES SERVICE.
Wählen Sie Speichern aus.
Wählen Map & Simulate in der linken Leiste aus.
Verschieben Sie die Karte an einen Speicherort eines Ihrer POIs.
Wählen Sie Lastpunkte simulieren aus. Ihr POI wird mit einem Kreis und einer Nadel identifiziert.
POI auswählen.
Wählen Sie im Popup die Option Eintrittsereignis simulieren.
Wählen Sie Ereignisse in der linken Leiste aus. Die von Ihnen simulierten Ereignisse sollten angezeigt werden.

Implementieren von Places in Ihrer App

Wie in den vorherigen Lektionen erläutert, wird bei der Installation einer mobilen Tag-Erweiterung nur die Konfiguration bereitgestellt. Als Nächstes müssen Sie die Places SDK installieren und registrieren. Wenn diese Schritte nicht klar sind, lesen Sie den Abschnitt Installieren von SDKs.

NOTE

Wenn Sie den Abschnitt Installieren von SDKs abgeschlossen haben, ist Places SDK bereits installiert und Sie können diesen Schritt überspringen.

Stellen Sie in Xcode sicher dass „AEP Places zur Liste der Pakete in den Paketabhängigkeiten hinzugefügt wird. Siehe Swift Package Manager.
Navigieren Sie im Xcode-Projekt-Navigator zu Luma > Luma > AppDelegate .
Stellen Sie sicher, dass AEPPlaces Teil Ihrer Importliste ist.
import AEPPlaces

Stellen Sie sicher, dass Places.self Teil des Arrays von Erweiterungen ist, die Sie registrieren.

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 im Xcode-Projekt-zu  Luma > Luma > Utils > MobileSDK und suchen Sie nach der func processRegionEvent(regionEvent: PlacesRegionEvent, forRegion region: CLRegion) async. Fügen Sie den folgenden Code hinzu:
// Process geolocation event Places.processRegionEvent(regionEvent, forRegion: region)
Diese Places.processRegionEvent-API übermittelt die Geolokalisierungsinformationen an den Places-Service.

Navigieren Sie im Projekt-Navigator von Xcode zu Luma > Luma > Views > Location > GeofenceSheet.

Geben Sie für die Eingabetaste den folgenden Code ein

// 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

// Simulate geofence exit event
Task {
    await MobileSDK.shared.processRegionEvent(regionEvent: .exit, forRegion: region)
}

Validieren mit der App

Öffnen Sie Ihre App auf einem Gerät oder im Simulator.
Wechseln Sie zur Registerkarte Speicherort.
Verschieben Sie die Karte, und ziehen Sie sie, um sicherzustellen, dass sich der blaue mittlere Kreis über einem Ihrer POI befindet, z. B. in London.
Tippen , bis Kategorie und Name im Etikett an der roten Stelle mit der Nadel angezeigt werden.
Tippen Sie auf den Titel des POI, wodurch das Blatt "POI“ geöffnet.
Drücken Sie die Eintritt oder Austritt, um Geofence-Eintritts- und Geofence-Ausstiegsereignisse aus der App zu simulieren.
Die Ereignisse sollten in der Assurance-Benutzeroberfläche zu sehen sein.

Nächste Schritte

Sie sollten jetzt über alle Tools verfügen, um Ihrer Geolocation-Funktion in der App weitere Funktionen hinzuzufügen. Nachdem Sie die Ereignisse an das Edge Network weitergeleitet haben, sollten nach dem Einrichten der App für Experience Platform die Erlebnisereignisse 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). Dies ist beispielsweise das übliche Beispiel für das Senden einer Push-Benachrichtigung an den App-Benutzer mit einer Produktwerbung, wenn dieser den Geofence eines physischen Geschäfts betritt.

Es wurde eine Implementierung von Funktionen für Ihre App gesehen, die hauptsächlich vom Places-Service und den Datenelementen und Regeln gesteuert werden, die Sie in Ihrer Tag-Eigenschaft definiert haben. Daher wird der Code in Ihrer App minimiert. Alternativ können Sie dieselben Funktionen auch direkt in Ihrer App implementieren, indem Sie die Edge.sendEvent-API (weitere Informationen finden unter "„) mit einer XDM-Payload verwenden, die ein ausgefülltes placeContext-Objekt enthält.

SUCCESS

Sie haben die App jetzt für Geolocation-Services mit der Places-Erweiterung in der Experience Platform Mobile SDK aktiviert.

Vielen Dank, dass Sie sich Zeit genommen haben, um mehr über Adobe Experience Platform Mobile SDK zu erfahren. Wenn Sie Fragen haben, allgemeines Feedback geben möchten oder Vorschläge für zukünftige Inhalte haben, teilen Sie diese auf diesem Experience League Community-Diskussionsbeitrag.

Weiter: Daten Adobe Analytics zuordnen

recommendation-more-help