DSP Guide (Getting Started)
Make your first payment
Billing is the starting page for the new account. Make a deposit to get access to all SmartyAds DSP functionality.
Note: transaction may take some time
After fulfillment you will be able to browse across sections using section tabs:
View Financial Activity
You can see your current balance in the upper right corner, next to your profile link.
To view detailed balance information, select 'Billing' in 'Billing' drop-down menu:
Here you can:
- View your Balance
- Set automated email notification when Balance reaches certain amount
- Deposit money to continue ad serving using the convenient payment method.
Here you can view your invoicing history on two tabs:
Deposit activity tab contains all your deposits by months. Open Transactions activity to view your monthly account statements which contains all transactions (traffic payments, deposits). Using download icon in the right corner of the table you can download or print the file.
To take a detailed view on your Transactions, select 'Transaction History' on 'Billing' drop-down menu.
Here you can view your Deposit and Daily Spend transactions. Select the date range, Transaction type (Deposit Funds, CashOut, Ad Campaigns Daily Spend, Daily Earn) and click 'Search' button to view the data.
To print the invoice, click on 'sheet' symbol:
After you made your first deposit, you will see the Dashboard section:
The Dashboard represents summary information on your campaigns and creatives results, impressions and wins, your spent and current balance.
After you've started work, the Dashboard will start filling with information for the period selected in the upper right corner:
Impressions is the number shows how many times users have seen your creatives. Dashboard also shows the number of impressions for the previous period and makes forecast to the next such period.
Average Winrate shows the number of impressions won over the number of impressions bid, for current and previous period.
Spend is the sum of money you have spent to show your creatives. There is also the sum of spend for the previous period and the forecast for the next period.
Your Balance shows the sum of money on your account at the current moment. You can click 'Deposit Funds' to open the Billing section and make the new deposit. You can also click Transaction History to view the history of deposits and expenses.
Campaigns Activity shows a numbers of impressions and spend of your top 5 campaigns. You can click on magnifying glass to view the report on certain campaign for the selected period.
Creatives Activity shows a numbers of impressions and spend of your top 5 creatives. You can click on magnifying glass to view the report on certain creative for the selected period.
Create Basic Campaign
To start getting traffic and attracting users to your product, create a new campaign. Select 'Add Campaign' in 'Campaigns' drop-down menu and click the “Add campaign” button.
or open the Dashboard section and click 'Add Campaign' button:
Then follow the creation steps below.
Note: To create a CTV campaign, follow steps as for basic campaign, add video creatives and then contact the system administrator to enable CTV traffic in the campaign settings.
Note: To learn how to create a Retargeting campaign, read a separate article.
Step 1. Enter Basic Details
On a new Campaign page, fill out the form with information about your campaign:
- Campaign Name
- Campaign type (basic or retargeting campaign)
Note: Read a separate article to learn more about retargeting and how to use it.
- Start and End dates of the campaign
- Max Impressions that would be shown before the bid stops (at least 150000)
- Daily Impressions Cap — maximum quantity of daily impressions (higher than 150000, or 0 if no daily limit needed)
- Campaign Budget and Daily Budget Cap – maximum spend for the whole campaign and daily spend (minimum of $70 for campaign, minimum of $70 daily spend, or 0 if no daily spend limit needed)
Step 2. Set Targeting Options
Specify targeting options to show your ads to the right people: include or exclude categories by IAB standard, countries, cities etc. These settings define requirements which user have to meet to see campaign creatives.
You can apply Filter list to filter traffic by detailed parameters, such as domains, application names, user IPs, etc.
See 'Set Filter Lists' section to know more about filter lists.
If necessary, you can add time targeting to select time periods over day and week for your campaign. Click 'Add Time Targeting' to open the time/day scale. Then click on its field to create serving periods and fill the entire week as you need. Note: To fill or clear entire day, click on its row title. To fill or clear a certain hour for all days, click on its column heading.
You can also set location targeting. To do so, click 'Add Locations (GPS)', so location selection form will be opened:
You can set location targeting by using a map or specifying covering parameters manually.
To create a targeting area, click on the map or click '+' button on the left side of the window.
To move targeting area, specify its GPS latitude and longitude (in degrees) and click icon, or drag and drop circle on the map, holding it by the white point in its center.
To resize covering area, set its radius in kilometers and click icon, or pull the white point on the perimeter of the circle.
Create such circles until you cover the entire area you want to target.
Click 'Submit' after finishing.
To complete campaign creation, click 'Create Campaign' button. After campaign saved, you will be automatically redirected to add the first creative in it. Find out how to configure creative at Step 3. You can change campaign settings later, simply click the name of the campaign.
Also at Campaigns page, you can view all your campaigns and all data about them, such as Impressions/Spend limits, Budget etc. To change fields displayed, click 'Gear' button in the right upper corner and select fields.
Step 3. Add Creatives for Your Campaign
After the campaign created, you will be redirected to add the creative. There are also few ways to add new creative: open campaigns creative list (click on a number in the ‘Creatives’ column) and click 'Add creative', or open campaigns list and click ‘+’ on the campaign:
On the creative page, you must set parameters to define which users will see your ad. For example, if you set only 'mobile web' traffic type and 'smartphone' device type, then the ad will be seen only by smartphone users who use a web browser. Tablet or desktop users, and smartphone users who use application will not see the ad.
Set common parameters (for any type of creative)
- Enter a creative name.
- Set Media Type (Banner Ad, In-Banner Video Ad, Native Ad or Video Pre-Roll).
Banner Ad is a simple image, static or animated.
In-Banner Video Ad is a video delivered as part of the display ad creative for a given placement rather than initiating the use of a video player.
Native Ad is an advertising content which integrates to the platform in such way that matches the form, feel and function of the content of the media on which it appears, so it is not distinct from the rest of the material presented there.
Video Pre-Roll is the In-Stream video content played before the streaming video content that the consumer has requested.
- Specify Traffic types (Desktop, In App, or Mobile Web) the ad will be shown on.
Desktop ads will be displayed in web browsers on laptops, PCs etc.
In App ads will be displayed in applications on mobile devices.
Mobile Web ads will be displayed in web browsers running on mobile devices, such as smartphones or tablets.
- Specify Mobile Device types (Smartphone or Tablet) on which you prefer to show your creative. This option is available only when In App or Mobile Web traffic allowed.
- Set CPM – cost per thousand impressions.
NOTE: Minimal allowed Bid Amount differs for different types of creative:
- $0.5 for Banner Ad and In-Banner Video Ad
- $0.7 for Native Ad
- for Pre-roll Video Ad it depends on size: $3 for small size, $5 for medium, and $7 for large size.
- Set Frequency in last 24 hours to specify how many times unique user can see creative in 24 hours. User uniqueness can be defined by IP or user agent.
- Select Connection Type to set which type of connection user must have to see creative.
- Select cellular Carrier if needed. Start typing its name to search for it.
- Set Ad Tag for creative (all creative types except Native Ad). If you already have ad tag, put it into Ad Tag field, so you can see the creative preview.
Note: Only valid tags will show up in preview. Show up of third-party tags depends on targeting.
Note: The xml tag must begin with xml version info and encoding format:
<?xml version="1.0" encoding="UTF-8" ?>
For banner and native creatives you can add an image from Creative Library (read below).
You can also add macros to your creative tag. Macro is built-in tracking variables you can use to specify additional parameters and details provided with tag.
Note: Macros allow tracking information on advertiser side. This information will not be available in reports on DSP side.
Click ‘Tag macro list’ to see all available macros. Choose parameters you need and add it to tag manually.
Note: You can only use macros from Tag macro list. Macro is case sensitive.
[HASH] — Unique Identifier
[CB] — Random Unique String
[SUB_ID] — Request ID
[SITE_APP_ID] — Site ID / Application ID
[SITE_DOMAIN_APP_NAME] — Site Domain / Application Name
[SITE_NAME] — Site Name
[SITE_APP_URL] — Full Site URL / Application Store URL
[APP_BUNDLE] — Application Bundle Name
[PUBLISHER_ID] — Publisher ID
[SOURCE_ID] — Source ID (SSP Partner)
[USER_ID] — User ID
[ADVERTISER_ID] — Advertiser ID
[CAMPAIGN_ID] — Campaign ID
[CREATIVE_ID] — Creative ID
[IAB_CAT] — Site / Application Сategory
[WIDTH] — Placement Width
[HEIGHT] — Placement Height
[GEO_LAT] — User's Latitude
[GEO_LON] — User's Longitude
[COUNTRY] — User's Country
[CITY] — User's City
[IFA] — User's Device IFA. (For Android and iOS devices)
[IP] — User's IP Address
[USER_AGENT] — User's Browser Agent
[CARRIER] — Carrier
[OS] — User's Operation System
[OSV] — User's Operation System Version
[BROWSER] — User's Browser
[BROWSER_VER] — User's Browser Version
[DATE_TIME] — Date in Format Y-M-D H:M:S
[PAGE_URL] - page site
For example, tag with PUBLISHER_ID and IAB_CAT macros:
You can use the Creative Library to store images and use them in your creatives.
- Open Campaigns->Creative Library. Click ‘+’ to add a new directory, if necessary.
- Click ‘Upload’ button (marked on image) to upload a new image.
- Set reference URL. This URL will be set in a href=”...” part of ad tag, and user will be redirected to that URL after click on ad.
- Set Alter Text to display if an image does not appear to the user.
- Click ‘Add files’ and select images to upload. Then click ‘Start upload’.
- After image uploaded, open creative and select image. Ad Tag will be created automatically.
Set additional parameters (for specific creative types)
Additional parameters for Banner Ad
- Choose one of the IAB standard sizes.
Note: Popular banner sizes, for example: 300*250, 728*90, 300*600. Standard-sized creatives usually get more wins and impressions than custom-sized creatives.
- If you already have Ad Tag for this creative — specify it in Ad Tag field.
If not, select image from Creative Library — Ad Tag will be created automatically.
- Specify the Landing Page TLD [top level domain]. Landing Page TLD [top level domain] is intended for SSPs and is not related to Ad Tag URL. When choosing creative from the library, its Reference URL top level domain will be automatically set as Landing Page TLD and can be changed manually.
Additional parameters for In-Banner Video Ad
- Activate Booster if needed. Booster is a tool to increase fillrate. The booster analyzes the previous placements on sites and optimizes future placements. Maximum CPF (Cost Per Fill) - maximum cost for one thousand fills you are ready to spend. Minimum FTR (Fill Through Rate) - minimal cost you are ready to spend to train Booster to increase fills number.
Note: It is not recommended for Maximum CPF to set small amounts such as 0,3 or less. For Minimum FTR, it is better to set a smaller amount at the beginning. Usually, it is effective to set as 1% of Maximum CPF.
Maximum CPF must be at least 0.005. Minimum FTP must be at least 0.05.
Note: Booster need some amount of time to optimize your campaign, usually it is about hours to days.
- Choose one of the IAB standard sizes.
- Specify the Landing Page TLD [top level domain]. Landing Page TLD [top level domain] is intended for SSPs and is not related to Ad Tag URL. When choosing creative from library, its Reference URL top level domain will be automatically set as Landing Page TLD and can be changed manually.
Additional parameters for Native Ad
- Set Native Rating – a number from 0 to 5 that represents the average rating of the app in a store.
- Set Native Cta Text – call-to-action text, describing a ‘call to action’ button for the destination URL. For example, 'Learn more' or 'Download'. Not longer than 20 characters.
- Set Headline text – a title, short descriptive text associated with the product or service being advertised. Not longer than 50 characters (mandatory field).
- Set Description – an additional descriptive text associated with the product or service being advertised, not longer than 99 characters (mandatory field).
- Set Sponsored Text – note of fact that what user seeing is advertising (mandatory field), not longer than 25 characters (mandatory field). For example, ‘Sponsored by Our Company’.
- Select Icon Image and Main Image from Creative Library. It can not be the same size images. Main Image is mandatory.
- Specify URL to which the user will be redirected after click on ad. You can also add macro to URL (like macros in Ad Tag for other types of creatives).
For example, URL with PUBLISHER_ID and IAB_CAT macros:
Additional parameters for Pre-roll Video Ad:
- Set Protocol – VAST, or DAAST. It must be the same protocol as specified in tag. Field is mandatory.
- Set duration of creative in seconds (more than 0, mandatory field).
- Specify the Landing Page TLD [top level domain]. Landing Page TLD [top level domain] is intended for SSPs and is not related to Ad Tag URL. When choosing creative from library, its Reference URL top level domain will be automatically set as Landing Page TLD and can be changed manually. This field is mandatory.
- Activate Booster if needed. Booster is a tool to increase fillrate. The booster analyzes the previous placements on sites and optimizes future placements.
Maximum CPF (Cost Per Fill) - maximum cost for one thousand fills you are ready to spent. Minimum FTR (Fill Through Rate) - minimal cost you are ready to spent to train Booster to increase fills number.
Note: It is not recommended for Maximum CPF to set small amounts such as 0,3 or less. For Minimum FTR, it is better to set a smaller amount at the beginning. Usually it is effective to set as 1% of Maximum CPF.
Note: Booster need some amount of time to optimize your campaign, usually it is about hours to days.
After configuring creative is finished, click 'Save Changes'. After changes saved, you will be automatically redirected to Creatives page where you can view all your creatives and all data about it (Bids, Impressions, Spend, Win Rate etc.).
You can easily change creative settings by clicking 'Gear' button beside its name (button pictured as gearwheel and visible when the cursor is over the field):
You can also perform actions to several creatives at a time. Select checkboxes in the first column for creatives you need to duplicate, start or stop, hover mouse over 'Actions' button and click on action you want to take: Duplicate, Start Selected or Stop Selected.
Note: When you add a new or change existing creatives, they will be waiting for approval; usually it takes two hours to scan the tags. If everything is okay with tags, campaign will start. To view creatives of certain campaign, click on the number of creatives on the campaigns list:
On the campaigns list page you can also perform actions to several campaigns. Select campaigns, hover mouse over 'Actions' button and click on action you want to take: Archive, Duplicate, Start Selected or Stop Selected. Note: Archived campaigns cannot be de-archived but can be copied to 'restore' such campaign.
Step 4. Set Filter Lists
You may create white or black lists for your campaigns. It allows excluding irrelevant domains, publishers, devices etc in the blacklist or target the ads only on certain domains, publishers, sites, apps etc described by the whitelist.
Note: You may create any number of lists, but only one blacklist or only one whitelist can be applied to a campaign at a time. Note: Filter list is not black or white by itself, it just contains conditions to filter by. It becomes black or white for each campaign separately, depending of how we apply it to campaign – so list may filter traffic out or let it go through. One filter list can be white list for one campaign and black list for another campaign.
To create a Filter List, select 'Filter List Manager' in Campaigns tab:
And then click 'Create Filter List' button.
On Create Filter List page, set the list name and add conditions to filter, for example site domains or IP addresses, each from the new line.
After finished configuring Filter List, click 'Create' button to proceed.
To edit existing filter list, open Filter Lists and click on its name, or click (‘magnifying glass’) in the Action column:
Note: You can export the content of the filter list. Click 'Export All' to export all categories that filter list contains (in this case categories will be downloaded as single Excel file with each category on separate worksheet). Hover mouse over arrow button and click on category at the drop-down list to export only list with conditions of that category:
The existing filter list page differs from the new filter list page, as filter categories are displayed on separate tabs. You can switch between tabs with different filter categories. To add an item to filter, click ‘+’ on the corresponding tab:
To remove a certain row, click ‘x’ symbol beside row (symbol appears as a mouse is hover over that row):
Then confirm deletion:
To apply Whitelist or Blacklist to campaign, open campaign, set the type of the list (White or Black), and select the list:
To disable filter-list, click 'Make choice' in drop-down list.
Note: System requires some time to apply new or updated filter list to campaign. Wait about 15 minutes after applying filter list, and then run the campaign.
Warning: pay attention to campaign targeting settings and filter lists. Try not to make it contradictory. For example, if you set only 'In App' traffic in campaign settings and then applied white filter list which allows traffic only from certain sites, you will get no traffic.
Conversion tracking is a tool that shows you what happens after a customer interacts with your ads whether they purchased a product, signed up for your newsletter, called your business, or downloaded your app. When a customer completes an action that you've defined as valuable, these customer actions are called conversions. Conversion Tracking enables you to use optimized cost per impressions (oCPM) and show ads to people who are more likely to convert at the most efficient bid possible.
Conversion tracking have 2 methods:
- Postback - is the method of tracking conversions that uses the advertiser’s server rather than the user’s browser (as pixel-based tracking does).
Postback is more complex to implement and however more flexible and easier to troubleshoot.
Use postback when you have resources to do it.
How to set up Conversion Pixel
Conversion tracking pixel serves to calculate events that have been created by advertisers in their adm tag in creative for unique user. Unique user will be defined by ip address. Here's how you can add a conversion pixel to your site:
- Open Campaigns and click on Conversions and Postback Endpoints.
- Click ‘Add Conversion Pixel’. Set its name and click ‘Save’.
- Copy conversion pixel script from CODE field. Add the script to your website page, button or another elements. Set it up to be triggered when a user performs a target action — for example, clicks a button to submit an order on your website.
When your ad impression is registered, DSP saves the information about this impression to user's cookie. This hash will be used to count this creative conversion when user performs actions to elements with conversion pixel. You will see the conversion in the reports:
How to set up Postback
- Add [HASH] macro to your creative tag.
- Open Campaigns->Conversion Pixels and Postback Endpoints section. Select ‘Postback Endpoint List’ and create new Postback Endpoint.
- Copy conversion pixel script from CODE field.
- Configure your Ad Server to send request to DSP after conversion has been tracked. Request must contain code that you have in Code field of Postback Endpoint with [clickid] being substituted by hash.
To keep noticed of how your campaigns going, you can use alerts.
You can see your alerts on the Alerts page. Hover mouse over your profile link and click 'My Alerts':
Here you can see your alerts and its main parameters, such as status, campaigns to check, condition, granularity, recipients to be notified, and a label which indicates if campaigns will be stopped:
There is two ways to create an alert:
- Click 'Add an Alert' on the Alerts page.
- Open the Report page, click on bell symbol in the upper right corner of the graph, below the date range.
On the new alert page, set its parameters:
Set the Name for the alert.
Set the Granularity – alert will be activated if conditions within that period will be triggered. Set specific campaign or all campaigns to check.
Set Conditions which alert have to check – parameter and its value to check. Click ‘Add condition’ if you want to add condition.
You can select Stop campaigns if you previously selected specific campaign and want to stop it when alert triggered.
Type Additional recipients email addresses separated by comma, if you want to notify them too. Once alert being triggered, you (and additional recipients) will get notification on email.
Get a Report
Select 'Reports' section on the navigation panel to see your statistics.
Here you can see the dynamics of the results of your campaigns throughout a period of time: How much impressions and conversions did you get; how eCPM changed during that period; how much did you spent. You can group results by day or by hour. Use switcher in the left upper corner to do so.
You can switch between impressions, conversions, eCPM or spend graphs by clicking tabs under the graph:
You can select date range: Today, Yesterday, This week, Last week, Last month, MTD (Month-to-date) or set up custom range in upper right corner of Reports page.
Currently selected date range are displayed in the upper right corner, like Mar 18 - Apr 2 To set custom date range, click on current date range. In calendar opened, select start and end date and click Apply:
Below graph view, you can see statistic in table view. By default it shows Impressions, Conversions, eCPM and Spend with grouping by day/hour:
You can add columns to display. Click on Gear button in the upper right corner, select columns and click Save:
You can also set number of records per page.
You can add grouping field: Campaign, Creative, Country, Connection, Type, Carrier, Device OS, Domain/App Name, Site ID/App ID and Publisher ID. To do this, click ‘Add Group Field’, select fields and click Apply:
You can select specific values for grouping fields. Click on grouping field name, select values and click Apply:
To delete grouping fields, click ‘x’ symbol beside grouping column name and click Apply:
You can export files with statistics in Excel, ODF, or CSV formats. Hover mouse over ‘Export’ button and click on preferred file format. File will be downloaded to your computer.