Vue d'ensemble des analytiques

MailLand fournit des analytiques en temps réel alimentées par ClickHouse pour une agrégation haute performance sur des millions d'événements. Suivez les livraisons, les ouvertures, les clics, les rebonds et les plaintes avec des plages de dates flexibles et un filtrage par type d'e-mail.

Résumé des événementsCopier le lien de la section

Obtenez des comptages agrégés d'événements pour une période donnée :

GET https://api.mail.land/v1/transactional/analytics/events/summary

curl "https://api.mail.land/v1/transactional/analytics/events/summary?from=2026-01-18&to=2026-02-17" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Paramètres de requêteCopier le lien de la section

{
  "from": "2026-01-18T00:00:00Z",
  "to": "2026-02-17T23:59:59Z",
  "sent": 142500,
  "delivered": 140325,
  "opened": 44878,
  "clicked": 5843,
  "bounced": 1125,
  "complained": 28,
  "source": "clickhouse",
  "data_source": "clickhouse",
  "is_degraded": false,
  "queryTimeMs": 45
}

Statistiques quotidiennesCopier le lien de la section

Obtenez des ventilations d'événements par jour pour la création de graphiques :

GET https://api.mail.land/v1/transactional/analytics/stats/daily

curl "https://api.mail.land/v1/transactional/analytics/stats/daily?from=2026-01-18&to=2026-02-17" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

[
  {
    "date": "2026-02-17T00:00:00Z",
    "sent": 4750,
    "delivered": 4680,
    "opened": 1498,
    "clicked": 195,
    "bounced": 38
  },
  {
    "date": "2026-02-16T00:00:00Z",
    "sent": 4320,
    "delivered": 4260,
    "opened": 1380,
    "clicked": 175,
    "bounced": 32
  }
]

TauxCopier le lien de la section

Obtenez les taux de livraison, d'ouverture et de clic calculés en pourcentages :

GET https://api.mail.land/v1/transactional/analytics/rates

curl "https://api.mail.land/v1/transactional/analytics/rates?from=2026-01-18&to=2026-02-17" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "from": "2026-01-18T00:00:00Z",
  "to": "2026-02-17T23:59:59Z",
  "deliveryRate": 98.47,
  "openRate": 31.49,
  "clickRate": 13.02
}

Calculs des taux :

Les trois requêtes de taux s'exécutent en parallèle pour des performances optimales.

Liens les plus cliquésCopier le lien de la section

Consultez les liens les plus cliqués dans vos e-mails :

GET https://api.mail.land/v1/transactional/analytics/links/top

curl "https://api.mail.land/v1/transactional/analytics/links/top?from=2026-01-18&to=2026-02-17&limit=10" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

[
  {
    "url": "https://your-app.com/orders/track",
    "clicks": 2340,
    "uniqueRecipients": 1890
  },
  {
    "url": "https://your-app.com/dashboard",
    "clicks": 1150,
    "uniqueRecipients": 980
  }
]

Volume horaireCopier le lien de la section

Suivez le volume d'envoi par heure, avec une superposition optionnelle de la ligne de base pour la détection d'anomalies :

GET https://api.mail.land/v1/transactional/analytics/volume/hourly?days=7

curl "https://api.mail.land/v1/transactional/analytics/volume/hourly?days=7" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

[
  {
    "hour": "2026-02-17T14:00:00Z",
    "sent": 520,
    "baseline": 480.5
  },
  {
    "hour": "2026-02-17T13:00:00Z",
    "sent": 495,
    "baseline": 480.5
  }
]

La baseline est le volume moyen historique pour cette heure de la journée, calculé par VolumeAnomalyWorker. Elle vaut null si aucune donnée de référence n'est encore disponible.

Mise en cacheCopier le lien de la section

Les points de terminaison d'analytiques sont mis en cache côté serveur pour minimiser la charge des requêtes :

Le point de terminaison events/summary fusionne les requêtes identiques simultanées par serveur : une seule requête atteint ClickHouse par instance de l'API, et tous les appelants de cette instance reçoivent le même résultat. Les autres points de terminaison de cette page ne fusionnent pas les requêtes ; chacune lit le cache puis interroge.

Sources de donnéesCopier le lien de la section

MailLand utilise ClickHouse comme source de données analytiques principale pour une agrégation rapide sur des milliards d'événements.

Le champ source dans les réponses indique quel magasin de données a servi le résultat. Le champ queryTimeMs aide à surveiller les performances.

RétentionCopier le lien de la section

Les données d'événements analytiques suivent le forfait de l'espace de travail : les journaux sont conservés 30 jours en Free, 90 jours en Pro et 180 jours en Max.

Étapes suivantesCopier le lien de la section

• Journaux d'e-mails : recherchez et inspectez les livraisons d'e-mails individuelles
• Analytiques avancées : analytiques géographiques, par appareil et par heure de la journée
• Vue d'ensemble de la délivrabilité : réputation de l'expéditeur et tendances