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ùprojectethostcorrespondent 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
Installez Node.js.
-
Exécutez la commande suivante pour installer la dépendance du SDK :
npm install --save @aliyun-sls/web-track-mini -
Ajoutez le code suivant pour configurer le SDK :
ImportantPour 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
timeetcount. Le type estObject: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
timeetcount. Le type estArray: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
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.
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
Si un appel d'API renvoie une erreur, consultez les rubriques Codes d'erreur des API pour résoudre le problème.
Simple Log Service propose également des SDK Alibaba Cloud. Pour plus de détails, consultez la rubrique Simple Log Service dans le centre SDK - Portail développeur OpenAPI Alibaba Cloud.
Simple Log Service met à disposition une interface de ligne de commande (CLI) pour la configuration automatisée. Pour plus de détails, consultez la rubrique Interface de ligne de commande (CLI) Simple Log Service.