Mobile Platform as a Service:Perguntas frequentes

Problemas comuns e etapas de solução de problemas do Mobile Analysis Service.

• Verifique se o cliente está integrado corretamente

• Os dados não aparecem no console após a integração correta do cliente

• Dados de PV e UV do evento não ficam visíveis após criar um evento no console

• O UV do evento permanece sempre 0 após criar um evento no console

• Nenhum dado é exibido no painel personalizado

• Logs de falha do cliente iOS não são simbolizados no console do Mobile Analysis Service

Verifique se o cliente está integrado corretamente

Visualize os logs locais (Android/iOS) ou consulte os logs no console para confirmar que o cliente foi integrado corretamente.

Os dados não aparecem no console após a integração correta do cliente

O SDK envia logs automaticamente apenas quando condições específicas são atendidas: o número de logs em cache local atinge um limiar ou o aplicativo passa para segundo plano por um determinado período. Durante os testes, acione um envio manual para visualizar os dados imediatamente.

Para obter instruções, consulte Enviar logs do Android manualmente ou Enviar logs do iOS manualmente.

Dados de PV e UV do evento não ficam visíveis após criar um evento no console

Três condições devem ser verdadeiras antes que os dados de PV e UV do evento apareçam:

• O cliente está integrado corretamente. Consulte Verifique se o cliente está integrado corretamente.

• O cliente enviou logs para o servidor de logs. Consulte Os dados não aparecem no console após a integração correta do cliente.

• Você criou o evento no console e um usuário o acionou.

O UV do evento permanece sempre 0 após criar um evento no console

O rastreamento de UV exige um ID de usuário configurado no cliente. Sem esse identificador, o SDK não consegue distinguir usuários únicos, mantendo o UV em 0. Defina um ID de usuário no cliente. Para mais detalhes, consulte ID de usuário.

Nenhum dado é exibido no painel personalizado

Siga estas etapas em ordem:

1. Verifique se a opção de envio de log está ativada. No console do mPaaS, acesse Mobile Analysis Service > Log management > Configure upload switch > Event tracking configuration e confirme se a chave de envio da tag relevante está ligada. Para mais detalhes, consulte Configurar chaves de envio de log.

2. Confirme se os logs chegaram ao servidor. Utilize Log management > Log playback no console para consultar logs históricos.

   • Se os logs aparecerem, significa que foram enviados com sucesso. Para mais detalhes, consulte Consultar logs históricos.

   • Caso nenhum log seja exibido, verifique se o aplicativo os gerou:

     1. Desconecte o dispositivo da rede e acione o evento de log.

     2. Coloque o aplicativo em segundo plano e verifique o diretório de logs locais:

        • iOS: Os logs ficam salvos no diretório sandbox Library > atrack > logs.

        • Android: Os logs ficam salvos em /data/data/[PackageName]/files/mdap ou /sdcard/Android/data/[PackageName]/files/mdap. O caminho depende do campo release_type em assets/channel.config. Para mais detalhes, consulte Visualizar logs locais.

     3. Execute a reprodução de logs novamente para verificar se o SDK enviou o log ao servidor.

        O envio automático ocorre apenas quando a quantidade de logs em cache local de um determinado tipo atinge o limiar definido. Esse valor pode variar conforme o tipo de log. Para forçar um envio durante a depuração, acesse Mobile Analysis Service > Log management > Configure upload switch > Event tracking configuration no console do mPaaS e defina temporariamente Upload quantity como 1. Restaure o valor original após concluir a depuração. Para saber mais sobre os gatilhos de envio, consulte Envio de logs do Android e Envio de logs do iOS.

3. Se a reprodução de logs indicar que eles ainda não estão chegando ao servidor, revise a documentação de Instrumentação do Android ou Instrumentação do iOS para identificar erros na instrumentação. Após corrigir a integração, repita a etapa 2 para confirmar que os logs estão sendo enviados normalmente.

4. Quando os logs chegarem ao servidor, mas o painel continuar sem exibir dados, verifique o formato do log.

   Compare os logs brutos em Log playback com o modelo de log de instrumentação. Se o formato estiver incorreto, atualize-o para corresponder ao modelo do tipo de instrumentação correspondente.

5. Caso tenha concluído todas as etapas anteriores e confirmado que os logs foram enviados com o formato correto, mas o painel ainda não mostre dados, procure pelo número do grupo 145930007362 para entrar no grupo do DingTalk e obter assistência.

Logs de falha do cliente iOS não são simbolizados no console do Mobile Analysis Service

Para simbolizar logs de falha do iOS, envie o arquivo da tabela de símbolos dSYM gerado durante o empacotamento do aplicativo. Sem esse arquivo, os rastreamentos de pilha aparecem como endereços de memória brutos e não podem ser lidos.

Envie o arquivo dSYM na página Mobile Analysis Service > Performance analysis > iOS symbol table management no console do mPaaS. Para mais detalhes, consulte Gerenciamento de tabela de símbolos do iOS.