Dokumentation Experience Platform Självstudiekurs om mobila appar

Använd platser

Last update: Tue Dec 05 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:
Mobile SDK

Skapat för:

Beginner
Intermediate
Developer

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örutsättningar

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.

I gränssnittet för datainsamling väljer du Platser.
Välj .
Välj Hantera bibliotek.
I Hantera bibliotek dialogruta, välja Nytt.
I Skapa bibliotek dialogruta Namn, till exempel Luma.
Välj Bekräfta.
Stäng Hantera bibliotek dialogruta, välja Stäng.
Tillbaka in POI-hantering, markera Importera POI.
Välj Starta i Importera platser -dialogrutan.
Välj Luma från listan över bibliotek,
Välj Nästa.
Ladda ned Luma POIs ZIP-fil och extrahera den till en plats på datorn.
I Importera platser dialogruta, dra och släppa den extraherade luma_pois.csv fil till Välj CSV-fil - dra och släpp filen. Du borde se Verifieringen lyckades - CSV-filen har verifierats.
Välj Starta import. Du borde se Lyckades - 6 nya POI har lagts till.
Välj Klar.
I POI-hantering ser du att sex nya Luma-butiker läggs till i listan. Du kan växla mellan lista och kartvy.
.

Tillägg för Installera platser

Navigera till Taggar och hitta din mobila taggegenskap och öppna egenskapen.
Välj Tillägg.
Välj Katalog.
Sök efter Platser tillägg.
Installera tillägget.
I Installera tillägg dialog:
1. Välj Luma från Välj ett bibliotek lista.
2. Se till att du har valt ditt arbetsbibliotek, till exempel Inledande bygge.
3. Välj Spara i bibliotek och bygge från Spara i bibliotek.
  
  .
Ditt bibliotek har byggts om.

Verifiera ditt schema

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

Navigera till gränssnittet Datainsamling och välj Scheman från den vänstra listen.
Välj Bläddra i det övre fältet.
Välj ditt schema för att öppna det.
Välj Consumer Experience Event.
Du ser en placeContext objekt med objekt och fält för inhämtning av 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 Dataelement från den vänstra listen.
Välj Lägg till dataelement.
I Skapa dataelement screen, ange ett namn, till exempel Name - Entered.
Välj Platser från Tillägg lista.
Välj Namn från Dataelementtyp lista.
Välj Aktuell POI under MÅL.
Välj Spara i bibliotek.

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

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4
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.

I taggegenskapen väljer du Regler från den vänstra listen.
Välj Lägg till regel.
I Skapa regel på skärmen, ange ett namn för regeln, till exempel POI - Entry.
Välj under HÄNDELSER.
1. Välj Platser från Tillägg lista och markera Ange POI från Händelsetyp lista.
2. Välj Behåll ändringar.
  
  .

Välj under ÅTGÄRDER.

Välj Mobile Core från Tillägg lista, välj Bifoga data från Åtgärdstyp listan. Den här åtgärden kopplar nyttolastdata.

I JSON-nyttolast, klistra in följande nyttolast:

code language-json

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

{
    "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 välja . I en popup-dialogruta kan du välja valfritt dataelement som du har skapat.

Välj Behåll ändringar.

Välj bredvid Mobile Core - bifoga data åtgärd.
1. Välj Adobe Experience Platform Edge Network från Tillägg lista och markera Vidarebefordra händelse till Edge Network. Den här åtgärden ser till att händelsen och ytterligare nyttolastdata vidarebefordras till plattforms-Edge-nätverket.
2. Välj Behåll ändringar.
Spara regeln genom att välja Spara i bibliotek.

Låt oss skapa en annan regel

I Skapa regel på skärmen, ange ett namn för regeln, till exempel POI - Exit.
Välj under HÄNDELSER.
1. Välj Platser från Tillägg lista och markera Avsluta POI från Händelsetyp lista.
2. Välj Behåll ändringar.

Välj under ÅTGÄRDER.

Välj Mobile Core från Tillägg lista, välj Bifoga data från Åtgärdstyp lista.

I JSON-nyttolast, klistra in följande nyttolast:

code language-json

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

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

Välj Behåll ändringar.

Välj bredvid Mobile Core - bifoga data åtgärd.
1. Välj Adobe Experience Platform Edge Network från Tillägg lista och markera Vidarebefordra händelse till Edge Network.
2. Välj Behåll ändringar.
Spara regeln genom att välja Spara i bibliotek.

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

Välj Inledande bygge som det bibliotek som ska byggas.
Välj Bygge.

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 väljer du Konfigurera i vänster rand och välj nästa Händelser och Karta och simulera under PLATSTJÄNST.
Välj Spara.
Välj Karta och simulera till vänster.
Flytta kartan till en plats för en av dina POI:n.
Välj Simulera laddnings-POI. Din POI identifieras med en cirkel och ett stift.
Välj POI.
I popup-fönstret väljer du Simulera anmälningshändelse.
Välj Händelser från vänster spår och du bör se de händelser 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 Installera SDK:er -avsnitt.

NOTE

Om du har slutfört Installera SDK:er , är platsens SDK redan installerat och du kan hoppa över det här steget.

I Xcode kontrollerar du att AEP-platser läggs till i listan över paket i paketberoenden. Se Swift Package Manager.
Navigera till Luma > Luma > AppDelegate i Xcode Project-navigatorn.

Säkerställ AEPPlaces är en del av din lista över importer.

code language-swift
`import AEPPlaces`

Säkerställ Places.self är en del av den array med tillägg som du registrerar.

code language-swift

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 ]`

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 navigator och hitta func processRegionEvent(regionEvent: PlacesRegionEvent, forRegion region: CLRegion) async funktion. Lägg till följande kod:

code language-swift
`// 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 projektnavigator.

Ange följande kod för anmälningsknappen

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

Ange följande kod för knappen Avsluta:

code language-swift
`// 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 Plats -fliken.
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 {width="20"} tills du ser kategorin och namnet visas på etiketten på den röda platsen med stiftet.
Tryck på etiketten för POI, som öppnar dialogrutan Nearby POI blad.

{width="300"}
Tryck på Post eller Avsluta knappar för att simulera geofence entry- och geofence exit-händelser i programmet.

{width="300"}
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 konfigurerat appen för Experience Platformska du se upplevelsehändelserna som visas för profilen som används i appen.

I Journey Optimizer-delen av den här självstudiekursen ser du att upplevelsehändelser kan användas för att utlösa resor (se push-meddelande 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 programmet med Edge.sendEvent API (se Händelser för mer information) med en XDM-nyttolast som innehåller en ifylld 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 om detta Experience League diskussionsinlägg.

Nästa: Mappa data till Adobe Analytics

recommendation-more-help

9fed61f5-c338-47ad-8005-0b89a5f4af8b