Publisher:Doku:API

Aus retailerweb.net Dokumentations-WIKI
Wechseln zu: Navigation, Suche

zurück zum Publisher-Manual

 

Inhaltsverzeichnis

Dokumentation der Publisher API


Allgemeine Informationen zur API und mögliche Parameter zur Filterung:

Die Ausgabe der Datei ist in CSV, XLS sowie XML möglich, dafür müssen Sie nur die Datei Endung entsprechend anpassen (im Beispiel ist es .csv)
Die genauen Links zur API finden Sie im Login Bereich unter Statistik => Export-API, wo Ihnen 8 unterschiedliche Schnittstellen angeboten werden.

Tagesstatistik, Merchantstatistik, Kampagnenstatistik, Projektstatistik, SubID Statistik, Referrer Statistik, Werbemittel-Statistik sowie eine Auflistung der erfassten Transaktionen inkl. der SUBID (falls übermittelt)


LINK-MIT-APIKEY/get-statistic_daily.csv?condition[period][from]=&condition[period][to]=15.02.2017

Die API-Schnittstelle der Private Network Software easy.affiliate bietet Ihnen mehrere Filtermöglichkeiten.

Startdatum ==> condition[period][from]=01.02.2017
Datum von dem an die Statistiken genommen werden sollen
 
Enddatum  ==> condition[period][to]=15.02.2017
Bis zu diesem Datum sollen die Werte geholt werden
 
Anstelle der oben genannten Eingabe geht auch:
LINK-MIT-APIKEY/get-statistic_daily.csv?condition[dynamicdate]=currentmonth

condition[dynamicdate]=

currentmonth steht für aktueller Monat
lastmonth wäre letzter Monat
last10d - die letzten 10 Tage
currentweek ist die Aktuelle Woche

 


 

Transaktions – API

Bei der Transaktions-API gibt es zusätzlich noch die Status Abfrage:

LINK-MIT-APIKEY/ get-statistic_transactions.csv?condition[period][from]=01.02.2017&condition[period][to]=28.02.2017&condition[l:processingstate]=open

 condition[l:processingstate]=

open steht für offene Transaktionen
confirmed sind bestätigte, aber noch nicht ausgezahlte Transaktionen
paid
sind bestätigte und bereits ausgezahlte Transaktionen
canceled sind stornierte Transaktionen 

Hier ist auch eine Kombination mehrer Status möglich:
condition[l:processingstate]=confirmed,paid


So erhalten Sie die bestätigten sowie ausgezahlten Transaktionen (kommasepariert)

 

Sonstige API Filter

condition[l:projects]= Ihre Projekt-ID (bei mehreren angemeldeten Seiten)
condition[l:campaigns]=
Die Kampagnen ID

 


 

Definition der Felder in der Transaktions-API

<tbody> </tbody>

criterion

Die verschlüsselte Transaktion-ID

trackingtime

Zeitpunkt der Transaktion

advertiser_id

Programm-Betreiber ID

campaign_title

Name des Programms (Kampagne)

campaign_id

Programm ID

project_id

Die ID Ihrer Webseite (Projekt)

project_title

Titel Ihrer Seite (Projekt)

event

Art der Transaktion – Lead, Sale, Bonus

Payoutdate

Auszahlungsdatum – leer wenn noch nicht beglichen, Format: YYYY-MM-DD HH:MM:SS

processingdate

Bearbeitungszeitpunkt - leer wenn noch nicht bearbeitet, Format: YYYY-MM-DD HH:MM:SS

salary_id

Interne Auszahlungs ID - -1 bei noch nicht ausgezahlt

salary

Gutschriftsnummer – Beleg wie unter Einstellungen=>Gutschriften downloadbar

clicktime

Zeitpunkt des Klicks - Format: YYYY-MM-DD HH:MM:SS

subid

Die von Ihnen im Klick / Postview übergebene subid – Falls leer, wird NONE wiedergegeben

referrer

Der Klick-Referrer falls ermittelbar – ansonsten ://NONE

admedia_id

Werbemittel ID des Klicks der zur Transaktion geführt hat

status

0 = offen |  1 = freigegeben | 2 = Storniert | 3 = ausgezahlt

reason_of_cancellation

Storno-Grund (falls angegeben)

provision

Ihre Vergütung

turnover

Netto-Warenkorb Wert

trigger_id

ID des Events

trigger_title

Name des Events

basket_count

Im Falle von Basket-Tracking wird die Anazhl der im Warenkorb befindlichen Artikel wiedergegeben, sonst 0

Meine Werkzeuge
MediaWiki Appliance - Powered by TurnKey Linux