Documentation Experience Platform Tutoriel sur les applications mobiles

Utiliser des emplacements

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

Rubriques :
Mobile SDK

Créé pour :

Beginner
Intermediate
Developer

Découvrez comment utiliser le service de géolocalisation Places dans votre application.

Le service Adobe Experience Platform Data Collection Places est un service de géolocalisation qui permet aux applications mobiles reconnaissant l’emplacement de l’application de comprendre le contexte de l’emplacement. Le service utilise des interfaces SDK riches et faciles à utiliser, accompagnées d’une base de données flexible de points ciblés (POI).

Conditions préalables

Toutes les dépendances de package sont en place dans le projet Xcode.
Extensions enregistrées dans AppDelegate.
Configuré MobileCore pour utiliser votre appId de développement.
SDK importés.
Création et exécution de l’application réussie avec les modifications ci-dessus.

Objectifs d'apprentissage

Dans cette leçon, vous allez

Découvrez comment définir des points ciblés dans le service Places.
Mettez à jour votre propriété de balise avec l’extension Places.
Mettez à jour votre schéma pour capturer les événements de géolocalisation.
Validez la configuration dans Assurance.
Mettez à jour votre application pour enregistrer l’extension Places.
Mettez en oeuvre le suivi de la géolocalisation à partir du service Places dans votre application.

Configuration

Pour que le service Places fonctionne dans votre application et dans le SDK Mobile, vous devez effectuer une configuration.

Définition des emplacements

Vous définissez certains points ciblés dans le service Places.

Dans l’interface utilisateur de la collecte de données, sélectionnez Places.
Sélectionner .
Dans le menu contextuel, sélectionnez Gestion des bibliothèques.
Dans le Gestion des bibliothèques boîte de dialogue, sélectionnez Nouveau.
Dans le Créer une bibliothèque entrée dans une boîte de dialogue Nom, par exemple Luma.
Sélectionner Confirmer.
Pour fermer la variable Gestion des bibliothèques boîte de dialogue, sélectionnez Fermer.
Retour à Gestion des points ciblés, sélectionnez Importation de points ciblés.
Sélectionner Début dans le Importer des emplacements boîte de dialogue.
Sélectionner Luma de la liste des bibliothèques,
Sélectionnez Suivant.
Téléchargez la Fichier ZIP des points ciblés Luma et extrayez-le vers un emplacement de votre ordinateur.
Dans le Importer des emplacements Boîte de dialogue, effectuez un glisser-déposer de l’élément extrait luma_pois.csv sur Choisir un fichier CSV - Effectuez un glisser-déposer de votre fichier. Vous devriez voir Validation Success - Validation réussie du fichier CSV.
Sélectionner Lancer l’importation. Vous devriez voir Succès - Ajout réussi de 6 nouveaux points ciblés.
Sélectionnez Terminé.
Dans Gestion des points ciblés, vous devriez constater que six nouveaux magasins Luma sont ajoutés à la liste. Vous pouvez basculer entre les list et vue map.
.

Installation de l’extension Places

Accédez à Balises et recherchez la propriété de balise mobile et ouvrez-la.
Sélectionner Extensions.
Sélectionner Catalogue.
Recherchez le Places extension .
Installez l’extension .
Dans le Installer l’extension dialog :
1. Sélectionner Luma de la Sélection d’une bibliothèque liste.
2. Vérifiez que vous avez sélectionné votre bibliothèque de travail, par exemple : Version initiale.
3. Sélectionner Enregistrer dans la bibliothèque et créer de Enregistrer dans la bibliothèque.
  
  .
Votre bibliothèque est reconstruite.

Vérification de votre schéma

Vérifiez si votre schéma est défini dans la section Créer un schéma, intègre les groupes de champs et classes nécessaires pour collecter les données des points ciblés et de géolocalisation.

