DokumentationExperience PlatformSjälvstudiekurs om mobila appar

Använd platser

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ä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.

  1. Välj Places i användargränssnittet för datainsamling.
  2. Välj Mer .
  3. Välj Manage Libraries på snabbmenyn.
    Hantera bibliotek
  4. Välj New i dialogrutan Manage Libraries.
  5. I dialogrutan Create Library anger du Name, till exempel Luma.
  6. Välj Confirm.
    Skapa bibliotek
  7. Om du vill stänga dialogrutan Manage Libraries väljer du Close.
  8. Gå tillbaka i POI Management, välj Import POIs.
  9. Välj Start i dialogrutan Import Places.
  10. Välj Luma i listan över bibliotek,
  11. Välj Next.
    Välj bibliotek
  12. Hämta Luma POIs ZIP-filen och extrahera den till en plats på datorn.
  13. 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.
  14. Välj Begin Import. Du bör se Success - Successfully added 6 new POIs.
  15. Välj Done.
  16. I POI Management bör du se att sex nya Luma-butiker har lagts till i listan. Du kan växla mellan listan och mappningsvyn Karta .
    Platslista .

Tillägg för Installera platser

  1. Navigera till Tags och hitta din mobila taggegenskap och öppna egenskapen.

  2. Välj Extensions.

  3. Välj Catalog.

  4. Sök efter tillägget Places.

  5. Installera tillägget.

    Lägg till beslutstillägg

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

      Installera Platstillägg .

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

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

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.

  1. Gå till taggegenskapen i användargränssnittet för datainsamling.

  2. Välj Data Elements i den vänstra listen.

  3. Välj Add Data Element.

  4. På skärmen Create Data Element anger du ett namn, till exempel Name - Entered.

  5. Välj Places i listan Extension.

  6. Välj Name i listan Data Element Type.

  7. Välj Current POI under TARGET.

  8. Välj Save to Library.
    Dataelement

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

  1. Välj Rules i den vänstra listen i taggegenskapen.

  2. Välj Add Rule.

  3. På skärmen Create Rule anger du ett namn för regeln, till exempel POI - Entry.

  4. Välj Lägg till under EVENTS.

    1. Välj Places i listan Extension och välj Enter POI i listan Event Type.

    2. Välj Keep Changes.

      Tagga händelse .

  5. Välj Lägg till under ACTIONS.

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

    2. Klistra in följande nyttolast i JSON Payload:

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

    3. Välj Keep Changes.

      Tagg, åtgärd

  6. Välj Lägg till 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.

  7. Spara regeln genom att välja Save to Library.

    Regel

Låt oss skapa en annan regel

  1. På skärmen Create Rule anger du ett namn för regeln, till exempel POI - Exit.

  2. Välj Lägg till under EVENTS.

    1. Välj Places i listan Extension och välj Exit POI i listan Event Type.
    2. Välj Keep Changes.

  3. Välj Lägg till under ACTIONS.

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

    2. Klistra in följande nyttolast i JSON 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. Välj Keep Changes.

  4. Välj Lägg till 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.

  5. Spara regeln genom att välja Save to Library.

    Regel

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

  1. Välj Initial Build som bibliotek att bygga.
  2. Välj Build.
    Skapa bibliotek

Validera inställningar i Assurance

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

  1. Gå till försäkringsgränssnittet.
  2. Om den inte redan är tillgänglig i den vänstra listen markerar du Configure i den vänstra listen och väljer Lägg till bredvid Events och Map & Simulate under PLACES SERVICE.
  3. Välj Save.
  4. Välj Map & Simulate i den vänstra listen.
  5. Flytta kartan till en plats för en av dina POI:n.
  6. Välj Kugga för att simulera inläsning av POI. Din POI identifieras med en cirkel och ett stift.
  7. Välj POI.
  8. Välj Kugga Simulate Entry Event på popup-menyn.
    Simulera transaktionshändelse
  9. Välj Events i den vänstra listen så ser du händelserna som du simulerade.
    Verifiering av AJO-beslut

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.

  1. Kontrollera att AEP-platser har lagts till i listan över paket i paketberoenden i Xcode. Se Hanteraren för wift-paket.

  2. Navigera till Luma > Luma > AppDelegate i Xcode Project-navigatorn.

  3. Se till att AEPPlaces ingår i din lista över importer.

    code language-swift 
    import AEPPlaces

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

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

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

    Detta Places.processRegionEvent-API kommunicerar geopositioneringsinformationen med platstjänsten.

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

    1. Ange följande kod för anmälningsknappen
    code language-swift 
    // Simulate geofence entry event
Task {
    await MobileSDK.shared.processRegionEvent(regionEvent: .entry, forRegion: region)
}
    1. 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

  1. Öppna appen på en enhet eller i simulatorn.

  2. Gå till fliken Location.

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

  4. Tryck {width="20"} tills du ser kategorin och namnet visas i etiketten på den röda platsen med stiftet.

  5. Tryck på etiketten för POI, som öppnar bladet Nearby POI.

    {width="300"}

  6. Tryck på knapparna Entry eller Exit för att simulera händelser för geostaktion och geostaktionsavslutning i appen.

    {width="300"}

  7. 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
9fed61f5-c338-47ad-8005-0b89a5f4af8b