Receive daily sales data via POST or GET

Kelkoo Group’s Postback for Sales service enables you to receive daily conversion data via server-to-server postbacks. This feature is designed to give publishers visibility into sales performance by delivering conversion events in a structured format once per day.

This guide outlines how to integrate with the service, what to expect, and the variables available to you.

What is a postback?

A postback is a server-side request that we send to your system each day for each recorded conversion. This allows you to ingest Kelkoo sale data directly into your reporting or optimisation tools.

Please note: This is a daily batch service – postbacks are not sent in real-time.

How it works

You provide us with:

HTTP Method: Either POST or GET
Postback URL: A templated URL containing variable placeholders
Optional POST Body: For POST requests, a structured payload
Optional Headers: Any headers you require for authentication, etc.

Example: POST configuration

Below is an example of a POST setup with a JSON payload.

JSON

{
 "method": "POST",
 "url_template": "https://your-server.com/conversion?saleId=${saleId}&saleValueInEur=${saleValueInEur}",
 "body_template": {
   "saleId": "${saleId}",
   "saleValueInEur": "${saleValueInEur}",
   "leadId": "${leadId}",
   "merchantId": "${merchantId}",
   "updateDateTime": "${updateDateTime}",
   "saleDateTime": "${saleDateTime}",
   "orderId": "${orderId}",
   "country": "${country}",
   "clickId": "${clickId}",
   "publisherClickId": "${publisherClickId}",
   "publisherSubId": "${publisherSubId}",
   "custom1": "${custom1}",
   "custom2": "${custom2}",
   "custom3": "${custom3}",
   "userDevice": "${userDevice}",
   "userBrowser": "${userBrowser}",
   "userBrowserVersion": "${userBrowserVersion}",
   "userOperatingSystem": "${userOperatingSystem}",
   "userOperatingSystemVersion": "${userOperatingSystemVersion}",
   "userAgent": "${userAgent}"
 },
 "headers": {
   "Authorization": "Bearer YOUR_API_KEY"
 }
}

Example: GET configuration

Replace with your own postback URL and insert variables of your choice:

https://track.yourdomain.com/go.php?id=${saleId}&salesAmount=${saleValue}&clickId=${clickId}

Available variables

You can include any of the following variables using the ${variable_name} format:

Variable name	Description
`saleId`	Kelkoo sale ID
`saleValue`	Sale amount in local currency
`saleValueInEur`	Sale amount in EUR
`saleValueInGbp`	Sale amount in GBP
`saleValueInUsd`	Sale amount in USD
`leadId`	Kelkoo lead ID
`merchantId`	Kelkoo merchant ID
`updateDateTime`	Timestamp of the last update to the sale record
`saleDateTime`	Timestamp when the sale occurred
`orderId`	Order ID as provided by the merchant
`country`	Two-letter country code (e.g. FR, DE, UK)
`clickId`	Internal Kelkoo click identifier
`publisherClickId`	Publisher’s click ID passed at click time by publisher
`publisherSubId`	Sub-identifier passed at click time by publisher
`custom1`	Custom parameter passed at click time by publisher
`custom2`	Custom parameter passed at click time by publisher
`custom3`	Custom parameter passed at click time by publisher
`userDevice`	Device type (e.g. desktop, mobile)
`userBrowser`	Name of the user's browser (e.g. Chrome, Safari)
`userBrowserVersion`	Browser version number
`userOperatingSystem`	Name of the user's OS (e.g. Windows, Android)
`userOperatingSystemVersion`	Operating system version
`userAgent`	Full user-agent string

Please contact your account manager to set this up.