Accédez à l’interface de collecte de données et sélectionnez Schémas dans le rail de gauche.
Sélectionner Parcourir dans la barre supérieure.
Sélectionnez votre schéma pour l’ouvrir.
Dans l’éditeur de schéma, sélectionnez Événement d’expérience client.
Vous voyez une placeContext avec objet et champs pour capturer les données d’interaction et de géolocalisation des points ciblés.
.

Mettre à jour la propriété de balise

L’extension Places pour les balises permet de surveiller les événements de géolocalisation et de déclencher des actions en fonction de ces événements. Vous pouvez utiliser cette fonctionnalité pour minimiser le codage de l’API que vous devez implémenter dans l’application.

Éléments de données

Vous devez d’abord créer plusieurs éléments de données.

Accédez à la propriété de balise dans l’interface utilisateur de la collecte de données.
Sélectionner Éléments de données dans le rail de gauche.
Sélectionnez Ajouter un élément de données.
Dans le Créer un élément de données , saisissez un nom, par exemple Name - Entered.
Sélectionner Places de la Extension liste.
Sélectionner Nom de la Type d’élément de données liste.
Sélectionner Point ciblé actuel underneath TARGET.
Sélectionner 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.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4
Nom	Extension	Type d’élément de données	TARGET
`Name - Exited`	Places	Nom	Dernier point ciblé de sortie
`Category - Current`	Places	Catégorie	Point ciblé actuel
`Category - Exited`	Places	Catégorie	Dernier point ciblé de sortie
`City - Current`	Places	Ville	Point ciblé actuel
`City - Exited`	Places	Ville	Dernier point ciblé de sortie

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

Liste des éléments de données

Règles

Vous allez ensuite définir des règles pour travailler avec ces éléments de données.

Dans la propriété de balise, sélectionnez Règles dans le rail de gauche.
Sélectionner Ajouter une règle.
Dans le Créer une règle , saisissez un nom pour la règle, par exemple POI - Entry.
Sélectionner underneath ÉVÉNEMENTS.
1. Sélectionner Places de la Extension répertorier et sélectionner Entrée dans le point ciblé de la Type d’événement liste.
2. Sélectionnez Conserver les modifications.
  
  .

Sélectionner underneath ACTIONS.

Sélectionner Mobile Core de la Extension list, select Joindre des données de Type d’action la liste. Cette action associe des données de payload.

Dans le Charge utile JSON, collez la charge utile suivante :

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

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

Sélectionnez Conserver les modifications.

Sélectionner en regard de Noyau mobile - Joindre des données action.
1. Sélectionner Adobe Experience Platform Edge Network de la Extension répertorier et sélectionner Transfert d’un événement vers Edge Network. Cette action garantit que l’événement et les données de charge utile supplémentaires sont transférés vers Platform Edge Network.
2. Sélectionnez Conserver les modifications.
Pour enregistrer la règle, sélectionnez Enregistrer dans la bibliothèque.

Créons une autre règle

Dans le Créer une règle , saisissez un nom pour la règle, par exemple POI - Exit.
Sélectionner underneath ÉVÉNEMENTS.
1. Sélectionner Places de la Extension répertorier et sélectionner Quitter le point ciblé de la Type d’événement liste.
2. Sélectionnez Conserver les modifications.

Sélectionner underneath ACTIONS.

Sélectionner Mobile Core de Extension list, select Joindre des données de Type d’action liste.

Dans le Charge utile JSON, collez la charge utile suivante :

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%%}"
                }
            }
        }
    }
}

Sélectionnez Conserver les modifications.

Sélectionner en regard de Noyau mobile - Joindre des données action.
1. Sélectionner Adobe Experience Platform Edge Network de la Extension répertorier et sélectionner Transfert d’un événement vers Edge Network.
2. Sélectionnez Conserver les modifications.
Pour enregistrer la règle, sélectionnez Enregistrer dans la bibliothèque.

Pour vous assurer que toutes les modifications apportées à votre balise sont publiées

Sélectionner Version initiale comme bibliothèque à créer.
Sélectionner Build.

