Returns a list of transactions for a given advertiser by ids
- 16 Jul 2024
- DarkLight
Returns a list of transactions for a given advertiser by ids
- Updated on 16 Jul 2024
- DarkLight
Article summary
Did you find this summary helpful?
Thank you for your feedback
Get
/advertisers/{advertiserId}/transactions
GET transactions (by ID)
Advertisers can pull individual transactions, check the status of the transactions, create their reports, and pull additional information that can be shared between publishers and advertisers via clickref (from publisher to advertiser) and orderRef and custom parameters (from advertiser to publisher). In addition to pulling transactions for a certain time frame, transactions can also be pulled by their IDs.
Who can use it
Advertisers
Header parameters
Authorization
string
accessToken
Path parameters
advertiserId
integer (int64) Required
advertiser id
Default"123456"
Query parameters
accessToken
stringRequired
access token
ids
stringRequired
ids
showBasketProducts
boolean
show basket products
Default"False"
timezone
string
time zone in short or default format
Default"UTC"
Further information on query parameters
| parameter | format | mandatory/optional |
| ids | numeric, comma-separated | mandatory |
| timezone | Europe/Berlin Europe/Paris Europe/London Europe/Dublin Canada/Eastern Canada/Central Canada/Mountain Canada/Pacific US/Eastern US/Central US/Mountain US/Pacific UTC | optional, default is UTC |
| showBasketProducts | JSON array | optional |
Responses
200
OK
Note that the field "lapseTime" is the conversion time in seconds
Basket Products
If &showBasketProducts=true then products sent via Product Level Tracking matched to the transaction can be viewed (please see "Conditional data fields" below for restrictions that might apply)
Conditional data fields
Some data fields are available for advertisers depending on additional settings.
| datafield | available for advertisers |
| orderRef | yes |
| clickRef | yes |
| clickRef2 - clickRef6 | no |
| customParameters | yes |
| basketProducts | yes |
| networkFee | yes, if the advertiser has standard invoicing terms |
Response values for "type"
Sale, Lead, Bonus, 2nd Tier, Commission group transaction, PPC, TQS, Mobile Sale, Mobile Lead, Mobile App Install, Mobile App Purchase, Compensation,
Was this article helpful?