自動化ログ - Mobile Platform as a Service - Alibaba Cloud ドキュメントセンター

自動化ログは、ページの切り替えとコントロールのクリックイベントを記録するために使用されます。自動化ログに基づいて、アプリ機能または操作ページのページビュー（PV）とユニーク訪問者（UV）データを分析できます。

イベントトラッキングの初期化

以下のメソッドを呼び出して、自動化ログのトラッキングイベントを初期化します。

  MPLogger.enableAutoLog();

Portal & Bundle プロジェクトの場合は、MockLauncherActivityAgent の postInit() メソッドでこのメソッドを呼び出すことをお勧めします。
Native AAR プロジェクトの場合は、Application の onCreate メソッドでこのメソッドを呼び出すことをお勧めします。また、mPaaS フレームワークの初期化メソッドを呼び出した後である必要があります。

Activity の構成

Activity は、onResume から onPause までのページの PV を記録します。ページ名は Activity クラス名で識別されます。

mPaaS フレームワークの BaseActivity、BaseFragmentActivity、または BaseAppCompatActivity クラスを継承する Activity は自動的に記録されます。

mPaaS フレームワークの基底クラスを継承しない場合は、次のように BaseActivity にライフサイクルモニタリングコードを追加できます。

  public class BaseActivity extends Activity {

  @Override
  protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      MPTracker.onActivityCreate(this);
  }

  @Override
  public void onWindowFocusChanged(boolean hasFocus) {
      super.onWindowFocusChanged(hasFocus);
      MPTracker.onActivityWindowFocusChanged(this, hasFocus);
  }

  @Override
  protected void onResume() {
      super.onResume();
      MPTracker.onActivityResume(this);
  }

  @Override
  protected void onPause() {
      super.onPause();
      MPTracker.onActivityPause(this);
  }

  @Override
  protected void onDestroy() {
      super.onDestroy();
      MPTracker.onActivityDestroy(this);
  }
}

Fragment の構成

mPaaS フレームワークが提供する com.mpaas.mas.adapter.api.BaseFragment を使用する場合は、このクラスを継承するだけです。

公式ライブラリ support-v4 の Fragment を使用する場合は、BaseFragment が TrackPageConfig インターフェイスを実装するように設定し、次のようにライフサイクルモニタリング構成を追加する必要があります。

  public class BaseFragment extends Fragment implements TrackPageConfig {

  /**
   * ページ ID。通常はクラス名です。
   * 渡されない場合、ページ分析データがコンソールに表示されない可能性があります。
   */
  @Override
  public String getPageSpmId() {
      return this.getClass().getName();
  }

  @Override
  public Map<String, String> getExtParam() {
      return null;
  }

  @Override
  public boolean isTrackPage() {
      return true;
  }

  @Override
  public void onResume() {
      super.onResume();
      MPTracker.onFragmentResume(this);
  }

  @Override
  public void onPause() {
      super.onPause();
      MPTracker.onFragmentPause(this);
  }

  @Override
  public void onHiddenChanged(boolean hidden) {
      super.onHiddenChanged(hidden);
      MPTracker.onFragmentHiddenChanged(this, hidden);
  }

  @Override
  public void setUserVisibleHint(boolean isVisibleToUser) {
      super.setUserVisibleHint(isVisibleToUser);
      MPTracker.onFragmentSetUserVisibleHint(this, isVisibleToUser);
  }

  @Override
  public void onDestroy() {
      super.onDestroy();
      MPTracker.onFragmentDestroy(this);
  }
}

カスタムパラメーターの追加

ベースライン 10.1.68.44 以降のバージョンでは、以下のメソッドを使用して自動化ログにカスタムパラメーターを追加することがサポートされています。

MPLogger.addAutoLogCustomParam("test_key1", "test_value1");
MPLogger.addAutoLogCustomParam("test_key2", "test_value2");

Map<String, String> params = new HashMap<>();
params.put("test_key3", "test_value3");
params.put("test_key4", "test_value4");
MPLogger.addAutoLogCustomParams(params);