You can run direct-sold campaigns that bid against networks for impressions in real time to help maximize revenue. Control the delivery of your direct campaigns with capping and pacing settings.
Direct deals support rewarded video, interstitial, banner footer, and MREC ad units.
Prerequisites
Before you begin, to enable direct deals in your account, contact support or contact your account manager.
Activate direct deals
- Sign in to your ironSource account and go to LevelPlay > Setup > SDK Networks.
- Select Activate on Direct Deals within the Available Networks list.
- Select Setup for the applications you want your direct campaigns to deliver on.
Set up your campaign
- In the left navigation menu, select Direct Deals.
- Select Create New Campaign.
- Complete the following fields:
- Status: Mark as active or inactive.
- Open Measurement: Enable if your advertiser requires Open Measurement scanning.
- Name: Enter a name for your campaign.
- CPM: Enter the predefined eCPM for the campaign, as agreed upon with the advertiser. The higher the rate, the higher in priority the campaign will be in the waterfall.
- Tag Type: Choose between VAST, Hosted Video, Hosted Banner, and MRAID.
- VAST
- Tag URL: Enter the VAST tag URL.
- For a list of supported macros, refer to the List of supported macros section later in this article.
- Every special character that is not alphanumeric in the values after the query string should be URL encoded, not including the macros placeholders. For example: https://vast.demo.com/ads?reqType=Ads%20%Setup&user\_agent=\[UA\]&ip=\[IP\]&width=\[WIDTH\]&height=\[HEIGHT\]&aid=\[IFA\]×tamp=\[CB\].
- Supported versions: VAST 2, VAST 3
- Tag URL: Enter the VAST tag URL.
- Hosted Video
- Video:
- Video Type: MP4
- Maximum size: 50 MB
- Dimensions: 16:9
- Recommended length: up to 30 seconds
- End Card:
- Image Type: JPG, PNG
- Maximum size: 5 MB
- If you don't upload a background image for the end card, the last frame of the video will serve as an end card.
- Click Through URL: Enter a link to drive the user to install the app when clicking on the end card. We recommend inserting either:
- App Store URL: you can track impressions, completions, and clicks, to be sent directly to your server.
- Tracking URL: you can track impressions, completions, clicks and installs with a third party tracking solution, to be sent directly to your server.
- Video:
- Hosted Banner (banner footer or MREC ad units)
- Image:
- File Type: JPG, PNG
- Maximum size: 5 MB
- Click Through URL: Enter a link to drive the user to install the app when clicking on the ad. We recommend inserting either:
- Creative size:
- Banner: the creative will be optimized according to 320x50 pixels.
- MREC: MREC is served within a full-screen interstitial, with black bars added.
- Image:
- MRAID
- Creative - must contain the string ‘mraid.js' for our MRAID validation, for example like this
<!--mraid.js\-->
- Duration (seconds): Recommended length up to 30 seconds
- Supported versions: MRAID 1.0, MRAID 2.0
- Creative - must contain the string ‘mraid.js' for our MRAID validation, for example like this
- VAST
- Ensure that you activate your ad unit on the SDK Networks page for the applications you want your direct campaigns to deliver on.
Tracking events
You can track multiple events, such as impressions and completions, to be sent directly to your server.
Delivery policy
You can limit or regulate a campaign's delivery on the impressions or completion level.
- Total Cap: Set a lifetime limit for the number of impressions/completions of the campaign
- Daily Cap: Set a daily limit for the total number of impressions/completions of the campaign
- Pacing: Deliver as fast as possible / Deliver daily cap evenly / Deliver total cap evenly
- User Daily Cap: Set a daily limit for the total number of impressions/completions of the campaign, per user
- User Lifetime Cap: Set a lifetime limit for the number of impressions/completions of the campaign, per user
Date and time
- Duration: Determine the time zone and start/end dates of the campaign.
- Week Parting Enabled: Optional. To set specific time slots for each day or week for the campaign to run, you can select these here (for example, only evenings or only weekends). Green selection signifies the active time slots.
Targeting
The following list details the available targeting criteria:
- Ad Unit
- Application
- Bundle ID
- City
- Country
- State
- Region
- Device ID List - by uploading a .csv or .txt file of device IDs
- IP List - by uploading a .csv or .txt file of IPs
- US ZIP code
- Segments (pre defined in the ‘Segments' section in the platform)
Reporting
There's a dedicated Imply dashboard for direct deal campaigns: https://analytics-rtp.is.com/pivot/home.
- Search for your campaign by name or ID, or by other dimensions.
- Request metric: all requests that match the same targeting. Note that this doesn't mean your campaign specifically received all the requests.
- Fulfilments metric: valid responses from the campaign.
Create a report
To create a report, complete the following steps:
- Selecting the More (...) menu in the upper right and then select Schedule report.
- Complete the report details:
- Name: Enter a name for your report
- Time Zone: Choose a timezone
- Delivery: Choose on which frequency, day of week and time the report will be delivered
- Reporting content: Select this by setting up the needed imply view under View
- In upper right corner, select Continue.
- Select Delivery options in the lower right corner.
- Add recipients and select their permissions: view or edit.
- Select how to deliver the report (for example: email, file, format).
You can review and edit reports under the Reports tab.
To change settings, select the More (...) menu to the right of each report.
List of supported macros
Macro | Parameter |
---|---|
[CB] | cachebreaker |
[WIDTH] | width |
[HEIGHT] | height |
[DO_NOT_TRACK] | dnt (1-True / 0- False) |
[SUB_ID] | sub_id |
[USER_LAT] | latitude |
[USER_LON] | longitude |
[PAGE_URL] | Pageurl/URL |
[DOMAIN] [DDOMAIN] - The detected domain [DPAGE_URL] - The detected page URL | domain |
[UA] | useragent/ua |
[IP] | ip address/ip |
[BUNDLE_ID] | bundleid |
[APP_NAME] | appname |
[IFA] | IDFA/IFA idfa/ifa (iOS device ID) |
[IFA] | GAID/AID (Android device ID) |
[USER_CONSENT] | user_consent (consent boolean will be replaced with a TCF string when received from the device) |
[GDPR] | gdpr |
[APP_STORE_URL] | app_store_url |
[APP_CATEGORY] | app_category |
[IFV] | identifier for vendors |