API des clics quotidiens (v2)

Obtenez le nombre de clics par jour (YYYY-MM-DD) sur une période définie.

Analysez l’évolution quotidienne du trafic pour un lien, un groupe ou l’ensemble du compte.
Utilisez ces données pour mesurer les performances, suivre les tendances et analyser l’acquisition d’utilisateurs.

Cette API est disponible à partir de l’offre Personal.

GET

/api/statistics/v2/clicks-by-date?startYmd={startYmd}&endYmd={endYmd} 


GET /api/statistics/v2/clicks-by-date
     ?startYmd=2025-04-01
     &endYmd=2025-04-30

Request Parameters

startYmd date required
Date de début de la requête (exemple : 2025-04-01)
endYmd date required
Date de fin de la requête (ex. : 2025-04-30). La période maximale entre la date de début et la date de fin est d’un mois.
Offre Personal : jusqu’à 7 jours
Offre Premium : jusqu’à 14 jours
linkId string
ID du lien. Si des caractères spéciaux ou Unicode sont inclus, un encodage URL est requis.
Forfait Personnel : linkId et domaine obligatoires, seules les statistiques de clics d’un lien individuel peuvent être récupérées.
Forfaits Premium ou supérieurs : saisie facultative.
domain string
Domaine du lien.
grpIdx integer
Groupe de liens. L’IDX du groupe peut être obtenu en appelant l’API Liste des Groupes ou en le consultant dans le tableau de bord.
Lorsqu’il est spécifié, le total des clics de tous les liens du groupe est renvoyé. Disponible uniquement avec les forfaits Premium ou supérieurs. 
{
    "code": 0,
    "message": "",
    "result": [
        {
            "ymd": "2025-04-01",
            "acesCnt": 384,
            "pernCnt": 295
        },
        {
            "ymd": "2025-04-02",
            "acesCnt": 1785,
            "pernCnt": 1720
        },
        {
            "ymd": "2025-04-03",
            "acesCnt": 19542,
            "pernCnt": 19083
        },
        {
            "ymd": "2025-04-04",
            "acesCnt": 3596,
            "pernCnt": 3274
        },
        {
            "ymd": "2025-04-05",
            "acesCnt": 171,
            "pernCnt": 164
        }
    ]
}

Response Parameters

codeinteger
Code de réponse : 0 = Succès, toute autre valeur = Erreur
messagestring
Message de réponse. Si le code n’est pas 0, un message d’erreur correspondant est renvoyé.
resultarray
ymddate
Date.
acesCntinteger
Nombre total de clics à la date indiquée.
pernCntinteger
Nombre d’utilisateurs uniques ayant cliqué sur des liens à cette date.

Quand utiliser cette API

Utilisez cette API pour comprendre l’évolution quotidienne des clics dans le temps.

Elle permet de comparer le trafic avant et après une campagne, d’analyser les tendances hebdomadaires et d’évaluer l’impact d’événements.

Il ne s’agit pas seulement de comptage, mais d’un outil d’analyse des tendances dans le temps.

Différence avec l’API des clics par heure

L’API des clics par heure regroupe les données par heure (0–23), tandis que cette API les regroupe par jour.

Utilisez l’API horaire pour analyser le comportement sur une journée et l’API quotidienne pour observer des tendances sur plusieurs jours ou semaines.

Définition du périmètre de requête

Le périmètre de la requête peut être défini de trois façons.

Envoyez linkId et domain pour obtenir les clics quotidiens d’un lien spécifique.
Envoyez grpIdx pour obtenir les clics agrégés de tous les liens d’un groupe.
Sans paramètre, les données quotidiennes de l’ensemble du compte sont retournées.

Fonctionnalités clés et indicateurs d’analyse

Cette API fournit des données agrégées par jour.

Clics quotidiens (accsCnt)

  • Nombre total de clics par date
  • Identification des hausses ou baisses de trafic

Utilisateurs uniques (pernCnt)

  • Nombre d’utilisateurs uniques par date
  • Analyse du comportement des utilisateurs par rapport aux clics

Ces indicateurs permettent de comprendre les tendances de croissance, les performances des campagnes et les comportements de clics répétés.

Cas d’utilisation

  • Mesure des campagnes : Définissez la période avec startYmd et endYmd pour analyser les tendances quotidiennes
  • Analyse hebdomadaire : Identifiez les jours avec le plus de trafic
  • Comparaison d’événements : Comparez le trafic avant et après un événement
  • Détection d’anomalies : Analysez les pics de clics à des dates spécifiques

Points à considérer

  • La plage de dates maximale dépend de l’offre. Toute requête dépassant cette limite renverra une erreur.
  • Les données quotidiennes n’incluent pas de détail horaire.
  • Si linkId contient des caractères spéciaux ou Unicode, appliquez un URL encoding.
  • Avec l’offre Personal, linkId et domain doivent être fournis ensemble.