Hinzufügen von Adobe Analytics zu einer Mobile App add-adobe-analytics-to-your-mobile-application

CAUTION
AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.
NOTE
Adobe empfiehlt die Verwendung des SPA-Editors für Projekte, für die ein frameworkbasiertes Client-seitiges Rendering für einzelne Seiten (z. B. React) erforderlich ist. Weitere Informationen

Möchten Sie ansprechende und relevante Erlebnisse für Ihre Mobile App-Benutzer erstellen? Wenn Sie das Adobe Mobile Services SDK nicht zur Überwachung und Messung des Lebenszyklus und der Nutzung von Anwendungen verwenden, auf welcher Grundlage basieren Sie dann Ihre Entscheidungen? Wo sind Ihre treusten Kunden? Wie können Sie sicherstellen, dass Sie relevant bleiben und Konversionen optimieren?

Haben Ihre Benutzer Zugriff auf alle Inhalte? Verlassen sie die App, und wenn ja, wo? Wie oft bleiben sie in der App und wie oft kommen sie zurück, um die App zu verwenden? Welche Änderungen können eingeführt und dann gemessen werden, um die Bindung zu erhöhen? Wie sieht es mit den Absturzraten aus, stürzt Ihre App für Ihre Benutzer ab?

Nutzen Sie die Vorteile von Mobile App Analytics in Ihren AEM Apps durch Integration von in Adobe Mobile Services.

Instrumentieren Sie Ihre AEM Apps, um zu verfolgen, darüber zu berichten und zu verstehen, wie Sie mit Ihrer mobilen App und Ihren Inhalten interagieren, und um wichtige Lebenszyklusmetriken wie Starts, Zeit in der App und Absturzhäufigkeit zu messen.

In diesem Abschnitt wird beschrieben, wie AEM Entwickler kann:

  • Mobile Analytics in Ihre Mobile App integrieren
  • Testen Sie Ihr Analytics-Tracking mit Bloodhound.

Voraussetzungen prerequisties

AEM Mobile benötigt ein Adobe Analytics-Konto, um Tracking-Daten in Ihrer App zu erfassen und zu melden. Im Rahmen der Konfiguration AEM Administrator muss zunächst:

  • Richten Sie ein Adobe Analytics-Konto ein und erstellen Sie eine Report Suite für Ihre Anwendung in Mobile Services.
  • Konfigurieren Sie einen AMS-Cloud Service in Adobe Experience Manager (AEM).

Für Entwickler - Integration von Mobile Analytics in Ihre App for-developers-integrate-mobile-analytics-into-your-app

ContentSync zum Abrufen der Konfigurationsdatei konfigurieren configure-contentsync-to-pull-in-configuration-file

Nachdem das Analytics-Konto eingerichtet wurde, müssen Sie eine Konfiguration für die Inhaltssynchronisierung erstellen, um den Inhalt in Ihre Mobile App zu übernehmen.

Weitere Informationen finden Sie unter Konfigurieren des Inhalts der Inhaltssynchronisierung . Die Konfiguration muss die Inhaltssynchronisierung anweisen, um ADBMobileConfig im Verzeichnis /www abzulegen. Beispielsweise befindet sich die Konfiguration der Inhaltssynchronisierung in der Geometrixx Outdoors App unter: /content/phonegap/geometrixx-outdoors/shell/jcr:content/page-app/app-config/ams-ADBMobileConfig. Es gibt auch eine Konfiguration für die Entwicklung. Sie ist jedoch bei Geometrixx Outdoors identisch mit der Nicht-Entwicklungs-Konfiguration.

Weitere Informationen zum Herunterladen der ADBMobileConfig über das Dashboard für Mobile Apps AEM Apps finden Sie unter Analytics - Mobile Services - Adobe Mobile Services SDK-Konfigurationsdatei.

<jcr:root xmlns:jcr="https://www.jcp.org/jcr/1.0" xmlns:nt="https://www.jcp.org/jcr/nt/1.0"
    jcr:primaryType="nt:unstructured"
    extension="json"
    path="../../../.."
    selector="ADBMobileConfig"
    targetRootDirectory="www"
    type="mobileADBMobileConfigJSON"/>

Für jede Plattform muss ADBMobileConfig an einen bestimmten Speicherort kopiert werden.

Beim Erstellen mit der PhoneGap-CLI kann dies mit Cordova-Build-Hook-Skripten durchgeführt werden. Dies ist in der Geometrixx Outdoors App zu sehen unter:content/phonegap/geometrixx-outdoors/shell/_jcr_content/pge-app/app-content/phonegap/scripts/restore_plugins.js

Für iOS muss die Datei in die Ressourcen Verzeichnis (z. B. "platforms/ios/Geometrixx/Resources/ADBMobileConfig.json"). Wenn die App für Android vorgesehen ist, lautet der Pfad, in den kopiert werden soll, "platforms/android/assets/ADBMobileConfig.json". Weitere Informationen zur Verwendung von Hooks während des PhoneGap-CLI-Builds finden Sie unter Drei Hooks für Ihr Cordova-/PhoneGap-Projekt.

