Utilisation de l'extension Places Monitor

Pour utiliser l'extension Places Monitor, effectuez les tâches suivantes :

Installez l’extension Places Monitor dans Experience Platform Launch

1. Dans l’Experience Platform Launch, cliquez sur l’onglet Extensions.
2. Dans l'onglet Catalogue, recherchez l'extension Moniteur des emplacements, puis cliquez sur Installer.
3. Cliquez sur Enregistrer.
4. Suivez le processus de publication pour mettre à jour la configuration du SDK.

Configuration de l'extension Places Monitor

Il n'existe aucune tâche de configuration pour l'extension du moniteur de lieux.

de lieux ‌

Ajouter l'extension Places Monitor à votre application

Vous trouverez ci-dessous les instructions concernant l’ajout de l’extension Places Monitor à votre application Android ou iOS.

La prise en charge des plates-formes supplémentaires pour l'extension Places Monitor inclut :
Cordova Places Monitor

Réagir à l'écran des emplacements natifs

Écran de battage

Android

Sous Android, procédez comme suit :

Java

1. Ajoutez l’extension Places Monitor et l’extension Places à votre projet à l’aide du fichier de nivellement de votre application.

2. Incluez également les derniers services Google Location dans le fichier de classement.

   implementation 'com.adobe.marketing.mobile:places:1.+'
   implementation 'com.adobe.marketing.mobile:places-monitor:1.+'
   implementation 'com.adobe.marketing.mobile:sdk-core:1.+'
   implementation 'com.google.android.gms:play-services-location:16.0.0'
   

3. Importez l’extension Places Monitor dans l’activité principale de votre application.

   import com.adobe.marketing.mobile.PlacesMonitor;
   

iOS

Sous iOS, procédez comme suit :

1. Ajoutez la bibliothèque à votre projet via votre Podfile Cocoapods en ajoutant le pod 'ACPPlacesMonitor'.
2. Importez les bibliothèques d’écran Lieux et Lieux :

Objective-C

#import "ACPCore.h"
#import "ACPPlaces.h"
#import "ACPPlacesMonitor.h"

Swift

import ACPCore
import ACPPlaces
import ACPPlacesMonitor

Enregistrer et début le moniteur des lieux

Vous devez enregistrer et début le moniteur de lieux sur Android ou iOS.

Android

Sous Android, procédez comme suit :

Java

Dans la méthode OnCreate de votre application, enregistrez les extensions du moniteur de lieux :

public class MobileApp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        MobileCore.setApplication(this);
        MobileCore.ConfigureWithAppId("yourAppId");
        try {
            PlacesMonitor.registerExtension(); //Register PlacesMonitor with Mobile Core
            Places.registerExtension(); //Register Places with Mobile Core
            MobileCore.start(null);
            PlacesMonitor.start();//Start monitoring the geo-fences
        } catch (Exception e) {
            //Log the exception
        }
    }
}

iOS

Dans l’application iOS application:didFinishLaunchingWithOptions, inscrivez PlacesMonitor et les emplacements avec Mobile Core :

Objectif C

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions {
    [ACPCore configureWithAppId:@"yourAppId"];
    [ACPPlaces registerExtension];
    [ACPPlacesMonitor registerExtension];
    [ACPCore start:^{            
        // do other initialization required for the SDK
        [ACPPlacesMonitor start];
    }];

    return YES;
}

Swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    ACPCore.configure(withAppId: "yourAppId")
    ACPPlaces.registerExtension()       
    ACPPlacesMonitor.registerExtension()
    ACPCore.start({
        // do other initialization required for the SDK
        ACPPlacesMonitor.start()
    })

    // Override point for customization after application launch.        
    return true
}

Ajouter des autorisations pour le manifeste

Android

Java

Pour toutes les versions d'Android, pour déclarer que votre application a besoin d'une autorisation d'emplacement, ajoutez un élément <uses-permission> dans votre manifeste d'application, en tant qu'enfant de l'élément de niveau supérieur <manifest>. Pour les applications Android qui utilisent l'API de cible Niveau 29 et plus, pour permettre à l'application d'accéder à un emplacement en arrière-plan, incluez l'autorisation ACCESS_BACKGROUND_LOCATION.

<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.adobe.placesapp">
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    // Only for Android apps targeting API level 29 and above
  <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
  <application>        
    ...    
  </application>
</manifest>

Activer les mises à jour d'emplacement en arrière-plan

iOS prend en charge la diffusion de événements d’emplacement pour les applications suspendues ou qui ne sont plus en cours d’exécution. Pour recevoir les mises à jour d'emplacement en arrière-plan pour l'extension Places Monitor, configurez la fonctionnalité de mises à jour d'emplacement pour votre application dans Xcode.background-location-updates.

Configuration des clés de liste

Les clés suivantes doivent être incluses dans le fichier Info.plist de votre application :

• NSLocationWhenInUseUsageDescription - le texte doit décrire pourquoi l’application demande l’accès aux informations d’emplacement de l’utilisateur lors de son exécution au premier plan.
• NSLocationAlwaysAndWhenInUseUsageDescription - le texte doit décrire pourquoi l’application demande l’accès aux informations d’emplacement de l’utilisateur en tout temps.