Places-Erweiterung

Mit der Erweiterung "Orte"können Sie je nach dem Standort Ihrer Benutzer handeln. Diese Erweiterung ist die Schnittstelle zu den Ores Abfrage Service APIs. Durch Listening auf Ereignis, die GPS-Koordinaten und Geofenregion-Ereignis enthalten, löst diese Erweiterung neue Ereignis aus, die von der Rules Engine verarbeitet werden. Die Plates-Erweiterung ruft außerdem eine Liste des nächstgelegenen POI für die App-Daten ab, die von den APIs abgerufen werden. Die von den APIs zurückgegebenen Regionen werden im Cache und in der Persistenz gespeichert, was eine begrenzte Offlineverarbeitung ermöglicht.

Installieren der Platzierungserweiterung beim Starten der Adobe Experience Platform

  1. In Experience Platform Launch, click the Extensions tab.

  2. Suchen Sie auf der Catalog Registerkarte die Places Erweiterung und klicken Sie auf Install.

  3. Wählen Sie die Orte-Bibliotheken aus, die Sie in dieser Eigenschaft verwenden möchten. Dies sind die Bibliotheken, auf die in Ihrer App zugegriffen werden kann.

  4. Klicken Sie auf Save.

    Wenn Sie auf klicken Save, durchsucht das Experience Platform-SDK die Orte-Dienste nach POIs in den von Ihnen ausgewählten Bibliotheken. Die POI-Daten werden beim Erstellen der App nicht in den Download der Bibliothek einbezogen, aber eine ortsbasierte Untergruppe von POIs wird zur Laufzeit auf das Gerät des Endbenutzers heruntergeladen und basiert auf den GPS-Koordinaten des Benutzers.

  5. Schließen Sie den Veröffentlichungsprozess ab, um die SDK-Konfiguration zu aktualisieren.

    Weitere Informationen zum Veröffentlichen in Experience Platform Launch finden Sie unter Veröffentlichen.

Configure the Places extension

Hinzufügen der Platzierungserweiterung für Ihre App

Sie können Ihre Android- und iOS-Apps mit der Erweiterung "Orte"versehen. Die Schritte zum Hinzufügen von Orten zu Ihrer iOS- oder Android-Anwendung finden Sie unten. Die Platzierungserweiterungen stehen auch für die folgenden Plattformen zur Verfügung. Informationen zum Hinzufügen von Orten zu Ihrer Anwendung beim Entwickeln mit einer dieser Plattformen finden Sie unter den folgenden Links:

Cordova Places Plugin

React Native Places Plugin

Flatter Places Plugin

Xamarin Places Plugin

Android

So fügen Sie Ihrer App die Platzierungserweiterung mit Java hinzu:

  1. Hinzufügen Sie die Platzierungs-Erweiterung mit der GPÜGELdatei Ihrer App auf Ihr Projekt.

    implementation 'com.adobe.marketing.mobile:places:1.+'
implementation 'com.adobe.marketing.mobile:sdk-core:1.+'

  2. Importieren Sie die Platzierungserweiterung in die Haupt-Aktivität Ihrer Anwendung.

    import com.adobe.marketing.mobile.Places;

iOS

So fügen Sie Ihrer App die Platzierungserweiterung mit Objective-C oder Swift hinzu:

  1. Hinzufügen Sie die Bibliotheken "Orte"und " Mobile Core "in Ihr Projekt ein. Sie müssen die folgenden Pods hinzufügen Podfile:

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

    Wenn Sie keine Cocoapods verwenden, können Sie auch die Bibliotheken für den Mobile Core und die Orte manuell auf unserer Seite für Veröffentlichungen auf Github einbinden.

  2. Aktualisieren Sie Ihre Cocoapods:

    pod update

  3. Öffnen Sie Xcode und importieren Sie in der AppDelegate-Klasse die Header Core und Places:

    Objective-C

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

    Swift

    import ACPCore
import ACPPlaces

Registrieren der Platzierungserweiterung mit Mobile Core

Sie müssen die Platzierungserweiterung mit Mobile Core unter Android und iOS registrieren.

Android

Registrieren Sie in der OnCreate Methode Ihrer App die Plates-Erweiterungen:

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

Registrieren Sie in der application:didFinishLaunchingWithOptions: Methode Ihrer App die Plates-Erweiterung bei Ihren anderen SDK-Registrierungsaufrufen:

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

Ändern der Mitgliederzeit für Orte

Standortdaten können schnell statisch werden, insbesondere wenn das Gerät nicht über eine Aktualisierung des Hintergrundorts verfügt.

Legen Sie die places.membershipttl Konfigurationseinstellung fest, um die Live-Übertragung der Mitgliedschaftsdaten auf dem Gerät zu steuern. Der übergebene Wert gibt an, wie viele Sekunden der Status "Orte"für das Gerät gültig bleibt.

Android

Im Rückruf der MobileCore.start() Aktualisierung der Konfiguration mit den erforderlichen Änderungen vor dem Aufruf 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

Rufen Sie in der ersten Zeile in der Rückruffunktion der ACPCore start: Methode 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;
}

Konfigurationsschlüssel

Um die SDK-Konfiguration zur Laufzeit programmgesteuert zu aktualisieren, ändern Sie die Konfigurationswerte der Plates-Erweiterung mithilfe der folgenden Informationen. Weitere Informationen finden Sie unter Configuration API Reference.

Schlüssel Erforderlich Beschreibung
places.libraries Ja Die Speichererweiterungsbibliotheken für die mobile App. Er gibt die Bibliotheks-ID und den Namen der Bibliothek an, die von der mobilen App unterstützt werden.
places.endpoint Ja Der Standardendpunkt "Orts Abfrage Service", mit dem Informationen zu Bibliotheken und POIs abgerufen werden.
places.membershipttl Nein Standardwert von 3600 (Sekunden in einer Stunde). Gibt an, wie lange (in Sekunden) die Platzierungsmitgliedschaftsinformationen für das Gerät gültig bleiben.

Auf dieser Seite