Api

Référence des Événements

Référence complète pour tous les événements et paramètres du Pixel Idlen

Référence des Événements

Documentation complète de tous les événements, paramètres et types de données supportés par le Pixel Idlen.

Types d'Événements

Le Pixel Idlen supporte trois types d'événements principaux :

Type d'Événement	Description	Cas d'Usage
`PageView`	Vue de page ou d'écran	Suivre la navigation et l'engagement
`Conversion`	Accomplissement d'objectif	Suivre les inscriptions, achats, essais
`Custom`	Événement personnalisé	Suivre toute interaction utilisateur

Événement PageView

Suit quand un utilisateur voit une page ou un écran.

Syntaxe

idlen('track', 'PageView');

Données Automatiques

Les données suivantes sont automatiquement capturées :

Champ	Type	Description
`url`	string	Chemin de l'URL actuelle
`referrer`	string	URL de la page précédente
`timestamp`	number	Horodatage de l'événement (Unix ms)
`visitor_id`	string	Identifiant visiteur anonyme

Exemple

// Page view basique
idlen('track', 'PageView');

// Le pixel capture automatiquement :
// {
//   url: '/pricing',
//   referrer: '/features',
//   timestamp: 1706400000000,
//   visitor_id: 'abc123-def456'
// }

Événement Conversion

Suit quand un utilisateur complète une action souhaitée.

Syntaxe

idlen('track', 'Conversion', {
  eventName?: string,
  value?: number
});

Paramètres

Paramètre	Type	Requis	Description
`eventName`	string	Non	Nom de catégorie de conversion
`value`	number	Non	Valeur monétaire (ex : montant d'achat)

Noms d'Événements Standards

Utilisez ces noms standards pour de meilleures analyses :

Nom d'Événement	Description	Exemple de Valeur
`signup`	Inscription utilisateur	-
`trial_start`	Activation d'essai gratuit	Prix mensuel
`purchase`	Achat complété	Total de la commande
`subscription`	Abonnement démarré	Prix mensuel/annuel
`lead`	Soumission de formulaire lead	-
`download`	Téléchargement app/fichier	-
`demo_request`	Demande de démo	-
`contact`	Formulaire de contact	-

Exemples

// Conversion basique
idlen('track', 'Conversion');

// Conversion nommée
idlen('track', 'Conversion', {
  eventName: 'signup'
});

// Conversion avec valeur
idlen('track', 'Conversion', {
  eventName: 'purchase',
  value: 99.99
});

// Essai avec valeur potentielle
idlen('track', 'Conversion', {
  eventName: 'trial_start',
  value: 29  // Prix du plan mensuel
});

Événements Personnalisés

Suivez toute interaction utilisateur personnalisée.

Syntaxe

idlen('track', 'NomEvenementPersonnalise', {
  // Propriétés personnalisées
});

Exemples

// Utilisation de fonctionnalité
idlen('track', 'FeatureUsed', {
  feature: 'export',
  format: 'csv'
});

// Engagement vidéo
idlen('track', 'VideoWatched', {
  videoId: 'intro-video',
  duration: 120,
  completed: true
});

// Recherche effectuée
idlen('track', 'Search', {
  query: 'pricing',
  results: 5
});

// CTA cliqué
idlen('track', 'CTAClicked', {
  location: 'hero',
  variant: 'primary'
});

Options d'Initialisation

Configurez le comportement du pixel à l'initialisation.

Syntaxe

idlen('init', 'ADVERTISER_ID', {
  debug?: boolean,
  autoTrack?: boolean,
  trackHash?: boolean,
  excludeRoutes?: string[]
});

Options

Option	Type	Défaut	Description
`debug`	boolean	`false`	Activer la journalisation console
`autoTrack`	boolean	`true`	Suivi auto des changements d'URL
`trackHash`	boolean	`false`	Suivre les changements de hash
`excludeRoutes`	string	`[]`	Routes à exclure du suivi

Exemples

// Setup production
idlen('init', 'YOUR_ADVERTISER_ID');

// Développement avec debug
idlen('init', 'YOUR_ADVERTISER_ID', {
  debug: true
});

// SPA avec tracking manuel
idlen('init', 'YOUR_ADVERTISER_ID', {
  autoTrack: false
});

// Routing basé sur hash
idlen('init', 'YOUR_ADVERTISER_ID', {
  trackHash: true
});

// Exclure routes admin
idlen('init', 'YOUR_ADVERTISER_ID', {
  excludeRoutes: ['/admin/*', '/internal/*']
});

Schéma de Données

Payload d'Événement

Tous les événements envoient le payload suivant au serveur :

interface EventPayload {
  // Requis
  aid: string;      // Advertiser ID
  vid: string;      // Visitor ID
  et: string;       // Type d'événement (pageview, conversion, custom)
  ts: number;       // Horodatage (Unix ms)
  url: string;      // URL de la page

  // Optionnel
  ref?: string;     // URL référente
  en?: string;      // Nom d'événement (pour conversions)
  ev?: number;      // Valeur d'événement (pour conversions)
  ed?: object;      // Données d'événement (pour custom)
}

Réponse serveur

Le endpoint de tracking retourne une image GIF transparente 1x1 pour une compatibilité maximale avec les ad blockers et protections tracking.

Vie Privée & Collecte de Données

Ce Que Nous Collectons

Donnée	Stockée	Hashée	Objectif
URL de page	Oui	Non	Analytics
Référent	Oui	Non	Attribution
User Agent	Oui	Non	Stats appareil
Adresse IP	Non	Oui	Géo (pays uniquement)
Visitor ID	Oui	Non	Suivi de session

Ce Que Nous Ne Collectons Pas

Informations personnelles (nom, email)
Cookies tiers
Données de suivi cross-site
Données de fingerprinting

Privacy-First : Le Pixel Idlen est conçu pour être conforme RGPD et CCPA par défaut. Aucune bannière de consentement n'est requise pour les analytics de base.

Limites de Débit

Limite	Valeur	Description
Événements par seconde	10	Par visiteur
Taille du payload	4KB	Données d'événement maximum
Propriétés personnalisées	20	Par événement

Les événements dépassant ces limites sont silencieusement ignorés.

Gestion des Erreurs

Le pixel gère les erreurs gracieusement sans affecter votre application :

// Sûr à appeler même si le pixel n'est pas chargé
if (window.idlen) {
  idlen('track', 'Conversion', { eventName: 'signup' });
}

// Ou utilisez l'optional chaining
window.idlen?.('track', 'PageView');

Les événements échoués sont :

Journalisés dans la console (en mode debug)
Silencieusement ignorés (en production)
Jamais réessayés (pour éviter les doublons)

Référence API

Référence API complète pour le SDK Pixel Idlen

Collecte de Données & Vie Privée

Quelles données le Pixel Idlen collecte et comment nous protégeons la vie privée des utilisateurs