モバイルアプリケーションへの Adobe Analytics の追加

メモ

アドビは、シングルページアプリケーションフレームワークをベースにしたクライアント側のレンダリング(React など)を必要とするプロジェクトには SPA エディターを使用することをお勧めします。詳細情報を参照してください。

モバイルアプリケーションユーザーにとって魅力的で関連性の高いエクスペリエンスを生成したいとお考えですか。アプリケーションのライフサイクルと使用状況の監視や測定に Adobe Mobile Services SDK を使用しないとしたら、何に基づいて決定を下すのでしょうか。ロイヤルティの最も高いお客様はどこにいますか。どのようにして確実に関連性の高さを維持し、コンバージョンを最適化しますか。

ユーザーは、すべてのコンテンツにアクセスしていますか。ユーザーはアプリの使用を中止していますか。中止している場合、その場所はどこですか。ユーザーがアプリに留まる頻度と戻ってくる頻度はどのくらいですか。どのような変更を導入でき、どのようにして定着率を測定しますか。クラッシュ率はどうなっていますか。ユーザーに対してクラッシュが発生していますか。

を活用する モバイルアプリ分析 をAEM Apps に追加するには、 AdobeMobile Services.

AEMアプリを実装して、モバイルアプリやコンテンツとの関わり方を追跡、レポートおよび理解し、起動回数、アプリ内時間、クラッシュ率などの主要なライフサイクル指標を測定します。

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

  • モバイルアプリケーションへの Mobile Analytics の統合
  • Bloodhound による Analytics トラッキングのテスト

前提条件

AEM Mobile では、アプリでのトラッキングデータを収集してレポートするには Adobe Analytics アカウントが必要です。設定の一環として、AEM 管理者 は最初に次をおこなう必要があります。

  • Adobe Analytics アカウントを設定し、Mobile Services にアプリケーションのレポートスイートを作成します。
  • Adobe Experience Manager(AEM)に AMS クラウドサービスを設定します。

開発者向け - アプリへの Mobile Analytics の統合

ContentSync での設定ファイルの取り込みの設定

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

詳しくは、コンテンツ同期コンテンツの設定を参照してください。 この設定は、コンテンツ同期に対して、ADBMobileConfig を /www ディレクトリに取り込むように指示する必要があります。例えば、Geometrixx Outdoorsアプリでは、コンテンツ同期設定は次の場所にあります。 /content/phonegap/geometrixx-outdoors/shell/jcr:content/pge-app/app-config/ams-ADBMobileConfig. 開発向けの設定もありますが、Geometrixx Outdoors の場合には開発以外の設定と同じものです。

Mobile Application AEM Apps ダッシュボードから ADBMobileConfig をダウンロードする方法について詳しくは、 Analytics - Mobile Services -AdobeMobile 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 プロジェクトの リソース ディレクトリ ( 例: 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 プラグインの追加

アプリがデータを収集するには、AdobeMobile Services(AMS) プラグインをアプリの一部として含める必要があります。 アプリの config.xml にプラグインを 1 つの機能としてインクルードすることで、別の Cordova フックを使用して、PhoneGap Build プロセスでプラグインを自動的に追加できます。

<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 で提供されるすべてのライフサイクル指標をレポートできるようになります。これには例えば、起動、クラッシュ、インストールなどのデータが含まれます。関心があるデータがこれだけの場合、操作は完了です。カスタムデータを収集する場合は、そのためのコードを実装する必要があります。

アプリを完全にトラッキングするためのコードの実装

複数のトラッキング API が AMS Phonegap プラグイン API です。

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

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

Geometrixx Outdoors アプリのコードを見ると参考になります。Geometrixx Outdoors アプリでは、ADB.trackState() メソッドを使用して、すべてのページ移動をトラッキングしています。詳しくは、 /libs/mobileapps/components/angular/ng-page/clientlibs/app-navigation.jsのソースコードを参照してください。

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

AMS への接続のプロパティ

com.adobe.cq.mobile.mobileservices.impl.service.MobileServicesHttpClientImpl は、AMS への接続用の以下のプロパティを公開しています。

ラベル 説明 デフォルト
API エンドポイント AdobeMobile Services HTTP API のベース URL https://api.omniture.com
Config エンドポイント 指定されたレポートスイート ID の ADB Mobile 設定を取得するために使用される URL /ams/1.0/app/config/
Mobile Service アプリ ユーザーの会社内のアプリのリストを取得 /ams/1.0/apps

このページ