Supply

In the “Supply” section, you can access and use the following key features:

  1. Create, browse and edit ad placements, switch them on/off
  2. Assign, browse and edit assigned demand, switch it on/off
  3. Access ad placement codes
  4. Track ad placement performance within the past 24 hours.

Let’s dive in into each in more details.

Create a New Ad Placement

To create a new ad placement:

1. Select a publisher from the list on the left.
2. Click a blue “+” button.
3. Configure ad placement settings (see Ad Placement Configuration Reference).
4. Finish adding a placement by clicking “Create.”

Ad Placement Configuration Reference

The AdPlayer.Pro ad placement configuration reference enlists options for configuring ad placement settings, including the ad format, player size & layout, playback behavior, and more.
 
Basic Settings
 

Parameter Description Value
Name The assigned ad placement name. string
ID Added automatically.

A unique ID attributed to an ad placement upon its creation.

string
Format Configures the video ad format:

  1.    Outstream:
      – InPage
      – InView
      – InBanner
      – Rewarded
  2.    InStream

Select one of the options from the drop-down menu.

InPage
InView
InBanner
Rewarded
InStream
Fixed player size Сonfigures the player width and height:

  1. Width – in pixels or as a parent element percentage
  2. Height – in pixels

*If aspect ratio is configured – ONLY responsive player size applied (i.e. width MUST be configured as percentage, height – NOT applied).

number(number%) / number
Responsive player Сonfigures the responsive player size and aspect ratio (see below):

  1. Width – [optional] as percentage
  2. Height – NOT applied
number% / –
Aspect Ratio ONLY applied for responsive player.

Configures proportions between the player width and height, if the width is configured as percentage.

Add manually, in the following format: x:y, where:

  1. x refers to the player width,
  2. y refers to the player height.
x:y
Sticky Sticky – applied for InPage ad format.

Implies the player sticks to the viewable area of the page on article/page scroll.

true/false
Position Required for InView, Sticky

Configures the player position – on top or bottom of the page:

  1. Top right (TR)
  2. Top left (TL)
  3. Top center (TC)
  4. Bottom right (BR)
  5. Bottom left (BL)
  6. Bottom center (BC)

Select one of the options from the drop-down menu.

TR/TL/TC
BR/BL/BC
Sticky width ONLY applied for Sticky
Specifies the Sticky player width in pixels.
number
Sticky height ONLY applied for Sticky
Specifies the Sticky player height in pixels.
number
Autostart Configures whether the player attempts to begin playback automatically on pageload or not. true/false
Muted Configures whether the player is muted during playback start or not. true/false
Sound by hover Configures the sound switch-on on hover.

NB! Doesn’t work on mobile web.

IF autoplay is ON: doesn’t work in Chrome v. 65 or higher, Safari.

true/false
Tap to unmute Configures the “Tap to Unmute” button display. true/false
Skip button with delay Сonfigures whether the “Skip” button is added during ad playback or not, and its delay in seconds.

NB! The countdown starts on player display and pauses on pausing ad content.

true/false
number,
≥ 0
Close button with delay Configures whether the “Close ad” (“X”) button is added during ad playback or not.

Delay: ONLY for outstream ad formats, except InBanner ads.

Configures delay (in seconds) before the “Close ad” (“X”) button display.

NB! The countdown starts on player display and doesn’t pause on pausing ad content.

true/false
number,
≥ 0
Ad Break Schedule: Optional.

ONLY applicable for InStream format.

Format Configures the video ad format for the scheduled ad break/s:

  1. Pre-Roll
  2. Mid-Roll
  3. Post-Roll

Tip! Check one or more boxes to schedule one or multiple ad breaks, accordingly.

true/false

If true:
Pre-Roll/
Mid-Roll/
Post-Roll/
Pre-roll + Mid-Roll/
Pre-roll + Post-Roll/
Mid-Roll + Post-Roll/
Pre-roll + Mid-Roll + Post+Roll

Seconds into video ONLY applicable for Mid-Roll ad breaks.

Configures timing in the video (in seconds), where the ad break is scheduled to occur.

number
% of video ONLY applicable for Mid-Roll ad breaks.

Configures timing in the video (in % of the video), where the ad break is scheduled to occur.

number%

 
Advanced Settings
 

Optional.

Parameter Description Value

Video Content

Video file/URL Configures the video content (a hosted video file or a direct URL to the file), selected for playing upon ad completion​, i.e.

  1. on-demand webcasting (MP4 video file), or
  2. live streaming (MPEG-DASH or HLS).

