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[l:processingstate] | open = alle offenen canceled = alle stornierten confirmed = alle bestätigten paid = alle ausgezahlten | Alle Transaktionen, welche einen bestimmten Status haben, werden hiermit gefiltert. Mehrfachnennung möglich. | condition[l:processingstate]=canceled,open |
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:
id | Einzigartige ID der Transaktion. |
status | Status der Transaktion. |
timestamp | Zeitpunkt der Transaktion. |
campaign_id | Kampagne, welcher der Transaktion zugeordnet wurde. |
attribution | Betrag der gezahlten Attribution. |
delivered_tagcode_count | Anzahl der ausgeführten Tags. |
delivered_tagcode_serversided_url | Übermittelter Serversided Trackingcall. |
ordertoken | Vom Advertiser übermittelte Bestellnummer. |
source | Quelle der Transaktion. |
project_id | Projekt ID, welche die Transaktion zugeordnet wurde. |
admedia_id | Werbemittel-ID über die die Transaktion erzeugt wurde. |
type | Der Typ der Transaktion wie zum Beispiel Sale oder View. |
commission | Provision, welche dem Publisher zugeordnet wurde. |
commission_group_id | Provisionsgruppe, in der sich der Publisher befand, als Transaktion erzeugt wurde. |
trigger_id | Trigger ID, welche der Transaktion zugeordnet wird. |
description | Beschreibung, welche bei der Transaktion übermittelt wurde. |
trigger_value | Die Vergütung, welche in der entsprechenden Trigger ID zum Zeitpunkt der Transaktion hinterlegt war. |
trigger_type | Art des Triggers (Fixvergütung, prozentuale Vergütung). |
turnover | Provisionsrelevanter Bestellwert |
original_turnover | Bestellwert in der Advertiser-Währung |
action_id | Action ID, welche bei der Transaktion übermittelt wurde. |
salary_id | ID des Auszahlungsvorgangs, in welchem die Transaktion abgerechnet wurde |
session_id | Session ID, welche bei der Transaktion übermittel wurde. |
order_currency | Währung der Bestellung. |
status_change_date | Bei Validierung der Transaktion wird dieser Wert an das entsprechende Datum angepasst. |
cancel_reason | Wenn die Transaktions storniert wurde, wird hier der Stornogrund hinterlegt. |
source_turnover | Vom Advertiser übermittelter Bestellwert. |
last_change | Timestamp der letzten Transaktionsänderung. |
user_agent | Clientinformation des Nutzers, welcher die Transaktion erzeugt hat. |
order_actions_id | Interner Verweis auf den provisionsrelevaten Klick / Postview. |
bonus_id | Die ID eines Bonus-Laufes. |
customer_journey_status | Interne Kennziffer. |
ebestid | Gehashte Bestellnummer zur Anzeige für den Publisher. |
order_timestamp | Timestamp des Orderaufrufs. |
action_timestamp | Timestamp der Action, welche zur Order führte. |
trigger_title | Name des Trägers. |
payoutdate | Auszahlungsdatum. |
commission_group_title | Titel der Provisionsgruppe. |
project_title | Name des Projekts, welchem die Transaktion zugeschrieben wurde. |
campaign_title | Name der Kampagne, die der Transaktion zugeordnet wird. |
advertiser_id | Die ID des Advertisers, welchem die Transaktion zugeordnet wird. |
publisher_id | Die ID des Publishers, welchem die Transaktion zu |
referrer | Die Seite au der der Klick erzeugt wurde, der später zur Transaktion geführt hat. |
country | Land in der die Transaktion erzeugt wurde. |
subid | Subid, welche bei der Transaktion übermittel wurde. |
publisher_prename | Vorname des Publishers. Wird anhand der Publisher ID aus dem System gezogen. |
publisher_surname | Nachname des Publishers. Wird anhand der Publisher ID aus dem System gezogen. |
publisher_searchtitle | Suchtitel des Publihsers. Wird anhand der Publisher ID aus dem System gezogen. |
basket_items | Anzahl der Artikel im Warenkorb. |
sub_status | Advertiser-Interner Status zur Verwaltung der Transaktion. |
visibility | Sichtbarkeit für den Publisher. |