Show Menu
SUJETS×

Utilisation de l’extension Places Monitor

Pour utiliser l’extension Places Monitor, procédez comme suit :

Installation de l’extension Places Monitor dans Experience Platform Launch

  1. In Experience Platform Launch, click the **Extensions**tab.
  2. Dans l’ Catalog onglet, recherchez l’ Places Monitor extension, puis cliquez sur Installer .
  3. Cliquez sur Save (Exécuter des tests d’Auditor).
  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 Places Monitor.
Places ‌

Ajout de l’extension Places Monitor à votre application

Vous devez ajouter l’extension Places Monitor à votre application Android ou iOS.

Android

Dans 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 classification.
    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 Cocoapods Podfile en ajoutant pod 'ACPPlacesMonitor' .
  2. Importez les bibliothèques du moniteur Lieux et Lieux :

Objective-C

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

Swift

import ACPCore
import ACPPlaces
import ACPPlacesMonitor

Enregistrement et démarrage du moniteur de lieux

Vous devez vous enregistrer et démarrer Places Monitor sous Android ou iOS.

Android

Dans Android, procédez comme suit :

Java

Dans la OnCreate méthode 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
        }
    }
}

La surveillance des lieux dépend de l’extension Places. Lorsque vous installez manuellement l’extension Surveiller les Places, veillez à ajouter également la bibliothèque places.aar à votre projet.

iOS

Dans les application:didFinishLaunchingWithOptions applications iOS, inscrivez-vous PlacesMonitor et emplacements avec Mobile Core :

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

La surveillance des lieux dépend de l’extension Places. When manually installing the Places Monitor extension, ensure that you also add the libACPPlaces_iOS.a library to your project.

Ajouter des autorisations au manifeste

Android

Java
Pour toutes les versions d’Android, pour déclarer que votre application a besoin d’une autorisation d’emplacement, ajoutez un <uses-permission> élément dans le manifeste de votre application, en tant qu’enfant de l’ <manifest> élément de niveau supérieur. Pour les applications Android qui ciblent les API Niveau 29 et supérieur, pour permettre à l'application d'accéder à l'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>

Activation des mises à jour d’emplacement en arrière-plan

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

Configuration des clés de liste

Les clés suivantes doivent être incluses dans le Info.plist fichier de votre application :
  • NSLocationWhenInUseUsageDescription - le texte doit expliquer 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 en permanence l’accès aux informations d’emplacement de l’utilisateur.
Si votre application prend en charge iOS 10 et les versions antérieures, la NSLocationAlwaysUsageDescription clé est également requise.