O WebTracking JavaScript SDK envia logs de usuários diretamente dos clientes de mini programas para um Logstore, sem passar pelos servidores da aplicação. Use este SDK para coletar e analisar o comportamento do usuário, como uso do aplicativo, histórico de navegação e eventos de compra, com sobrecarga mínima no servidor.
Pré-requisitos
O WebTracking está ativado para o Logstore. Para mais informações, consulte Usar o WebTracking para coletar logs de front-end.
Adicione o domínio do WebTracking à lista de domínios de solicitação permitidos no console de gerenciamento do mini programa. As plataformas de mini programas exigem essa lista de permissões para garantir a segurança dos dados. O formato do domínio é
https://${project}.${host}, em queprojectehostcorrespondem aos valores configurados no SDK.
Limitações
Cada envio de log tem limite de 10 MB.
Plataformas compatíveis: WeChat Mini Program, WeChat Mini Game, Alipay Mini Program, ByteDance Mini Program, DingTalk Mini Program, QQ Mini Program, QQ Mini Game e Baidu Mini Program.
Etapa 1: Instale e configure o SDK
Instale o Node.js.
-
Execute o comando a seguir para instalar a dependência do SDK:
npm install --save @aliyun-sls/web-track-mini -
Adicione o código abaixo para configurar o SDK:
ImportantePara quick apps, adicione opções extras de configuração ao módulo de requisição antes de criar o objeto SlsTracker. O exemplo a seguir usa o módulo
requesttask:// Define the quickappSDK object to encapsulate the request API. const quickappSDK = { request: requesttask.request } const tracker = new SlsTracker({ ...opts, platformSDK: quickappSDK, platformRequestName: 'request', })import SlsTracker from '@aliyun-sls/web-track-mini' const opts = { host: '${host}', // The endpoint of the region. For example, cn-hangzhou.log.aliyuncs.com. project: '${project}', // The name of the project. logstore: '${logstore}', // The name of the Logstore. time: 10, // The interval for sending logs, in seconds. Default: 10. count: 10, // The number of logs to send in each batch. Default: 10. topic: 'topic',// A custom log topic. source: 'source', tags: { tags: 'tags', }, } const tracker = new SlsTracker(opts) // Create an SlsTracker object.Parâmetro
Obrigatório
Descrição
host
Sim
Endpoint do Simple Log Service para sua região. Exemplo:
cn-hangzhou.log.aliyuncs.com. Para endpoints de outras regiões, consulte Endpoints.project
Sim
Nome do projeto.
logstore
Sim
Nome do Logstore.
time
Não
Intervalo, em segundos, para envio de logs. O valor padrão é 10.
count
Não
Quantidade de logs enviados em cada lote. O valor padrão é 10.
topic
Não
Tópico do log. Especifique um tópico personalizado para identificar os logs.
source
Não
Origem do log. Especifique uma origem personalizada para identificar os logs.
tags
Não
Tags do log. Especifique tags personalizadas para identificar os logs.
Etapa 2: Enviar logs
Envie um único log como um Object ou vários logs como um Array de Object s. O SDK oferece os seguintes métodos de envio:
-
Envie um único log como um
Object:tracker.send({ eventType:'view_product', productName: 'Tablet', price: 500 }) -
Envie um único log imediatamente, ignorando os parâmetros
timeecount. O tipo éObject:tracker.sendImmediate({ eventType:'view_product', productName: 'Tablet', price: 500 }) -
Envie vários logs em lote como um
Array:tracker.sendBatchLogs([ { eventType: 'view_product', productName: 'Tablet', price: 500 }, { eventType: 'view_product', productName: 'Laptop', price: 1200 } ]) -
Envie vários logs imediatamente, ignorando os parâmetros
timeecount. O tipo éArray:tracker.sendBatchLogsImmediate([ { eventType:'view_product', productName: 'Tablet', price: 500 }, { eventType:'view_product', productName: 'Laptop', price: 1200 } ])
Etapa 3: Visualize resultados do envio
Após enviar os logs para o Logstore, crie índices antes de consultá-los e analisá-los.
Visualização rápida
Para visualizar logs sem índices, acesse a página Search & Analysis do Logstore e clique em Preview.
Consultar e analisar logs
Chame a operação Create-Index para criar um índice de texto completo ou de campo. Crie um índice de campo para usar instruções SQL nas consultas.
Chame a operação GetLogs para consultar dados de log. A resposta contém um array de logs em que cada elemento representa uma única entrada.
Referências
Se uma chamada de API retornar um erro, consulte Códigos de erro da API para solução de problemas.
O Simple Log Service também fornece SDKs da Alibaba Cloud. Para mais detalhes, consulte Simple Log Service no SDK Center - Portal do Desenvolvedor OpenAPI da Alibaba Cloud.
O Simple Log Service oferece uma CLI para configuração automatizada. Para mais detalhes, consulte Interface de Linha de Comando (CLI) do Simple Log Service.