SDK JavaScript
Le SDK navigateur de 3 Ko : track, identify, page, reset.
Le SDK JavaScript envoie les événements de votre site à STRIKE et identifie vos visiteurs. Il pèse environ 3 Ko, n'a
aucune dépendance et utilise votre clé de tracking publique strk_….
1. Récupérez votre clé de tracking
Dans votre dashboard, ouvrez Engagement → Parcours, puis la section
Installer le tracking. Vous y trouverez votre clé (au format strk_…) et un
snippet prêt à copier, déjà configuré pour votre compte.
La clé de tracking est publique et ne permet que l'écriture : elle peut figurer dans le code de votre site. Elle ne donne accès à aucune donnée de votre compte.
2. Ajoutez le SDK à votre site
Collez ce code avant la balise </body> de chaque page :
<script src="https://strikespace.net/sdk/strike.js"></script>
<script>
strike.init('strk_votre_cle', { host: 'https://strikespace.net' })
</script>
Le SDK pèse environ 3 Ko, n'a aucune dépendance et enregistre automatiquement une vue de page
(page_view) à l'initialisation.
3. Envoyez vos événements clés
// Quand le visiteur laisse ses coordonnées
strike.identify({ email: 'awa@exemple.com', first_name: 'Awa' })
// Quand il réalise une action importante
strike.track('checkout_started', { cart_total: 25000, currency: 'XOF' })
Vos événements apparaissent ensuite dans le constructeur de segments et peuvent déclencher un parcours dans le Journey Builder.
Référence du SDK
Le SDK expose un objet global strike. Les événements sont mis en file d'attente, conservés
dans le localStorage du navigateur et envoyés par lots à POST /api/v1/batch.
strike.init(key, options)
Initialise le SDK. À appeler une fois par page, avant tout autre appel.
| Option | Défaut | Description |
|---|---|---|
host |
— | URL de l'API STRIKE (celle indiquée dans votre snippet). |
flushInterval |
2000 |
Délai en millisecondes avant l'envoi d'un lot d'événements. |
autoPageView |
true |
Envoie un événement page_view à l'initialisation. Passez false pour le désactiver. |
leadId |
— | Identifiant STRIKE du lead, si vous le connaissez déjà (UUID). |
strike.identify(attributes)
Associe le visiteur à un lead. Les clés email, phone_number,
first_name et lead_id sont envoyées comme coordonnées ; toutes les autres
clés sont enregistrées comme traits du lead. L'appel est envoyé immédiatement à
POST /api/v1/identify et retourne une promesse.
strike.identify({
email: 'awa@exemple.com',
phone_number: '+22997000000',
first_name: 'Awa',
plan: 'pro', // → traits.plan
city: 'Cotonou', // → traits.city
})
strike.track(eventName, properties)
Enregistre une action du visiteur. Le nom est libre (lettres, chiffres, espaces et
_ . : -, 128 caractères maximum). Les propriétés sont un objet JSON libre.
strike.track('product_viewed', { product_id: 'robe-wax-42', price: 15000 })
strike.track('checkout_started', { cart: { total: 25000, items: 2 } })
Chaque événement reçoit automatiquement un anonymous_id, un message_id unique,
un horodatage et le contexte de la page (URL et titre).
strike.page(properties)
Envoie un événement page_view avec url, path, title
et referrer, complétés par vos propriétés. Utile pour les applications monopages, à
appeler à chaque changement de route.
strike.reset()
Oublie le visiteur courant (identifiant anonyme et lead mémorisé), par exemple à la déconnexion. Les événements suivants repartent d'un nouvel identifiant anonyme.
strike.flush()
Force l'envoi immédiat de la file d'attente. Le SDK envoie déjà la file automatiquement quand elle
atteint 20 événements, après flushInterval, et quand l'onglet est masqué ou fermé.
En cas d'erreur réseau, de réponse 5xx ou 429, le lot est conservé et renvoyé avec un délai croissant (de 2 à 60 secondes). Les autres erreurs 4xx ne seront jamais acceptées : le lot est alors abandonné pour ne pas bloquer la file.
Applications monopages
Sur une application monopage (React, Vue, Next.js…), désactivez au besoin autoPageView et appelez
strike.page() à chaque changement de route :
// Application monopage : une vue de page à chaque changement de route
router.afterEach(() => strike.page({ section: 'boutique' }))
// Déconnexion : oublier le visiteur courant
strike.reset()
Le SDK s'appuie sur l'API de tracking v1 : consultez-la pour les formats, les limites et la façon dont les visiteurs anonymes sont rattachés à leurs leads.
Une question sur l'intégration ? Écrivez à
contact@strike.app
en indiquant l'endpoint, l'heure et le request_id de la réponse.