Todos os produtos
Search
Central de documentação

Simple Log Service:WebTracking JavaScript SDK para mini programas

Última atualização: Jul 03, 2026

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 que project e host correspondem 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

  1. Instale o Node.js.

  2. Execute o comando a seguir para instalar a dependência do SDK:

    npm install --save @aliyun-sls/web-track-mini
  3. Adicione o código abaixo para configurar o SDK:

    Importante

    Para 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 time e count. 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 time e count. 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

  1. 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.

  2. 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