Mobile Platform as a Service:Configurar instrumentação geral

Configure uma solução unificada de instrumentação H5 para páginas H5 em PC e dispositivos móveis com a biblioteca mtracker.

Sobre esta tarefa

Escolha o tipo de instrumentação conforme seu cenário de negócios. Tipos de instrumentação geral.

Procedimento

1. Importe a versão CDN do mtracker. Isso injeta um objeto Tracker no objeto global window.

   Se os caracteres chineses no arquivo JS baixado aparecerem ilegíveis, ainda será possível usar o arquivo. A ilegibilidade decorre de incompatibilidade de codificação e não afeta a instrumentação.

2. Inicialize a configuração conforme seu cenário.

   • Aplicativo no contêiner mPaaS com o contêiner H5 do mPaaS já integrado.

     Código de exemplo:

     <script>
     window._to = {
       bizScenario: 'alipay',   // Optional. The channel source. Default: empty.
       mtrDebug: true,         // Optional. Default: false.
     };
     </script>

     Parâmetro	Descrição
     bizScenario	Opcional. Origem do canal. Padrão: vazio.
     mtrDebug	Opcional. Ativa o modo de depuração do mtracker para imprimir logs relatados. Padrão: false.

   • Aplicativo sem integração com o contêiner H5 do mPaaS ou páginas executadas em navegador:

     Código de exemplo:

     <script>
     window._to = {
       server: 'https://cn-hangzhou-mas-log.cloud.alipay.com/loggw/webLog.do', // Required. The service endpoint that receives instrumentation data.
       appId: 'xxxxxxxxxx', // Required. The unique identifier of the app.
       workspaceId: 'default', // Required. The environment identifier.
       h5version: '1.0.0',    // Required. The version of the client app or H5 page.
       userId: '1234567890',      // Optional. Default: empty.
       bizScenario: 'alipay',   // Optional. The channel source. Default: empty.
       mtrDebug: true,         // Optional. Default: false.
       extendParams: { test: 111 } // Optional. Global extension parameters. Default: empty. Supported in mtracker 1.2.0 and later.
     };
     </script>

     Parâmetro	Descrição
     server	Endpoint de serviço que recebe dados de instrumentação.
     appId	Identificador exclusivo do aplicativo.
     workspaceId	Identificador do ambiente.
     h5version	Versão do aplicativo cliente ou da página H5.
     userId	Opcional. ID do usuário. Padrão: vazio.
     bizScenario	Opcional. Origem do canal. Padrão: vazio.
     mtrDebug	Opcional. Ativa o modo de depuração do mtracker para imprimir logs relatados. Padrão: false.
     extendParams	Opcional. Parâmetros de extensão globais. Padrão: vazio. Requer mtracker 1.2.0 ou posterior.

3. Inicialize o objeto mtracker.

   Por padrão, o mtracker se autoinicializa após a importação do arquivo JS. Para inicialização manual:

   1. Antes da linha de importação do JS, adicione o código a seguir para desativar a autoinicialização.

      window.notInitTrackerOnStart = true;

   2. Adicione o código de inicialização.

      window.initTracker();

Defina extendParams em window._to para incluir parâmetros de extensão em todos os relatórios subsequentes. Caso uma propriedade no parâmetro ext de uma chamada click ou expo tenha o mesmo nome de um parâmetro de extensão global, o valor no nível do método terá precedência.

Para atualizar extendParams em tempo de execução, execute o código a seguir. O novo objeto substitui todos os valores anteriores.

window.changeTrackerExtendParams({ newValue: 11111 });

Próximos passos

Use a página de análise personalizada no console Mobile Analysis para visualizar dados de instrumentação H5. Analisar instrumentação geral.