Validation de la configuration dans Assurance

Pour valider votre configuration dans Assurance :

Accédez à l’interface utilisateur d’assurance.
Si elle n’est pas déjà disponible dans le rail de gauche, sélectionnez Configurer dans le rail de gauche et sélectionnez en regard de Événements et Carte et simulation underneath SERVICE PLACES.
Sélectionnez Enregistrer.
Sélectionner Carte et simulation dans le rail de gauche.
Déplacez la carte vers un emplacement de l’un de vos points ciblés.
Sélectionner Simulation de la charge des points ciblés. Votre point ciblé est identifié à l’aide d’un cercle et d’une broche.
Sélectionnez votre point ciblé.
Dans la fenêtre contextuelle, sélectionnez Simulation de l’événement d’entrée.
Sélectionner Événements dans le rail de gauche, et vous devriez voir les événements que vous avez simulés.

Mise en oeuvre de Places dans votre application

Comme indiqué dans les leçons précédentes, l’installation d’une extension de balise mobile fournit uniquement la configuration. Vous devez ensuite installer et enregistrer le SDK Places. Si ces étapes ne sont pas claires, passez en revue la Installation des SDK .

NOTE

Si vous avez terminé la Installation des SDK , le SDK Places est déjà installé et vous pouvez ignorer cette étape.

Dans Xcode, assurez-vous que Places AEP 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.

code language-swift
`import AEPPlaces`

Assurez-vous que Places.self fait partie du tableau des extensions que vous enregistrez.

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
]

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

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

Ceci Places.processRegionEvent L’API communique les informations de géolocalisation au service Places.

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

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

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

Pour le bouton Quitter , saisissez le code suivant :

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

Validation à l’aide de votre application

Ouvrez votre application sur un appareil ou dans le simulateur.
Accédez au Emplacement .
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.
Pression+--------------+ | img-md | +==============+ | w-20 | +--------------+ | | +--------------+jusqu’à ce que la catégorie et le nom apparaissent dans le libellé à l’emplacement rouge avec l’épingle.

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

img-md
w-300

Appuyez sur la touche Entrée ou Quitter pour simuler les événements d’entrée et de sortie de géobarrière de l’application.

img-md
w-300

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

Étapes suivantes

Vous devriez maintenant disposer de tous les outils pour commencer à ajouter d’autres fonctionnalités à votre fonctionnalité de géolocalisation dans l’application. Lorsque vous avez transféré les événements vers le réseau Edge, une fois que vous avez configuré l’application pour Experience Platform, vous devriez voir les événements d’expérience apparaissant pour le profil utilisé dans l’application.

Dans la section Journey Optimizer de ce tutoriel, vous verrez que les événements d’expérience peuvent être utilisés pour déclencher des parcours (voir notification push et messagerie in-app avec Journey Optimizer). Par exemple, l’exemple habituel d’envoi à l’utilisateur de votre application d’une notification push avec une promotion de produit lorsque cet utilisateur accède à la clôture d’une boutique physique.

Vous avez vu une mise en oeuvre de la fonctionnalité de votre application, principalement pilotée par le service Places, ainsi que par les éléments de données et les règles que vous avez définis dans votre propriété de balise. Par conséquent, minimisez le code dans votre application. Vous pouvez également mettre en oeuvre la même fonctionnalité directement dans votre application à l’aide du Edge.sendEvent API (voir Événements pour plus d’informations) avec un payload XDM contenant un placeContext .

SUCCESS

Vous avez désormais activé l’application pour les services de géolocalisation à l’aide de l’extension Places dans le SDK Mobile Experience Platform.

Merci d’investir votre temps à apprendre sur le SDK Adobe Experience Platform Mobile. Si vous avez des questions, souhaitez partager des commentaires généraux ou avez des suggestions sur le contenu futur, partagez-les à ce sujet. Article de discussion de la communauté Experience League.

Suivant : Mappage des données à Adobe Analytics

recommendation-more-help

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