Aller au contenu principal
Zenovaydocs
3 min de lecture

Essayer en direct

Cette page construit la requête exacte que le tracker Zenovay envoie lorsqu'il enregistre un événement, afin que vous puissiez la lire champ par champ avant de l'intégrer à votre propre site. Modifiez le nom de l'événement pour voir la charge utile se mettre à jour, puis envoyez-la pour voir la réponse.

Sans cookie par défaut. Les identifiants de visiteur et de session ci-dessous sont générés en mémoire uniquement pour cette page. Rien n'est écrit dans un cookie ni dans le stockage local.

Comment fonctionne l'envoi

Le bouton fonctionne selon l'un des deux modes, selon que l'équipe l'a relié à un site bac à sable :

  • Mode simulé (par défaut). Aucune requête ne quitte votre navigateur. Vous obtenez la réponse 200 représentative que l'ingestion renvoie pour un événement personnalisé enregistré, marquée comme simulée. La page reste ainsi honnête sans toucher à aucune donnée analytique réelle.
  • Mode en direct. Lorsqu'un véritable code de suivi bac à sable est configuré, le bouton envoie l'événement à ce seul site et affiche la réponse réelle. Un code inconnu renvoie un 404 propre, donc une valeur mal saisie ne crée jamais de données parasites.

Cette page ne relit pas les données analytiques. Elle montre la requête et la réponse de l'ingestion, rien de plus. Pour voir les événements enregistrés, ouvrez votre propre tableau de bord pour un site qui vous appartient.

Mode en direct

Un code de suivi bac à sable est configuré. Le bouton d'envoi publie un événement réel sur ce seul site et affiche la réponse réelle.

Utilisé comme event_name dans la charge utile ci-dessous. Modifiez-le pour voir la requête se mettre à jour.

Requête

POSThttps://api.zenovay.com/api/events/uZE6xUOdwuEQ

Content-Type: application/json

{
  "event_type": "custom",
  "event_name": "signup_clicked",
  "session_id": "s_0000000000000000",
  "visitor_id": "v_0000000000000000",
  "url": "https://example.com/pricing",
  "referrer": "https://example.com/",
  "device_type": "desktop",
  "browser": "Chrome",
  "os": "macOS",
  "screen_width": 1512,
  "screen_height": 982,
  "language": "en-US",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36"
}

Réponse

Envoyez l'événement pour voir la réponse ici.

La requête, expliquée

Le tracker envoie un POST vers le point de terminaison des événements, avec le code de suivi du site dans le chemin :

POST https://api.zenovay.com/api/events/<votre-code-de-suivi>
Content-Type: application/json

Le corps est du JSON simple. Un événement personnalisé nécessite event_type, event_name, un session_id d'au moins 8 caractères, l'url de la page et les champs client de base (device_type, browser, os, user_agent). Le reste est du contexte facultatif. Le même point de terminaison accepte aussi /api/track/<code> et le chemin court /e/<code>.

Un événement enregistré revient ainsi :

{
  "success": true,
  "data": {
    "type": "event_recorded",
    "event_type": "custom",
    "event_name": "signup_clicked"
  },
  "timestamp": "2026-06-20T00:00:00.000Z"
}

Étapes suivantes

Cette page vous a-t-elle été utile ?