API für Klicks nach Gruppen (v2)

Rufen Sie die Klickzahlen pro Linkgruppe für ein bestimmtes Datum ab.

Die API summiert die Klicks aller Links innerhalb jeder Gruppe und gibt sie als Liste zurück.
So können Sie mehrere Gruppen gleichzeitig vergleichen und die Kampagnenleistung auf einen Blick bewerten.

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

GET

/api/link/v2/clicks-by-group?startYmd={startYmd}&endYmd={endYmd}&grpIdxList={grpIdxList}&pages={pages} 


GET /api/link/v2/clicks-by-group
     ?startYmd=2025-08-01
     &endYmd=2025-08-31
     &grpIdxList=151,207,209
     &pages=1

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
grpIdxList string

Liste der Gruppen-IDs, durch Kommas (,) getrennt angeben. Beispiel: 151,207,209

  • Premium-Tarif: Die Gruppen-IDs müssen angegeben werden, maximal 5 Gruppen.
  • Business-Tarif: Wenn weggelassen, werden Klicks aller Gruppen abgerufen. Es können beliebig viele Gruppen angegeben werden.
pages integer required
Default:1
Seitennummer der Ergebnisse.
Standardmäßig werden pro Seite 30 Ergebnisse zurückgegeben. Beispiel: Wenn pages=2, werden ab dem 31. Eintrag 30 Ergebnisse zurückgegeben. 
{
    "code": 0,
    "message": "",
    "result": {
        "extra": {
            "pages": 1,
            "nextPages": 1,
            "nextYn": "N",
            "count": 3,
            "totalCount": 3
        },
        "list": [
            {
                "grpIdx": 151,
                "grpNm": "Electronics",
                "acesCnt": 181,
                "pernCnt": 164
            },
            {
                "grpIdx": 207,
                "grpNm": "Kitchenware",
                "acesCnt": 19847,
                "pernCnt": 18095
            },
            {
                "grpIdx": 209,
                "grpNm": "Brian Smith Advertiser Only",
                "acesCnt": 5730,
                "pernCnt": 5409
            }
        ]
    }
}

Response Parameters

code integer
Antwortcode: 0 = Erfolg, andere Werte = Fehler
message string
Antwortnachricht. Wenn der Code nicht 0 ist, wird eine Fehlermeldung zurückgegeben.
result object
extra object
Informationen zu Seiten und Datensätzen.
pages integer
Aktuelle Seitennummer
nextPages integer
Nächste Seitennummer
nextYn string
Ob eine nächste Seite existiert
count integer
Anzahl der Datensätze auf der aktuellen Seite
totalCount integer
Gesamtanzahl der Datensätze
list array
Klicks nach Gruppe
grpIdx integer
Link-Gruppe (IDX).
grpNm string
Name der Link-Gruppe.
acesCnt integer
Gesamtanzahl der Klicks aller Links in dieser Gruppe.
pernCnt integer
Anzahl der eindeutigen Nutzer, die auf Links in dieser Gruppe geklickt haben.

Wann diese API verwenden

Verwenden Sie diese API, um die Leistung mehrerer Kampagnengruppen für ein bestimmtes Datum zu vergleichen.

Sie aggregiert Klicks und eindeutige Nutzer pro Gruppe in einer Anfrage und eignet sich ideal für Kampagnenvergleiche und Traffic-Analysen.

Sie geht über eine reine Abfrage hinaus und ermöglicht eine vergleichende Leistungsanalyse.

Unterschied zu anderen Klick-APIs

Zeit → „wann“, Datum → „Trend“, Gruppe → „Quelle“
Diese API ist für Leistungsvergleiche optimiert.

Mehrere Gruppen gleichzeitig abfragen

Geben Sie mehrere Gruppen-IDXs in grpIdxList durch Kommas (,) getrennt an, um sie in einer Anfrage abzurufen.
Beispiel: 151,207,209. Bis zu 30 Gruppen pro Anfrage; für weitere verwenden Sie den Parameter pages.

Ob grpIdxList optional ist, hängt vom Tarif ab.
Im Premium-Tarif ist die Angabe verpflichtend und auf 5 Gruppen begrenzt.
Im Business-Tarif werden bei Auslassung alle Gruppen ohne Limit zurückgegeben.

Anwendungsfälle

  • Kampagnenvergleich: Mehrere Gruppen in einer Anfrage vergleichen
  • Monatliche Analyse: Klicks pro Gruppe über einen Zeitraum auswerten
  • Ereignisanalyse: (Business+) alle Gruppen abrufen und Rankings erstellen
  • Dashboards: Paging verwenden, um vollständige Daten zu sammeln

Wichtige Hinweise

  • Bei einer großen Anzahl von Gruppen ist eine Paginierung erforderlich.
  • Die Antwortzeit kann bei großen Datenmengen länger werden.
  • Der maximal abfragbare Zeitraum hängt vom Tarif ab. Personal: bis zu 7 Tage, Premium: bis zu 14 Tage.
  • Pro Seite werden maximal 30 Gruppen zurückgegeben. Wenn die Gesamtzahl 30 überschreitet, erhöhen Sie pages, um weitere Ergebnisse abzurufen.