Plaatsen gebruiken

Leer hoe u de geolocatieservice Plaatsen in uw app gebruikt.

De Adobe Experience Platform Data Collection Places Service is een geolocatieservice waarmee mobiele apps met het bewustzijn van de locatie de context van de locatie kunnen begrijpen. De dienst gebruikt rijke en makkelijk te gebruiken interfaces van SDK vergezeld van een flexibele gegevensbank van punten van belang (POIs).

Vereisten

  • Alle pakketgebiedsdelen zijn op zijn plaats in het project van Xcode.
  • Geregistreerde extensies in AppDelegate.
  • MobileCore is geconfigureerd om uw ontwikkelings-appId te gebruiken.
  • Geïmporteerde SDK's.
  • De app is gemaakt en uitgevoerd met de bovenstaande wijzigingen.

Leerdoelstellingen

In deze les zult u

  • Begrijp hoe te om punten van belang in de dienst van Plaatsen te bepalen.
  • Werk de eigenschap tag bij met de extensie Plaatsen.
  • Werk uw schema bij om geolocatiegebeurtenissen vast te leggen.
  • Instellingen valideren in Assurance.
  • Werk uw app bij om de extensie Plaatsen te registreren.
  • Implementeer de functie voor het bijhouden van geolocaties via de service Plaatsen in uw app.

Instellen

De service Plaatsen werkt alleen in uw app en in de Mobile SDK als u de installatie uitvoert.

Plaatsen definiëren

U definieert enkele aandachtspunten in de service Plaatsen.

  1. Selecteer Places in de gebruikersinterface voor gegevensverzameling.

  2. Selecteer Meer .

  3. Selecteer Manage Libraries in het contextmenu.

    beheert bibliotheken {modal="regular"}

  4. Selecteer Manage Libraries in het dialoogvenster New .

  5. Voer in het dialoogvenster Create Library bijvoorbeeld een Name Luma in.

  6. Selecteer Confirm.

    creeer bibliotheek {modal="regular"}

  7. Selecteer Manage Libraries om het dialoogvenster Close te sluiten.

  8. Ga terug in POI Management en selecteer Import POIs .

  9. Selecteer Start in het dialoogvenster Import Places .

  10. Selecteer Luma in de lijst met bibliotheken.

  11. Selecteer Next.

    Uitgezochte Bibliotheek {modal="regular"}

  12. Download het dossier van het ZIP van POIs van de Lumaen haal het aan een plaats op uw computer uit.

  13. Sleep het uitgenomen Import Places -bestand naar luma_pois.csv in het dialoogvenster Choose CSV File - Drag and Drop your File . Zie Validation Success - Successfully validated the CSV file .

  14. Selecteer Begin Import. Zie Success - Successfully added 6 new POIs .

  15. Selecteer Done.

  16. In POI Management ziet u dat er zes nieuwe Luminantiewinkels aan de lijst worden toegevoegd. U kunt tussen van de Lijst en Kaart in- en uitschakelen kaartweergave.

    de lijst van Plaatsen {modal="regular"}

    .

De extensie Plaatsen installeren

  1. Navigeer naar Tags , zoek de eigenschap mobile tag en open deze.

  2. Selecteer Extensions.

  3. Selecteer Catalog.

  4. Zoek naar de extensie Places .

  5. De extensie installeren.

    voegt Plaatsen toe

  6. In het dialoogvenster Install Extension :

    1. Selecteer Luma in de lijst Select a Library .

    2. Controleer of u de werkbibliotheek hebt gekozen, bijvoorbeeld Initial Build .

    3. Selecteer Save to Library and Build in Save to Library .

      installeer de uitbreiding van Plaatsen {modal="regular"}

      .

  7. Uw bibliotheek wordt opnieuw samengesteld.

Uw schema verifiëren

Verifieer of uw schema, zoals die in wordt bepaald leidt tot schema, de noodzakelijke gebiedsgroepen en de klassen opneemt om POI en geolocatiegegevens te verzamelen.

  1. Navigeer naar de interface voor gegevensverzameling en selecteer Schemas in de linkertrack.

  2. Selecteer Browse in de bovenste balk.

  3. Selecteer het schema om het te openen.

  4. Selecteer Consumer Experience Event in de schema-editor.

  5. U ziet een placeContext -object met object en velden voor het vastleggen van POI-interactie en geolocatiegegevens.

    Plaatsen van het Schema {modal="regular"}

    .

De eigenschap tag bijwerken

