Analytiques avancées

Analytiques géographiques, par appareil, par client de messagerie et par heure de la journée avec export de données

MailLand fournit des endpoints d'analytiques avancées pour une compréhension approfondie de l'endroit, du moment et de la manière dont les destinataires interagissent avec vos e-mails. Toutes les données proviennent de ClickHouse et sont mises en cache pendant 5 minutes.

Les ouvertures et les clics incluent l'activité automatisée, le préchargement d'Apple Mail Privacy Protection et les scanners de liens de sécurité, que MailLand ne filtre pas aujourd'hui. Chaque métrique de cette page dérivée des ouvertures ou des clics (géographique, appareil, client de messagerie, heure de la journée) est une limite supérieure de l'engagement humain, et non un décompte précis.

Pour eventType=bounced et eventType=complained, les points de terminaison géographique et appareil excluent les lignes sans country_code ni device_type : les événements de rebond et de plainte ne portant pas ces données, ces deux points de terminaison renvoient normalement un tableau vide pour ces types d'événement. Le point de terminaison par heure de la journée n'a pas ce filtre et renvoie des comptages réels pour tout type d'événement.

Analytiques géographiques

Découvrez où vos destinataires interagissent, répartis par pays et ville :

GET https://api.mail.land/v1/transactional/analytics/advanced/geographic

Get geographic analytics

curl "https://api.mail.land/v1/transactional/analytics/advanced/geographic" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Paramètre	Type	Défaut	Description
`from`	datetime	30 jours avant	Date de début
`to`	datetime	Maintenant	Date de fin
`eventType`	string	`opened`	Événement à analyser : `opened`, `clicked`, `bounced`, `complained`

Geographic analytics response

[
  {
    "countryCode": "US",
    "city": "San Francisco",
    "eventCount": 3420,
    "uniqueUsers": 2850
  },
  {
    "countryCode": "DE",
    "city": "Berlin",
    "eventCount": 1280,
    "uniqueUsers": 1100
  },
  {
    "countryCode": "GB",
    "city": "London",
    "eventCount": 950,
    "uniqueUsers": 820
  }
]

Analytiques par appareil

Découvrez quels appareils et navigateurs vos destinataires utilisent :

GET https://api.mail.land/v1/transactional/analytics/advanced/devices

Get device analytics

curl "https://api.mail.land/v1/transactional/analytics/advanced/devices" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Paramètre	Type	Défaut	Description
`from`	datetime	30 jours avant	Date de début
`to`	datetime	Maintenant	Date de fin
`eventType`	string	`opened`	Événement à analyser : `opened`, `clicked`, `bounced`, `complained`

Device analytics response

[
  {
    "deviceType": "desktop",
    "browser": "Chrome",
    "emailClient": "Gmail",
    "eventCount": 5200,
    "uniqueUsers": 4100
  },
  {
    "deviceType": "mobile",
    "browser": "Safari",
    "emailClient": "Apple Mail",
    "eventCount": 3800,
    "uniqueUsers": 3200
  },
  {
    "deviceType": "desktop",
    "browser": "Firefox",
    "emailClient": "Thunderbird",
    "eventCount": 420,
    "uniqueUsers": 380
  }
]

Heure de la journée

Découvrez quand les destinataires interagissent le plus, répartis par heure et jour de la semaine :

GET https://api.mail.land/v1/transactional/analytics/advanced/time-of-day

Get time of day analytics

curl "https://api.mail.land/v1/transactional/analytics/advanced/time-of-day" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Paramètre	Type	Défaut	Description
`from`	datetime	30 jours avant	Date de début
`to`	datetime	Maintenant	Date de fin
`eventType`	string	`opened`	Événement à analyser : `opened`, `clicked`, `bounced`, `complained`

Time of day response

[
  { "hour": 9, "dayOfWeek": 1, "eventCount": 1240 },
  { "hour": 10, "dayOfWeek": 1, "eventCount": 1580 },
  { "hour": 14, "dayOfWeek": 2, "eventCount": 1120 },
  { "hour": 9, "dayOfWeek": 3, "eventCount": 1350 }
]

Champ	Description
`hour`	Heure de la journée (0–23, UTC)
`dayOfWeek`	Jour de la semaine (0 = dimanche, 6 = samedi)
`eventCount`	Nombre d'événements dans ce créneau horaire

