Mobile Platform as a Service:Registro de logs automatizado

O registro de logs automatizado captura eventos de troca de página para que você visualize visualizações de página (PV) e visitantes únicos (UV) dos recursos e páginas do seu aplicativo.

Inicializar a instrumentação

Chame o método a seguir para inicializar a instrumentação de logs automatizados.

MPLogger.enableAutoLog();

• Em projetos Portal & Bundle, chame este método em postInit da classe MockLauncherActivityAgent.

• Em projetos AAR nativos, chame este método em onCreate da classe Application, após o método de inicialização do framework mPaaS.

Configure uma activity

O sistema registra uma visualização de página (PV) durante o ciclo de vida da activity, entre onResume e onPause. O nome da classe da activity serve como identificador da página.

• Activities que herdam de BaseActivity, BaseFragmentActivity ou BaseAppCompatActivity do framework mPaaS são registradas automaticamente.

• Se sua activity não herdar de uma classe base do mPaaS, adicione o código do listener de ciclo de vida à sua 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);
    }
  }

Configure um fragment

• Herde da classe com.mpaas.mas.adapter.api.BaseFragment fornecida pelo mPaaS.

• Se você usar o Fragment da biblioteca oficial support-v4, faça seu BaseFragment implementar a interface TrackPageConfig e adicione o código do listener de ciclo de vida:

    public class BaseFragment extends Fragment implements TrackPageConfig {
  
    /**
     * The page identity. The class name is typically used.
     * If this is not passed, the page does not appear in the page analysis section of the console.
     */
    @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);
    }
  }

Adicionar parâmetros personalizados

Na baseline 10.1.68.44 ou posterior, use os métodos a seguir para adicionar parâmetros personalizados aos logs automatizados.

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