For server-side integrations, especially where structural manipulation (layout, aggregation with other feeds, etc) is required, XML requests with appropriate 2nd party XSLT transformations or similar is recommended.
For AJAX type requests JSONP is generally recommended where server-side proxy requests are possible using JSON, but note that a SCRIPT request may better fit most of the common AJAX use cases and is much simpler to implement.
Data formats & Feed-URLs
JSON formatted data object
XHMTL (transitional) document
The User-Agent of the brwser. In general, client-side implementations (JSON, JSONP, HTML, SCRIPT) do this automatically, server-side implementations must set this header in the request to SolAds Media accordingly.
The URL of the page that will receive the adverts from the request. In general, client-side implementations (JSON, JSONP, HTML, SCRIPT) do this automatically, server-side implementations must set this header in the request to SolAds Media accordingly.
1 In the unlikely event of your chosen programming language or environment not allow you to set request headers, these can be supplied using the "ua=" and "ref=" parameters. The data must be URL encoded if sent in this manner. Please try and use headers if at all possible because the use of parameters causes unnecessary logging and may impact performance as a result.
Your publisher id
Activate Actual Impressions and receive an impression callback url to notify our adserver when advert was visually served to the user
Use backfill results if required (default = 1). "Backfill" results are 3rd party results which help to fill advert requests.
Minimum Bid for Banners. Only relevant for display ads. Usage: #.##
Copy width for banner ads
Copy height for banner ads
Declare if you have user consent to enable processing of Personally Identifiable Information (PII) as per Regional Data Regulation Laws. Values are 1 for consent or 0 for no consent. Default value if empty or not defined is 0 (no consent).
Use images if available (default = 0)
Logo image height for native text ads
Logo image width for native text ads
End user IP address
End User Browser Language
Media Type - banner, standardtexts
Number of results requested (1-15)
Return prices. See below.
Set sl=1 to get secure links (HTTPS) (Default=0)
sys=Solads, internal Systemname
Current URL on which the ad is integrated. Use this parameter to track your views in the site table of your publisher account and allow advertisers to target individual categories or domains. Use only if referrer cannot be sent via the HTTP header. If you send the string "REF" in the parameter "u", SolAds Media evaluates the HTTP referrer of the request.
1 Depending upon the system's configuration, specific types of adverts can be requested by supplying the media type parameter. If this parameter is not supplied, the advert server is free to choose any media type that is valid for the other parameters in the request.
Prices (Parameter "p"):
Empty or 0
Do not return price (Default)
Return prices in Euros (estimated if not feed default)
Return prices in US Dollars (estimated if not feed default)
Return prices in Sterling (estimated if not feed default)
N.B. All prices are in cents/pennies NOT Pounds/Euros/Dollars e.g. 1.52 is ONE POINT FIVE-TWO CENTS, NOT ONE DOLLAR FIFTY-TWO!
For HTML requests:
URI of your CSS file
Filter for adult content (default = 0)
Yes2, if ch not defined