SSP Guide (Getting Started)

Page interface

Page contains the following areas:

  1. User profile link and log out button. Click it when you need to view or change your profile settings or log out.
  2. Sections tabs. Here you can switch between tabs (Dashboard, Inventory, Deals, Report, Billing).
  3. Section page. This area displays all information of the selected section.
  4. You can also find help with SDK or API by hovering the mouse over Help button:
  • GDPR – here you can get info of how SSP processing users' consent to ensure GDPR compliance.
  • iOS SDK – learn how to use software development tools that allow you to integrate advertising into your app for Apple iOS devices.
  • Android SDK – find out how to use SDK that allows you to get revenue through mobile advertising on Android OS devices.
  • Management API – learn about inventory management API that allows publishers to manage their inventory and placements without affecting user’s interface.
  • Bid processing API – read about API that allows sending HTTP/HTTPS requests to receive advertising creatives.

Dashboard

The Dashboard is your main page when you log into the platform. Here you can view the data on your revenue, impressions and fill rate, your current balance, and the charts of TOP-5 performing inventories and placements.

You can view statistics by different time periods. To do so, click on dates in the upper right corner and select dates or select Today, Last 7 Days, Last 30 Days, This Month, or Lifetime.

How to add an Inventory

To get started, go to Inventory page.

Click Add Inventory button to create new inventory. Then choose inventory type: Android Application, iOS Application, or Web Site.

 

Warning: You won't be able to change its type later, so make sure to choose the correct type. On the page opened, fill in the fields:

  • Inventory Name - set the name to recognize this inventory amongst your other inventories. Required field.
  • Domain (for a website) or application bundle (for Android app) or iTunes ID (for iOS app). Field is required.
  • Language – select the content target language. English is set by default. Field is required.
  • GDPR compliance - select it to provide the GDPR compliance (a few more steps needed, use Help section to learn more).
  • Supply Categories — choose one or more categories that represent your content.
  • Left list contains all categories, right list contains categories you selected. Single click moves category from one list to another.
  • Note: Name of each category begins from code such as 'IAB5-1' which is standard IAB (Interactive Advertising Bureau) code for that category.
  • For example, you can choose both categories Automotive and Travel if your content is autotravels.
  • Filter Categories — choose content categories you would like to block.
  • Blocked Domains — you can set top-level domains of organizations whose content you don't want to display in your inventory.

Click 'Save changes'. Now this inventory will appear on the Inventory page:

‘Pending’ below the inventory name (as seen on screenshot) is the status of inventory. New inventory needs administrator's approval. It will be activated after administrator checks to confirm it has correct content and audience. Then you can start making money by selling ad placements.
After creating inventory, you have to add some placements to your inventory. To add a banner, video or native placement, use the buttons to the right of the inventory.

You can edit your inventory later, just click the ‘Edit’ button to the right of the inventory name.

You can search inventories or placements using the search field in the left corner. Type part of the inventory or placement name, and then will be shown only inventories/placements with that text in its name.
Note: the search works only for inventories with ‘Active’ status.

You can check earnings by each inventory. To do this, click the "Earnings" button to open a report on the selected inventory.

Placements

After you added an Inventory, you have to add one or more placements.

Adding a Banner Placement

Fill the fields on page (Name and Size or Width/Height is required):

  • Placement Name
  • Position — you can specify the position of your placement on the page.
  • Size, Width, and Height — enter width and height of your banner place manually if you have a custom size placement, or select IAB Size if size is standard. It's recommended to use one of the common sizes for better fill rates.
  • Serve All Acceptable — if you turn this setting ON, we can resize banners of acceptable sizes to fit your placement size. In this case, you must set maximal acceptable size for the creative.
  • Floor Price (CPM) and Optimal Floor Price— set your minimal floor price for one thousand impressions manually or let us determine the optimal floor price for the placement dynamically.

Note: placement fill rate may decrease in case the Floor Price (CPM) is too high.

You can set a different floor price for different countries. To do so, click on the planet image in 'Floor price' field. In the pop-up window, click on Country field and select countries, then set a floor price for them and click 'Done'. Repeat that consequence for each set of countries with a different floor price and click 'Save' after finished.

