Centre d'aide · guide version 1.0
Affichage de tous les sujets d'aide.
Installation
</body>.Si votre politique de sécurité du contenu (CSP) bloque le script, ajoutez Webcounter.ca à script-src et connect-src.
Recettes pour frameworks
WordPress et générateurs de sites : placez l'extrait de code dans le pied de page global ou une zone de code personnalisé approuvée.
React, Vue, Svelte et autres applications monopages : installez l'extrait de code une seule fois. Counter observe la navigation par historique; appelez counter('pageview') seulement lorsqu'une route change sans mise à jour de l'URL.
Cadriciels à rendu serveur : placez l'extrait de code dans la disposition racine partagée afin qu'il apparaisse une seule fois sur chaque page.
Consentement et confidentialité
Le mode d'identité par défaut ne dépose aucun témoin de visiteur. Si vous sélectionnez cookie_on_consent, appelez counter('consent', true) seulement après un consentement affirmatif, et counter('consent', false) lorsqu'il est retiré.
Ne pas suivre (DNT) et Contrôle global de la confidentialité (GPC) sont respectés par défaut. Les adresses IP brutes des visiteurs ne sont pas stockées dans le flux d'événements analytiques.
Qu'est-ce qui compte exactement comme un visiteur, une session, un rebond ou un visiteur de retour?
Qualité du trafic
Utilisez les commandes d'un jour, de 30 jours ou d'un an dans l'onglet Paramètres du site. Le choix est stocké sur le domaine suivi, limité à un seul site, et confirmé sur cette page.
Pour des commandes personnalisées, utilisez counter('ignore', 30), inspectez counter('ignored'), et rétablissez la collecte avec counter('include').
Événements automatiques
Ajoutez data-track-outbound="true" ou data-track-downloads="true" à l'extrait de code. Les téléchargements utilisent une liste d'extensions par défaut prudente, personnalisable avec data-download-extensions="pdf,csv,zip".
La taxonomie émise est outbound_click et file_download. Les charges utiles ne contiennent que l'hôte ou le chemin de destination, ou le chemin ou l'extension du fichier — jamais de chaînes de requête ni de fragments.
Dépannage
data-site de l'extrait de code correspond à l'identifiant du site dans le tableau de bord./c.js et /api/collect.Le point de collecte n'indique pas pourquoi il accepte ou refuse un événement. Consultez les diagnostics de collecte dans le tableau de bord.
API client
Il existe deux types d'identifiants porteurs : une clé API en lecture seule et une clé secrète en lecture-écriture. Transmettez l'une ou l'autre dans l'en-tête Authorization—jamais dans une chaîne de requête. Les réponses utilisent une seule enveloppe stable {ok,data,error}.
Les flux de visiteurs utilisent une pagination par curseur opaque. Conservez le curseur retourné sans le modifier et arrêtez lorsque has_more est faux.
Lisez la documentation complète de l'API · Téléchargez le contrat OpenAPI 3.1 · Vous confiez une clé à un agent automatisé? Commencez par /llms.txt.
Surveillance de disponibilité (bêta)
La surveillance vérifie qu'une URL HTTPS répond; elle ne confirme pas que Counter reçoit des données analytiques. Si le trafic s'arrête, vérifiez d'abord Santé de la collecte. Ajoutez une URL HTTPS enregistrée dans l'onglet Surveillance du site. Deux échecs confirment la panne et deux réussites confirment le rétablissement.
Activez les notifications du navigateur pour chaque appareil dans les paramètres du compte. Les alertes peuvent aussi utiliser le courriel vérifié du propriétaire. Les vérifications partent d'une seule région canadienne, et une panne complète de Webcounter.ca peut retarder les alertes.
Toujours coincé?
Précisez l'identifiant du site, l'heure UTC approximative, le navigateur et l'étape en échec. N'envoyez jamais de mots de passe, de clés API, de codes de récupération ou de données brutes sur les visiteurs.