As configurações de chave controlam dinamicamente o envio de logs ao transmitir valores do servidor que alteram as condições de acionamento do envio automático.
O Mobile Analysis Service (MAS) depende do SDK cliente para marcação a fim de coletar dados de comportamento do usuário e desempenho do aplicativo. O SDK gera logs com esses dados e os envia ao servidor, onde processos de computação em tempo real ou offline os transformam em métricas e painéis.
O mPaaS cobra pelo tráfego gerado pelos logs de marcação enviados. Para evitar custos desnecessários, gerencie o envio de logs por meio das configurações de chave. Para obter mais informações sobre as cobranças de tráfego para envio de logs, consulte Pós-pago.
As seções a seguir descrevem como adicionar e gerenciar configurações de marcação.
Adicionar uma configuração de marcação
Faça login no console do mPaaS. No painel de navegação à esquerda, escolha Mobile Analysis Service > Log management > Configure upload switch. No canto superior esquerdo, clique em Tagging Configuration para abrir a página da lista de chaves de log.
-
Clique em New Business e configure as informações de marcação.
-
Business Code: Para tags de comportamento personalizado, a configuração do código de negócio varia conforme a plataforma.
Android: O
bizTypedefinido pelo cliente usando o métodoMPLogger.event(String logId, String bizType, Map<String, String> params). O bizType não pode conter underscores (_).iOS: O valor padrão é
behavior. O cliente pode personalizá-lo usando o parâmetrobizTypena interfacewriteLogWithActionId. Para mais detalhes, consulte Códigos de negócio Android ou Códigos de negócio iOS.
Business Name: Descrição da operação de marcação. Personalize o nome do negócio conforme necessário.
Log Header: Corresponde ao Field 01 no modelo de log e distingue os diferentes tipos de log. O cabeçalho de log para tags de comportamento personalizado é
D-VM. Para mais informações, consulte Modelo de log.
-
Clique em Add para incluir a configuração de marcação. Para saber mais sobre como modifique a configuração, consulte Modificar uma configuração de marcação abaixo.
Modificar uma configuração de marcação
Após adicionar uma configuração de marcação, ela aparece na lista de chaves de log. Defina a chave de envio de log, ajuste as configurações de rede, modifique tags e exclua a configuração conforme necessário.
Definir a chave de envio de log
Ative ou desative o envio de logs. Com a chave ativada, o sistema envia automaticamente os logs de marcação da operação.
Definir a rede de envio
Escolha enviar logs de marcação em All network environments (como 2G, 3G, 4G e Wi-Fi) ou apenas em ambiente Wi-Fi.
Modificar informações de marcação
Na coluna Actions, clique em Modify para abrir a página de modificação com as seguintes configurações:
Business Code: Código de negócio inserido ao adicionar a configuração de marcação.
Description: Nome do negócio informado durante a criação da configuração de marcação.
Log Header: Cabeçalho de log especificado ao adicionar a configuração de marcação.
Minimum upload level: Cada log possui um nível de importância 1, 2 ou 3. O nível 1 é o mais importante, seguido pelo nível 2 e depois pelo nível 3. Se você definir o nível mínimo de envio como 2, o sistema enviará os logs dos níveis 1 e 2, mas não os do nível 3. O nível padrão para tags de comportamento personalizado é 2. Em aplicativos iOS, modifique o nível de log durante a marcação no lado do cliente. Para mais detalhes, consulte Marcação de comportamento personalizado iOS.
Uploaded logs: Os logs de marcação do cliente são gravados primeiro em um arquivo local. Quando a contagem de logs para esse tipo de código de negócio atinge o limiar especificado, o sistema envia automaticamente os logs ao servidor do Mobile Analysis Service. Consulte Envio automático de logs Android ou Envio automático de logs iOS para mais informações.
Log upload rate: Taxa de envio de logs, calculada por usuário. Trata-se de um valor em por mil. Por exemplo, um valor de 1000 significa que os logs são enviados para todos os usuários.
-
Strategy: Ao marcar a política Upload in background, o momento do envio varia conforme a plataforma.
Android: O envio automático de logs é acionado quando o aplicativo permanece em segundo plano por mais de meia hora.
iOS: O envio automático de logs é acionado imediatamente quando o aplicativo entra em segundo plano. Para mais informações, consulte Envio de logs Android ou Envio de logs iOS.
Inicializar o negócio
Os logs do lado do cliente são enviados automaticamente ao servidor do Mobile Analysis Service quando condições específicas são atendidas. A configuração de marcação padrão determina as condições de acionamento para o envio automático. Após criar um novo aplicativo, utilize o recurso Initialize Business para sincronizar as configurações de marcação padrão com o novo aplicativo.
Para inicializar a configuração de negócio, clique em Initialize Business na página e confirme a ação. Após a inicialização, a lista de configurações de marcação padrão será exibida.
Mesmo sem usar o recurso Initialize Business para sincronizar as configurações de marcação padrão com a lista do novo aplicativo, as configurações padrão ainda entram em vigor. No entanto, elas não aparecerão na lista de configurações de marcação.
Mock
Além de adicionar e modificar configurações de marcação na página do console, configure a marcação diretamente usando JSON. Contudo, não recomendamos essa abordagem pelos seguintes motivos:
O recurso mock serve apenas como uma forma conveniente de configurar a marcação e não oferece funcionalidades adicionais.
Caso configure a mesma tag de negócio tanto pela página do console quanto pelo recurso mock, a configuração mock terá precedência.
Se você não estiver familiarizado com o formato de configuração de marcação, o uso incorreto poderá afetar o comportamento padrão de envio automático de logs.
Adicionar uma configuração mock
Para adicionar uma configuração mock:
Na página Configure Upload Switch, clique em Add Mock Configuration.
-
Preencha as informações de configuração.
Version: Selecione a versão do seu aplicativo.
Platform: Escolha o tipo de aplicativo.
Value: Informações de configuração no formato JSON. Para mais detalhes, consulte a seção Formato de configuração mock abaixo.
Verifique as informações e clique em OK para adicionar a configuração mock.
Formato de configuração mock
O formato da configuração mock é o seguinte:
{
"LogHeader1": {
"BusinessCode1": {
"write": "yes",
"send": [
"wifi"
],
"maxLogCount": 50,
"level": 3,
"uploadRate": 1000,
"event": [
"gotoBackground"
]
},
"BusinessCode2": {
...
},
...
},
"LogHeader2": {
...
},
...
}LogHeader: Corresponde ao cabeçalho de log na configuração de marcação.
BusinessCode: Refere-se ao código de negócio na configuração de marcação.
write: Representa a chave de envio na configuração de marcação. O valor é
"yes"quando a chave está ativada e"no"caso contrário.send: Indica a rede na configuração de marcação. O valor é
["2g", "3g", "4g", "wifi"]para All networks e["wifi"]apenas para Wi-Fi.maxLogCount: Equivale à contagem de envio de log na configuração de marcação.
level: Corresponde ao nível mínimo de envio na configuração de marcação.
uploadRate: Refere-se à taxa de envio de logs na configuração de marcação.
event: Relaciona-se à política na configuração de marcação. O valor é
["gotoBackground"]se a política Report in Background estiver selecionada e[]caso contrário.