De extensie Plaatsen voor tags biedt functionaliteit om gebeurtenissen met betrekking tot geolocatie te controleren en biedt u de mogelijkheid om handelingen te activeren op basis van deze gebeurtenissen. U kunt deze functionaliteit gebruiken om de API-codering die u in de app moet implementeren, tot een minimum te beperken.

Elementen van Gegevens

Eerst maakt u verschillende gegevenselementen.

  1. Ga naar uw markeringsbezit in de UI van de Inzameling van Gegevens.

  2. Selecteer Data Elements in het linkerspoor.

  3. Selecteer Add Data Element.

  4. Voer in het scherm Create Data Element een naam in, bijvoorbeeld Name - Entered .

  5. Selecteer Places in de lijst Extension .

  6. Selecteer Name in de lijst Data Element Type .

  7. Selecteer Current POI onder TARGET .

  8. Selecteer Save to Library.
    element van Gegevens {modal="regular"}

  9. Herhaal stap 4 - 8 met behulp van de informatie uit de onderstaande tabel om aanvullende gegevenselementen te maken.

    table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4
    Naam Extensie Type gegevenselement DOEL
    Name - Exited Plaatsen Naam Laatst afgesloten POI
    Category - Current Plaatsen Categorie Huidige POI
    Category - Exited Plaatsen Categorie Laatst afgesloten POI
    City - Current Plaatsen Plaats Huidige POI
    City - Exited Plaatsen Plaats Laatst afgesloten POI

    U moet de volgende lijst met gegevenselementen hebben.

    Lijst van gegevenselementen {modal="regular"}

Regels

Vervolgens gaat u regels definiëren om met deze gegevenselementen te werken.

  1. Selecteer Rules in de eigenschap Tag aan de linkerkant.

  2. Selecteer Add Rule.

  3. Voer in het scherm Create Rule een naam voor de regel in, bijvoorbeeld POI - Entry .

  4. Selecteer toevoegen onderaan EVENTS.

    1. Selecteer Places in de Extension lijst en selecteer Enter POI in de Event Type lijst.
    2. Selecteer Keep Changes.
      gebeurtenis van de Markering .
  5. Selecteer toevoegen onderaan ACTIONS.

    1. Selecteer Mobile Core in de lijst Extension en selecteer Attach Data in de lijst Action Type . Met deze handeling worden gegevens over de lading gekoppeld.

    2. Plak in de JSON Payload de volgende payload:

      code language-json
      {
          "xdm": {
              "eventType": "location.entry",
              "placeContext": {
                  "geo": {
                      "city": "{%%City - Current%%}"
                  },
                  "POIinteraction": {
                      "poiDetail": {
                          "name": "{%%Name - Current%%}",
                          "category": "{%%Category - Current%%}"
                      },
                      "poiEntries": {
                          "value": 1
                      }
                  }
              }
          }
      }
      

      U kunt {%% ... %%} placeholder van het gegevenselement ook opnemen waarden in JSON door de Gegevens te selecteren. In een pop-updialoogvenster kunt u elk gegevenselement kiezen dat u hebt gemaakt.

    3. Selecteer Keep Changes.
      actie van Markeringen {modal="regular"}

  6. Selecteer toevoegen naast de Mobile Core - Attach Data actie.

    1. Selecteer Adobe Experience Platform Edge Network in de lijst Extension en selecteer Forward event to Edge Network . Deze actie zorgt ervoor dat de gebeurtenis en de extra ladingsgegevens aan Platform Edge Network door:sturen.
    2. Selecteer Keep Changes.
  7. Selecteer Save to Library om de regel op te slaan.

    Regel {modal="regular"}

Laten we een andere regel maken

  1. Voer in het scherm Create Rule een naam voor de regel in, bijvoorbeeld POI - Exit .

  2. Selecteer toevoegen onderaan EVENTS.

    1. Selecteer Places in de Extension lijst en selecteer Exit POI in de Event Type lijst.
    2. Selecteer Keep Changes.
  3. Selecteer toevoegen onderaan ACTIONS.

    1. Selecteer Mobile Core in de lijst Extension en selecteer Attach Data in de lijst Action Type .

    2. Plak in de JSON Payload de volgende payload:

      code language-json
      {
          "xdm": {
              "eventType": "location.exit",
              "placeContext": {
                  "geo": {
                      "city": "{%%City - Exited%%}"
                  },
                  "POIinteraction": {
                      "poiExits": {
                          "value": 1
                      },
                      "poiDetail": {
                          "name": "{%%Name - Exited%%}",
                          "category": "{%%Category - Exited%%}"
                      }
                  }
              }
          }
      }
      
    3. Selecteer Keep Changes.

  4. Selecteer toevoegen naast de Mobile Core - Attach Data actie.

    1. Selecteer Adobe Experience Platform Edge Network in de lijst Extension en selecteer Forward event to Edge Network .
    2. Selecteer Keep Changes.
  5. Selecteer Save to Library om de regel op te slaan.

    Regel {modal="regular"}

