Utiliser des barrières virtuelles pour lancer des campagnes requiert d'avoir accès à la fonctionnalité Interactions.
Cet article donne aux développeurs des informations pour configurer le traçage de la géolocalisation de sorte à permettre aux marketeurs de configurer des zones d'utilisation.
Table des matières
- Configuration requise
- Autorisations de localisation
- Activer la fonctionnalité de géolocalisation
- Désactiver la fonctionnalité de géolocalisation
- Vérifier que / regarder si la fonctionnalité de géolocalisation est activée
- Utiliser le setEventHandler
Ressources
Configuration du SDK Android
Il est fortement conseillé de n'utiliser que le SDK Emarsys pour la gestion des zones d'utilisation au sein de l'app. Utiliser 2 services de géoblocage ou plus à l'intérieur d'une app peut créer un conflit entre les différents ensembles de zones d'utilisation pour le système d'exploitation, entraînant un comportement incohérent.
1. Configuration requise
Il faut au moins la version 2.5.0 du SDK pour prendre en charge le géoblocage.
2. Autorisations de localisation
Pour demander à ce que l'app ait accès aux services de localisation de l'appareil, le AndroidManifest.xml doit être étendu de la manière suivante :
... <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" /> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> ...
Quand vous testez l'app, veuillez vous assurer qu'il est demandé au contact d'autoriser à l'app l'accès à la géolocalisation.
3. Activer la fonctionnalité de géolocalisation
Pour activer la fonctionnalité de gélocalisation, utilisez la méthode enable
:
Java
Emarsys.getGeofence().enable(CompletionListener completionListener);
Kotlin
Emarsys.geofence.enable(completionListener: CompletionListener? = null)
4. Désactiver la fonctionnalité de géolocalisation
Pour déactiver la fonctionnalité de gélocalisation, utilisez la méthode disable
:
Java
Emarsys.getGeofence().disable();
Kotlin
Emarsys.geofence.disable()
5. Vérifier que / regarder si la fonctionnalité de géolocalisation est activée
Pour vérifier que / regarder si la fonctionnalité de géolocalisation est activée, utilisez la méthode isEnabled
:
Java
Emarsys.getGeofence().isEnabled();
Kotlin
Emarsys.geofence.isEnabled()
6. Utiliser le setEventHandler
Pour réagir à un événement déclenché par une zone d'utilisation, il est possible de s'y inscrire en utilisant la méthode setEventHandler
. Le eventHandler est un rappel d'un événement de zone d'utilisation.
Java
Emarsys.getGeofence().setGeofenceEventHandler(EventHandler geofenceEventHandler);
Kotlin
Emarsys.geofence.geofenceEventHandler(geofenceEventHandler: EventHandler)