Dokumentation Experience Platform Självstudiekurs om mobila appar

Använd platser

Senast uppdaterad: 5 maj 2025

Ämnen:

Skapat för:

Nybörjare
Mellanliggande
Utvecklare

Lär dig hur du använder platsens geopositioneringstjänst i din app.

Tjänsten Adobe Experience Platform Data Collection Places är en geopositioneringstjänst som gör det möjligt för mobilappar med platsmedvetenhet att förstå platskontexten. Tjänsten använder avancerade och lättanvända SDK-gränssnitt tillsammans med en flexibel databas med intressepunkter (POI).

Förhandskrav

Alla paketberoenden finns på plats i Xcode-projektet.
Registrerade tillägg i AppDelegate.
MobileCore har konfigurerats för att använda ditt utvecklingsprogram-ID.
Importerade SDK:er.
Programmet har skapats och körts med ändringarna ovan.

Utbildningsmål

I den här lektionen ska du

Lär dig hur du definierar intressepunkter i tjänsten Platser.
Uppdatera taggegenskapen med tillägget Platser.
Uppdatera ditt schema för att hämta geopositioneringshändelser.
Validera inställningar i Assurance.
Uppdatera programmet för att registrera Platser-tillägget.
Implementera geopositioneringsspårning från platstjänsten i appen.

Inställningar

För att platstjänsten ska fungera i din app och i Mobile SDK måste du göra några inställningar.

Definiera platser

Du definierar några intressepunkter i tjänsten Platser.

Välj Places i användargränssnittet för datainsamling.
Välj .
Välj Manage Libraries på snabbmenyn.
Välj New i dialogrutan Manage Libraries.
I dialogrutan Create Library anger du Name, till exempel Luma.
Välj Confirm.
Om du vill stänga dialogrutan Manage Libraries väljer du Close.
Gå tillbaka i POI Management, välj Import POIs.
Välj Start i dialogrutan Import Places.
Välj Luma i listan över bibliotek,
Välj Next.
Hämta Luma POIs ZIP-filen och extrahera den till en plats på datorn.
Dra och släpp den extraherade luma_pois.csv-filen på Choose CSV File - Drag and Drop your File i dialogrutan Import Places. Du bör se Validation Success - Successfully validated the CSV file.
Välj Begin Import. Du bör se Success - Successfully added 6 new POIs.
Välj Done.
I POI Management bör du se att sex nya Luma-butiker har lagts till i listan. Du kan växla mellan och mappningsvyn .
.

Tillägg för Installera platser

Navigera till Tags och hitta din mobila taggegenskap och öppna egenskapen.
Välj Extensions.
Välj Catalog.
Sök efter tillägget Places.
Installera tillägget.
I dialogrutan Install Extension:
1. Välj Luma i listan Select a Library.
2. Kontrollera att du har valt ditt arbetsbibliotek, till exempel Initial Build.
3. Välj Save to Library and Build från Save to Library.
  
  .
Ditt bibliotek har byggts om.

Verifiera ditt schema

Kontrollera om schemat, enligt definitionen i Skapa schema, innehåller de fältgrupper och klasser som krävs för att samla in POI- och geopositioneringsdata.

Navigera till gränssnittet för datainsamling och välj Schemas i den vänstra listen.
Välj Browse i det övre fältet.
Välj ditt schema för att öppna det.
Välj Consumer Experience Event i schemaredigeraren.
Du ser ett placeContext-objekt med objekt och fält för att hämta POI-interaktion och geopositioneringsdata.
.

Uppdatera taggegenskapen

Tillägget Platser för taggar innehåller funktioner för att övervaka geopositioneringshändelser och gör att du kan utlösa åtgärder som baseras på dessa händelser. Du kan använda den här funktionen för att minimera API-kodningen som du måste implementera i appen.

Dataelement

Först skapar du flera dataelement.

Gå till taggegenskapen i användargränssnittet för datainsamling.
Välj Data Elements i den vänstra listen.
Välj Add Data Element.
På skärmen Create Data Element anger du ett namn, till exempel Name - Entered.
Välj Places i listan Extension.
Välj Name i listan Data Element Type.
Välj Current POI under TARGET.
Välj Save to Library.

Upprepa steg 4-8 med hjälp av informationen från tabellen nedan för att skapa ytterligare dataelement.

Namn	Tillägg	Dataelementtyp	MÅL
`Name - Exited`	Platser	Namn	Senaste utgångna POI
`Category - Current`	Platser	Kategori	Aktuell POI
`Category - Exited`	Platser	Kategori	Senaste utgångna POI
`City - Current`	Platser	Ort	Aktuell POI
`City - Exited`	Platser	Ort	Senaste utgångna POI

Du bör ha följande lista över dataelement.

Lista över dataelement

Regler

Därefter ska du definiera regler som ska användas med dessa dataelement.

Välj Rules i den vänstra listen i taggegenskapen.
Välj Add Rule.
På skärmen Create Rule anger du ett namn för regeln, till exempel POI - Entry.
Välj under EVENTS.
1. Välj Places i listan Extension och välj Enter POI i listan Event Type.
2. Välj Keep Changes.
  
  .

Välj under ACTIONS.

Välj Mobile Core i listan Extension och välj Attach Data i listan Action Type. Den här åtgärden kopplar nyttolastdata.

Klistra in följande nyttolast i JSON Payload:

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

