API für stündliche Klickstatistiken (v3)

Rufen Sie die Klickzahlen pro Stunde (00:00–23:59) für einen bestimmten Zeitraum ab.

Analysieren Sie die stündliche Traffic-Verteilung für einzelne Links, Gruppen oder das gesamte Konto.
Nutzen Sie dies zur Auswertung von Kampagnen, zur Identifikation von Spitzenzeiten und zur Analyse des Nutzerverhaltens.

Diese API ist im Personal-Tarif und höher verfügbar.

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
Startdatum der Abfrage (z. B. 2025-12-01)
endYmd date required
Enddatum der Abfrage (z. B. 2025-12-31). Der maximale Zeitraum zwischen Start- und Enddatum beträgt 1 Monat.
Personal-Tarif: bis zu 7 Tage
Premium-Tarif: bis zu 14 Tage
linkId string
Link-ID. Wenn Sonderzeichen oder Unicode enthalten sind, ist URL-Encoding erforderlich.
Personal-Tarif: linkId und Domain erforderlich, es können nur Klicks einzelner Links abgefragt werden.
Premium-Tarife oder höher: optionale Eingabe.
domain string
Link-Domain.
grpIdx integer
Link-Gruppe. Die Gruppen-IDX kann über den Gruppenlisten-API abgerufen oder im Dashboard eingesehen werden.
Wenn angegeben, wird die Gesamtsumme der Klicks aller Links in dieser Gruppe zurückgegeben. Nur in Premium-Tarifen oder höher verfügbar. 
{
    "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
Antwortcode: 0 = Erfolgreich, jeder andere Wert = Fehler
messagestring
Antwortnachricht. Wenn der Antwortcode ungleich 0 ist, wird eine Fehlermeldung zurückgegeben.
resultarray
ymddate
Datum.
hourinteger
Stunde (0–23).
acesCntinteger
Gesamtanzahl der Klicks im angegebenen Zeitraum.
pernCntinteger
Anzahl der eindeutigen Nutzer, die in diesem Zeitraum auf Links geklickt haben.

Wann diese API verwenden

Verwenden Sie diese API, um zu erkennen, zu welchen Tageszeiten die meisten Klicks erfolgen.

Sie unterstützt die Optimierung von Kampagnenzeiten, die Planung von Anzeigen und die Analyse des Nutzerverhaltens.

Sie können einzelne Links oder aggregierte Gruppendaten analysieren.
Sie ermöglicht mehr als reine Statistik und dient der zeitbasierten Verhaltensanalyse.

Festlegung des Abfragebereichs

Der Abfragebereich kann auf drei Arten festgelegt werden.

Geben Sie linkId und domain an, um Klicks für einen bestimmten Link abzurufen.
Geben Sie grpIdx an, um aggregierte Klicks aller Links einer Gruppe zu erhalten.
Ohne Angabe werden die Daten für das gesamte Konto zurückgegeben.

Zentrale Funktionen und Analysemetriken

Diese API liefert zeitbasierte Analysedaten und nicht nur einfache Klickzahlen.

Klicks pro Stunde (accsCnt)

  • Gesamtzahl der Klicks pro Stunde
  • Erkennung von Spitzenzeiten im Traffic

Nutzeranzahl (pernCnt)

  • Anzahl eindeutiger Nutzer pro Stunde
  • Analyse des Verhältnisses zwischen Klicks und Nutzern

Der Vergleich ermöglicht die Erkennung von Mehrfachklicks und die Analyse des Nutzerverhaltens.

Anwendungsfälle

  • Kampagnenoptimierung: Versand auf Zeiten mit hoher Klickrate konzentrieren
  • Anzeigenplanung: Zeitfenster basierend auf accsCnt optimieren
  • Nutzeranalyse: Spitzenzeiten neuer Nutzer mit pernCnt erkennen
  • Gruppenanalyse: Performance nach Stunden mit grpIdx auswerten

Wichtige Hinweise

  • startYmd und endYmd sind Pflichtparameter und müssen im Format yyyy-MM-dd angegeben werden.
  • Der maximal abfragbare Zeitraum hängt vom Tarif ab. Wird der Grenzwert überschritten, wird ein Fehler zurückgegeben.
  • Wenn linkId Sonderzeichen oder Unicode enthält, wenden Sie URL-Encoding an.
  • Klickzahlen und Nutzerzahlen können voneinander abweichen.