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

NOTE
Adobeは、単一ページアプリケーションのフレームワークベースのクライアントサイドレンダリング(React など)を必要とするプロジェクトでは、SPA Editor を使用することをお勧めします。 詳細情報

モバイルアプリケーションユーザーにとって魅力的で関連性の高いエクスペリエンスを構築したい場合は、 Adobeのライフサイクルと使用状況を監視および測定するために Mobile Services SDK を使用していない場合は、どのような決定に基づいていますか? 最も忠誠度の高い顧客はどこにいますか。 関連性の高い最適化コンバージョンを保証するには、どうすればよいですか?

ユーザーはすべてのコンテンツにアクセスしていますか? アプリを放棄していますか。放棄した場合は、どこですか。 ユーザーはどのくらいの頻度でアプリにとどまり、どのくらいの頻度でアプリを使用するために戻ってくるのですか? どのような変更を導入し、その後の保持率の向上を測定できますか。 クラッシュ率はどうなりますか。アプリはユーザーに対してクラッシュしますか。

を活用する モバイルアプリ分析 をAdobe Experience Manager(AEM) アプリに追加するには、 AdobeMobile Services.

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

この節では、AEMの仕組みについて説明します 開発者 次のことが可能です。

  • モバイルアプリケーションに Mobile Analytics を統合する
  • Bloodhound を使用した Analytics トラッキングのテスト

前提条件 prerequisties

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

  • Adobe Analyticsアカウントを設定し、Mobile Services でアプリ用のレポートスイートを作成します。
  • Adobe Experience Manager(AEM) で AMSCloud Serviceを設定します。

開発者向け — アプリへの Mobile Analytics の統合 for-developers-integrate-mobile-analytics-into-your-app

設定ファイルを取り込むためのコンテンツ同期の設定 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がある場合 ) と同じです。

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

アプリがデータを収集するには、AdobeMobile Services(AMS) プラグインをアプリの一部として含める必要があります。 このプラグインをアプリの config.xml の機能として含めることで、別の 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が提供するすべてのライフサイクル指標のレポートがアプリで有効になります。 これには、起動、クラッシュ、インストールなどのデータが含まれます。 それがあなたが気にする唯一のデータなら、あなたは終わりです。 カスタムデータを収集する場合は、コードを実装する必要があります。

コードを完全なアプリ追跡用に実装する instrument-your-code-for-full-app-tracking

複数のトラッキング 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 に接続するためのプロパティ properties-for-connecting-to-ams

com.adobe.cq.mobile.mobileservices.impl.service.MobileServicesHttpClientImp l は、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
recommendation-more-help
2eeeb575-8007-40cc-a72d-206fbc4ddd4b