Mobile Platform as a Service:自動ロギング

インストルメンテーションの初期化

次のメソッドを呼び出して、自動ロギングのインストルメンテーションを初期化します。

MPLogger.enableAutoLog();

• Portal & Bundle プロジェクトの場合は、MockLauncherActivityAgent の postInit メソッドでこのメソッドを呼び出します。

• ネイティブ AAR プロジェクトの場合は、mPaaS フレームワークの初期化メソッドの後に、Application の onCreate メソッドでこのメソッドを呼び出します。

アクティビティの設定

ページビュー (PV) は、onResume から onPause までのアクティビティのライフサイクルで記録されます。アクティビティのクラス名がページ ID として使用されます。

• mPaaS フレームワークの BaseActivity、BaseFragmentActivity、または BaseAppCompatActivity を継承するアクティビティは自動的に記録されます。

• アクティビティが 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);
    }
  }

フラグメントの設定

• 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);