Clients de messagerie

Découvrez quels clients de messagerie vos destinataires utilisent pour les ouvertures et les clics :

GET https://api.mail.land/v1/transactional/analytics/advanced/email-clients

Get email clients

curl "https://api.mail.land/v1/transactional/analytics/advanced/email-clients" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Paramètre	Type	Défaut	Description
`from`	datetime	30 jours avant	Date de début
`to`	datetime	Maintenant	Date de fin

Email clients response

[
  {
    "emailClient": "Gmail",
    "opens": 15200,
    "clicks": 1980,
    "uniqueUsers": 12500
  },
  {
    "emailClient": "Apple Mail",
    "opens": 8400,
    "clicks": 1100,
    "uniqueUsers": 7200
  },
  {
    "emailClient": "Outlook",
    "opens": 6800,
    "clicks": 850,
    "uniqueUsers": 5900
  }
]

Carte de chaleur de l'engagement

Obtenez une carte de chaleur combinée ouvertures + clics par heure et jour de la semaine, idéale pour visualiser les meilleurs moments d'envoi :

GET https://api.mail.land/v1/transactional/analytics/advanced/engagement-heatmap

Get engagement heatmap

curl "https://api.mail.land/v1/transactional/analytics/advanced/engagement-heatmap" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Paramètre	Type	Défaut	Description
`from`	datetime	30 jours avant	Date de début
`to`	datetime	Maintenant	Date de fin

Engagement heatmap response

[
  { "hour": 9, "dayOfWeek": 1, "opens": 1240, "clicks": 160 },
  { "hour": 10, "dayOfWeek": 1, "opens": 1580, "clicks": 205 },
  { "hour": 14, "dayOfWeek": 2, "opens": 1120, "clicks": 145 },
  { "hour": 9, "dayOfWeek": 3, "opens": 1350, "clicks": 175 }
]

Cela fournit 168 points de données (24 heures x 7 jours) lorsque les données sont disponibles pour une semaine complète.

Export de données

Téléchargez les rapports d'analytiques en Excel ou PDF :

Export Excel

GET https://api.mail.land/v1/transactional/analytics/advanced/export/excel

Paramètre	Type	Défaut	Description
`from`	datetime	30 jours avant	Date de début
`to`	datetime	Maintenant	Date de fin

Retourne un fichier .xlsx avec le type de contenu application/vnd.openxmlformats-officedocument.spreadsheetml.sheet. Le nom du fichier suit le format MailLand_Analytics_{from}_{to}.xlsx.

Export PDF

GET https://api.mail.land/v1/transactional/analytics/advanced/export/pdf

Paramètre	Type	Défaut	Description
`from`	datetime	30 jours avant	Date de début
`to`	datetime	Maintenant	Date de fin

Retourne un fichier .pdf avec le type de contenu application/pdf. Le nom du fichier suit le format MailLand_Analytics_{from}_{to}.pdf.

Download Excel report

curl -o analytics.xlsx \
  "https://api.mail.land/v1/transactional/analytics/advanced/export/excel?from=2026-01-01&to=2026-02-01" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Mise en cache

Tous les endpoints d'analytiques avancées sont mis en cache pendant 5 minutes. Les clés de cache incluent l'ID du locataire, la plage de dates et le filtre de type d'événement, de sorte que les requêtes différentes sont mises en cache indépendamment.

Prochaines étapes

Présentation des analytiques : résumés d'événements, taux et statistiques quotidiennes
Journaux d'e-mails : rechercher et inspecter les e-mails individuels
Présentation de la délivrabilité : réputation de l'expéditeur et métriques par fournisseur

Analytiques avancées

Analytiques géographiquesCopier le lien de la section

Analytiques par appareilCopier le lien de la section

Heure de la journéeCopier le lien de la section

Clients de messagerieCopier le lien de la section

Carte de chaleur de l'engagementCopier le lien de la section

Export de donnéesCopier le lien de la section

Export ExcelCopier le lien de la section

Export PDFCopier le lien de la section

Mise en cacheCopier le lien de la section

Prochaines étapesCopier le lien de la section

Sur cette page