URL Examples:

  1. MP4 file: https://example.com/video/1.mp4
  2. HLS video: https://example.com/video/2.m3u8
  3. MPEG-DASH video: https://example.com/video/3.mpd
string
Force video content Optional.

ONLY applicable for outstream ad formats.
Configures the switch-on of video content playback – regardless of the ad response.

true/false
Passback ONLY applicable for outstream ad formats.

Configures the default tag (banner, image tag, etc.), applied in case of the following:
1) IF no video content URL added, when no video ad tag was processed (due to ad error, or else).
2) IF no video ad tags were added/switched on.

string (HTML)
Insert after Optional. ONLY for InPage, InView and InBanner formats.

Configures ad placement insertion after a defined webpage element without modifying the page source code.

Example:

document.querySelectorAll('#myId')[0]
query selector
CSS Margins Optional.

ONLY applied for InPage ad format. NOT applicable for the Sticky player mode.

Configures the margin area for the InPage ad placement on all four sides – i.e. top, right, bottom and left.

Tip! Follow the instructions in your account dashboard or read more on how to apply advanced CSS margin settings here.

string
Lifecycle loop Configures the player loop: i.e. the number of player lifecycles in a loop (in addition to the 1st player lifecycle).

Enter the number or leave blank to keep the player loop OFF.

Enter “true” to switch on the infinite player loop.

true/false
number,
> 0
Show & Play ONLY for InPage and InBanner formats.

InPage – both Show & Play parameters are required.

InBanner – only the Play parameter is required.

Configures the player part in-view (in %), required to show the player and launch the video ad content.

number
Progress bar color Optional.

Сonfigures ad progress bar color.

Click the “Color” square to select the color from a color scheme, or enter the color code (RGB) manually.

color code

Pricing

CPM: Configures the estimated CPM* value for an Ad Placement.

*Used for calculating the estimated revenue, displayed in Supply statistics reports.

Note! If configured, the Assigned Demand CPM settings will override Ad Placement CPM settings.

Global Configures the default global CPM value** for an Ad Placement for all countries (in US Dollars), other than those, for which the country-specific CPM value is configured.

Note! Adding the “Global CPM” value is preferable.
If the field is blank, the zero (0) value will be applied.

number
By Country Configures the CPM value for an Ad Placement for a specific country**.

Tip! Add manually or leave blank to apply the global CPM value instead.

number
**Split by Platform Optional.

Enables configuring the CPM value (Global and/or by Country) – separately, for Desktop and Mobile, if needed.

Click “≺” and add the two values manually.

Default value: OFF

Note! If ON, both the Desktop and Mobile CPM values is preferable.
If the field is blank, the zero (0) value will be applied.

true/false

If true:
number

Targeting & Limits

Overall impression limit Configures the total maximum number of ad impressions, enabled for the Ad Placement. number
Impressions capping Configures the maximum number of ad placement display for all (non-unique) users within 24 hours. number
Frequency capping Configures the maximum number of ad placement display within a defined timeframe for 1 unique user.

Enter the values in the following format: number of shows/number of hours.

number/number
Domains Optional.

If defined, configures video ad display ONLY on defined domain.

Tip! Enter BOTH *.example.com & example.com to include both the main domain and all its sub-domains.

string

Copyright

Watermark link Configures the webpage, opened onclick the watermark icon. string
Watermark icon Configures the image source for the waterlink icon. string (Base64/URL)
Copyright: ONLY for InBanner format

IF no video content URL added, and no passback applied, the grey default background will display w/ copyright text, link and icon.

Copyright text Configures the displayed copyright text.

Usually: Powered by

string
Copyright link Configures the webpage, opened onclick the copyright icon. string
Copyright icon Configures the image source for the copyright icon. string (Base64/URL)

Ad Waterfall

Sequential waterfall Configures the sequential waterfall switch-on.

Check the box to switch on sequential waterfall or leave unchecked to apply default settings (parallel waterfall).

true/false
Rotation Configures how many times Demand Tags are re-requested. number,
> 0
Replay ONLY for InPage, InView and InBanner formats.

Configures the number of ads replayed (in addition to the 1st ad impression).

number,
> 0
Tag Request Timeout Configures ad server response timeout (in milliseconds) for ad request. number
Best Tag Timeout ONLY for multiple Demand Tags assigned.

Configures ad server response timeout (in milliseconds) for the top-ranked ad tag, provided there’s at least one ad server response already returned via lower-ranked ad tags.

number
Creative Timeout Configures ad server response timeout (in milliseconds) for ad impression, upon the ad tag response. number

Brand Safety

Brand Safety Optional.

Configures Brand Safety settings for the ad placement.