To remove an existing set of countries, click the red cross at that set.
To add the new set of countries, click the ‘+’ symbol.

  • If you activate the optimal floor price, the system sets the floor price automatically, basing on collected statistics about placement. You can leave the Floor Price (CPM) field empty. To set the minimal price for the optimal price floor, you'll need to fill in the Floor Price (CPM) field first and then turn Optimal Floor Price setting to ON.
  • Blocked Ad Types — you can choose to block unwanted ad types (for example, iframe and XHTML Text Ad).
  • Blocked Placement Attributes — ads can be blocked by specific attributes selected from the list.
  • Back fill / Passback tag — an optional tag to use in case the placement is not filled by our service.

Adding a Video Placement

Fill in the fields:

Common fields which are the same as for Banner ad:

  • Placement Name
  • Position — you can specify the position of your placement on the page.
  • Floor Price (CPM) and Optimal Floor Price— set your minimal floor price for one thousand impressions manually or let us determine the optimal floor price for the placement dynamically.
    Note: placement fill rate may decrease in case the Floor Price (CPM) is too high.

You can set a different floor price for different countries. To do so, click on the planet image in 'Floor price' field. In the pop-up window, click on Country field and select countries, then set a floor price for them and click 'Done'. Repeat that consequence for each set of countries with a different floor price and click 'Save' after finished.

To remove an existing set of countries, click the red cross at that set.
To add the new set of countries, click the ‘+’ symbol.

If you activate the optimal floor price, the system set the floor price automatically, basing on collected statistics about placement. You can leave the Floor Price (CPM) field empty. To set the minimum price for the optimal price floor, you'll need to fill in the Floor Price (CPM) field first and then turn the Optimal Floor Price setting to ON.

  • Blocked Placement Attributes — ads can be blocked by specific attributes selected from the list.

There’re also several specific fields:

  • Video Linearity — In-Stream (inside your video player) or Out-Stream (placed within non-video content).
  • Video Start Delay (for linear video) — the ad can appear before (pre-roll) or during (mid-roll) a piece of video content. For mid-roll, you can specify the exact Start Delay In Seconds in the corresponding field. You can also select generic pre-roll and generic mid-roll.
  • Placing (for non-linear video) — the type of content in which the video will be placed.
  • Playback Methods — choose how to initiate video playback. Depending on this setting, the ad can be played automatically with sound on or off, played on user click or on mouse-over.
  • Allow Skip, Skip Delay — if you set skip to YES, after a specified delay a skip button to end playback will be displayed to a user.
  • Serve ads via API(VPAID) link (for non-linear video) — if you choose this option, you will need to embed generated API link into the player's ad-serving interface and replace its macros with actual values.
  • Supported MIME Types (for linear video and VPAID non-linear video) — choose video format types supported by your player.

Adding a Native Placement

Fill in the fields:

Fill in the following inputs: 

  • Placement Name
  • Width and Height
  • Floor Price (CPM) and Optimal Floor Price— set your minimal floor price for one thousand impressions manually or let us determine the optimal floor price for the placement dynamically.
    Note: placement fill rate may decrease in case the Floor Price (CPM) is too high.

You can set a different floor price for different countries. To do so, click on the planet image in 'Floor price' field. In the pop-up window, click on Country field and select countries, then set a floor price for them and click 'Done'. Repeat that consequence for each set of countries with a different floor price and click 'Save' after finished.

To remove an existing set of countries, click the red cross at that set.
To add the new set of countries, click the ‘+’ symbol.

If you activate the optimal floor price, the system set the floor price automatically, basing on collected statistics about placement. You can leave the Floor Price (CPM) field empty. To set the minimum price for the optimal price floor, you'll need to fill in the Floor Price (CPM) field first and then turn the Optimal Floor Price setting to ON.

  • Ad Title / Title Length — set length of title or disable this option.
  • Ad Data — set the Data Asset Types available for the placement.
    Available Data Asset Types:
    • Sponsored
    • Desc
    • Rating
    • Likes
    • Downloads
    • Price
    • Saleprice
    • Phone
    • Address
    • Desc2
    • Displayurl
    • Ctatext
  • Ad Image / Image Type — set the type of image you allow.
  • Ad Environment — select preferred environment: Content-centric context, Social-centric context, or Product context.
  • Advanced Ad Settings — select type of content you prefer for placement.
  • Ad Unit Options — select option (In the feed of content, In the atomic unit of the content, Outside the core content, or Recommendation widget)..

