Demand

The “Demand” section functionality enables you to do the following:

  1. Add, switch on/off and delete Demand Tags
  2. Browse and edit basic Demand Tag settings
  3. Apply advanced Demand Tag settings, using macros. 
  4. Track Demand Tag performance within the past 24 hours.

Let’s dive in into each in more details.

Create a New Demand Tag

To create a new Demand Tag:

1. Select an advertiser from the list on the left.
2. Click a blue “+” button.
3. Configure Demand Tag settings (see Demand Tag Configuration Reference).
4. Finish adding the Demand Tag by clicking “Create.”

Note! Read more about Demand creation from local video files in a separate section below.

Create a Demand Tag from Uploaded Video File

To create a Demand Tag from an uploaded video file (see screenshot):

1. Select an advertiser, then click a blue “+” button.
2. In the Demand Tag settings: select type “Video File.”
3. Click “Upload file.”
NB! Upload limits: only MP4 format, maximum size: 300MB, minimum width 240px.
4. Configure a landing page URL and event tracking URLs:

  1. “Impression” > filled ad impressions
  2. “Start” > ad starts
  3. “First quartile” > ads played to first quartile (25%)
  4. “Midpoint” > played to midpoint (50%)
  5. “Third quartile” > ads played to third quartile (75%)
  6. “Complete” > ads played to completion (100%)

5. Click “Generate” to generate an editable VAST XML file for the Demand Tag.
6. Optional. Edit any VAST XML parameter/s, if needed.
7. Configure other Demand Tag parameters.
8. Click “Create.”

Demand Tag Configuration Reference

The AdPlayer.Pro demand tag configuration reference enlists the following options for demand tag setup (see screenshot):
 

Parameter Description Value
Name Demand Tag name. string
Type Configures Demand Tag type:

  1. URL
  2. Header Bidding
  3. Video File
  4. XML

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

URL/

Header Bidding/

Video File/

XML

Client Configures the ad format:

  1. for VAST/VPAID ads: VAST
  2. for Google IMA ads: Google IMA

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

VAST/Google IMA
URL
  1. For URL Demand Tags: Enter the URL to xml, js file with all ad parameters.
  2. For Header Bidding Demand Tags: Enter JSON with all ad parameters.
string (URL/JSON)
CPM: Configures the estimated CPM* value for a Demand Tag.

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

Note! The Demand Tag CPM settings are automatically shared to all Assigned Supply (i.e. override the Ad Placement CPM value, if configured).

Global CPM Configures the default global CPM value for a Demand Tag 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
Country-specific CPM Configures the CPM value for a Demand Tag for a specific country.

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

number
Include countries Optional.

Specifies countries for Demand Tag display.

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

NB! If parameter settings for Demand Tag and Assigned Supply are different  – none of the settings will be applied.

string
Exclude countries Optional.

Specifies countries, excluded from Demand Tag display.

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

NB! If parameter settings for Demand Tag and Assigned Supply are different  – all settings will be applied.

string
Include domains Optional.

Specifies domains for Demand Tag display.

Enter domains, separated by comma with space, or leave blank.

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

string
Exclude domains Optional.

Specifies domains, excluded from Demand Tag display.

Enter domains, separated by comma with space, or leave blank.

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

string
Overall impression limit Configures the total maximum number of ad impressions for the Demand Tag.
*Tip! You can also configure Overall impression limit at the Advertiser level, if needed.

number
Impressions capping Configures the maximum number of ad impressions for the Demand Tag* for all users within 24 hours.

NB! The Demand Tag impression capping settings are automatically shared to all Assigned Supply.

*Tip! You can also configure impressions capping at the Advertiser level, if needed.

number
Frequency capping Configures the maximum number of Demand Tag display within a defined time frame for 1 unique user.

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

NB! The Demand Tag frequency capping settings are automatically shared to all Assigned Supply.

number/number
Disable rotation Configures disabling rotation for Demand Tag.

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

true/false
Disable replay Configures disabling replay for Demand Tag.

Default value: false (i.e. Demand Tag replay enabled).

true/false
Display once per cycle Configures display limitations for Demand Tag.

Check the box to display only once per player lifecycle.

true/false
Ad Schedule Optional.

Configures the specific time frame, i.e. Start and End date & time, for Demand Tag display.

Note! The operating time is UTC (cannot be changed).

yy-mm-dd hh:mm // yy-mm-dd hh:mm

 

Edit Demand Tag Settings

To edit Demand Tag settings:

1. Select an advertiser from the list on the left.
2. Click the Demand Tag to browse its current settings in the main window area.
3. Click “Edit” to edit the Demand Tag settings.
4. Click “Update” to apply changes.

Tip! Go to “Assigned Supply” tab to browse Assigned Supply details, if any.

AdPlayer.Pro Macros

 

Macros Description Value
$$WIDTH$$ Returns the player width, in pixels.

number
$$HEIGHT$$ Returns the player height, in pixels.

number
$$REFERER$$ Returns the webpage data, where the ad is served.

Example: domain.com/page

string
$$REFERER_DOMAIN$$ Returns the domain’s hostname, where the ad is served. string
$$CLIENT_USER_AGENT$$ Returns the сlient’s user agent data (navigator.userAgent). string
$$RANDOM$$ Returns the random numeric string. number
$$PUB_ID$$ Returns the publisher’s website ID.* string
$$PLACEMENT_ID$$ Returns the ad placement ID. string
$$TIMESTAMP$$ Returns the current time, in milliseconds.* number
$$REMOTE_IP$$ Returns the client’s IP address data.* string
$$REMOTE_COUNTRY$$ Returns the client’s country code.*

Example: ES

string
$$REMOTE_COUNTRY_NAME$$ Returns the client’s country name in full.*

Example: Spain

string

*ONLY applied for Placement code and/or VAST code (see Ad Placement Codes).
 

Pass-through Macros

 

Macros Description Value
$$LAT$$ Passes user’s location latitude (also applicable for “appLat” parameter, specified in JS code). number
$$LON$$ Passes user’s location longitude (also applicable for “appLon” parameter, specified in JS code). number
$$APP_BUNDLE$$ Passes mobile app bundle name (“appBundle” parameter value, specified in JS code). string
$$DNT$$ Passes true/false value for “Do Not Track” parameter (“dnt” parameter value, specified in JS code). 0/1
$$APP_NAME$$ Passes mobile app name (“appName” parameter value, specified in JS code). string
$$APP_STORE_URL$$ Passes link to mobile app page on the app store (“appStoreUrl” parameter value, specified in JS code). URL
$$APP_VERSION$$ Passes mobile app version (“appVersion” parameter value, specified in JS code). string
$$DEVICE_ID$$ Passes mobile device ID (“deviceId” parameter value, specified in JS code). string
$$DEVICE_MAKE$$ Passes mobile device manufacturer name (“deviceMake” parameter value, specified in JS code). string
$$C_PARAM_NAME$$ Passes the custom parameter (“paramName” parameter value, specified in JS code).

Examples:
$$C_DEVICE_WIDTH$$
$$C_DEVICE_HEIGHT$$

string