Statistik API - Dokumentation

Die Statistik API ermöglicht den Export und die Auswertung aggregierter Leistungsdaten im Rahmen des Partnerprogramm-Systems. Sie stellt unterschiedliche Statistik-Arten bereit, wie z. B. Auswertungen nach Tag, Kampagne, Projekt oder Werbemittel, und unterstützt so bei der Performance-Analyse und Optimierung.

Alle APIs können im User-Interface unter dem Menüpunkt Daten-API verwendet werden.

API-Aufruf

https://www.domain.de/api//ACCESS-TOKEN/advertiser/ID/get-statistic_daily.csv

Wert	Beschreibung
www.domain.de	System-Partnerprogramm
ACCESS-TOKEN	Access Token des Users
ID	User-ID
get-statistic_{Statistik-Art}	Art der Statistik (z.B. Tagesbasiert, etc.)
.csv	Art des Downloads

Statistik-API Filterung

Für die Statistik API können verschiedene Parameter als Filter verwendet werden.
Nachfolgend eine Übersicht aller verfügbaren Parameter:

Statistik-Art	Parameter
Statistik nach Tag	`get-statistic_daily`
Statistik nach Advertiser	`get-statistic_advertiser`
Statistik nach Kampagnen	`get-statistic_campaign`
Statistik nach Werbemittel	`get-statistic_media`
Statistik nach Publisher	`get-statistic_publisher`
Statistik nach Projekt	`get-statistic_project`
Statistik nach SubID	`get-statistic_subid`
Statistik nach Referrer	`get-statistic_referrer`
Statistik nach Channel	`get-statistic_channel`
Statistik nach Provisionsgruppe	`get-statistic_provisionsgroup`
Statistik nach Trigger	`get-statistic_trigger`
Statistik nach Journey	`get-statistic_journey`
Statistik nach A/B-Test	`get-statistic_abtest`
Statistik nach Gerätetyp	`get-statistic_devicetype`
Statistik nach Gerät	`get-statistic_device`
Statistik nach Browser	`get-statistic_browser`
Statistik nach Betriebssystem	`get-statistic_os`
Statistik nach Land	`get-statistic_geocountry`
Manuelle Statistik	`get-statistic_manualstatistics`

Parameter	Wert / Beispiel	Beschreibung
`condition[period][from]`	`01.01.2025`	Startdatum der Statistik
`condition[period][to]`	`31.01.2025`	Enddatum der Statistik
`condition[paymentstatus]`	`all` = alle `0` = nicht ausgezahlt `1` = ausgezahlt	Filtert nach Auszahlungsstatus
`condition[dynamicdate]`	`currentmonth` = aktueller Monat `lastmonth` = vorheriger Monat `currentweek` = aktuelle Woche `last10d` = letzte 10 Tage	Dynamische Zeiträume
`condition[l:publisher]`	`1234,5678`	Filtert nach Publisher-IDs
`condition[project_id]`	`12345`	Filtert nach Projekt-IDs
`condition[bruttodata]`	`true`	Gibt Bruttozahlen zurück (z. B. Klicks/Views)
`condition[l:mandant]`	`1`	Filtert nach Mandanten-IDs
`condition[l:advertiser]`	`2,3`	Filtert nach Advertiser-IDs
`condition[l:campaigns]`	`1,3`	Filtert nach Kampagnen-IDs

Aufschlüsselung nach weiteren Kriterien (Dynamische-Statistik)

Die Statistik kann zusätzlich nach weiteren Kriterien aufgeschlüsselt (segmentiert) werden.
Hierzu wird der Parameter condition[l:criterions] verwendet.

Parameter	Wert	Beschreibung	Beispiel
`condition[l:criterions]`	`day`	Aufschlüsselung nach Tag	`condition[l:criterions]=day`
	`publisher`	Aufschlüsselung nach Publisher	`condition[l:criterions]=publisher`
	`media`	Aufschlüsselung nach Werbemittel	`condition[l:criterions]=media`
	`advertiser`	Aufschlüsselung nach Advertiser	`condition[l:criterions]=advertiser`
	`campaign`	Aufschlüsselung nach Kampagnenname	`condition[l:criterions]=campaign`
	`campaign_id`	Aufschlüsselung nach Kampagnen-ID	`condition[l:criterions]=campaign_id`
Kombination	z. B. `day,publisher,media`	Mehrdimensionale Aufschlüsselung	`condition[l:criterions]=day,publisher,media`

Hinzufügen von KPIs

Über den Parameter condition[l:additional_parameters] können zusätzliche Key Performance Indicators (KPIs) zur Statistik hinzugefügt werden.

Parameter	Wert	Beschreibung	Beispiel
`condition[l:additional_parameters]`	`all`	Fügt alle verfügbaren KPIs hinzu	`condition[l:additional_parameters]=all`

Definition der Felder in der Statistik API

Die Spaltennamen der heruntergeladenen Datei beinhalten folgende Parameter:

Feldname	Beschreibung
`criterion`	Das Kriterium, welches für die Statistik ausgewählt wurde. Wurde beispielsweise die Statistik nach Tag ausgewählt, werden in diesem Feld die betroffenen Tage ausgegeben. Wird Statistik nach Campagne ausgewählt, werden hier die entsprechenden Kampagnen-ID ausgewählt. In der Regel wird hier die ID ausgegeben.
`title`	Der Name der entsprechend ausgewählten Criterion. Hier steht z. B. der Name der Kampagne oder des Projekts.
`leads_open_count`	Anzahl der offenen Leads.
`leads_confirmed_count`	Anzahl der bestätigten Leads.
`leads_canceled_count`	Anzahl der stornierten Leads.
`sales_open_count`	Anzahl der offenen Sales.
`sales_confirmed_count`	Anzahl der bestätigten Sales.
`sales_canceled_count`	Anzahl der stornierten Sales.
`all_open_count`	Anzahl der offenen Leads und Sales addiert.
`all_confirmed_count`	Anzahl der bestätigten Leads und Sales addiert.
`all_canceled_count`	Anzahl der stornierten Leads und Sales addiert.
`leads_open_provision`	Provisionssumme der offenen Leads.
`leads_confirmed_provision`	Provisionssumme der bestätigten Leads.
`leads_canceled_provision`	Provisionssumme der stornierten Leads.
`sales_open_provision`	Provisionssumme der offenen Sales.
`sales_confirmed_provision`	Provisionssumme der bestätigten Sales.
`sales_canceled_provision`	Provisionssumme der stornierten Sales.
`all_open_provision`	Provisionssumme der offenen Leads und Sales addiert.
`all_confirmed_provision`	Provisionssumme der bestätigten Leads und Sales addiert.
`all_canceled_provision`	Provisionssumme der stornierten Leads und Sales addiert.
`views`	Anzahl der Views.
`clicks`	Anzahl der Klicks.
`epc`	Die berechnete, durchschnittliche Einnahme pro Klick.
`ctr`	Der Wert gibt an, wie viele User tatsächlich auf das Werbemittel klickten, nachdem sie es gesehen haben.
`leads_canceled_turnover`	Gesamter Warenkorbwert der stornierten Leads.
`leads_open_turnover`	Gesamter Warenkorbwert der offenen Leads.
`leads_confirmed_turnover`	Gesamter Warenkorbwert der bestätigten Leads.
`sales_canceled_turnover`	Gesamter Warenkorbwert stornierten Sales.
`sales_open_turnover`	Gesamter Warenkorbwert der offenen Sales.
`sales_confirmed_turnover`	Gesamter Warenkorbwert der bestätigten Sales.