將Adobe Analytics新增至行動應用程式 add-adobe-analytics-to-your-mobile-application

想要為您的行動應用程式使用者建立吸引人且相關的體驗嗎？ 如果您沒有使用AdobeMobile Services SDK來監視和測量應用程式的生命週期和使用情形，則您的決策依據為何？ 您最忠誠的客戶在哪裡？ 如何確保保持相關性並最佳化轉換？

您的使用者是否可存取所有內容？ 他們是否正在放棄應用，如果是，在哪裡？ 他們多久停留在應用程式內，又多久回來使用應用程式？ 您可以引入哪些變更，然後衡量哪些變更可增加保留率？ 當機率如何？您的應用程式是否會因使用者而當機？

善用 行動應用程式分析 與整合，在AEM應用程式中 AdobeMobile Services.

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

本節說明AEM 開發人員 可以：

必要性 prerequisties

AEM Mobile需要Adobe Analytics帳戶，才能收集應用程式中的追蹤資料並製作報表。 作為設定的一部分，AEM 管理員 首先需要：

開發人員 — 將行動分析整合至您的應用程式 for-developers-integrate-mobile-analytics-into-your-app

配置ContentSync以提取配置檔案 configure-contentsync-to-pull-in-configuration-file

設定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行動服務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，則需要將檔案複製到 資源 目錄(例如 "platforms/ios/Geometrixx/Resources/ADBMobileConfig.json")。 如果應用程式鎖定Android目標，則複製至的路徑為「platforms/android/assets/ADBMobileConfig.json」。 有關在PhoneGap CLI構建期間使用掛接的詳細資訊，請參閱 三個鈎點：Cordova/PhoneGap專案需求.

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

在應用程式中新增AMS外掛程式 add-the-ams-plugin-in-the-app

AdobeMobile Services(AMS)外掛程式必須包含在應用程式中，應用程式才能收集資料。 將外掛程式納入應用程式的config.xml中作為功能後，便可使用另一個Cordova連結，在PhoneGap建置程式期間自動新增外掛程式。

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

Geometrixx Outdoors應用配置.xml位於 /content/phonegap/geometrixx-outdoors/shell/jcr:content/pge-app/app-content/phonegap/www/config.xml. 上述範例要求您先新增「#」，然後在外掛程式URL後面新增標籤值，以使用特定版本的外掛程式。 這是確保在建立期間新增未經測試的外掛程式時，不會出現非預期問題的理想作法。

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

測量您的程式碼以進行完整的應用程式追蹤 instrument-your-code-for-full-app-tracking

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

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

若需參考，您可以檢視Geometrixx Outdoors應用程式中的程式碼。 在Geometrixx Outdoors應用程式中，所有頁面導覽都使用ADB.trackState()方法來追蹤。 欲知更多詳情，請查看/libs/mobileapps/components/angular/ng-page/clientlibs/app-navigation.js的原始碼

透過這些方法呼叫檢測原始碼，您便能夠針對應用程式收集完整量度。

使用Bloodhound測試Analytics追蹤 testing-analytics-tracking-with-bloodhound

（可選）部署至生產環境前，您可以使用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的屬性 properties-for-connecting-to-ams

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