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.

  1. Wählen Sie in der Datenerfassungs-Benutzeroberfläche die Option Orte.
  2. Auswählen Mehr .
  3. Wählen Sie im Kontextmenü die Option Bibliotheken verwalten.
    Bibliotheken verwalten
  4. Im Bibliotheken verwalten Dialogfeld auswählen Neu.
  5. Im Bibliothek erstellen Dialogfeld eingeben Name, beispielsweise Luma.
  6. Auswählen Bestätigen.
    Bibliothek erstellen
  7. So schließen Sie die Bibliotheken verwalten Dialogfeld auswählen Schließen.
  8. Zurück in POI-Verwaltung auswählen POIs importieren.
  9. Auswählen Starten im Importorte angezeigt.
  10. Auswählen Luma aus der Liste der Bibliotheken,
  11. Klicken Sie auf Weiter.
    Bibliothek auswählen
  12. Laden Sie die Luma POIs-ZIP-Datei und extrahieren Sie es an eine Stelle auf Ihrem Computer.
  13. 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.
  14. Auswählen Import beginnen. Sie sollten Erfolg - 6 neue Zielpunkte wurden erfolgreich hinzugefügt.
  15. Klicken Sie auf Fertig.
  16. In POI-Verwaltung, sollten Sie sehen, dass sechs neue Luma-Stores zur Liste hinzugefügt werden. Sie können zwischen Liste und Zuordnung Landkartenansicht.
    Places list .

Installieren der Places-Erweiterung

  1. Navigieren Sie zu Tags und suchen Sie Ihre mobile Tag-Eigenschaft und öffnen Sie die Eigenschaft .

  2. Auswählen Erweiterungen.

  3. Auswählen Katalog.

  4. Suchen Sie nach Orte -Erweiterung.

  5. Installieren Sie die -Erweiterung.

    Entscheidungserweiterung hinzufügen

  6. Im Installieren der Erweiterung dialog:

    1. Auswählen Luma aus dem Bibliothek auswählen Liste.

    2. Stellen Sie sicher, dass Sie Ihre Arbeitsbibliothek ausgewählt haben, z. B. Ursprünglicher Build.

    3. Auswählen In Bibliothek speichern und erstellen von In Bibliothek speichern.

      Installieren der Places-Erweiterung .

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

  1. Navigieren Sie zur Datenerfassungsoberfläche und wählen Sie Schemas über die linke Leiste.
  2. Auswählen Durchsuchen aus der oberen Leiste.
  3. Wählen Sie Ihr Schema aus, um es zu öffnen.
  4. Wählen Sie im Schema-Editor Ereignis für Kundenerlebnisse.
  5. Sie sehen eine placeContext -Objekt mit Objekt und Feldern zum Erfassen von POI-Interaktionen und Geolocation-Daten.
    Schema Places .

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.

  1. Rufen Sie Ihre Tag-Eigenschaft in der Datenerfassungs-Benutzeroberfläche auf.

  2. Auswählen Datenelemente über die linke Leiste.

  3. Wählen Sie Datenelement hinzufügen aus.

  4. Im Datenelement erstellen Bildschirm, geben Sie einen Namen ein, beispielsweise Name - Entered.

  5. Auswählen Orte aus dem Erweiterung Liste.

  6. Auswählen Name aus dem Datenelementtyp Liste.

  7. Auswählen Aktueller POI darunter TARGET.

  8. Auswählen In Bibliothek speichern.
    Datenelement

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

    Liste der Datenelemente

Regeln

Als Nächstes definieren Sie Regeln für die Verwendung dieser Datenelemente.

  1. Wählen Sie in der Tag-Eigenschaft Regeln über die linke Leiste.

  2. Auswählen Regel hinzufügen.

  3. Im Regel erstellen Bildschirm einen Namen für die Regel eingeben, z. B. POI - Entry.

  4. Auswählen Hinzufügen darunter EREIGNISSE.

    1. Auswählen Orte aus dem Erweiterung Liste und Auswahl POI eingeben aus dem Ereignistyp Liste.

    2. Wählen Sie Änderungen beibehalten aus.

      Tag-Ereignis .

  5. Auswählen Hinzufügen darunter AKTIONEN.

    1. Auswählen Mobile Core aus dem Erweiterung Liste auswählen Daten anhängen von Aktionstyp die Liste. Diese Aktion hängt Payload-Daten an.

    2. 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 Daten . In einem Popup-Dialogfeld können Sie jedes von Ihnen erstellte Datenelement auswählen.

    3. Wählen Sie Änderungen beibehalten aus.

      Tags-Aktion

  6. Auswählen Hinzufügen neben dem Mobile Core - Daten anhängen Aktion.

    1. 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.
    2. Wählen Sie Änderungen beibehalten aus.
  7. Um die Regel zu speichern, wählen Sie In Bibliothek speichern.

    Regel