Du kan också infoga {%% ... %%} platshållarvärden för dataelement i JSON genom att markera . I en popup-dialogruta kan du välja valfritt dataelement som du har skapat.

Välj Keep Changes.

Välj bredvid åtgärden Mobile Core - Attach Data.
1. Välj Adobe Experience Platform Edge Network i listan Extension och välj Forward event to Edge Network. Den här åtgärden ser till att händelser och ytterligare nyttolastdata vidarebefordras till Platform Edge Network.
2. Välj Keep Changes.
Spara regeln genom att välja Save to Library.

Låt oss skapa en annan regel

På skärmen Create Rule anger du ett namn för regeln, till exempel POI - Exit.
Välj under EVENTS.
1. Välj Places i listan Extension och välj Exit POI i listan Event Type.
2. Välj Keep Changes.

Välj under ACTIONS.

Välj Mobile Core i listan Extension och välj Attach Data i listan Action Type.

Klistra in följande nyttolast i JSON Payload:

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

Välj Keep Changes.

Välj bredvid åtgärden Mobile Core - Attach Data.
1. Välj Adobe Experience Platform Edge Network i listan Extension och välj Forward event to Edge Network.
2. Välj Keep Changes.
Spara regeln genom att välja Save to Library.

För att säkerställa att alla ändringar i taggen publiceras

Välj Initial Build som bibliotek att bygga.
Välj Build.

Validera inställningar i Assurance

Så här validerar du inställningarna i Assurance:

Gå till försäkringsgränssnittet.
Om den inte redan är tillgänglig i den vänstra listen markerar du Configure i den vänstra listen och väljer bredvid Events och Map & Simulate under PLACES SERVICE.
Välj Save.
Välj Map & Simulate i den vänstra listen.
Flytta kartan till en plats för en av dina POI:n.
Välj för att simulera inläsning av POI. Din POI identifieras med en cirkel och ett stift.
Välj POI.
Välj Simulate Entry Event på popup-menyn.
Välj Events i den vänstra listen så ser du händelserna som du simulerade.

Implementera platser i din app

Som tidigare nämnts tillhandahåller installation av ett mobiltaggtillägg bara konfigurationen. Därefter måste du installera och registrera Places SDK. Om de här stegen inte är tydliga går du igenom avsnittet Installera SDK.

NOTE

Om du har slutfört avsnittet Installera SDK är Platser SDK redan installerat och du kan hoppa över det här steget.

Kontrollera att AEP-platser har lagts till i listan över paket i paketberoenden i Xcode. Se Hanteraren för wift-paket.
Navigera till Luma > Luma > AppDelegate i Xcode Project-navigatorn.
Se till att AEPPlaces ingår i din lista över importer.
import AEPPlaces

Kontrollera att Places.self är en del av den array med tillägg som du registrerar.

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
]

Navigera till Luma > Luma > Utils > MobileSDK i Xcode Project-navigatorn och hitta funktionen func processRegionEvent(regionEvent: PlacesRegionEvent, forRegion region: CLRegion) async. Lägg till följande kod:
// Process geolocation event Places.processRegionEvent(regionEvent, forRegion: region)
Detta Places.processRegionEvent-API kommunicerar geopositioneringsinformationen med platstjänsten.

Navigera till Luma > Luma > Views > Location > GeofenceSheet i Xcodes projektnavigerare.

Ange följande kod för anmälningsknappen

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

Ange följande kod för knappen Avsluta:

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

Validera med din app

Öppna appen på en enhet eller i simulatorn.
Gå till fliken Location.
Flytta (dra) runt kartan för att se till att den blå mittre cirkeln är ovanför en av dina POI:er, till exempel London.
Tryck tills du ser kategorin och namnet visas i etiketten på den röda platsen med stiftet.
Tryck på etiketten för POI, som öppnar bladet Nearby POI.
Tryck på knapparna Entry eller Exit för att simulera händelser för geostaktion och geostaktionsavslutning i appen.
Du bör se händelserna i försäkringsgränssnittet.

Nästa steg

Nu bör du ha alla verktyg som behövs för att börja lägga till fler funktioner i geopositioneringsfunktionerna i appen. När du har vidarebefordrat händelserna till Edge Network bör du, när du har konfigurerat appen för Experience Platform, se upplevelsehändelserna för profilen som används i appen.

I Journey Optimizer-delen av den här självstudien ser du att upplevelsehändelser kan användas för att utlösa resor (se push-meddelanden och meddelanden i appen med Journey Optimizer). Det vanliga exemplet med att skicka ett push-meddelande till en appanvändare med en produktbefordran när den användaren fyller i en fysisk butik.

Du har sett en implementering av funktionalitet för din app, som till största delen styrs av tjänsten Platser samt dataelement och regler som du har definierat i taggegenskapen. Därför bör du minimera koden i appen. Du kan också implementera samma funktioner direkt i appen med API:t Edge.sendEvent (se Händelser för mer information) med en XDM-nyttolast som innehåller ett fyllt placeContext -objekt.

SUCCESS

Du har nu aktiverat appen för geopositioneringstjänster med tillägget Platser i Experience Platform Mobile SDK.

Tack för att du lade ned din tid på att lära dig om Adobe Experience Platform Mobile SDK. Om du har frågor, vill dela allmän feedback eller har förslag på framtida innehåll kan du dela dem i det här Experience League-diskussionsinlägget.

Nästa: Mappa data till Adobe Analytics

recommendation-more-help