- General Questions
- My Inventory
- What is an App?
- How many Apps can I create inside SPX?
- Am I obligated to enter detailed information about my App and/or Adspace?
- What is an Adspace?
- What Download URL should I include if my app is in development stage?
- How many Adspaces can I create inside SPX?
- What sites or apps qualify for Smaato?
- Why should I specify the page placement of my Adspace?
- Which page placement should I choose if I'm not sure (i.e. my Adspace is in the footer and below the fold)?
- Does the Adspace dimension overwrite or substitute the dimension parameter inside the ad request?
- Is an Adspace limited to one dimension, or can I choose multiple dimensions?
- Can I use different IAB Categories for my App and related Adspaces?
- What will happen if I set up an Android App and Adspace instance, but set the associated Line Item to iOS? Will this result in no fill on that Line Item?
- Where can I find my Publisher ID?
- Where can I find my AdSpace ID?
- Where can I find my Client ID and Client Secret?
- How can I test my integration?
- Smaato Exchange
- What is a Line Item?
- Which priority is the highest and which is the lowest?
- What does SMX stand for?
- How many demand sources compete within Smaato Exchange Line Items for the impression?
- What is a DSP?
- What is an Ad Network?
- What's the difference between Real-Time Bidding and Ad Network Mediation?
- What's Smaato's business model?
- How does the minimum CPM affect my eCPM?
- Why is my eCPM lower than the Line Item minimum CPM?
- Why should I disable Smaato Ad Network Demand?
- What impact do my Smaato Exchange Settings have on Ad Network Mediation?
- Do the Smaato Exchange Settings apply to all my SMX Line Items?
- Which of the values that are configurable on the SPX are actually passed into RTB?
- What is an Order?
- What is an Advertiser?
- What’s the difference between Direct and House Line Items?
- What kind of Creatives can I run?
- What are SPX Macros and how do I use them?
- Is there a click tracking Macro for HTML Creatives?
- What configurations enable evenly pacing?
- My Line Item is still pending and not live!
- My Line Item is live but not delivering / running!
- What is Smaato Ad Network Demand? And how is this different from Networks?
- Why should I enable the reporting for my ad network?
- How does Smaato calculate the CPM for network auto-optimization?
- Can I enable network reporting, but disable auto-optimization if I want to set the CPM rate myself?
- Which system counts the views and clicks that are displayed in the dashboard?
- Can I use my existing network account for my SPX setup?
- I set up a network line item and activated 'Revenue Reporting & CPM Auto Optimization' - but for the first X days, my network does not provide any data, so there's no auto-optimization network CPM available yet! What can I do?
- Network Line Items are by default set to a lower Priority level than SMX Line Items. Is this in any way mandatory?
- Ad Operation
- Where can I find an integration guide?
- How long do changes to a Line Item take to go live?
- My Line Item is in status Pending, when will it be live?
- How long does it take for impression data to be available in the Smaato Publisher Platform SPX?
- Is it possible to delete Inventory (ad space/app/line item)?
- What is the average latency of an ad request on the platform?
- Which image ad dimensions are supported?
- I'm getting a smaller ad banner dimension than I requested.
- What kind of response do I receive from the SOMA optimization platform after submitting an ad request?
- What kind of encoding is used by the SOMA optimization platform for a response to an ad request?
- What is a tracking pixel / beacon?
- In what time zone are the reports displayed?
- What's the difference between an ad request and an ad impression?
- What is eCPM?
- Why is eCPM important to me?
- Why do my reporting numbers change?
- What are possible reasons for a low fill rate?
- In which currency are my earnings displayed?
- What payment methods are available?
- How can I change my payment method?
- What is necessary to be completed before being able to receive payment?
- Where can I download the W8/W9 forms?
- What is my minimum payout?
- In which currency will I receive my payment?
- Is there an additional fee for the transfer?
- What does net revenue mean?
- What is my revenue share?
- What is my payout?
- When do I get the money? The Smaato payment schedule.
- How often will I receive payments?
- Can I see my payment history?
- My bank's located in a different country than my business - how can I enter differing countries for bank and business addresses?
- I'm receiving error code 42.
- I'm receiving error code 84.
- I've integrated the Smaato SDK, but I'm getting the error code 106.
- I've integrated the code snippet into my site, but I'm not getting any test ad.
- My integration works, but I'm not getting any ads.
- What browsers are supported and recommended for SPX?
- I'm using an old Internet Explorer and can't sign up to SPX. What's wrong?
- How can I reach out for SPX support?
Why is Smaato the smartest advertising management solution?
Within the mobile display advertising market, agencies mostly interact with intermediaries such as ad networks by investing their advertising budgets into advertising on their network. The role of ad networks within the ecosystem is to aggregate and connect advertisers who want to buy advertising space with publishers who offer inventory.
Under this model, publishers are often unable to monetize their ad inventory efficiently because they are typically only integrated with one ad network. This creates a problem because single ad networks have a limited amount of advertisers, as well as specific price points and advertising formats. In addition, the ad network may only be specialized in a particular region with a national market.
As the leading global mobile RTB ad exchange and integrated Supply Side Platform, Smaato offers a solution to this significant problem. The Smaato Publisher Platform SPX directly connects publishers to nearly 400 aggregated DSPs and networks from around the world with one integration. Smaato gives publishers full control over the monetization of their inventory.
How does Smaato maximize my eCPM?
The Smaato Publisher Platform SPX features groundbreaking Dynamic Demand technology. With Dynamic Demand, direct sold, RTB, indirect, and programmatic buys all compete within the platform on an impression-by-impression basis, delivering maximum yield to the publisher. Publishers have the power to make any Line Item compete with any other while SPX ensures that all goals and targets are met. With Dynamic Demand, we're moving away from sequential ad server selection and into a world of truly universal competition.
What does Dynamic Demand mean?
Dynamic Demand is the Smaato technology enabling per-impression competition among any buying model.
What types of inventory can I monetize as a publisher?
As a publisher, you can monetize your mobile website, or areas within your App.
How much does it cost to use the Smaato Publisher Platform (SPX)?
Smaato acts as a full service provider for mobile advertising aggregation services. Revenue generated through Smaato's services is subject to a revenue share. Want to know your revenue share? See our for more information!
What is an App?
An App within the Smaato Publisher Platform SPX is an actual mobile application or website with at least one Adspace.
How many Apps can I create inside SPX?
There is no limit to the number of Apps that the publisher can create inside the platform.
Am I obligated to enter detailed information about my App and/or Adspace?
Not all information fields are required to be filled out. However, the more information you can provide, the better we can optimize your traffic.
What is an Adspace?
Any space within an application that has been reserved for the display of advertising. Its dimensions and location within an application typically define an Adspace.
What Download URL should I include if my app is in development stage?
You can insert a dummy URL (e.g. http://www.test.com/placeholder) for the time being; don't forget to insert the proper URL as soon as your App is live on the store!
How many Adspaces can I create inside SPX?
There's no limit to the number of Adspaces that the publisher can create inside the platform.
What sites or apps qualify for Smaato?
The Smaato Publisher Platform SPX is open to everyone, ranging from large publishers with multiple mobile sites or applications to small start-ups, blogs, and app developers. Smaato accepts all mobile sites and apps that do not host pornographic or illegal/pirated content, as defined in our Terms and Conditions.
Why should I specify the page placement of my Adspace?
Some advertisers are looking for specific page positions for their ads. Providing more information about the Adspace location can impact the fillrate and eCPM for an impression in Real-Time Bidding ("RTB").
Which page placement should I choose if I'm not sure (i.e. my Adspace is in the footer and below the fold)?
The page placement information is passed to DSPs that are interested in it, so this is a non-technical setting. If you have two criteria that apply, choose the one that you deem more prevalent, and go with absolute over relative position (i.e. if your adspace is in the footer, just use footer, no matter if the footer is below the fold or not).
Does the Adspace dimension overwrite or substitute the dimension parameter inside the ad request?
The dimension parameter in the SPX Adspace configuration is for your organizing purposes and does not override the ad request's dimension parameter set in the SDK or Ad Tag. Please provide the dimension parameter in the ad request dynamically.
Is an Adspace limited to one dimension, or can I choose multiple dimensions?
Inside the Adspace configuration, the dimension parameter is limited to one dimension.
Can I use different IAB Categories for my App and related Adspaces?
Sure! We'll submit both to our demand partners.
What will happen if I set up an Android App and Adspace instance, but set the associated Line Item to iOS? Will this result in no fill on that Line Item?
As with the dimension parameter setting, the App Type setting is for your organizing purposes. It won't override ad request configurations from the SDK or Ad Tag, so if you associate instances and line items with different types, fill won't be affected. Your setup will be cluttered, but that's about it.
Where can I find my Publisher ID?
The Publisher ID is located in the administration area under My Account or in the summary area under Inventory.
Where can I find my AdSpace ID?
The Adspace ID is located under Inventory - open the App of the Adspace, and the ID will be visible in the overview as well as in the integration options pop up.
Where can I find my Client ID and Client Secret?
Go to the top right and click on OAuth API Credentials. You can also find more info on authentication here: Authentication Credentials.
How can I test my integration?
Use 0 as a value for both PublisherID and AdspaceID; this will call a test campaign. If you need further instructions (e.g. VAST Video integration), head over to our Publisher Integration space.
What is a Line Item?
The primary unit of execution for an Order, representing the purchase of specific inventory characterized with a price, priority and targeting.
Which priority is the highest and which is the lowest?
Priority 1 is the highest, Priority 16 is the lowest.
What does SMX stand for?
SMX is an acronym for Smaato Mobile Advertising Exchange, a Smaato-owned-and-operated integrated Open RTB and Ad Network Mediation mobile ad exchange.
How many demand sources compete within Smaato Exchange Line Items for the impression?
SPX directly connects publishers to nearly 400 aggregated DSPs and networks from around the world.
What is a DSP?
A Demand Side Platform (DSP) is a type of RTB Ad Network in which agencies run ad campaigns that bid in an auction for a certain impression.
What is an Ad Network?
A network that sells advertising space for sites and apps.
What's the difference between Real-Time Bidding and Ad Network Mediation?
Among various other differences between RTB and AN Mediation, the most notable difference is that RTB demand is transacted programmatically on an impression-by-impression basis (thus enabling leveraging available data in real time), while Ad Network Mediation is a non-programmatic (i.e. pre-configured) direct demand stream.
What's Smaato's business model?
How does the minimum CPM affect my eCPM?
The minimum CPM is your lowest acceptable price per 1000 impressions of your inventory. The eCPM for each Line item will have to be above the minimum CPM. Raising the minimum CPM may improve your eCPM, but may also decrease your overall fillrate.
Why is my eCPM lower than the Line Item minimum CPM?
The minimum CPM is the guaranteed Floorprice for Smaato RTB and the recommended historical Ad Network Mediation CPM. In order to obtain a strict floor, disable Smaato Ad Network Demand for this Line Item.
Why should I disable Smaato Ad Network Demand?
If you'd like to run a Smaato RTB-only auction and omit Ad Network Mediation, you can disable Smaato Ad Network Demand per Line Item.
What impact do my Smaato Exchange Settings have on Ad Network Mediation?
The Smaato Exchange Settings won't affect Smaato Ad Network Mediation; they will solely impact the RTB demand sources.
Do the Smaato Exchange Settings apply to all my SMX Line Items?
Yes, the general settings apply to all Line Items. Line Item related settings apply only to this Line Item.
Which of the values that are configurable on the SPX are actually passed into RTB?
The following configurable SPX parameters are sent into RTB: Blocked Advertiser Domains, Blocked Advertiser Categories, Floor Price, App & Adspace Category, Page Placement.
What is an Order?
An Order in SPX is mostly synonymous to an insertion order; it represents an advertising agreement between two parties. To set up a Campaign in SPX, an Order needs to be connected to a Line Item (that acts as a connector to your inventory).
Orders can be paused, which globally pauses all connected Line Items and Creatives.
What is an Advertiser?
An Advertiser is assigned to an order and is the entity that reaches an agreement with you, the publisher, to advertise a campaign on your inventory, and to pay an agreed price or rate.
What’s the difference between Direct and House Line Items?
Direct Orders can either be run via Direct or House Ad Line Items; the key differences are Priority (Direct Line Items are by default set to 6, House Ad Line Items to 16) and price (Direct Line Items usually have a price point, while House Ads are run at no cost). Direct campaigns are sold for a set CPM and number of impressions to an agreed pricing, usually at a high Priority. House Ad campaigns are self promotional campaigns to advertise other apps at no cost, and are usually set to a low priority to serve as backfill.
What kind of Creatives can I run?
SPX offers 3 different types of Creatives: Image, Text and HTML (Rich Media)
Creatives can be paused and resumed individually.
What are SPX Macros and how do I use them?
SPX Macros dynamically pull attributes and add them into your remote Creative URLs, as well as click-through URLs, when SPX serves an ad.
Click URL (Unescaped)
Click URL (Escaped)
Cache Buster (Generates a random number e.g. unix timestamp in milliseconds)
Creative ID of the corresponding Creative
Line Item ID of the corresponding Creative
Adspace ID of the requesting Adspace
Publisher ID of the requesting Publisher
Unique Device ID if available (Apple IDFA, SHA1 Hashed Android ID, Google Ad ID) inside the ad request
|%%AGE%%||The user’s age of the initial ad request|
|%%GENDER%%||The user’s gender of the initial ad request|
|%%LATITUDE%%||The latitude value of the initial ad request|
|%%LONGITUDE%%||The longitude value of the initial ad request|
|%%ZIP_CODE%%||The zip code value of the initial ad request|
|%%REF_URL_UNESC%%||The HTTP referer of the initial ad request (Unescaped)|
|%%REF_URL_ESC%%||The HTTP referrer of the initial ad request (Escaped)|
To use SPX Macros, insert the desired Macro into your remote image URLs, click URLs, tracking URLs or HTML (Rich Media) - wherever you’d like that data to show up.
Is there a click tracking Macro for HTML Creatives?
To support click tracking for HTML Creatives, SPX provides the 2 different click tracking Macros:
Click URL (Unescaped)
Click URL (Escaped)
There is no universal rule to either using the Escaped or Unescaped version of the Macro; in general, please follow these guidelines:
- if the Macro comes at the beginning of the URL sequence (most common with simple creatives, like text & image), use the unescaped Macro
- if the Macro comes at the end of the URL sequence (most common with more elaborate creatives, like rich media) , the escaped macro should be used (escaping the URL is necessary when the tracking URL is passed as a parameter to a third-party server because unescaped reserved characters can interfere with that third-party server's parameter parsing)
What configurations enable evenly pacing?
Pacing is designed to distribute the actual number of impressions for a Line Item Evenly or As fast as possible. Delivery speed is planned based on pacing, budget and flight dates, e.g. spacing out 1000 impressions over 10 days would evenly deliver 100 impressions (max.) per day. Evenly pacing is available for daily capped impressions, or for a limited amount of total impressions with a defined end date.
My Line Item is still pending and not live!
If your Line Item is not live yet, please check the following:
No Inventory targeted - Check your Line Item’s Inventory targeting!
No Creative Added - You’ll need at least 1 Creative set up!
Start Date later than today - If the Start Date’s set to the future, the Line Item won’t be live yet.
My Line Item is live but not delivering / running!
If your Line Item is live but not actually delivering anything, please check the following:
Available Creative - Make sure that there’s no configuration conflict in the way between your available creative sizes and the requested ad size.
Capping - Your limit may already be reached, check your Line Item’s frequency and volume capping settings.
Targeting - Make sure there’s no Targeting conflict in your Line Item.
What is Smaato Ad Network Demand? And how is this different from Networks?
The Smaato Exchange consists of RTB buyers and traditional Ad Network Demand.
Smaato Ad Network Demand refers to the Ad Network Mediation-connected Demand Sources within the Smaato Exchange. Networks are publisher owned accounts and not part of the Smaato Exchange.
Why should I enable the reporting for my ad network?
By providing your account details, you allow Smaato to access your network's reporting numbers and better optimize your traffic to get the highest possible eCPM. At the same time, you'll only need to check one single reporting dashboard to view all your networks' performances.
How does Smaato calculate the CPM for network auto-optimization?
If the account details are provided for your network account, Smaato collects the network's data of the last 3 days and calculates the eCPM to rate your Line Items. Importing the latest numbers happens every one or two hours.
Can I enable network reporting, but disable auto-optimization if I want to set the CPM rate myself?
You sure can! Just enable the reporting, and enter your preferred Network CPM.
Which system counts the views and clicks that are displayed in the dashboard?
In the SPX GUI, we currently display network counted impressions & clicks. Therefore, you need to activate Revenue Reporting & CPM Auto Optimization to see network views and clicks in the SPX dashboard.
Can I use my existing network account for my SPX setup?
Yes, but your network account should be dedicated to your Smaato setup. If you've got third parties accessing your Network account, data management will get messy, and you might lose revenue.
I set up a network line item and activated 'Revenue Reporting & CPM Auto Optimization' - but for the first X days, my network does not provide any data, so there's no auto-optimization network CPM available yet! What can I do?
During this transition phase, you should enter a manual CPM rate in the network line item that you want to prioritize until revenue data is provided by the network.
Network Line Items are by default set to a lower Priority level than SMX Line Items. Is this in any way mandatory?
Not at all! For starters, we suggest prioritizing Network Line Items lower than SMX Line Items for optimized performance, but you're free to configure Priorities to fit your specific goals and needs.
Where can I find an integration guide?
The latest Smaato API integration guide is available in the administration area (top right in SPX) under Smaato Integration.
How long do changes to a Line Item take to go live?
My Line Item is in status Pending, when will it be live?
Reasons for the status Pending can be:
- The start date is in the future
- No inventory is specified for delivery
- No creatives have been added to the direct line item
- All creatives added to the direct line item are paused
How long does it take for impression data to be available in the Smaato Publisher Platform SPX?
Time delays between impression and reporting are approximately 4 hours, subject to the frequency of updates from the demand partners.
Is it possible to delete Inventory (ad space/app/line item)?
For various reasons (safety & legal, among others), this isn't possible.
- If you don't want to use a Line Item anymore, pause it (status toggle button).
- If you have a lot of Line Items and are annoyed by old Line Items cluttering up your view, we recommend prepending e.g. a Z to the Line Item name(s) to make them slide to the bottom of the list.
What is the average latency of an ad request on the platform?
We don't have reliable and referenced data available yet.
Which image ad dimensions are supported?
Smaato supports internationally accepted ad formats defined by the Mobile Marketing Association (MMA) or IAB (Interactive Advertising Bureau) and a large number of full screen sizes.
I'm getting a smaller ad banner dimension than I requested.
In the unlikely event that you receive an ad banner that is smaller than the size you requested, please ensure that you have set the 'dimension strict' parameter on your ad request. Please refer to our integration documents for more details on this parameter.
What kind of response do I receive from the SOMA optimization platform after submitting an ad request?
The SOMA system response for a mobile website is usually an HTML response. Depending on the requested ad format, the HTML response contains the link, text, or image tag and a tracking pixel.
For Apps, the SOMA response format can be XML or HTML - including the text, image, video, ad tag, click URL, and a tracking pixel.
What kind of encoding is used by the SOMA optimization platform for a response to an ad request?
What is a tracking pixel / beacon?
A beacon is a transparent 1x1 image that helps to count the view of an ad and validate traffic performance.
In what time zone are the reports displayed?
The reports are shown in GMT / UTC.
What's the difference between an ad request and an ad impression?
The ad request is the call of a site or app for an ad. The ad impression describes a successful request - loading an ad on the site or app.
What is eCPM?
The Effective Cost per Thousand impressions (eCPM) is calculated by dividing the total earnings by the total number of impressions. For example, if you earned $200.00 from 40,000 impressions, the eCPM calculation would be ($200.00 / 40,000) x 1000 resulting in an eCPM of $5.00.
Why is eCPM important to me?
eCPM is a useful reporting metric for comparing revenue generated across marketing channels and advertising networks.
Why do my reporting numbers change?
It can take about a month until all demand partners have finalized their reports. We are in a continual updating and balancing process to provide you with the latest revenue numbers.
What are possible reasons for a low fill rate?
There are numerous possible explanations, and applicability depends on your setup. However, the most common ones would be:
- minimum CPM set too high (start with low min CPM values instead of setting them high to begin with, or set up 2 price points (i.e. 2 line items) instead of one)
- blocking too strict (make sure that you've only excluded what you really don't want!)
- uncommon ad formats (fill rates are highest for common ad formats such as MMA standard banners and interstitials)
- lack of traffic enrichment (not passing geo location, device ID and further possible user info doesn't only result in a low fill rate, but also in low valuation and thus low eCPM!)
In which currency are my earnings displayed?
All monetary values are displayed in USD (U.S. Dollars).
All payments are now handled thru Tipalti. Head to Payment Information in your SPX account to set up payment details.
If you haven't updated your payment details yet, your payments will be on hold until you've updated. You cannot get paid by Smaato moving forward if you don't submit your payment and tax details to Tipalti.
What payment methods are available?
Currently, we offer PayPal, Wire Transfer and eCheck/Local Bank Transfer.
How can I change my payment method?
Select your preferred payment method in Tipalti in the administration area under Payment Information.
What is necessary to be completed before being able to receive payment?
- Complete your business information in your SPX Account.
- Fill out the Payment Information within your Smaato Account.
- Reach the minimum payout (100$).
Where can I download the W8/W9 forms?
You can find the tax forms within Tipalti now.
What is my minimum payout?
100 USD. If your revenue is less than $100 per month, Smaato will roll over the amount payable to you to the subsequent payout cycle, until at least $100 are reached.
In which currency will I receive my payment?
Is there an additional fee for the transfer?
Please also be aware that the payments are sent in U.S. Dollars, and your bank may charge a fee for converting this to your local currency. Contact your bank for more detailed information.
What does net revenue mean?
Net revenue is the amount actually received by Smaato from third party advertisers or ad networks for delivered ads calculated per impression, click or other actions less the Smaato revenue share.
What is my revenue share?
The net revenue share for the actual month is based on the ad impressions of the previous month. Upon joining Smaato, your net revenue share is set to the default rate of 70/30. Please refer to our Terms and Conditions or contact your account manager for more details.
What is my payout?
Your payout, or payment, is the amount of gross revenue your account achieved during a month less the Smaato share, and less any taxes Smaato may be legally required to withhold.
When do I get the money? The Smaato payment schedule.
Smaato follows a 60-day payment schedule. Smaato will pay you your net revenue share within sixty days after the end of the calendar month in which revenue was accrued.
To be eligible for payout, you'll need to complete all the necessary steps to receive payment (see here).
For example, if you earned $60 in January, the payment will be sent to you in early/mid April.
It can take about a month until all our partner ad networks have finalized their reports. After this time, Smaato will provide you with a payment report under My Account/Credit Notes. During the following month, Smaato collects the revenue from our partner ad networks, and pays your net revenue share.
How often will I receive payments?
Smaato pays you every month after the payment schedule. If your earnings are below the minimum payout, we will carry the earnings over to the following month.
Can I see my payment history?
Select your preferred payment history in the administration area under Payment History.
My bank's located in a different country than my business - how can I enter differing countries for bank and business addresses?
To enter different countries for both, please reach out to firstname.lastname@example.org.
I'm receiving error code 42.
The message "no ads available" means that for this specific request (e.g. combination of device/location/category), there is currently no ad available.
I'm receiving error code 84.
Please check all the required parameters. One or more of the mandatory parameters are missing in your request.
I've integrated the Smaato SDK, but I'm getting the error code 106.
This may be due to one of the reasons below:
- The Publisher ID and the Adspace ID do not belong to the same account. Check if you used your personal Publisher ID and the correct Adspace ID.
- The Adspace ID might have been blocked by you for Smaato Demand. Enable Smaato Demand again or enable different demand sources.
I've integrated the code snippet into my site, but I'm not getting any test ad.
Please check the following:
- Make sure you copied and pasted the entire code snippet.
- Check the configuration options within the code. Consult all comments and set the options as desired.
- Verify that your Publisher ID and Adspace ID are correct.
- Verify that at lease one Line Item for the given traffic is active.
My integration works, but I'm not getting any ads.
Please check the following:
- Do you have an active Line Item including your requesting Adspace?
- Does your Line Item targeting match the incoming ad request?
What browsers are supported and recommended for SPX?
Smaato recommends the latest versions of the web browser Internet Explorer, Firefox, Chrome or Safari.
I'm using an old Internet Explorer and can't sign up to SPX. What's wrong?
SPX does not support Internet Explorer 11.0 or older. Please choose one of the recommended browsers or upgrade your browser.
How can I reach out for SPX support?
Please contact us at our dedicated SPX support account: email@example.com.