Utiliser des emplacements

Accédez à Balises et recherchez votre propriété de balise mobile, puis ouvrez la propriété .

Sélectionnez Extensions.

Sélectionnez Catalog.

Recherchez l’extension Places .

Installez l’extension .

Dans la boîte de dialogue Installer l’extension :

1. Sélectionnez Luma dans la liste Sélectionner une bibliothèque.

2. Vérifiez que vous avez sélectionné votre bibliothèque de travail, par exemple Initial Build.

3. Sélectionnez Enregistrer dans la bibliothèque et créer depuis Enregistrer dans la bibliothèque.

   .

Votre bibliothèque est reconstruite.

Accédez à la propriété de balise dans l’interface utilisateur de la collecte de données.

Sélectionnez Data Elements dans le rail de gauche.

Sélectionnez Ajouter un élément de données.

Dans l’écran Créer un élément de données , saisissez un nom, par exemple Name - Entered.

Sélectionnez Places dans la liste Extension.

Sélectionnez Name dans la liste Data Element Type.

Sélectionnez POI actuel sous TARGET.

Sélectionnez Enregistrer dans la bibliothèque.

Répétez les étapes 4 à 8 en utilisant les informations du tableau ci-dessous, pour créer des éléments de données supplémentaires.

La liste des éléments de données doit être la suivante.

Dans la propriété de balise, sélectionnez Rules dans le rail de gauche.

Sélectionnez Ajouter une règle.

Dans l’écran Créer une règle , saisissez un nom pour la règle, par exemple POI - Entry.

Sélectionnez sous EVENTS.

1. Sélectionnez Places dans la liste Extension et Entrer sur le point ciblé dans la liste Type d’événement.

2. Sélectionnez Conserver les modifications.

   .

Sélectionnez sous ACTIONS.

1. Sélectionnez Mobile Core dans la liste Extension, puis Joindre des données dans la liste Type d’action. Cette action associe des données de payload.

2. Dans la charge utile JSON, collez la charge utile suivante :

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

   Vous pouvez également insérer des valeurs d’espace réservé d’élément de données {%% ... %%} dans le fichier JSON en sélectionnant les . Une boîte de dialogue contextuelle vous permet de sélectionner un élément de données que vous avez créé.

3. Sélectionnez Conserver les modifications.

   

Sélectionnez en regard de l’action Mobile Core - Attach Data .

1. Sélectionnez Adobe Experience Platform Edge Network dans la liste Extension et sélectionnez Forward event to Edge Network. Cette action garantit que l’événement et les données de payload supplémentaires sont transférés à l’Edge Network Platform.
2. Sélectionnez Conserver les modifications.

Pour enregistrer la règle, sélectionnez Enregistrer dans la bibliothèque.

Dans l’écran Créer une règle , saisissez un nom pour la règle, par exemple POI - Exit.

Sélectionnez sous EVENTS.

1. Sélectionnez Places dans la liste Extension et Quitter POI dans la liste Type d’événement.
2. Sélectionnez Conserver les modifications.

Sélectionnez sous ACTIONS.

1. Sélectionnez Mobile Core dans la liste Extension, puis Attach Data dans la liste Action Type.

2. Dans la charge utile JSON, collez la charge utile suivante :

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

3. Sélectionnez Conserver les modifications.

Sélectionnez en regard de l’action Mobile Core - Attach Data .

1. Sélectionnez Adobe Experience Platform Edge Network dans la liste Extension et sélectionnez Forward event to Edge Network.
2. Sélectionnez Conserver les modifications.

Pour enregistrer la règle, sélectionnez Enregistrer dans la bibliothèque.

Dans Xcode, assurez-vous que AEP Places est ajouté à la liste des modules dans les dépendances de modules. Voir Swift Package Manager.

Accédez à Luma > Luma > AppDelegate dans le navigateur de projet Xcode.

Assurez-vous que AEPPlaces fait partie de votre liste d’importations.

import AEPPlaces

Vérifiez que Places.self fait partie du tableau des extensions que vous enregistrez.

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
]

Accédez à Luma > Luma > Utils > MobileSDK dans le navigateur de projet Xcode et recherchez la fonction func processRegionEvent(regionEvent: PlacesRegionEvent, forRegion region: CLRegion) async . Ajoutez le code suivant :

// Process geolocation event
Places.processRegionEvent(regionEvent, forRegion: region)

Cette API Places.processRegionEvent communique les informations de géolocalisation au service Places.

Accédez à Luma > Luma > Views > Location > GeofenceSheet dans le navigateur de projet de Xcode.

1. Pour le bouton Entrée, saisissez le code suivant :

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

1. Pour le bouton Quitter , saisissez le code suivant :

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

Ouvrez votre application sur un appareil ou dans le simulateur.

Accédez à l’onglet Location .

Déplacez (faites glisser) la carte pour vous assurer que le cercle central bleu se trouve au-dessus de l’un de vos points ciblés, par exemple Londres.

Appuyer {width="20"} jusqu’à ce que la catégorie et le nom s’affichent dans le libellé à l’emplacement rouge avec l’épingle.

Appuyez sur le libellé du point ciblé, ce qui ouvre la feuille Point ciblé le plus proche.

{width="300"}

Appuyez sur les boutons Entry ou Exit pour simuler les événements d’entrée et de sortie de géobarrière de l’application.

{width="300"}

Les événements doivent s’afficher dans l’interface utilisateur d’Assurance.