> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.pixalate.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.pixalate.com/_mcp/server. # Server-to-server integration > Parameter reference and example requests for sending data to Pixalate Analytics through the server-to-server ingest endpoint. 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. > **Note** > > 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`. ```bash 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 | Parameter | Key | Description | | ------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | Browser agent | `__aaba` | The browser agent string, as sent in the HTTP `User-Agent` header | | Client ID | `__aaci` | Your client identifier, supplied by Pixalate | | Visitor IP address | `__aaxi` | The visitor's IP address. It must be a valid visitor IP address. Don't send local or private IP addresses. | | Page URI | `__aapu` | The URI of the page | | Session ID | `__aasi` | A 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 | `__aast` | The Unix time, in milliseconds, when the session ID was created. This is normally stored in a browser session cookie. | | Visitor ID | `__aavi` | A 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 | `__aavt` | The Unix time, in milliseconds, when the visitor ID was created. This is normally stored in a persistent browser cookie. | | Partner ID | `paid` | Your partner identifier, supplied by Pixalate | | Supply type | `kv24` | The supply environment, for example `Desktop`, `Mobile_Web`, `Mobile_InApp` or `OTT`. See [Supply types](/analytics/tag-and-macros#supply-types-kv24). | For in-app events, also send these. Ask your Customer Success representative for their keys. | Parameter | Description | | ------------- | ----------------------------------------------------------------------------- | | Event ID | A unique number for each event, from 0 to 9,223,372,036,854,775,807 inclusive | | Ad event time | The Unix time, in milliseconds, when the event ID was created | ## Optional parameters | Parameter | Key | Description | | ------------- | ------------- | -------------------------------------------------------------------------------- | | Event type | `__aaic` | `1` to track a click, `2` to track a conversion. Leave it out for an impression. | | Page referrer | `__aapr` | The URI of the referring page | | Publisher ID | `publisherId` | Publisher identifier | | Seller ID | `sellerId` | Seller identifier | | Site ID | `siteId` | Site identifier | ## Mobile parameters For events from mobile apps, add these to the required parameters. | Parameter | Key | Description | | --------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Latitude | `kv16` | The 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. | | Longitude | `kv17` | The 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 ID | `kv18` | The identifier of the app requesting the impression | | Device ID | `kv22` | The device's advertising identifier, such as Apple's IDFA or an Android or Microsoft mobile device ID | ### Optional mobile parameters | Parameter | Key | Description | | --------------------- | ------ | ---------------------------------------------------------------------------------- | | Device MD5 | `kv19` | The MD5-hashed unique identifier of the mobile device | | Device OpenUDID | `kv20` | The OpenUDID of the mobile device | | Device ODIN | `kv21` | The ODIN identifier of the mobile device | | Carrier ID | `kv23` | Carrier ID or mobile brand name | | App name | `kv25` | App type, app name or SDK version | | Device OS | `kv26` | Operating system of the device | | Device make and model | | The device's make and model. Ask your Customer Success representative for the key. | ## Related * [Choose an integration method](/analytics/integration-methods) * [Click tracking](/analytics/click-tracking) * [The Pixalate tag and macros](/analytics/tag-and-macros)