Tous les produits
Search
Centre de documentation

Simple Log Service:SDK JavaScript WebTracking pour les mini-programmes

Dernière mise à jour :Aug 18, 2026

Le SDK JavaScript WebTransfer permet de transférer directement les journaux utilisateur depuis les clients de mini-programmes vers un Logstore, sans passer par vos serveurs d'application. Utilisez ce SDK pour collecter et analyser le comportement des utilisateurs (utilisation de l'application, historique de navigation, événements d'achat) avec une charge serveur minimale.

Prérequis

  • Activez la fonctionnalité WebTracking pour le Logstore. Pour plus d'informations, consultez la rubrique Utilisation de WebTracking pour collecter les journaux frontaux.

  • Ajoutez le domaine WebTracking à la liste des domaines de requête autorisés dans votre console de gestion des mini-programmes. Les plateformes de mini-programmes exigent cette liste d'autorisation pour garantir la sécurité des données. Le format du domaine est https://${project}.${host}, où project et host correspondent aux valeurs configurées dans le SDK.

Limites

  • Chaque envoi de journal est limité à 10 Mo.

  • Plateformes prises en charge : WeChat Mini Program, WeChat Mini Game, Alipay Mini Program, ByteDance Mini Program, DingTalk Mini Program, QQ Mini Program, QQ Mini Game et Baidu Mini Program.

Étape 1 : Installer et configurer le SDK

  1. Installez Node.js.

  2. Exécutez la commande suivante pour installer la dépendance du SDK :

    npm install --save @aliyun-sls/web-track-mini
  3. Ajoutez le code suivant pour configurer le SDK :

    Important

    Pour les quick apps, ajoutez des options de configuration supplémentaires pour le module de requête avant de créer l'objet SlsTracker. L'exemple suivant utilise le module 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.

    Paramètre

    Obligatoire

    Description

    host

    Oui

    L'endpoint Simple Log Service pour votre région. Exemple : cn-hangzhou.log.aliyuncs.com. Pour connaître les endpoints des autres régions, consultez la rubrique Endpoints.

    project

    Oui

    Nom du projet.

    logstore

    Oui

    Nom du Logstore.

    time

    Non

    Intervalle d'envoi des journaux, en secondes. La valeur par défaut est 10.

    count

    Non

    Nombre de journaux à envoyer par lot. La valeur par défaut est 10.

    topic

    Non

    Sujet du journal. Spécifiez un sujet personnalisé pour identifier les journaux.

    source

    Non

    Source du journal. Spécifiez une source personnalisée pour identifier les journaux.

    tags

    Non

    Tags du journal. Spécifiez des tags personnalisés pour identifier les journaux.

Étape 2 : Envoyer les journaux

Transmettez un seul journal sous forme d'Object ou plusieurs journaux sous forme de Array d'Object. Le SDK propose les méthodes d'envoi suivantes :

  • Envoyez un seul journal sous forme d'Object :

    tracker.send({
      eventType:'view_product',
      productName: 'Tablet',
      price: 500
    })
  • Envoyez immédiatement un seul journal, en ignorant les paramètres time et count. Le type est Object :

    tracker.sendImmediate({
      eventType:'view_product',
      productName: 'Tablet',
      price: 500
    })
  • Envoyez plusieurs journaux par lot sous forme d'Array :

    tracker.sendBatchLogs([
      {
        eventType: 'view_product',
        productName: 'Tablet',
        price: 500
      },
      {
        eventType: 'view_product',
        productName: 'Laptop',
        price: 1200
      }
    ])
  • Envoyez immédiatement plusieurs journaux, en ignorant les paramètres time et count. Le type est Array :

    tracker.sendBatchLogsImmediate([
      {
        eventType:'view_product',
        productName: 'Tablet',
        price: 500
      },
      {
        eventType:'view_product',
        productName: 'Laptop',
        price: 1200
      }
    ])

Étape 3 : Consulter les résultats de l'envoi

Une fois les journaux envoyés vers le Logstore, créez des index avant de les interroger et de les analyser.

Aperçu rapide

Pour prévisualiser les journaux sans index, accédez à la page Search & Analysis de votre Logstore et cliquez sur Preview.

Interroger et analyser les journaux

  1. Appelez l'opération Create-Index pour créer un index plein texte ou un index de champ. Pour utiliser des instructions SQL lors des requêtes, créez un index de champ.

  2. Appelez l'opération GetLogs pour interroger les données de journal. La réponse contient un tableau de journaux où chaque élément représente une entrée de journal unique.

Références