Übersicht über das PhoneGap-Plug-in

Mit diesem Plug-in können Sie Android-AppMeasurement-Aufrufe von Ihrem PhoneGap-Projekt ausführen. Informationen zum Erstellen eines PhoneGap-Projekts finden Sie unter PhoneGap.

Neue Version des Adobe Experience Platform Mobile SDK

Sind Sie auf der Suche nach Informationen und Dokumentation zu Mobile SDK für die Adobe Experience Platform? Klicken Sie hier, um unsere aktuelle Dokumentation abzurufen.

Seit September 2018 steht eine neue, bessere Version des SDK zur Verfügung. Diese neuen Adobe Experience Platform Mobile SDK können über Experience Platform Launch konfiguriert werden.

Installieren des Plug-ins mit npm

Führen Sie folgenden Befehl aus:

cordova plugin add adobe-mobile-services

Manuelles Installieren des Plug-ins

Plug-in einschließen

  1. Ziehen Sie die Datei ADBMobile_PhoneGap.java in Ihren src-Ordner.

    Um die Datei zu verschieben, klicken Sie auf OK.

  2. Ziehen Sie die Datei ADB_Helper.js in den Ordner, der die Datei index.html enthält.

    Um die Datei zu verschieben, klicken Sie auf OK.

  3. Öffnen Sie im res/xml-Ordner die Datei config.xml und registrieren Sie ein neues Plug-in, indem Sie Folgendes hinzufügen:

    <feature name="ADBMobile_PhoneGap"> 
  <param name="android-package" value="[YOUR_PACKAGE_NAME].ADBMobile_PhoneGap" /> 
</feature>

    Wenn Ihr Paket beispielsweise com.example.phonegaptest heißt, lautet der Wert android-package wie folgt:

    <param name="android-package" value="com.example.phonegaptest.ADBMobile_PhoneGap" />

AppMeasurement-Bibliothek einschließen

  1. Informationen zum Herunterladen der AppMeasurement-Bibliothek finden Sie im Abschnitt SDK abrufen.

  2. Ziehen Sie die Datei adobeMobileLibrary.jar in Ihren src-Ordner.

    Um die Datei zu verschieben, klicken Sie auf OK.

  3. Klicken Sie mit der rechten Maustaste auf die Datei adobeMobileLibrary.jar und wählen Sie Als Bibliothek hinzufügen aus.

  4. Geben Sie je nach Anforderungen Ihres Projekts den Namen, die Ebene und den Standort der Bibliothek ein.

  5. Ziehen Sie die Datei ADBMobileConfig.json zum assets-Ordner im Stammverzeichnis der App.

  6. Bestätigen Sie, dass Sie die Stammanwendung und nicht eine Anwendung in einer Anwendung ausgewählt haben.

    Um die Datei zu verschieben, klicken Sie auf OK.

App-Berechtigungen hinzufügen

Die AppMeasurement-Bibliothek erfordert folgende Berechtigungen, um Daten zu senden und Offline-Verfolgungsaufrufe aufzuzeichnen:

  • INTERNET
  • ACCESS_NETWORK_STATE

Ergänzen Sie die Datei AndroidManifest.xml im Projektverzeichnis der Anwendung um die folgenden Zeilen, um diese Berechtigungen hinzuzufügen:

<uses-permission android:name="android.permission.INTERNET" /> 
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

So aktivieren Sie In-App-Nachrichten:

Aktualisieren Sie AndroidManifest.xml, um die Vollbildaktivität zu deklarieren und den Nachrichten-Handler zu aktivieren:

<activity  
android:name="com.adobe.mobile.MessageFullScreenActivity"  
android:theme="@android:style/Theme.Translucent.NoTitleBar" /> 
<receiver android:name="com.adobe.mobile.MessageNotificationHandler" />

Wenn Sie beim Erstellen einer Nachricht in Adobe Mobile Services das modale Layout gewählt haben, wählen Sie eines der folgenden Designs aus:

  • Theme.Translucent.NoTitleBar.Fullscreen
  • Theme.Translucent.NoTitleBar
  • Theme.Translucent

Beispiel:

<activity 
android:name="com.adobe.mobile.MessageFullScreenActivity" 
android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" 
android:windowSoftInputMode="adjustUnspecified|stateHidden" /> 
<receiver android:name="com.adobe.mobile.MessageNotificationHandler" />

Benutzerdefinierte Verfolgung implementieren

Fügen Sie in html-Dateien Folgendes zum <head>-Tag hinzu, den Sie für das Tracking verwenden möchten:

<script type="text/javascript" charset="utf-8" src="ADB_Helper.js"></script>

Auf dieser Seite