Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

After the access token a "/publisher/" is appended followed by the publisher ID of the system. If the publisher ID is not known, please follow these instructions:

Wo ist die Publisher ID zu findenWhere can the publisher ID be found?

Then the type of API call is determined. Which types of API-calls are available can be found in the following instructions:

Welche API Aufrufe gibt esWhich API-calls are available?

Finally, it can be decided in which format the data should be provided. The output of the file is possible in CSV, XLS, XML and JSON. The file extension must be adapted accordingly. The CSV file format is recommended!

...

Available file formats

file format

parameter

CSV format - seperated by comma

.csv

XLS format - default format of Microsoft Excel

.xls

XML format- extensible markup language

.xml

View API in frontend

The APIs can also be found in the frontend. In order to do so, you have to login first and afterwards navigating to the tab "API" to the point "Data API", where all interfaces are offered.

...

Below are all additional parameters that can be queried:

Transaction status

parameter

value

description

example

condition[l:processingstate]

open

All transaction with the status “open” within the system.

condition[I:processingstate]=open

confirmed

All transaction with the status “confirmed” within the system.

condition[I:processingstate]=confirmed

paid

All transaction with the status “paid” within the system.

condition[I:processingstate]=paid

canceled

All transaction with the status “canceled” within the system.

condition[I:processingstate]=canceled

Please notice: A combination of several statuses is possible. For example:
condition[l:processingstate]=confirmed,paid


Additional Transaction API filters

parameter

value

description

example

condition[l:projects]

id of the project as integer

All transactions that are stored under the given project ID within the program.

condition[l:projects]=1234

condition[l:campaigns]

id of the campaign as integer

All transactions that are stored under the given campaign ID within the program.

condition[l:campaigns]=1

condition[timetype]

0 = creation date

1 = processing date

2 = payout date

All transactions that have been created/processed/payed out in a certain period.

condition[timetype]=1

 Definition of the fields delivered by the transaction api

The columns of downloaded transactions contain the following parameters:Definitions of columns names

column

description

criterion

encrypted

hashed transaction id

trackingtime

timestamp of

the

transaction

advertiser_id

advertiser id

of the advertiser within the system

campaign_title

title

name of the campaign

campaign_id

campaign id

of the campaign within the system

project_id

project id

of the project

project_title

title of

the

project

event

type of transaction e.g.

lead

Lead,

sale

Sale,

bonus

Bonus

payoutdate

Payoutdate

Payout date - empty if not payed out yet, format: YYYY-MM-DD HH:MM:SS

processingdate

Processing time - empty if not processed yet, format: YYYY-MM-DD HH:MM:SS

date of payout 

processingdate

validation date

salary_id

internal

salary id, -1 if not payed out yet

billing id

salary

Credit note number – document can be downloaded as unter settings =>billing

invoice number

clicktime

timestamp of the click

- format: YYYY-MM-DD HH:MM:SS

subid

Subid you passed in click / postview - default: NONE

subid

referrer

The click

referrer

if determinable – default: ://NONE

admedia_id

admedia id

which led to the transaction

status

0 = open |

  1

 1 =

confirmed

valid | 2 =

canceled

cancelled | 3 = paid

reason_of_cancellation

cancel reason (if given)

Reason of cancellation

provision

your provision

commission of transaction

turnover

net basked value

Ordervalue

trigger_id

internal id

ID of the event

trigger_title

name of the event

basket_count

in case of enabled basket-tracking, the

number

amount of

items in the basket, otherwise 0

basket-items