Ad Insertion is an optional feature controlled by the license you purchase from RealNetworks.
The following settings pertain to Ad Insertion:
Setting |
Description |
AdEnabled | Initializes the RealServer for advertising play. If Ad Insertion is enabled, a plug-in must be defined (see AdPlugin). |
AdPlugin | Specifies which plug-in is used to drive advertising insertion. |
AdDefaultCfg | Optional. Global default advertising insert method for the RealServer. |
AdCfgList | Specifies the location(s) of content media files for which ad insertion is enabled and type of ad insertion for those files. |
AdLogPath | The relative path and name of the log file in which RealServer chronicles advertising presentation activity (pnad.log or pnad). |
When any of these settings are changed, you must restart RealServer in order for the change to take effect. Data specified in these parameters is loaded into the server's memory.
Turns Ad Insertion on (True) or off (False). If AdEnabled is set to True, a plug-in must be defined (see AdPlugin setting).
Default value | True |
Range of values | True, False |
AdEnabled <Boolean>
AdEnabled True
AdPlugIn specifies the .dll to drive Advertising Insertion in the RealServer. If AdEnabled is set to True, an ad plug-in must be defined.
Default value | Windows: \inetpub\rvroot\adli.3250.dll UNIX: /rvroot/adlist.so.5.0 |
Range of values | any valid filename for operating system Ad List Plug-In: Ad selection based on a text file that you define (see ads.txt in Chapter 6, "Ad Insertion"). Ad Server Plug-In: Ad selection based on third-party ad selection software. |
To use third party ad targeting software for selecting ads, check with the software company for the correct filename.
AdPlugin <filename>
AdPlugin d:\inetpub\rvroot\adli3250.dll AdPlugin /rvroot/adlist.so.5.0
Optional. If used, specifies the global default ad insertion type for
the RealServer. If ad insertion is enabled this is the ad insertion type
for all content media files unless otherwise specified. You can customize
ad insertion for content files by directory using the AdCfgList command.
Default value | 7 |
Range of values | 0 No ads played 1 Play lead ad only 2 Play end ad only 3 Play both lead and end ads 4 Play in-line ads only (pre-defined content markers must be defined in a .rad file) 5 Play lead and in-line ads 6 Play end and in-line ads 7 Play lead, end and in-line ads |
AdDefaultCfg <value>
AdDefaultCfg 2
Specifies the location(s) of content media files for which ad insertion is enabled and the type of ad insertion for the files in that path.
This command overrides the global setting specified by the AdDefaultCfg command.
Default value | none |
Range of values | pathname relative to BasePath |
AdCfgList [{<path1>, <adinsert type>}, {<path2>, <adinsert type>}, ...]
where:
<path>
is the path to
the directory containing the media clips and is relative to the BasePath
setting
<adinsert type>
is type
of ad insertion permitted for files in the path:
Default value | 7 |
Range of values | 0 No ads played 1 Play lead ad only 2 Play end ad only 3 Play both lead and end ads 4 Play in-line ads only (pre-defined content markers must be defined in a .rad file) 5 Play lead and in-line ads 6 Play end and in-line ads 7 Play lead, end and in-line ads |
AdCfgList [{noads/video, 0}, {ads/video/20k, 4}]
AdCfgList [{film/previews, 3}, {news, 0}]
Specifies the relative path and name of the log file in which RealServer chronicles advertising presentation activity.
Default value | logs/pnad.log |
Range of values | valid path and file name |
AdLogPath <path/filename.log>
AdLogPath /logs/pnad.log
For details about log file maintenance, see RealServer Log Files.