Home > Supply Side Platform > Push Notifications > AdPush request/response format and examples

AdPush request/response format and examples

AdPush request example

Request URL TEMPLATE:

https://xxxxxx.xmlfeed.adtelligent.com/?subscriber_id=[replace_me]&subscription_date=[replace_me]&subscription_days=[replace_me]&ua=[replace_me]&subscription_timestamp=[replace_me]&uip=[replace_me]&subid=[replace_me]&domain=[replace_me]&site_page_url=[replace_me]&uid=[replace_me]&click_id=[replace_me]&lang=[replace_me]

Real example:

https://622188.xmlfeed.feed-xml.com/?subscription_date=2021-04-16&subscription_timestamp=1618555774&lang=en&subscriber_id=fystenf860sb&uip=72.61.121.77&ua=Opera%2F9.80+%28iPhone%3B+Opera+Mini%2F16.0.14%2F176.158%3B+U%3B+id%29+Presto%2F2.12.423+Version%2F12.16&subid=947235&domain=https%3A%2F%2Ftest.com&empty

 

Parameters description

Parameter

Description

622188

Source ID on Adtelligent platform

subscription_date

Date of the subscription to the feed

subscription_temestamp

Time and date when subscription was issued (unix time)

lang

Device language

uip

IP of the user

ua

Device user agent

subid

Traffic source id

somain

Domain of the request

subscription_days

Days from subscription (can be calculated as well as the number of days from subscription date)

site_page_url

Referrer of the request

uid

ID of the subscriber

click _id

ID of the click

 

Macros

Name

Parameter

Macro

Meaning

IP

&uip=

{uip}

user ip

User Agent

&ua=

{ua}

user agent

Subid

&subid=

{subid}

traffic source id; if supply source has passed some value we are passing it further, if not - we are generating a value based on domain and source id which is passed to advertiser

Referrer

&site_page_url=

{page}

referrer

Domain

&domain=

{domain}

domain

User ID

&uid=

{uid}

user id

Language

&lang=

{lang}

user browser language

Subscription Date

&subscription_date=

{subscription_date}

date of subscription to the feed

Subscription Days

&subscription_days=

{subscription_days}

will pass either value from subscription_days parameter or calculate the number of days from subscription date

Click ID

&click_id=

{click_id}

ID of the click

 

AdPush JSON response example

Valid response: 

{
  "title":  " Fortnite ",
  "link":  "https://abc54.feed-xml.com/tracking/pc?adid=T1618555790U3672FAFCDD4D611E_544742_622188",
  "imp_url":  "https://abc54.feed-xml.com/tracking/icon?adid=T1618555790U3672FAFCDD4D611E_544742_622188",
  "image_url":  "https://abc54.feed-xml.com/tracking/image?adid=T1618555790U3672FAFCDD4D611E_544742_622188",
  "description":  " Fortnite will live forever! ",
  "nurl":  "https://abc54.feed-xml.com/tracking/win?adid=3672FAFCDD4D611E_544742&aid=622188&event=nurl&without_adm=true",
  "cpc":  0.01
}

No Response:
204

AdPush XML response example

Valid response:
<result>
<ad title=“Let me show you this world 💶📲 " descr=" This world is beautiful ❗️ " bid="0.000112" url=“https://ads54.adtelligent.com/tracking/pushclick?adid=54D42R7A90T73BT3_771143_326738” image="https://ads54.adtelligent.com/tracking/image?adid=54D42R7A90T73BT3_771143_326738" icon="https://ads54.adtelligent.com/tracking/icon?adid=54D42R7A90T73BT3_771143_326738"/>
</result>


No Response:
<xml error="no-ads"></xml>