Documentatie Experience Platform Tutorial voor mobiele apps

Plaatsen gebruiken

Laatst bijgewerkt: 5 mei 2025

Onderwerpen:

Gemaakt voor:

Beginner
tussenpersoon
Ontwikkelaar

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 gegevensbestand van belangenpunten (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.
Valideer installatie in Betrouwbaarheid.
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 binnen uw app en in de SDK voor mobiele apparaten als u een aantal instellingen opgeeft.

Plaatsen definiëren

U definieert enkele aandachtspunten in de service Plaatsen.

Selecteer Places in de gebruikersinterface voor gegevensverzameling.
Selecteer .
Selecteer Manage Libraries in het contextmenu.
Selecteer New in het dialoogvenster Manage Libraries .
Voer in het dialoogvenster Create Library bijvoorbeeld een Name Luma in.
Selecteer Confirm.
Selecteer Close om het dialoogvenster Manage Libraries te sluiten.
Ga terug in POI Management en selecteer Import POIs .
Selecteer Start in het dialoogvenster Import Places .
Selecteer Luma in de lijst met bibliotheken.
Selecteer Next.
Download het dossier van het ZIP van POIs van de Lumaen haal het aan een plaats op uw computer uit.
Sleep het uitgenomen luma_pois.csv -bestand naar Choose CSV File - Drag and Drop your File in het dialoogvenster Import Places . Zie Validation Success - Successfully validated the CSV file .
Selecteer Begin Import. Zie Success - Successfully added 6 new POIs .
Selecteer Done.
In POI Management ziet u dat er zes nieuwe Luminantiewinkels aan de lijst worden toegevoegd. U kunt tussen en in- en uitschakelen kaartweergave.
.

De extensie Plaatsen installeren

Navigeer naar Tags , zoek de eigenschap mobile tag en open deze.
Selecteer Extensions.
Selecteer Catalog.
Zoek naar de extensie Places .
De extensie installeren.
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 .
  
  .
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.

Navigeer naar de interface voor gegevensverzameling en selecteer Schemas in de linkertrack.
Selecteer Browse in de bovenste balk.
Selecteer het schema om het te openen.
Selecteer Consumer Experience Event in de schema-editor.
U ziet een placeContext -object met object en velden voor het vastleggen van POI-interactie en geolocatiegegevens.
.

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.

Ga naar uw markeringsbezit in de UI van de Inzameling van Gegevens.
Selecteer Data Elements in het linkerspoor.
Selecteer Add Data Element.
Voer in het scherm Create Data Element een naam in, bijvoorbeeld Name - Entered .
Selecteer Places in de lijst Extension .
Selecteer Name in de lijst Data Element Type .
Selecteer Current POI onder TARGET .
Selecteer Save to Library.
Herhaal stap 4 - 8 met behulp van de informatie uit de onderstaande tabel om aanvullende gegevenselementen te maken.

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.

Regels

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

Selecteer Rules in de eigenschap Tag aan de linkerkant.
Selecteer Add Rule.
Voer in het scherm Create Rule een naam voor de regel in, bijvoorbeeld POI - Entry .
Selecteer onderaan EVENTS.
1. Selecteer Places in de Extension lijst en selecteer Enter POI in de Event Type lijst.
2. Selecteer Keep Changes.
  
  .

Selecteer onderaan ACTIONS.

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.

Plak in de JSON Payload de volgende payload:

{
    "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 te selecteren. In een pop-updialoogvenster kunt u elk gegevenselement kiezen dat u hebt gemaakt.

Selecteer Keep Changes.

Selecteer 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 de Edge Network van het Platform door:sturen.
2. Selecteer Keep Changes.
Selecteer Save to Library om de regel op te slaan.

Laten we een andere regel maken

Voer in het scherm Create Rule een naam voor de regel in, bijvoorbeeld POI - Exit .
Selecteer onderaan EVENTS.
1. Selecteer Places in de Extension lijst en selecteer Exit POI in de Event Type lijst.
2. Selecteer Keep Changes.

Selecteer onderaan ACTIONS.

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

Plak in de JSON Payload de volgende payload:

{
    "xdm": {
        "eventType": "location.exit",
        "placeContext": {
            "geo": {
                "city": "{%%City - Exited%%}"
            },
            "POIinteraction": {
                "poiExits": {
                    "value": 1
                },
                "poiDetail": {
                    "name": "{%%Name - Exited%%}",
                    "category": "{%%Category - Exited%%}"
                }
            }
        }
    }
}

Selecteer Keep Changes.

Selecteer 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.
Selecteer Save to Library om de regel op te slaan.

Alle wijzigingen in de tag worden gepubliceerd

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

Setup valideren bij Betrouwbaarheid

Uw instellingen valideren in Betrouwbaarheid:

Ga naar de betrouwbaarheidsinterface.
Als niet reeds beschikbaar in het linkerspoor, selecteer Configure in linkerspoor en selecteer naast Events en Map & Simulate onder PLACES SERVICE.
Selecteer Save.
Selecteer Map & Simulate in het linkerspoor.
Verplaats de kaart naar een locatie van een van uw POI's.
Selecteer lading POIs simuleren. Uw POI wordt geïdentificeerd gebruikend een cirkel en een speld.
Selecteer uw POI.
Van popup, uitgezochte Simulate Entry Event.
Selecteer Events in de linkertrack en bekijk de gebeurtenissen die u hebt gesimuleerd.

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 SDK van Plaatsen 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.

In Xcode, zorg ervoor dat Plaatsen AEPaan de lijst van pakketten in de Afhankelijkheden van het Pakket wordt toegevoegd. Zie {de Manager van het Pakket van 0} Swift 🔗.
Navigeer naar Luma > Luma > AppDelegate in de Xcode-projectnavigator.
Controleer of AEPPlaces deel uitmaakt van uw lijst met importbewerkingen.
import AEPPlaces

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

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
]

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:
// Process geolocation event Places.processRegionEvent(regionEvent, forRegion: region)
Deze Places.processRegionEventAPI deelt de geolocatieinformatie aan de dienst van Plaatsen mee.

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

Voer voor de knop Item de volgende code in

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

Voer voor de knop Afsluiten de volgende code in

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

Valideren met uw app

Open uw app op een apparaat of in de simulator.
Ga naar de tab Location .
Verplaats (sleep) de kaart om ervoor te zorgen dat de blauwe middelste cirkel zich boven een van uw POI's bevindt, bijvoorbeeld Londen.
Tikken totdat u de categorie en naam ziet in het label op de rode locatie met de pin.
Tik op het label van de POI die het Nearby POI -blad opent.
Druk op de knoppen Entry of Exit om geofence-item en geofence exit-gebeurtenissen uit de app te simuleren.
U zou de gebeurtenissen in de Verzekering UI moeten zien.

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 de 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, zult u zien 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.

U hebt een implementatie van de functionaliteit voor uw app gezien, voornamelijk door de service Plaatsen en gegevenselementen en -regels die u in de eigenschap Tag hebt gedefinieerd. Hierdoor wordt de code in uw app geminimaliseerd. 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 u 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 de Experience Leaguedelen.

Volgende: gegevens van de Kaart aan Adobe Analytics

recommendation-more-help