Alle wijzigingen in de tag worden gepubliceerd

  1. Selecteer Initial Build als de bibliotheek die u wilt maken.

  2. Selecteer Build.

    bouwt bibliotheek {modal="regular"}

Instellingen valideren in Assurance

Uw instellingen valideren in Assurance:

  1. Ga naar de gebruikersinterface van Assurance.

  2. Als niet reeds beschikbaar in het linkerspoor, selecteer Configure in linkerspoor en selecteer toevoegen naast Events en Map & Simulate onder PLACES SERVICE.

  3. Selecteer Save.

  4. Selecteer Map & Simulate in het linkerspoor.

  5. Verplaats de kaart naar een locatie van een van uw POI's.

  6. Selecteer Vistuig lading POIs simuleren. Uw POI wordt geïdentificeerd gebruikend een cirkel en een speld.

  7. Selecteer uw POI.

  8. Van popup, uitgezochte Veer Simulate Entry Event.

    Simuleer de Gebeurtenis van de Ingang {modal="regular"}

  9. Selecteer Events in de linkertrack en bekijk de gebeurtenissen die u hebt gesimuleerd.

    AJO Beslissende bevestiging {modal="regular"}

Plaatsen in uw app implementeren

Zoals in vorige lessen is besproken, biedt het installeren van een extensie voor mobiele tags alleen de configuratie. Vervolgens moet u de Places SDK installeren en registreren. Als deze stappen niet duidelijk zijn, herzie installeer SDKssectie.

NOTE
Als u voltooide installeerde SDKssectie, dan is SDK van Plaatsen reeds geïnstalleerd en u kunt deze stap overslaan.
IMPORTANT
Als u de Kaarten SDK voor Android in uw app instelt, moet u facturering instellen als kosten voor het gebruik. U kunt de kosten beperken door uw unieke toepassings-id en een SHA-1-sleutel te gebruiken. Voor meer details, zie Kaart SDK voor Android. Sla deze les over als u geen facturering wilt instellen of geen kosten wilt maken.
iOS
  1. In Xcode, zorg ervoor dat de Plaatsen van AEPaan de lijst van pakketten in de Afhankelijkheden van het Pakket wordt toegevoegd. Zie {de Manager van het Pakket van 0} Swift .

  2. Navigeer naar Luma > Luma > AppDelegate in de Xcode-projectnavigator.

  3. Controleer of AEPPlaces deel uitmaakt van uw lijst met importbewerkingen.

    code language-swift
    import AEPPlaces
    
  4. Controleer of Places.self deel uitmaakt van de array met extensies die u registreert.

    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. Navigeer naar Luma > Luma > Utils > MobileSDK in de Xcode Project navigator en zoek de func processRegionEvent(regionEvent: PlacesRegionEvent, forRegion region: CLRegion) async functie. Voeg de volgende code toe:

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

    Deze Places.processRegionEventAPI deelt de geolocatieinformatie aan de dienst van Plaatsen mee.

  6. Navigeer naar Luma > Luma > Views > Location > GeofenceSheet in de projectnavigator van Xcode.

    1. Voer voor de knop Item de volgende code in:

      code language-swift
      // Simulate geofence entry event
      Task {
          await MobileSDK.shared.processRegionEvent(regionEvent: .entry, forRegion: region)
      }
      
    2. Voer voor de knop Afsluiten de volgende code in:

      code language-swift
      // Simulate geofence exit event
      Task {
          await MobileSDK.shared.processRegionEvent(regionEvent: .exit, forRegion: region)
      }
      
