Aller au contenu
VisualClicks
Intégration et API

Une ligne de code – et tout le reste selon vos besoins

Le code de suivi pèse environ 5 Ko compressé et fonctionne sur tout site web. Pour les événements, la connexion, l'e-commerce et les données côté serveur, vous disposez d'une API JavaScript légère et d'une API serveur.

Code de suivi pour le <head>HTML
<script defer src="https://visualclicks.de/t/fwa.js" data-site="vc_…"></script>
API JavaScript

Événements, propriétés et connexion

Envoyez vos propres événements, comme des recherches, des téléchargements ou des clics, avec fwa.track(), et des informations supplémentaires avec fwa.set() – pour l'événement, la page, la session ou durablement pour l'utilisateur. Après la connexion, fwa.identify() associe la session à votre numéro client.

Chaque nouvelle propriété apparaît automatiquement dans le registre des propriétés et devient alors disponible dans les filtres, les cartes et les segments.

// événement avec propriétés
fwa.track('search', { query: 'tente', results: 12 });

// propriété pour toute la session
fwa.set('customer_type', 'vip', { scope: 'session' });

// associer la connexion, se déconnecter
fwa.identify('cust_4711');
fwa.reset();

// consentement depuis votre bannière cookies
fwa.consent.grant(['analytics', 'recording']);
E-commerce

Le processus d'achat sous forme d'événements

L'API e-commerce reprend la structure de Google Analytics 4 : vue produit, panier, passage en caisse, livraison, paiement, achat et remboursement, chacun avec articles, marque, catégories, prix et quantité.

Si votre boutique dispose déjà d'un modèle de données GA4, la migration ne demande que peu d'efforts.

fwa.ecommerce.viewItem({ item_id: 'ZT-100', item_name: 'Tente de trekking',
  item_brand: 'NordCamp', item_category: 'Tentes', price: 249 });
fwa.ecommerce.addToCart({ item_id: 'ZT-100', price: 249, quantity: 1 });
fwa.ecommerce.beginCheckout(items, { value: 249 });
fwa.ecommerce.purchase(items, { transaction_id: 'A-1001',
  value: 249, tax: 39.76, shipping: 0, currency: 'EUR' });
API serveur

Commandes et crawlers IA directement depuis votre serveur

Avec une clé serveur issue des paramètres, votre backend envoie les événements directement à VisualClicks – indépendamment du navigateur, des bloqueurs de publicité et du consentement. Les commandes sont fusionnées avec les données du navigateur grâce au numéro de commande.

Vous déclarez les requêtes des crawlers IA de la même façon, ou vous importez un journal d'accès au format « combined ».

  • Plusieurs clés par site web, révocables une par une
  • Une clé n'est affichée qu'une seule fois et stockée uniquement sous forme de hash
  • Exclusions d'IP pour le trafic interne
curl -X POST https://visualclicks.de/api/s/v1/events \
  -H "Authorization: Bearer vcsk_…" \
  -H "Content-Type: application/json" \
  -d '{"source":"server","e":[{"t":"ecommerce","n":"purchase",
       "u":"https://shop.example/thank-you",
       "x":{"transaction_id":"A-1001","value":249}}]}'

Asynchrone

Chargé avec defer, ne bloque jamais la page

Applications monopages

Changements de page via l'History API, automatiquement

Sans code

Suivez les clics avec data-fwa-event

Plusieurs sites web

Code et paramètres propres à chaque site web

Questions fréquentes

Où dois-je intégrer le code de suivi ?

Dans le <head> de chaque page – dans la plupart des CMS et des solutions e-commerce, via le thème ou un champ prévu pour les scripts personnalisés. Le code se charge de manière asynchrone et ne bloque pas la page.

Cela fonctionne-t-il avec les applications monopages (React, Vue, Next.js) ?

Oui. Les changements de page via l'History API sont automatiquement enregistrés comme pages vues.

Comment suivre les clics sur des boutons sans coder ?

Avec l'attribut data-fwa-event sur l'élément, par exemple data-fwa-event="newsletter_click". Ajoutez des propriétés supplémentaires avec data-fwa-prop-….

À quoi sert une clé serveur ?

Elle permet à votre serveur d'envoyer directement des événements : commandes, remboursements ou requêtes des crawlers IA. Les clés serveur n'ont jamais leur place dans le code source de votre site web et peuvent être révoquées une par une.

Prêt pour la première ligne de code ?

Demandez votre accès. Ensuite, une seule ligne de code de suivi suffit – les premières visites s'affichent en temps réel.