將Adobe Analytics新增至您的行動應用程式

想要為您的行動應用程式使用者建立引人入勝的相關體驗嗎？ 如果您不是使用Adobe Mobile Services SDK來監控和測量應用程式的生命週期和使用情形，那麼您的決策依據是什麼？ 您最忠誠的客戶在哪裡？ 如何保證您保持相關性並最佳化轉換？

您的使用者是否可存取所有內容？ 他們會放棄應用嗎？如果會，會在哪裡？ 他們多久會留在應用程式中，又多久會回來使用應用程式？ 您可以引入哪些更改，然後衡量這些更改是否提高了保留率？ 當機率呢？您的應用程式是否對您的使用者造成當機？

透過與Adobe Mobile Services整合，在您的AEM應用程式中善用行動應用程式分析。

利用您的AEM應用程式來追蹤、報告並瞭解您的使用者如何與行動應用程式和內容互動，以及測量關鍵生命週期度量，例如啟動、應用程式逗留時間和當機率。

本節說明AEM Developers​如何：

• 將Mobile Analytics整合至您的行動應用程式
• 使用Bloodhound測試您的分析追蹤

先決條件

AEM Mobile需要Adobe Analytics帳戶才能收集和報告應用程式中的追蹤資料。 在設定中，AEM Administrator​首先需要：

• 在Mobile Services中設定Adobe Analytics帳戶並建立應用程式的報表套裝。
• 在Adobe Experience Manager(AEM)中設定AMS Cloud服務。

針對開發人員——將Mobile Analytics整合至您的應用程式

配置ContentSync以提取配置檔案

在設定Analytics帳戶後，您將需要建立內容同步設定，以將內容納入您的行動應用程式。

如需詳細資訊，請參閱「設定內容同步內容」。 配置將需要指示「內容同步」將ADBMobileConfig放入/www目錄。 例如，在Geometrixx Outdoors應用程式中，內容同步設定位於：/content/phonegap/geometrixx-outdoors/shell/jcr:content/pge-app/app-config/ams-ADBMobileConfig。 此外，還有一種發展配置；但是，它與Geometrixx Outdoors的非開發設定相同。

如需如何從「行動應用程式AEM應用程式」儀表板下載ADBMobileConfig的詳細資訊，請參閱「Analytics - Mobile Services - Adobe Mobile Services SDK設定檔」。

<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"/>

每個平台都需要將ADBMobileConfig複製至特定位置。

如果使用PhoneGap CLI建立，則可使用cordova建立掛接指令碼來完成。 這可在Geometrixx Outdoors應用程式中看到，網址為：content/phonegap/geometrixx-outdoors/shell/_jcr_content/pge-app/app-content/phonegap/scripts/restore_plugins.js。

對於iOS，需要將檔案複製到XCode項目的​Resources​目錄(如 「platforms/ios/Geometrixx/Resources/ADBMobileConfig.json」)。 如果應用程式已定位至Android，則要複製至的路徑是「platforms/android/assets/ADBMobileConfig.json」。 有關在PhoneGap CLI構建過程中使用掛接的詳細資訊，請參閱 Three hooks your Cordova/PhoneGap project needs。

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

將AMS外掛程式新增至應用程式

App若要收集資料，Adobe Mobile Services(AMS)外掛程式必須包含在應用程式中。 將外掛程式加入應用程式的config.xml中做為功能，可在PhoneGap建立程式期間使用另一個Cordova掛接自動新增外掛程式。

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

Geometrixx Outdoors App config.xml位於​/content/phonegap/geometrixxx-outdoors/shell/jcr:content/pge-app/app-content/phonegap/www/config.xml。 上述範例會要求在外掛程式URL後新增「#」和標籤值，以使用特定版本的外掛程式。 這是一個很好的做法，可確保由於在構建過程中添加未經測試的插件而出現意想不到的問題。

執行這些步驟後，您的應用程式將會啟用，以報告Adobe Analytics提供的所有生命週期度量。 這包括啟動、當機和安裝等資料。 如果這是您唯一關心的資料，您就完成了。 如果您想要收集自訂資料，則需要測量您的程式碼。

測量您的程式碼以進行完整的應用程式追蹤

AMS Phonegap外掛程式API中提供數個追蹤API。

這些功能可讓您追蹤狀態和動作，例如使用者在應用程式中瀏覽至的頁面位置，以及最常使用的控制項。 要測量應用程式進行追蹤，最簡單的方式就是使用AMS外掛程式提供的Analytics API。

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

您可以參考Geometrixx Outdoors應用程式中的程式碼。 在Geometrixx Outdoors應用程式中，所有頁面導覽都會使用ADB.trackState()方法進行追蹤。 如需詳細資訊，請參閱/libs/mobileapps/components/angular/ng-page/clientlibs/app-navigation.js的原始碼

透過這些方法呼叫來檢測您的原始碼，您就可以針對您的應用程式收集完整量度。

使用Bloodhound測試Analytics追蹤

（可選）在部署至生產環境之前，您可以使用Adobe工具Bloodhound來測試您的分析設定。 為測試您的分析設定，您需要編輯ADBMobileConfig.json檔案，以指向Bloodhound執行的伺服器，而非實際的Analytics伺服器。 若要進行此變更，請從您的ADBMobileConfig.json變更下列項目。

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

變更以符合此項目：

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

這會將AMS外掛程式收集的所有資料重新導向至Bloodhound，讓您檢視結果。

連接到AMS的屬性

com.adobe.cq.mobile.mobileservices.impl.service. MobileServicesHttpClientImpl公開下列用於連線至AMS的屬性：