API des clics par heure (v3)

Obtenez le nombre de clics par heure (00:00–23:59) sur une période définie.

Analysez la répartition du trafic horaire pour un lien, un groupe ou l’ensemble du compte.
Utilisez ces données pour mesurer les performances, identifier les heures clés et comprendre le comportement des utilisateurs.

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

GET

/api/statistics/v3/clicks-by-hour?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 (ex. : 2025-12-01)
endYmd date required
Date de fin de la requête (ex. : 2025-12-31). 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",
            "hour": 0,
            "acesCnt": 24,
            "pernCnt": 17
        },
        {
            "ymd": "2025-04-02",
            "hour": 1,
            "acesCnt": 121,
            "pernCnt": 198
        },
        {
            "ymd": "2025-04-03",
            "hour": 2,
            "acesCnt": 84,
            "pernCnt": 68
        },
        {
            "ymd": "2025-04-04",
            "hour": 3,
            "acesCnt": 21,
            "pernCnt": 15
        },
        {
            "ymd": "2025-04-05",
            "hour": 4,
            "acesCnt": 1950,
            "pernCnt": 1621
        },
        {
            "ymd": "2025-04-10",
            "hour": 5,
            "acesCnt": 7,
            "pernCnt": 7
        }
    ]
}

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.
hourinteger
Heure (0–23).
acesCntinteger
Nombre total de clics pendant la période spécifiée.
pernCntinteger
Nombre d’utilisateurs uniques ayant cliqué sur des liens pendant cette période.

Quand utiliser cette API

Utilisez cette API pour identifier les moments de la journée où les clics sont les plus élevés.

Elle permet d’optimiser les horaires de campagne, de planifier les diffusions publicitaires et d’analyser le comportement des utilisateurs.

Vous pouvez analyser un lien spécifique ou des données agrégées par groupe.
Elle va au-delà de la simple statistique et permet une analyse comportementale basée sur le temps.

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 d’un lien spécifique.
Envoyez grpIdx pour obtenir les clics agrégés d’un groupe.
Sans paramètre, les données de l’ensemble du compte sont retournées.

Fonctionnalités clés et indicateurs d’analyse

Cette API fournit des données analytiques basées sur le temps, au-delà du simple nombre de clics.

Clics par heure (accsCnt)

  • Nombre total de clics pour chaque heure
  • Identification des périodes de trafic élevé

Utilisateurs uniques (pernCnt)

  • Nombre d’utilisateurs uniques par heure
  • Analyse du ratio clics/utilisateurs

La comparaison permet d’identifier les clics répétés et d’analyser les comportements utilisateurs.

Cas d’utilisation

  • Optimisation des campagnes : Se concentrer sur les heures à fort trafic
  • Planification des annonces : Ajuster les horaires selon accsCnt
  • Analyse des utilisateurs : Identifier les pics d’acquisition via pernCnt
  • Analyse par groupe : Évaluer les performances horaires avec grpIdx

Points à considérer

  • startYmd et endYmd sont des paramètres obligatoires et doivent respecter le format yyyy-MM-dd.
  • La plage de dates maximale dépend de l’offre. Toute requête dépassant cette limite renverra une erreur.
  • Si linkId contient des caractères spéciaux ou Unicode, appliquez un URL encoding.
  • Le nombre de clics et d’utilisateurs peut différer.