コア実装とライフサイクル

この情報は、Android ライブラリを実装し、ライフサイクル指標(起動、アップグレード、セッション、アクションを実行したユーザーなど)を収集する場合に役立ちます。

SDK のダウンロード

重要

SDK をダウンロードするには、Android 2.2 以降を使用する必要があります。

  1. 次の節の手順を実行して開発レポートスイートを設定し、設定ファイルの事前入力済みバージョンをダウンロードします。

  2. [Your_App_Name_]AdobeMobileLibrary-4.*-Android.zip ファイルをダウンロードして展開し、次のソフトウェアコンポーネントが存在することを確認します。

    • adobeMobileLibrary.jar:Android デバイスおよびシミュレーターで使用されるライブラリ。

    • ADBMobileConfig.json:アプリ用にカスタマイズされた SDK 設定ファイル。

    重要

    SDK を Adobe Mobile Services UI 以外でダウンロードした場合は、ADBMobileConfig.json ファイルを手動で設定する必要があります。Analytics と Mobile SDK を使い始めたばかりのユーザーが開発レポートスイートを設定して、事前に構成された設定ファイルをダウンロードする場合は、「事前準備」を参照してください。

IntelliJ IDEA または Eclipse プロジェクトへの SDK と設定ファイルの追加

IntelliJ IDEA プロジェクト

SDK と設定ファイルをプロジェクトに追加するには、以下のようにします。

  1. ADBMobileConfig.json ファイルをプロジェクトの assets フォルダーに追加します。

  2. プロジェクトナビゲーションパネルで、プロジェクトを右クリックします。

  3. モジュール設定を開く​を選択します。

  4. プロジェクト設定​で、ライブラリ​を選択します。

  5. + アイコンをクリックし、新しいライブラリを追加します。

  6. Java​を選択し、adobeMobileLibrary.jar ファイルに移動します。

  7. モバイルライブラリを使用する予定のモジュールを選択します。

  8. 適用​をクリックしてから​OK​をクリックして、モジュール設定ウィンドウを閉じます。

Eclipse プロジェクト

SDK と設定ファイルをプロジェクトに追加するには、以下のようにします。

  1. ADBMobileConfig.json ファイルをプロジェクトの assets フォルダーに追加します。
  2. Eclipse IDE で、プロジェクト名を右クリックします。
  3. ビルドパス外部アーカイブの追加​をクリックします。
  4. adobeMobileLibrary.jar を選択します。
  5. 開く」をクリックします。
  6. プロジェクトを再度右クリックし、ビルドパスビルドパスを設定​を選択します。
  7. 並べ替えと書き出し」タブで、adobeMobileLibrary.jar が選択されていることを確認します。

アプリの権限の追加

AppMeasurement ライブラリでは、データの送信とオフラインのトラッキングコールの記録のために、次の権限が必要です。

  • INTERNET
  • ACCESS_NETWORK_STATE

これらの権限を追加するには、アプリケーションのプロジェクトディレクトリにある AndroidManifest.xml ファイルに以下の行を追加します。

<uses-permission android:name="android.permission.INTERNET" /> 
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

アプリケーションコンテキストの設定

メインアクティビティの onCreate メソッドで、次のコードを追加する必要があります。

   @Override
   public void onCreate(BundlesavedInstanceState){
     super.onCreate(savedInstanceState)
     setContentView(R.layout.main);
     Config.setContext(this.getApplicationContext());
   }

ライフサイクル指標の実装

ライフサイクルを有効にすると、アプリが起動されるたびに、1 件のヒットが送信されて、起動、アップグレード、セッション、アクションを実行したユーザー、その他の多くの指標が測定されます。詳しくは、「ライフサイクル指標」を参照してください。

アプリケーションの各アクティビティで、次の手順を実行します。

  1. ライブラリをインポートします。

    import com.adobe.mobile.*;
    
  2. onResume 関数で、ライフサイクルデータの収集を開始します。

    @Override 
    public void onResume() { 
        Config.collectLifecycleData(this); 
        // -or- Config.collectLifecycleData(this, contextData); 
    }
    
  3. onPause 関数で、ライフサイクルデータの収集を一時停止します。

    @Override 
    public void onPause() { 
        Config.pauseCollectingLifecycleData(); 
    }
    
重要

正確なクラッシュレポートが生成されるようにするには、これらの呼び出しをすべてのアクティビティに追加する必要があります。詳しくは、「アプリのクラッシュの追跡」を参照してください。

ライフサイクル呼び出しで追加のデータを含める

追加のデータをライフサイクル指標呼び出しで含めるには、コンテキストデータを含む追加のパラメーターを collectLifecycleData に渡します。

@Override 
public void onResume() {
    HashMap<String, Object> contextData = new HashMap<String, Object>(); 
    contextData.put("myapp.category", "Game"); 
    Config.collectLifecycleData(this, contextData); 
}

collectLifecycleData で送信される追加のコンテキストデータ値は、Adobe Mobile Services のカスタム変数にマッピングする必要があります。

その他のライフサイクル指標は自動的に収集されます。詳しくは、「ライフサイクル指標」を参照してください。

次の作業

次のタスクを実行します。

このページ