Transaction IDs

Retrieving Transaction Data at the Advertiser Level

The transaction ID report allows all advertisers to retrieve the same level of information that is available in Criteo's Marketing UI. These reports include the ability to report on transactions within a given time period, transactions associated with select or all advertisers in your portfolio, or specific transaction ID's.

Transaction ID reports are available at the following endpoint:

https://api.criteo.com/2024-04/transactions/report

Below is an example of the body for the POST call:

{
  "data": [{
    "type":"Report",
    "attributes": {
      "advertiserIds": "22, 4949",
      "startDate": "2020-11-04",
      "endDate": "2020-11-04",
      "format": "json",
      "timezone": "Asia/Tokyo",
      "currency": "JPY",
      "eventType": "click"
    }
  }]
}

The following fields are required: startDate, endDate, timezone, and currency. One or more advertiserIds can be requested. If none are specified, all advertisers in your portfolio will be included in the report.

The POST call will generate a report based on the format specified in the request. If not specified, the default report format is a CSV.

{
  "data": [{
    "type":"TransactionsReport",
    "attributes": {
      "advertiserId": "22",
      "transactionId": "20203090520694",
      "transactionDate": "11/04/2020 08:19:07",
      "adsetName": "crm-conversion-fil-rouge-famille",
      "advertiserName": "laredoute",
      "eventType": "click",
      "eventDate": "11/01/2020 22:42:29",
      "attributedTransaction": "True",
      "currency": "JPY",
      "amount": "15193.4412",
      "crossDeviceTransaction": "No"
    }
  }]
}

The following metrics and dimensions will be returned in the report: