Extension Places

L’extension Places vous permet d’agir en fonction de l’emplacement de vos utilisateurs. Cette extension est l’interface des API de Places Query Service. En écoutant les événements qui contiennent des coordonnées GPS et des événements de région de géobarrière, cette extension distribue les nouveaux événements qui sont traités par le moteur de règles. L’extension Places récupère et fournit également une liste du point ciblé le plus proche pour les données de l’application récupérées à partir des API. Les régions renvoyées par les API sont stockées dans le cache et la persistance, ce qui permet un traitement hors ligne limité.

Installation de l’extension Places dans Adobe Experience Platform Launch

  1. Dans Experience Platform Launch, cliquez sur le Extensions .

  2. Sur le Catalogue , recherchez la variable Places puis cliquez sur Installer.

  3. Sélectionnez les bibliothèques Places que vous souhaitez utiliser dans cette propriété. Il s’agit des bibliothèques qui seront accessibles dans votre application.

  4. Cliquez sur Enregistrer.

    Lorsque vous cliquez sur Enregistrer, le SDK Experience Platform recherche les points ciblés dans les services Places dans les bibliothèques que vous avez sélectionnées. Les données du point ciblé ne sont pas incluses dans le téléchargement de la bibliothèque lorsque vous créez l’application, mais un sous-ensemble de points ciblés basé sur l’emplacement est téléchargé sur l’appareil de l’utilisateur final au moment de l’exécution et est basé sur les coordonnées GPS de l’utilisateur.

  5. Suivez le processus de publication pour mettre à jour la configuration du SDK.

    Pour plus d’informations sur la publication dans Experience Platform Launch, voir Publication.

Configuration de l’extension Places

Ajout de l’extension Places à votre application

Vous pouvez ajouter l’extension Places à vos applications Android et iOS. Les étapes d’ajout de Places à votre application iOS ou Android sont présentées ci-dessous. Les extensions Places sont également disponibles pour les plateformes suivantes. Pour ajouter des Places à votre application lors du développement avec l’une de ces plateformes, consultez les liens suivants :

Plug-in Cordova Places

Module externe React Native Places

Plug-in Fbattaces

Module externe Xamarin Places

Android

Pour ajouter l’extension Places à votre application à l’aide de Java :

  1. Ajoutez l’extension Places à votre projet à l’aide du fichier gradle de votre application.

    implementation 'com.adobe.marketing.mobile:places:1.+'
    implementation 'com.adobe.marketing.mobile:sdk-core:1.+'
    
  2. Importez l'extension Places dans l'activité principale de votre application.

    import com.adobe.marketing.mobile.Places;
    

iOS

Pour ajouter l’extension Places à votre application à l’aide d’Objective-C ou de Swift :

  1. Ajoutez les Places et Mobile Core bibliothèques de votre projet. Vous devrez ajouter les capsules suivantes à votre Podfile:

    pod 'ACPPlaces', '~> 1.0'
    pod 'ACPCore', '~> 2.0'    # minimum Core version for Places is 2.0.3
    

    Si vous n’utilisez pas Cocoapods, vous pouvez également inclure manuellement les bibliothèques Mobile Core et Places de notre page des versions sur Github.

  2. Mettez à jour votre Cocoapods :

    pod update
    
  3. Ouvrez Xcode, puis, dans votre classe AppDelegate, importez les en-têtes Core et Places :

    Objective-C

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

    Swift

    import ACPCore
    import ACPPlaces
    

Enregistrement de l’extension Places avec Mobile Core

Vous devez enregistrer l’extension Places avec Mobile Core dans Android et iOS.

Android

Dans votre application OnCreate enregistrer les extensions Places :

public class PlacesTestApp extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        MobileCore.setApplication(this);

        try {
            Places.registerExtension();
            MobileCore.start(null);
        } catch (Exception e) {
            Log.e("PlacesTestApp", e.getMessage());
        }
    }
}

iOS

Dans votre application application:didFinishLaunchingWithOptions: , enregistrez l’extension Places avec vos autres appels d’enregistrement SDK :

Objective-C

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // make other sdk registration calls
    [ACPPlaces registerExtension];
    return YES;
}

Swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // make other sdk registration calls
    ACPPlaces.registerExtension();
    return true;
}

Modification de la durée de vie de l’appartenance à Places

Les données d’emplacement peuvent rapidement devenir obsolètes, en particulier si l’appareil ne reçoit pas de mises à jour d’emplacement en arrière-plan.

Contrôlez la durée de vie des données d’appartenance à Places sur l’appareil en définissant la variable places.membershipttl paramètre de configuration . La valeur transmise à représente le nombre de secondes pendant lesquelles l’état Places reste valide pour l’appareil.

Android

Dans le rappel de MobileCore.start() mettre à jour la configuration avec les modifications nécessaires avant d’appeler lifecycleStart:

public class PlacesTestApp extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        MobileCore.setApplication(this);

        try {
            Places.registerExtension();
            MobileCore.start(new AdobeCallback() {
                @Override
                public void call(Object o) {
                    // switch to your App ID from Launch
                    MobileCore.configureWithAppID("my-app-id");

                    final Map<String, Object> config = new HashMap<>();
                    config.put("places.membershipttl", 30);
                    MobileCore.updateConfiguration(config);

                    MobileCore.lifecycleStart(null);
                }
            });
        } catch (Exception e) {
            Log.e("PlacesTestApp", e.getMessage());
        }
    }
}

iOS

Sur la première ligne du rappel de ACPCore's start: méthode, appel updateConfiguration:

Objective-C

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // make other sdk registration calls

    const UIApplicationState appState = application.applicationState;
    [ACPCore start:^{
        [ACPCore updateConfiguration:@{@"places.membershipttl":@(30)}];

        if (appState != UIApplicationStateBackground) {
            [ACPCore lifecycleStart:nil];
        }
    }];

    return YES;
}

Swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // make other sdk registration calls

    let appState = application.applicationState;
    ACPCore.start {
        ACPCore.updateConfiguration(["places.membershipttl" : 30])

        if appState != .background {
            ACPCore.lifecycleStart(nil)
        }
    }

    return true;
}

Clés de configuration

Pour mettre à jour la configuration du SDK par programmation au moment de l’exécution, utilisez les informations suivantes pour modifier les valeurs de configuration de l’extension Places. Pour plus d’informations, voir Référence de l’API de configuration.

Clé Obligatoire Description
places.libraries Oui Les bibliothèques d’extension Places pour l’application mobile. Il spécifie l’ID de bibliothèque et le nom de la bibliothèque pris en charge par l’application mobile.
places.endpoint Oui Point d’entrée Places Query Service par défaut, utilisé pour obtenir des informations sur les bibliothèques et les points ciblés.
places.membershipttl Non Valeur par défaut de 3 600 (secondes dans une heure). Indique la durée de validité, en secondes, des informations d’appartenance à Places pour l’appareil.

Sur cette page