Click 'Set self ID's for elements' if you want to receive more information about how users interact with elements selected at Data Asset Type.

How to manage placements

After you added placements, you will see it in the list of inventories:


Here you can see general information on each placement: its name, icon of type, size (for banner and native) or type (for video placement), status (active or not active), its price settings (the icon to the right of the price shows whether the Floor Price by Country or Optimal Floor Price is activated).
There is also a block of Actions for each placement, which allows you to get the link for GDPR consent storage, get tags, edit placement and deactivate or activate placement:

Click the <G> button to get the consent storage link (a filled in macros). Drop it into the script eliciting user consent on the site.

How to use placement tags

 

Placement tag

Publishers can use placement tag to natively integrate with SSP platforms.
To use placement tag:

  1. Create a placement. Tags for this placement will be created automatically.
  2. Click on the tag symbol   in Actions block for that placement.
  3. Copy a tag and paste it to the site code into the body container (<body>...</body>).

For example, use this code in the 'Native' tab to integrate with SSP:

There may be other tabs to integrate with other platforms, such as DFP, Mopub, etc

Mediation tag

Mediation tag is the instrument that allows publishers to fill ad request in case it wasn’t filled by SDK or ad server.
To use mediation tag:

  1. Create a placement. Tags for this placement will be created automatically.
  2. Click on tag symbol   in Actions buttons block for that placement.
  3. Copy needed tag. Use it to get ads from a third-party auction.

For example, if you have created the app on Mopub platform, copy such code from the corresponding tab:

Then update your app on Mopub as guided in following instruction: MoPub.
To integrate with other services, use instructions: 
AerServ
IronSrc
DoubleClick for Publishers: DFP iOS, DFP Android.

 

Private Marketplace Deals

To sell your placements in the private marketplace auction, you can use Deals feature. To get started, open Deals section and fill the new deal fields. If some deals are already created, click "+" button to add a new deal.

Set the title, floor price, placement, type of auction, and the estimated impressions count and revenue ($). The deal will be assigned a unique hash id.

When your estimates are exceeded, the deal will be turned off automatically, and the deal placement will go to open exchange with second price auction.

Adding Billing information

To receive revenue, you will need to fill in your cashout information. In the navigation bar, click Cashout link in Billing menu. On the Cashout Settings page, you can set automatic cashout to get your revenue automatically each month.

You can choose between PayPal and Wire Transfer cashout options in 'Default cashout method' area.

To set cashout via PayPal, fill in PayPal Email (required field). To set cashout via Wire Transfer, you have to fill in all fields on the page, including routing number (which depends on your region) and account number (International Bank Account Number).

Your revenue will be available for cashout when it reaches $50.00 for PayPal, or $100.00 for Wire Transfer. Money will be withdrawn automatically each month (unless you choose to freeze cashout).

You can see your balance and the date, and amount of money to be withdrawn in your Dashboard.

For the detailed statistics on your earn and cashout, check out your transactions in Billing->Transaction History.

Viewing Report

Report is a handy way of presenting data with charts and numbers that reflect your inventory performance and revenue. Click Report in the navigation menu.

Click on date range to set date range for your report manually or select available date range: Today, Last 7 Days, Last 30 Days, This Month, or Lifetime. On the left side you can choose the type of view of report: by date, inventory, placement, countries (shown on map) or view suspicious-looking requests. Below the graph you can see table view of report data. You can export this data to email or download it in XLS, XLSX, PDF or CSV formats.

Click Inventory, Placement, Deal, or Geo tab in the sidebar on the left to view the charts by inventory, placement or deal, or grouped by country. You can also see the information about suspicious-looking requests in the corresponding tab.