///////////////////////////
//          iOS
///////////////////////////
    ios : [
        {
            "www/ADBMobileConfig.json": "platforms/ios/<YOUR_APP_NAME>/Resources/ADBMobileConfig.json"
        }
    ],
///////////////////////////
//          ANDROID
///////////////////////////
    android: [
        {
            "www/ADBMobileConfig.json": "platforms/android/assets/ADBMobileConfig.json"
        }
    ]

Hinzufügen des AMS-Plug-ins in der App add-the-ams-plugin-in-the-app

Damit die App die Daten erfassen kann, muss das Adobe Mobile Services (AMS)-Plug-in als Teil der App enthalten sein. Indem Sie das Plug-in als Funktion in die config.xml der App einfügen, kann ein weiterer Cordova-Erweiterungspunkt verwendet werden, um das Plug-in während des PhoneGap-Build-Prozesses automatisch hinzuzufügen.

<feature name="ADBMobile">
    <param name="id" value="https://github.com/Adobe-Marketing-Cloud/mobile-services#0482f9cedf90c98a8d4b07219ece1933b2e46a60"/>
</feature>

Die Geometrixx Outdoors App config.xml befindet sich unter /content/phonegap/geometrixx-outdoors/shell/jcr:content/pge-app/app-content/phonegap/www/config.xml. Im obigen Beispiel wird eine bestimmte Version des Plug-ins angefordert, indem ein "#"hinzugefügt und anschließend ein Tag-Wert nach der Plug-in-URL eingefügt wird. Dies ist eine Best Practice, um sicherzustellen, dass nicht erwartete Probleme nicht auftreten, da während eines Builds nicht getestete Plug-ins hinzugefügt werden.

Nachdem Sie diese Schritte ausgeführt haben, kann Ihre App alle Lebenszyklusmetriken von Adobe Analytics melden. Dazu gehören Daten wie Starts, Abstürze und Installationen. Wenn das die einzigen Daten sind, die Ihnen wichtig sind, dann sind Sie fertig. Wenn Sie benutzerdefinierte Daten erfassen möchten, müssen Sie Ihren Code instrumentieren.

Instrumentieren Ihres Codes für das vollständige App-Tracking instrument-your-code-for-full-app-tracking

Im Abschnitt werden verschiedene Tracking-APIs bereitgestellt AMS PhoneGap-Plug-in-API.

Auf diese Weise können Sie Status und Aktionen verfolgen, z. B., wohin Seiten Ihre Benutzer in Ihrer App navigieren und welche Steuerelemente am häufigsten verwendet werden. Die einfachste Möglichkeit, Ihre App für das Tracking zu instrumentieren, besteht darin, die Analytics-APIs zu verwenden, die vom AMS-Plug-in bereitgestellt werden.

  • ADB.trackState()
  • ADB.trackAction()

Als Referenz können Sie sich den Code in der Geometrixx Outdoors App ansehen. In der Geometrixx Outdoors-App werden alle Seitennavigationen mithilfe der ADB.trackState() -Methode verfolgt. Weitere Informationen finden Sie im Quellcode für /libs/mobileapps/components/angular/ng-page/clientlibs/app-navigation.js .

Durch die Instrumentierung Ihres Quellcodes mit diesen Methodenaufrufen können Sie vollständige Metriken zu Ihrer Anwendung erfassen.

Testen des Analytics-Trackings mit Bloodhound testing-analytics-tracking-with-bloodhound

Optional können Sie vor der Bereitstellung in der Produktion das Adobe-Tool Bloodhound verwenden, um Ihre Analysekonfiguration zu testen. Um Ihre Analysekonfiguration zu testen, müssen Sie Ihre Datei ADBMobileConfig.json so bearbeiten, dass sie auf den Server verweist, auf dem Bloodhound ausgeführt wird, anstatt auf den eigentlichen Analytics-Server. Um diese Änderung vorzunehmen, ändern Sie in ADBMobileConfig.json den folgenden Eintrag.

...
"analytics": {
    "rsids": "YOUR_RSID",
    "server": "YOUR_TRACKING_SERVER:YOUR_TRACKING_PORT",
...

Ändern Sie diese Einstellung entsprechend diesem Eintrag:

...
"analytics": {
    "rsids": "YOUR_RSID",
    "server": "localhost:50000",
...

Dadurch werden alle vom AMS-Plug-in erfassten Daten an Bloodhound weitergeleitet, damit Sie die Ergebnisse anzeigen können.

Eigenschaften für die Verbindung mit AMS properties-for-connecting-to-ams

com.adobe.cq.mobile.mobileservices.impl.service.MobileServicesHttpClientImp l legt die folgenden Eigenschaften für die Verbindung mit AMS offen:

Bezeichnung
Beschreibung
Standard
API-Endpunkt
Die Basis-URL der Adobe Mobile Services-HTTP-APIs
https://api.omniture.com
Config Endpoint
Die URL, die zum Abrufen der ADB Mobile-Konfiguration für die jeweilige Report Suite-ID verwendet wird
/ams/1.0/app/config/
Mobile Service-Apps
Abrufen einer Liste von Apps im Benutzerunternehmen
/ams/1.0/apps
recommendation-more-help
547b817b-14b5-4d82-aa0f-a64750e0e592