Die Statistik API wird zum Aufruf der Statistikdaten genutzt. Hierfür muss folgender Parameter an den API-Aufruf angehangen werden:
API | Parameter |
---|---|
Statistik | get-statistic_{Statistikart} |
Beispiel: https://www.domain.de/api//ACCESS-TOKEN/publisher/ID/get-statistic_daily.csv
Für die Statistik API gibt es die Möglichkeit, die Statistikart zu bestimmen. Dies wird an den API-Aufruf mit angehangen. Eingeleitet wird dies durch “/get-statistic_” gefolgt von dem entsprechenden Parameter. Welche Arten es gibt, wird in folgender Tabelle zusammengefasst:
Statistik - Art | Parameter |
---|---|
Statistik nach Tag | get-statistic_daily |
Kampagnen Statistik | get-statistic_campaign |
Statistic nach Project | get-statistic_project |
Statistik nach Subid | get-statistic_subid |
Statistik nach Trigger | get-statistic_trigger |
Statistik nach Referrer | get-statistic_referrer |
Statistik nach Werbemittel | get-statistic_media |
Statistik nach Transaktionen | get-statistic_transactions |
Statistik nach Baskets | get-orders_baskets |
Filterungen
Die API-Schnittstelle bietet mehrere Filtermöglichkeiten, welche hinter der Statistik mit dem “?” - Operator angehangen werden.
Parameter | Wert | Beschreibung | Beispiel |
---|---|---|---|
condition[period][from] | Startdatum | Definierung des Startdatums | condition[period][from]=19.12.1909 |
condition[period][to] | Enddatum | Definierung des Enddatums | condition[period][to]=19.12.1909 |
condition[dynamicdate] | |||
Aktueller Monat | Alle Daten des aktuellen Monats | condition[dynamicdate]=currentmonth | |
Vorheriger Monat | Alle Daten des vorherigen Monats | condition[dynamicdate]=lastmonth | |
Aktuelle Woche | Alle Daten der aktuellen Woche | condition[dynamicdate]=currentweek | |
Letzten [Tage] | Es kann hier jeder beliebiger Wert für das '[Tage]' eingetragen werden (z. B. 10 für die letzen 10 Tagen) | condition[dynamicdate]=last10d | |
condition[project_id] | Projekt ID | Definition der Projekte, nach denen gefiltert werden soll | condition[project_id]=12345 |
condition[bruttodata] | True / false | Definiert, ob die Zahlen als Bruttozahlen heruntergeladen werden sollen. Dies betrifft vor allem die Klicks und Views der Werbemittel. | condition[bruttodaten]=true |
condition[ignormandant] | True / false | Definiert, ob die entsprechenden Daten nur für eine Kampagne heruntergeladen werden sollen oder nicht. | condition[ignoremandant]=true |
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. |
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. |