API für tägliche Klickstatistiken (v2)

Rufen Sie die täglichen Klickzahlen (YYYY-MM-DD) für einen bestimmten Zeitraum ab.

Analysieren Sie die tägliche Traffic-Entwicklung für einzelne Links, Gruppen oder das gesamte Konto.
Nutzen Sie dies zur Bewertung von Kampagnen, zur Erkennung von Trends und zur Analyse des Nutzerwachstums.

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

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
Startdatum der Abfrage (Beispiel: 2025-04-01)
endYmd date required
Enddatum der Abfrage (z. B. 2025-04-30). 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",
            "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
Antwortcode: 0 = Erfolgreich, jeder andere Wert = Fehler
messagestring
Antwortnachricht. Wenn der Antwortcode ungleich 0 ist, wird eine Fehlermeldung zurückgegeben.
resultarray
ymddate
Datum.
acesCntinteger
Gesamtanzahl der Klicks am angegebenen Datum.
pernCntinteger
Anzahl der eindeutigen Nutzer, die an diesem Datum auf Links geklickt haben.

Wann diese API verwenden

Verwenden Sie diese API, um zu verstehen, wie sich Klicks täglich im Zeitverlauf verändern.

Sie eignet sich für den Vergleich von Traffic vor und nach Kampagnen, die Analyse von Wochentagsmustern und die Bewertung von Ereignissen.

Sie ermöglicht mehr als einfache Zählungen und unterstützt eine Trendanalyse über die Zeit.

Unterschied zur stündlichen Klick-API

Die stündliche Klick-API aggregiert Daten nach Stunden (0–23), während diese API nach Tagen aggregiert.

Verwenden Sie die stündliche API für kurzfristige Analysen innerhalb eines Tages und die tägliche API für Trends über mehrere Tage oder Wochen.

Festlegung des Abfragebereichs

Der Abfragebereich kann auf drei Arten festgelegt werden.

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

Zentrale Funktionen und Analysemetriken

Diese API liefert täglich aggregierte Daten.

Tägliche Klicks (accsCnt)

  • Gesamtzahl der Klicks pro Datum
  • Erkennung von Anstiegen oder Rückgängen im Traffic

Nutzeranzahl (pernCnt)

  • Anzahl eindeutiger Nutzer pro Datum
  • Analyse des Nutzerverhaltens im Verhältnis zu Klicks

Diese Kennzahlen helfen, Wachstumstrends, Kampagnenleistung und wiederholte Klickmuster zu verstehen.

Anwendungsfälle

  • Kampagnenanalyse: Definieren Sie den Zeitraum mit startYmd und endYmd, um tägliche Klicktrends zu analysieren
  • Wochentagsanalyse: Identifizieren Sie durch Wochenabfragen die Tage mit dem höchsten Traffic
  • Ereignisvergleich: Vergleichen Sie den Traffic vor und nach Ereignissen
  • Anomalieerkennung: Untersuchen Sie plötzliche Klickspitzen an bestimmten Tagen

Wichtige Hinweise

  • Der maximal abfragbare Zeitraum hängt vom Tarif ab. Wird der Grenzwert überschritten, wird ein Fehler zurückgegeben.
  • Tägliche Daten enthalten keine stündlichen Details.
  • Wenn linkId Sonderzeichen oder Unicode enthält, wenden Sie URL-Encoding an.
  • Im Personal-Tarif müssen linkId und domain gemeinsam übergeben werden.