Skip to navigation
AnalyticsSet up measurement

Server-to-server integration

Send impression, click and conversion events to Pixalate Analytics from your servers, with no client-side tag.

If you can’t run a Pixalate tag in the browser or app, your servers can send each event to Pixalate’s ingest endpoint instead. Each request describes one impression, click or conversion as query string parameters: the visitor’s user agent and IP address, the page or app, and your IDs.

Before you start

  • Endpoint. Your Customer Success representative gives you the ingest URL during integration. Send each event as a GET request to it.
  • IDs. Pixalate gives you your client ID (__aaci) and partner ID (paid).
  • Samples. Ask your Customer Success representative for sample impression, click and conversion trackers for your setup.

Parameter keys for server-to-server can differ from the keys in the Pixalate tag. Use the keys on this page, and confirm them with your Customer Success representative.

Send an impression

Set INGEST_URL to the ingest URL Pixalate gave you, ending in /ingest.

curl -G "$INGEST_URL" \
  --data-urlencode "__aaci=YOUR_CLIENT_ID" \
  --data-urlencode "paid=YOUR_PARTNER_ID" \
  --data-urlencode "__aaba=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36" \
  --data-urlencode "__aaxi=198.51.100.23" \
  --data-urlencode "__aapu=https://www.example.com/2015/03/18/photos/" \
  --data-urlencode "__aasi=11688292681380980" \
  --data-urlencode "__aast=1426775058223" \
  --data-urlencode "__aavi=26821458186066696" \
  --data-urlencode "__aavt=1426407629708" \
  --data-urlencode "publisherId=45094030" \
  --data-urlencode "kv26=iOS"

To send a click instead, add __aaic=1. For a conversion, add __aaic=2.

Required parameters

ParameterKeyDescription
Browser agent__aabaThe browser agent string, as sent in the HTTP User-Agent header
Client ID__aaciYour client identifier, supplied by Pixalate
Visitor IP address__aaxiThe visitor’s IP address. It must be a valid visitor IP address. Don’t send local or private IP addresses.
Page URI__aapuThe URI of the page
Session ID__aasiA unique number for each browser session, from 0 to 9,223,372,036,854,775,807 inclusive. This is normally stored in a browser session cookie.
Session time__aastThe Unix time, in milliseconds, when the session ID was created. This is normally stored in a browser session cookie.
Visitor ID__aaviA unique number for each browser visitor, from 0 to 9,223,372,036,854,775,807 inclusive. This is normally stored in a persistent browser cookie.
Visitor time__aavtThe Unix time, in milliseconds, when the visitor ID was created. This is normally stored in a persistent browser cookie.
Partner IDpaidYour partner identifier, supplied by Pixalate
Supply typekv24The supply environment, for example Desktop, Mobile_Web, Mobile_InApp or OTT. See Supply types.

For in-app events, also send these. Ask your Customer Success representative for their keys.

ParameterDescription
Event IDA unique number for each event, from 0 to 9,223,372,036,854,775,807 inclusive
Ad event timeThe Unix time, in milliseconds, when the event ID was created

Optional parameters

ParameterKeyDescription
Event type__aaic1 to track a click, 2 to track a conversion. Leave it out for an impression.
Page referrer__aaprThe URI of the referring page
Publisher IDpublisherIdPublisher identifier
Seller IDsellerIdSeller identifier
Site IDsiteIdSite identifier

Mobile parameters

For events from mobile apps, add these to the required parameters.

ParameterKeyDescription
Latitudekv16The user’s latitude, when GPS data is available from the device, for example +12.345 or -45.123. South is negative. To comply with privacy standards, use at most 3 decimal places.
Longitudekv17The user’s longitude, when GPS data is available from the device, for example +12.345 or -45.123. West is negative. Use at most 3 decimal places.
App IDkv18The identifier of the app requesting the impression
Device IDkv22The device’s advertising identifier, such as Apple’s IDFA or an Android or Microsoft mobile device ID

Optional mobile parameters

ParameterKeyDescription
Device MD5kv19The MD5-hashed unique identifier of the mobile device
Device OpenUDIDkv20The OpenUDID of the mobile device
Device ODINkv21The ODIN identifier of the mobile device
Carrier IDkv23Carrier ID or mobile brand name
App namekv25App type, app name or SDK version
Device OSkv26Operating system of the device
Device make and modelThe device’s make and model. Ask your Customer Success representative for the key.