Ad Insertion Settings

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.

AdEnabled

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

Syntax

AdEnabled <Boolean>

Examples

AdEnabled True

AdPlugin

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.

Syntax

AdPlugin <filename>

Examples

AdPlugin d:\inetpub\rvroot\adli3250.dll
AdPlugin /rvroot/adlist.so.5.0

AdDefaultCfg

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

Syntax

AdDefaultCfg <value>

Example

AdDefaultCfg 2

AdCfgList

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

Syntax

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

Examples

AdCfgList [{noads/video, 0}, {ads/video/20k, 4}] 
AdCfgList [{film/previews, 3}, {news, 0}]

AdLogPath

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

Syntax

AdLogPath <path/filename.log>

Example

AdLogPath /logs/pnad.log

For details about log file maintenance, see RealServer Log Files.

© 1997 RealNetworks, Inc.