モバイルアプリケーションへの Adobe Analytics の追加 add-adobe-analytics-to-your-mobile-application

モバイルアプリケーションユーザー向けに、魅力的で関連性の高いエクスペリエンスを構築するには、 Adobe Mobile Services SDKを使用して、アプリケーションのライフサイクルと使用状況をモニタリングおよび測定していない場合、どのような判断を下すのでしょうか？ 最も忠実な顧客はどこにいるのか？ コンバージョンを最適化し、関連性を維持するにはどうすればよいでしょうか？

ユーザーはすべてのコンテンツにアクセスしていますか？ アプリを放棄しているか、その場合、どこで放棄しているか、などです。 どれくらいの頻度でアプリに滞在し、どれくらいの頻度でアプリを使用するために再訪問するか？ リテンションを高めるために、どのような変化を導入し、それを測定できますか？ クラッシュ率について、あなたのアプリはあなたのユーザーのためにクラッシュしていますか？

Adobe Mobile Servicesと連携することで、Adobe Experience Manager（AEM）アプリの​ モバイルアプリ分析を活用できます。

AEMアプリを計測することで、利用者がモバイルアプリやコンテンツにどのようにエンゲージしているのかを追跡、レポート、把握し、ローンチ、アプリ滞在時間、クラッシュ率などの主要なライフサイクル指標を測定できます。

この節では、AEM Developers​が次の操作を実行する方法について説明します。

前提条件 prerequisties

AEM Mobileでは、アプリ内のトラッキングデータを収集およびレポートするためにAdobe Analytics アカウントが必要です。 設定の一部として、AEM Administrator​は最初に次の操作を行う必要があります。

開発者向け – モバイル分析をアプリに統合する for-developers-integrate-mobile-analytics-into-your-app

設定ファイルを取り込むためのContentSyncの設定 configure-contentsync-to-pull-in-configuration-file

Analytics アカウントを設定したら、コンテンツ同期設定を作成して、コンテンツをモバイルアプリケーションに取り込みます。

詳しくは、コンテンツ同期コンテンツの設定を参照してください。 設定では、ADBMobileConfigを/www ディレクトリに配置するようにContent Syncに指示する必要があります。 例えば、Geometrixx Outdoors アプリのContent Sync設定は​ /content/phonegap/geometrixx-outdoors/shell/jcr:content/page-app/app-config/ams-ADBMobileConfig ​です。 開発のための構成もあります。 ただし、Geometrixx Outdoorsがある場合は、開発以外の設定と同じです。

Mobile Application AEM Apps ダッシュボードからADBMobileConfigをダウンロードする方法の詳細については、Analytics - Mobile Services - Adobe Mobile Services SDK Config Fileを参照してください。

<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のビルド中にフックを使用する方法について詳しくは、Cordova/PhoneGap プロジェクトに必要な3つのフック ​を参照してください。

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

アプリがデータを収集するには、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 アプリ config.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

AMS Phonegap Plugin APIには、複数のトラッキング APIが用意されています。

これにより、ユーザーがアプリ内のどこに移動しているか、どのコントロールが最も頻繁に使用されているかなどの状態とアクションを追跡できます。 トラッキング用にアプリを計測する最も簡単な方法は、AMS プラグインが提供するAnalytics APIを使用することです。

参考までに、Geometrixx Outdoors アプリのコードを参照してください。 Geometrixx Outdoors アプリでは、すべてのページナビゲーションがADB.trackState （） メソッドを使用して追跡されます。 詳しくは、/libs/mobileapps/components/angular/ng-page/clientlibs/app-navigation.jsのソースコードを参照してください。

このメソッド呼び出しでソースコードを実装することで、アプリケーションに対する完全な指標を収集できます。

AMSに接続するためのプロパティ properties-for-connecting-to-ams

com.adobe.cq.mobile.mobileservices.impl.service.MobileServicesHttpClientImp lは、AMSに接続するための次のプロパティを公開します。