Android
  1. In de Studio van Android, zorg ervoor dat aepsdk-place-androiddeel van de gebiedsdelen in build.gradle.kts (Module :app) in Android ChevronDown Gradle Scripts uitmaakt. Zie Gradle.

  2. Navigeer aan Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication in de het projectnavigator van Android Studio.

  3. Controleer of com.adobe.marketing.mobile.Messaging deel uitmaakt van uw lijst met importbewerkingen.

    import import com.adobe.marketing.mobile.Places

  4. Controleer of Places.EXTENSION deel uitmaakt van de array met extensies die u registreert.

    code language-kotlin
    val extensions = listOf(
        Identity.EXTENSION,
        Lifecycle.EXTENSION,
        Signal.EXTENSION,
        Edge.EXTENSION,
        Consent.EXTENSION,
        UserProfile.EXTENSION,
        Places.EXTENSION,
        Messaging.EXTENSION,
        Optimize.EXTENSION,
        Assurance.EXTENSION
    )
    
  5. Navigeer aan Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK in de het projectnavigator van Android Studio. Zoek de functie suspend fun processGeofence(geofence: Geofence?, transitionType: Int) . Voeg de volgende code toe:

    code language-kotlin
    // Process geolocation event
    Places.processGeofence(geofence, transitionType)
    

    Deze Places.processRegionEventAPI deelt de geolocatieinformatie aan de dienst van Plaatsen mee.

  6. Navigeer aan Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > views > LocationView.k in de het projectnavigator van Android Studio.

    1. Voer voor de knop Item de volgende code in:

      code language-kotlin
      // Simulate geofence entry event
      coroutineScope.launch {
          MobileSDK.shared.processGeofence(
             region,
             Geofence.GEOFENCE_TRANSITION_ENTER
          )
      }
      
    2. Voer voor de knop Afsluiten de volgende code in:

      code language-kotlin
      // Simulate geofence entry event
      coroutineScope.launch {
          MobileSDK.shared.processGeofence(
              region,
              Geofence.GEOFENCE_TRANSITION_EXIT
          )
      }
      

Valideren met uw app

U kunt als volgt de functies voor geolocatie in uw app valideren:

iOS
  1. Open uw app op een apparaat of in de simulator.

  2. Ga naar het tabblad Location.

  3. Verplaats (sleep) de kaart om ervoor te zorgen dat de blauwe middelste cirkel zich boven een van uw POI's bevindt, bijvoorbeeld Londen.

  4. Tikken {width="20"} totdat u de categorie en naam ziet in het label op de rode locatie met de pin.

  5. Tik op het label van de POI die het Nearby POI -blad opent.

    {width="300"}

  6. Druk op de knoppen Entry of Exit om geofence-item en geofence exit-gebeurtenissen uit de app te simuleren.

    {width="300"}

  7. De gebeurtenissen worden weergegeven in de gebruikersinterface van Assurance. Zowel in de Gebeurtenissen als in de Gebeurtenissen van de Dienst van Plaatsen.

Android
  1. Ga naar het tabblad Location.

  2. Selecteer Use and/or Simulate Geofences.

  3. Tik ergens in de rode cirkel die wordt weergegeven.

    {width="300"}

  4. Druk op de knoppen Entry of Exit om geofence-item en geofence exit-gebeurtenissen uit de app te simuleren.

    {width="300"}

  5. De gebeurtenissen worden weergegeven in de gebruikersinterface van Assurance.

Volgende stappen

U moet nu over alle gereedschappen beschikken om meer functionaliteit toe te voegen aan de functie voor geolocatie in de app. Aangezien u de gebeurtenissen aan Edge Network door:sturen, zodra u opstelling app voor Experience Platformhebt, zou u de ervaringsgebeurtenissen moeten zien die voor het profiel verschijnen in app wordt gebruikt.

In de sectie van Journey Optimizer van dit leerprogramma, ziet u dat de ervaringsgebeurtenissen kunnen worden gebruikt om reizen (zie duw berichten in-app overseinenmet Journey Optimizer) teweeg te brengen. Bijvoorbeeld, het gebruikelijke voorbeeld om uw toepassingsgebruiker een dupbericht met één of andere productbevordering te verzenden wanneer die gebruiker de geofence van een fysieke opslag ingaat.

Deze implementatie van de geolocatiefunctie voor uw app minimaliseert de code. De service Plaatsen, gegevenselementen en regels die u in de eigenschap Tag hebt gedefinieerd, bieden het grootste deel van de functionaliteit. Alternatief, kunt u de zelfde functionaliteit direct in uw app uitvoeren gebruikend Edge.sendEventAPI (zie Gebeurtenissenvoor meer informatie) met een nuttige XDM die een bevolkt placeContext voorwerp bevat.

SUCCESS
U hebt de app voor geolocatieservices nu ingeschakeld met de extensie Plaatsen in de Experience Platform Mobile SDK.
Bedankt dat je tijd hebt geïnvesteerd in het leren van Adobe Experience Platform Mobile SDK. Als u vragen hebt, algemene terugkoppelen willen delen, of suggesties over toekomstige inhoud hebben, hen op deze Communautaire besprekingspost van Experience Leaguedelen.

Volgende: gegevens van de Kaart aan Adobe Analytics

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