Click “Add Brand Safety” and select the Brand Safety Tag from the drop-down list to configure.

Tip! If the list is empty – add a Brand Safety Tag in the “Brand Safety” section (see Brand Safety Configuration Reference).

string
Check traffic volume Configures the share of video ad impressions (in %), selected for the assigned Brand Safety (viewability tracking, fraud checks, etc.).

  1. Add manually, or
  2. Leave blank to apply the default Brand Safety Tag settings, – IF the latter were previously configured.

Note! Ad Placement Brand Safety settings override the default Brand Safety Tag settings, if configured.

number
Check until time Configures end time and date*, selected for the assigned Brand Safety (viewability tracking, fraud checks, etc.).

*The operating time is UTC (cannot be changed).

  1. Add manually, or
  2. Leave blank to apply the default Brand Safety Tag settings.

Note! Ad Placement Brand Safety settings override the default Brand Safety Tag settings, if configured.

yy-mm-dd hh:mm

 

Edit Ad Placement Settings

To edit ad placement settings:

1. Select a publisher from the list on the left.
2. Click the ad placement to browse its current settings in the main window area.
3. Click “Edit” in the “Settings” tab to edit ad placement settings.
4. Click “Update” to apply changes.

Go to “Assigned Demand” tab in the main window area to browse and manage assigned demand for the selected placement (see Assigned Demand Configuration Reference).

Go to “Codes” tab to access ad placement codes (see Ad Placement Codes).

Create an Ad Placement Copy

You can create similar ad placements for one publisher fast and easy, by creating an ad placement copy.

To create an ad placement copy:

1. Select a publisher from the list on the left.
2. Click the publisher’s ad placement.
3. Click “Copy” in the “Settings” tab (see screenshot).

Assign Demand to Ad Placement

To assign Demand to the created ad placement:

1. Go to “Assigned Demand” tab.
2. Click “Assign Demand.”
3. Configure Assigned Demand settings* (see screenshot).
4. Click “Create.”

NB! You can assign Demand to ad placements ONLY upon adding and configuring Demand Tag/s in the Demand section (see Demand Tag Configuration Reference).

*Tip! You can also monetize with AdPlayer.Pro premium demand – simply select the corresponding Demand Tag, while configuring Assigned Demand settings for your ad placement.
 

Assigned Demand Configuration Reference

 

Parameter Description Value
Name Assigned Demand name. string
Demand Configures which Demand Tag/s should be assigned.

Select one Demand Tag from the list,
then click “+” to assign multiple Demand Tags, if needed.

If the list is empty – add a Demand Tag in the Demand section (see Demand Tag Configuration Reference).

string
Weight ONLY for multiple Demand Tags assigned.

The higher Demand Tag weight implies the larger share of ad impressions served, from total.

number
Pub ID Optional.

Specifies the publisher ID in Demand Tag using macros (see AdPlayer.Pro Macros).

string
Include countries Optional.

Specifies countries for Assigned Demand display.

Add country codes, separated by comma with space, or leave blank.

string
Exclude countries Optional.

Specifies countries, excluded from Assigned Demand display.

Add country codes, separated by comma with space, or leave blank.

string
Overall impression limit Configures the total maximum number of ad impressions, enabled for the Assigned Demand. number
Impressions Capping Configures the maximum number of ad impressions for the Assigned Demand – to all users within 24 hours. number
Priority Configures Assigned Demand priority in ad waterfall (where 1 refers to the highest priority). number, ≥ 1
Platform Configures the platform for Assigned Demand display:

  1. web
  2. mobile
  3. all

Select one of the options from the drop-down menu.

web/mobile/all
Use video file Configures linking to video content URL (see Ad Placement Configuration Reference). true/false
Disable rotation Configures disabling rotation for the Assigned Demand.

Check the box “Disable Rotation” to disable Assigned Demand rotation.

Default value: false (i.e. Assigned Demand rotation enabled).

true/false
Disable replay Configures disabling replay for the Assigned Demand. true/false

 

Manage Assigned Demand

To manage Assigned Demand for the ad placement:

1. Go to “Assigned Demand” tab.
2. Manage Assigned Demand, accordingly:

  1. browse the current status,
  2. access Demand Tag details, if available,
  3. reconfigure, delete or switch them on/off.

 

Ad Placement Codes

 
You may access the following codes for a selected ad placement in a separate “Codes” tab:

Code Description
Placement code Curtailed ad placement code with no parameters included.
VAST codes (Outstream & InStream) Used for video ad display in third-party video ad player solutions.

 
Tip! Request a JS Code and/or InApp Placement Code from your dedicated account manager, if needed.