DocumentatieExperience PlatformTutorial voor mobiele apps

Plaatsen gebruiken

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

  1. Selecteer Places in de gebruikersinterface voor gegevensverzameling.
  2. Selecteer Meer .
  3. Selecteer Manage Libraries in het contextmenu.
    beheert bibliotheken
  4. Selecteer New in het dialoogvenster Manage Libraries .
  5. Voer in het dialoogvenster Create Library bijvoorbeeld een Name Luma in.
  6. Selecteer Confirm.
    creeer bibliotheek
  7. Selecteer Close om het dialoogvenster Manage Libraries 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
  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 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 .
  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 .

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.

    voeg de uitbreiding van het Beslissen 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 .

  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 .

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

  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

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

  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 de Edge Network van het Platform door:sturen.
    2. Selecteer Keep Changes.

  7. Selecteer Save to Library om de regel op te slaan.

    Regel

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

Alle wijzigingen in de tag worden gepubliceerd

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

Setup valideren bij Betrouwbaarheid

Uw instellingen valideren in Betrouwbaarheid:

  1. Ga naar de betrouwbaarheidsinterface.
  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
  9. Selecteer Events in de linkertrack en bekijk de gebeurtenissen die u hebt gesimuleerd.
    AJO Beslissende bevestiging

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.

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

  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)
}
    1. 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)
}

Valideren met uw app

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

  2. Ga naar de tab 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. 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
9fed61f5-c338-47ad-8005-0b89a5f4af8b