Les événements serveur en bref

​

Quand utiliser les événements serveur

​

Le fonctionnement de l’attribution côté serveur

Un visiteur scanne le QR Code
    ↓
Il arrive sur yoursite.com/?scnv=7ad26d4f-...
    ↓
Le SDK enregistre scan_session_id dans localStorage
    ↓
Le visiteur remplit un formulaire d'achat
    ↓
Le navigateur envoie scan_session_id à votre API de paiement
    ↓
Votre serveur envoie un événement purchase avec ce scan_session_id
    ↓
Scanova attribue l'achat au scan du QR Code

• Le placer dans un champ de formulaire masqué
• L’envoyer dans le corps de la requête API depuis le JavaScript de votre frontend
• Le conserver dans la session du visiteur sur votre serveur (en le lisant dans le paramètre d’URL au chargement de la page)

// Read from SDK (browser-side)
// Note: _scnv is the SDK's internal storage key — structure may change.
// Use this pattern only if no higher-level SDK method is available.
const scanSessionId = localStorage.getItem('_scnv')
  ? JSON.parse(localStorage.getItem('_scnv')).sid
  : null;

// Include in your API call to your backend
await fetch('/api/checkout', {
  method: 'POST',
  body: JSON.stringify({ ...orderData, scan_session_id: scanSessionId })
});

​

Prérequis

• Un site de suivi créé dans Analyses → Suivi des conversions
• Une clé d’API limitée au site (générée dans l’onglet Configuration du suivi → Suivre via l’API du site)
• Un serveur capable de faire des requêtes POST HTTPS sortantes
• Un moyen de récupérer le scan_session_id depuis le navigateur du visiteur

​

Exigences de sécurité

• N’exposez jamais votre clé d’API dans le code du frontend ni dans du JavaScript côté client
• Conservez la clé dans une variable d’environnement ou un gestionnaire de secrets
• Renouvelez les clés régulièrement depuis le tableau de bord

​

Étapes suivantes