Home > Supply Side Platform > General > Required Parameters for different traffic types

Required Parameters for different traffic types

To properly deliver and track ads through the Adtelligent Ad Server, certain parameters must be passed in each ad request. These parameters ensure accurate targeting and reporting. Below is a breakdown of required parameters for CTV/In-App and Desktop/Mobile Web traffic types.

 

📌 Parameter Table

Parameter

CTV / In-App

Desktop / Mobile Web

Description

Required

width

✔️

✔️

Ad slot width in pixels

Yes

height

✔️

✔️

Ad slot height in pixels

Yes

ua (User Agent)

✔️

✔️

User device’s User Agent string

Yes

uip (IP address)

✔️

✔️

User IP address

Yes

app_name

✔️

Application name (for in-app/CTV traffic)

Yes

app_bundle

✔️

App bundle identifier (e.g., com.publisher.app)

Yes

idfa (Device ID)

✔️

✔️

Advertising ID (for in-app/CTV) or equivalent identifier for web

Yes

app_store_url

✔️

Link to app store page (for app verification)

Yes

cb (Cachebuster)

✔️

Random number to prevent ad caching

Yes

content_page_url

✔️

Full URL of the page where the ad is displayed

Yes

 

📌 Example Ad Request URLs

Example for CTV / In-App:

http://s.adtelligent.com/?width=640&height=360&ua=Mozilla/5.0&uip=192.168.1.1&app_name=AwesomeTVApp&app_bundle=com.awesome.tvapp&idfa=A1B2C3D4-E5F6-7890-GH12-3456789IJKLM&app_store_url=https://appstore.com/app&id=111222

 

 

Example for Desktop / Mobile Web:

https://s.adtelligent.com/?content_page_url=https%3A%2F%2Fpublisher.com%2Fpage&width=300&height=250&cb=123456789&aid=111222&uip=192.168.1.1&ua=Mozilla/5.0&idfa=A1B2C3D4-E5F6-7890-GH12-3456789IJKLM

 

📌 Integration Notes:

  • Do not omit required parameters — missing them may result in no ad fill or inaccurate reporting.

  • For CTV/In-App traffic, passing idfa or platform-specific identifiers (e.g., gaid for Android) is highly recommended for better demand matching.

  • Always use a cachebuster (cb) on web to avoid creative caching by browsers or CDNs.

  • Ensure page URLs and app bundle names are URL-encoded where necessary.

  • IP addresses and User Agents must be real values for proper geo-targeting and device-based targeting.