Erstellen wir eine weitere Regel

  1. Im Regel erstellen Bildschirm einen Namen für die Regel eingeben, z. B. POI - Exit.

  2. Auswählen Hinzufügen darunter EREIGNISSE.

    1. Auswählen Orte aus dem Erweiterung Liste und Auswahl Ausstiegspunkt aus dem Ereignistyp Liste.
    2. Wählen Sie Änderungen beibehalten aus.
  3. Auswählen Hinzufügen darunter AKTIONEN.

    1. Auswählen Mobile Core von Erweiterung Liste auswählen Daten anhängen von Aktionstyp Liste.

    2. 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%%}"
                      }
                  }
              }
          }
      }
      
    3. Wählen Sie Änderungen beibehalten aus.

  4. Auswählen Hinzufügen neben dem Mobile Core - Daten anhängen Aktion.

    1. Auswählen Adobe Experience Platform Edge Network aus dem Erweiterung Liste und Auswahl Weiterleiten von Ereignissen an Edge Network.
    2. Wählen Sie Änderungen beibehalten aus.
  5. Um die Regel zu speichern, wählen Sie In Bibliothek speichern.

    Regel

Um sicherzustellen, dass alle Änderungen in Ihrem Tag veröffentlicht werden

  1. Auswählen Ursprünglicher Build als Bibliothek, die erstellt werden soll.
  2. Auswählen Build.
    Bibliothek erstellen

Validieren der Einrichtung in der Zuverlässigkeitserklärung

So überprüfen Sie Ihre Einrichtung in Assurance:

  1. Navigieren Sie zur Benutzeroberfläche "Assurance".
  2. Wenn nicht bereits in der linken Leiste verfügbar, wählen Sie Konfigurieren Wählen Sie in der linken Leiste Hinzufügen neben Veranstaltungen und Karte und Simulieren darunter PLACES SERVICE.
  3. Wählen Sie Speichern aus.
  4. Auswählen Karte und Simulieren in der linken Leiste.
  5. Verschieben Sie die Karte an die Position eines Ihrer POIs.
  6. Auswählen Fanggerät Laden-POIs simulieren. Ihr POI wird anhand eines Kreises und einer Nadel identifiziert.
  7. Wählen Sie Ihren POI aus.
  8. Wählen Sie im Popup-Fenster Fanggerät Eintrittsereignis simulieren.
    Eintrittsereignis simulieren
  9. Auswählen Veranstaltungen über die linke Leiste aus, und Sie sollten die simulierten Ereignisse sehen.
    Validierung von AJO-Entscheidungen

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.

NOTE
Wenn Sie die SDKs installieren hinzugefügt, ist das Places SDK bereits installiert und Sie können diesen Schritt überspringen.
  1. Stellen Sie in Xcode sicher, dass AEP Places wird zur Liste der Pakete in Package-Abhängigkeiten hinzugefügt. Siehe Swift Package Manager.

  2. Navigieren Sie zu Luma > Luma > AppDelegate im Xcode-Projektnavigator.

  3. Sichern AEPPlaces ist Teil Ihrer Importliste.

    code language-swift
    import AEPPlaces
    
  4. 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
    ]
    
  5. 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.

  6. Navigieren Sie zu Luma > Luma > Views > Location > GeofenceSheet im Projektnavigator von Xcode.

    1. 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)
    }
    
    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 Ihrer App

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

  2. Navigieren Sie zu Standort Registerkarte.

  3. Verschieben Sie die Karte (ziehen Sie sie), um sicherzustellen, dass sich der blaue mittlere Kreis über einem der POIs befindet, z. B. London.

  4. Tippen {width="20"} bis die Kategorie und der Name in der Beschriftung an der roten Stelle mit dem Pin erscheinen.

  5. Tippen Sie auf die Bezeichnung des POI, wodurch sich der Nächster POI Blatt.

    {width="300"}

  6. Drücken Sie die Einstieg oder Beenden -Schaltflächen zum Simulieren von Geofence-Einstiegs- und Geofence-Ausstiegsereignissen aus der App.

    {width="300"}

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

SUCCESS
Sie haben die App jetzt für Geolocation-Dienste unter Verwendung der Places-Erweiterung im Experience Platform Mobile SDK aktiviert.
Vielen Dank, dass Sie Ihre Zeit investiert haben, um mehr über das Adobe Experience Platform Mobile SDK zu erfahren. Wenn Sie Fragen haben, ein allgemeines Feedback oder Vorschläge zu künftigen Inhalten teilen möchten, teilen Sie diese hier mit. Experience League Community-Diskussionsbeitrag.

Weiter: Zuordnen von Daten zu Adobe Analytics

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b