DokumentationExperience PlatformTutorial für Mobile Apps

Verwenden von Orten

Last update: Tue Dec 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 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.

  1. Wählen Sie in der Datenerfassungs-Benutzeroberfläche Orte.
  2. Wählen Sie Mehr aus.
  3. Wählen Sie im Kontextmenü die Option Bibliotheken verwalten aus.
    Bibliotheken verwalten
  4. Wählen im Dialogfeld " verwalten“ die Option Neu.
  5. Geben Sie im Dialogfeld Bibliothek erstellen einen Namen ein, z. B. Luma.
  6. Wählen Sie Bestätigen aus.
    Bibliothek erstellen
  7. Um das Dialogfeld Bibliotheken verwalten zu schließen, wählen Sie Schließen aus.
  8. Zurück in POI-Verwaltung wählen Sie POIs importieren.
  9. Wählen Start im Dialogfeld Importplätze aus.
  10. Wählen Sie Luma aus der Liste der Bibliotheken aus.
  11. Klicken Sie auf Weiter.
    Bibliothek auswählen
  12. Laden Sie die ZIP-Datei der Luma-POIs herunter und extrahieren Sie sie an einen Speicherort auf Ihrem Computer.
  13. 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.
  14. Wählen Sie Import beginnen. Sie sollten Erfolg sehen 6 neue POIs erfolgreich hinzugefügt.
  15. Wählen Sie Fertig aus.
  16. In POI-) sollten Sie sehen, dass der Liste sechs neue Luma-Stores hinzugefügt werden. Sie können zwischen Liste und Map Kartenansicht wechseln.
    Ortsliste .

Installieren der Places-Erweiterung

  1. Navigieren Sie zu Tags, suchen Sie die Eigenschaft für mobile Tags und öffnen Sie sie.

  2. Wählen Sie Erweiterungen aus.

  3. Wählen Sie Katalog aus.

  4. Suchen Sie nach der Places-Erweiterung.

  5. Installieren Sie die Erweiterung .

    Entscheidungserweiterung hinzufügen

  6. 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.

      Install Places-Erweiterung .

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

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

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.

  1. Wechseln Sie in der Datenerfassungs-Benutzeroberfläche zu Ihrer Tag-Eigenschaft.

  2. Wählen Datenelemente in der linken Leiste aus.

  3. Wählen Datenelement hinzufügen aus.

  4. Geben Sie Bildschirm Datenelement erstellen einen Namen ein, z. B. Name - Entered.

  5. Wählen Sie Places in der Liste Erweiterung aus.

  6. Wählen Name in der Liste Datenelementtyp aus.

  7. Wählen Aktueller POI unter TARGET aus.

  8. Wählen Sie In Bibliothek speichern.
    Datenelement

  9. Wiederholen Sie die Schritte 4 bis 8 anhand der Informationen aus der folgenden 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 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.

    Liste der Datenelemente

Regeln

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

  1. Wählen Sie in Ihrer Tag-Eigenschaft Regeln in der linken Leiste aus.

  2. Wählen Sie Regel hinzufügen aus.

  3. Geben im Bildschirm Regel einen Namen für die Regel ein, z. B. POI - Entry.

  4. Wählen Hinzufügen 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.

      Tag- .

  5. Wählen Hinzufügen unter AKTIONEN aus.

    1. 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.

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

    3. Wählen Sie Änderungen beibehalten aus.

      Aktion für Tags

  6. Wählen Hinzufügen 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.

  7. Wählen Sie zum Speichern der Regel In Bibliothek speichern aus.

    Regel

Erstellen wir eine weitere Regel

  1. Geben im Bildschirm Regel einen Namen für die Regel ein, z. B. POI - Exit.

  2. Wählen Hinzufügen 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.

  3. Wählen Hinzufügen unter AKTIONEN aus.

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

    2. Fügen Sie in JSON Payload 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%%}"
                }
            }
        }
    }
}

    3. Wählen Sie Änderungen beibehalten aus.

  4. Wählen Hinzufügen 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.

  5. Wählen Sie zum Speichern der Regel In Bibliothek speichern aus.

    Regel

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

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

Überprüfen des Setups in Assurance

So validieren Sie das Setup in Assurance:

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

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.

  1. Stellen Sie in Xcode sicher dass „AEP Places zur Liste der Pakete in den Paketabhängigkeiten hinzugefügt wird. Siehe Swift Package Manager.

  2. Navigieren Sie im Xcode-Projekt-Navigator zu Luma > Luma > AppDelegate .

  3. Stellen Sie sicher, dass AEPPlaces Teil Ihrer Importliste ist.

    code language-swift 
    import AEPPlaces

  4. Stellen Sie sicher, dass Places.self Teil des Arrays von Erweiterungen ist, 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
]

  5. 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:

    code language-swift 
    // Process geolocation event
Places.processRegionEvent(regionEvent, forRegion: region)

    Diese Places.processRegionEvent-API übermittelt die Geolokalisierungsinformationen an den Places-Service.

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

    1. Geben Sie für die Eingabetaste den folgenden Code ein
    code language-swift 
    // Simulate geofence entry event
Task {
    await MobileSDK.shared.processRegionEvent(regionEvent: .entry, forRegion: region)
}
    1. 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 der App

  1. Öffnen Sie Ihre App auf einem Gerät oder im Simulator.

  2. Wechseln Sie zur Registerkarte Speicherort.

  3. 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.

  4. Tippen {width="20"}, bis Kategorie und Name im Etikett an der roten Stelle mit der Nadel angezeigt werden.

  5. Tippen Sie auf den Titel des POI, wodurch das Blatt "POI“ geöffnet.

    {width="300"}

  6. Drücken Sie die Eintritt oder Austritt, um Geofence-Eintritts- und Geofence-Ausstiegsereignisse aus der App zu simulieren.

    {width="300"}

  7. 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
9fed61f5-c338-47ad-8005-0b89a5f4af8b