Die Transaktions API wird zum Aufruf der Transaktionen genutzt. Hierfür muss folgender Parameter an den API-Aufruf angehangen werden:
API | Parameter |
|---|---|
Transaktionen | get-statistic_transactions |
Beispiel: https://www.domain.de/api//ACCESS-TOKEN/publisher/ID/get-statistic_transactions.csv
Für die Transaktions API gibt es zusätzliche Parameter, die abgefragt werden können. Nachfolgend eine Aufstellung aller Parameter:
Transaktions-API Filter
Parameter | Wert | Beschreibung | Beispiel |
|---|---|---|---|
condition[period][from] | Startdatum | Definition des Startdatums | condition[period][from]=19.12.1909 |
condition[period][to] | Enddatum | Definition des Enddatums | condition[period][to]=19.12.1909 |
condition[dynamicdate] | currentmonth = aktueller Monat | Definition eines dynamischen Zeitraums. | condition[dynamicdate]=currentweek |
condition[l:projects] | Zahlenwert, entsprechend des Projekts | Alle Transaktionen, welche unter der entsprechenden Projekt-ID des Programms hinterlegt sind. Mehrfachnennung möglich. | condition[l:projects]=1234 |
condition[l:campaigns] | Zahlenwert, entsprechend der Kampagne | Alle Transaktionen, welche unter der entsprechenden Kampagne des Programms hinterlegt sind. Mehrfachnennung möglich. | condition[l:campaigns]=1 |
condition[timetype] | 0 = Transaktionsdatum 1 = Validierungsdatumdatum 2 = Auszahlungsdatum | Alle Transaktionen, welche in einem bestimmten Zeitraum erstellt/ generiert/ validiert worden sind. | condition[timetype]=1 |
Nachbuchungen per API abfragen
Es ist auch möglich über die API Nachbuchungen abzufragen. Dies ist folgendermaßen ausführbar:
Parameter | Wert | Beschreibung | Beispiel |
|---|---|---|---|
condition[show_bookingrequests] | boolean, mit dem Wert true oder false. | Zeigt alle Nachbuchungen an, die entsprechend hochgeladen wurden. | condition[show_bookingrequests]=true |
Für Nachbuchungen gibt es folgenden Status:
-5 = ausstehend
Definition der Felder in der Transaktions-API
Die Spaltennamen der heruntergeladenen Transaktionen beinhalten folgende Parameter:
criterion | gehashter Ordertoken |
trackingtime | Zeitpunkt der Transaktion. |
advertiser_id | Advertiser-ID |
campaign_title | Kampagnentitle |
campaign_id | Kampagnen-ID |
project_id | Projekt-ID |
project_title | Projekt-Title |
event | Transaktonstyp – lead, sale, bonus |
payoutdate | Auszahlungsdatum - leer, wenn noch nicht ausgezahlt |
processingdate | Bearbeitungsdatum - leer, wenn noch nicht bearbeitet |
salary_id | interne salary id |
salary | Gutschrifts-ID |
clicktime | Klickzeitpunkt |
subid | sub-id |
referrer | click referrer – default: ://NONE |
admedia_id | Admedia-ID |
status | 0 = offen | 1 = bestätigt | 2 = storniert | 3 = ausgezahlt |
reason_of_cancellation | Stornogrund |
provision | Commission |
turnover | Umsatz |
trigger_id | Trigger_ID |
trigger_title | Trigger Name |
basket_count | falls Basket-Tracking aktiv, Anzahl der Basket-Items der Transaktion, andernfalls 0 |