FreeWheel
Configure FreeWheel ad requests, ad units, key-value pairs, and targeting parameters.
You can configure the following FreeWheel ad settings:
- Set a FreeWheel
GETad request URL. - Define where ads may be placed within your content.
- Pass key/value pairs to FreeWheel that describe the content currently being streamed.
- Pass additional parameters to customize the data provided to FreeWheel and the ads it returns.
FreeWheel Ad Requests
When you set the Server URL parameter, the service constructs the following GET request to retrieve ads for your content:
http://[customerId].v.fwmrm.net/ad/g/1?[globalParams];[keyValues];[ParamsForSlot1];[ParamsForSlot2];...;[ParamsForSlotN];
The query string is constructed from the parameters described below.
- [globalParams]: Most parameters described in the FreeWheel Ad Parameters section apply globally to all ad units.
- [keyValues]: The Key-Value Pairs parameter (
ad.kv) defines key-value pairs that may be passed to or retrieved from FreeWheel. - [ParamsForSlotN]: The Ad Units parameter (
ad.slau) determines whether slot-specific parameters (i.e.,[ParamsForSlot1];[ParamsForSlot2];...;[ParamsForSlotN];) are added to the query string.
Toggle Ad Units
Ad placement differs between live and on-demand streaming.
Live Streaming
Toggle ad units by setting the Ad Units parameter (ad.slau) to a comma-separated list of ad unit types. Only ad unit types defined within this parameter will be requested.
Example:
The following value requests only mid-roll ads during this playback session of the live stream.
ad.slau=,midroll
On-Demand Content
By default, ads are requested for pre-roll, mid-roll, and post-roll ad units.
FreeWheel Ad Parameters
This section describes the parameters that the service inserts into the GET request sent to the FreeWheel ad server.
| Name | Parameter | Description |
|---|---|---|
| Server URL | ad.serverurl | Required Defines the base URL to the desired FreeWheel ad decision server. Example: ad.serverurl=http://g1.v.fwmrm.net/ad/p/1? A default value for this parameter may be defined from within the CMS. This parameter takes precedence over the Customer ID parameter (ad.customer_id). Learn how to set a default value for this parameter. |
| Location Description (Custom Site Section ID) | ad.locationDesc | Required Defines a description for the playback location. Example: ad.locationDesc=web Learn how to set a default value for this parameter. This parameter takes precedence over the Custom Site Section ID parameter (ad.csid). |
| Network ID | ad.nw | Required Sets the distributor's FreeWheel network ID ( adRequest@networkId). Example: ad.nw=14611 Learn how to set a default value for this parameter. |
| Player Profile | ad.prof | Required Sets the player's profile ( adRequest@profile). Example: ad.prof=14611:Vod Learn how to set a default value for this parameter. |
| Maximum Pre-Roll Ads | ad.pre_maxads | Sets the maximum number of pre-roll ad units that the ad server may return. |
| Minimum Pre-Roll Duration | ad.pre_mind | Sets the minimum duration, in seconds, for pre-roll ad units within a live stream. This duration is used only when the ad unit duration is unknown. This parameter supports integers only. Example: ad.pre_mind=15 |
| Maximum Pre-Roll Duration | ad.pre_maxd | Sets the maximum duration, in seconds, for pre-roll ad units within a live stream. This parameter supports integers only. Example: ad.pre_maxd=50 |
| Pre-Roll Duration | ad.predur | Required for Live Streaming OnlySets the duration, in seconds, of a live stream's pre-roll ad unit. Example: ad.predur=45 |
| Duration | ad.rdur | Defines a default duration. This duration applies only to ad breaks without an explicitly defined duration. Default Value: 240 Example: ad.rdur=120 |
| Minimum Mid-Roll Duration | ad.mind | Sets the minimum duration, in seconds, for mid-roll ad units within a live stream. This duration is used only when the ad unit duration is unknown. This parameter supports integers only. Example: ad.mind=15 Default Value: The default minimum duration is set by the Duration parameter (ad.rdur). If it is not set, then the default duration is determined by the duration passed to the Live Slicer. |
| Maximum Mid-Roll Duration | ad.maxd | Sets the maximum duration, in seconds, for mid-roll ad units within a live stream. This parameter supports integers only. Example: ad.maxd=50 Default Value: By default, the maximum duration is the duration passed to the Live Slicer. |
| Use Live Break Duration | ad.ulbd | Sets ad unit duration for on-demand content to the duration defined when the source live stream was sliced. Set this parameter to 1. Example: ad.ulbd=1 |
| Mode | ad.mode | Overrides the default request mode (adRequest@mode) for ad units. Valid values are: live, ondemand. Learn how to set a default value for this parameter. |
| Flags | ad.flags | Enables one or more flags that define the player's capabilities. This value should be URL encoded. Example: ad.flags=+play+sync Specified Flags Only: Enable only specific flags by setting this parameter to a colon followed by the desired set of flags. Example: ad.flags=:+amcb |
| Suppress supportsSlotTemplate | ad.suppress_pre_sltp | Removes supportsSlotTemplate from the pre-roll ad request. |
| Advanced Callbacks | ad.ametr | Allows FreeWheel to use impressions with advanced callbacks. Set this flag to 1. Example: ad.ametr=1 |
| HyLDA | ad.hylda | Activates FreeWheel's HyLDA feature. Set this flag to 1. Example: ad.hylda=1 |
| Acid | ad.acid | Adds Acid as a value in the HyLDA keyword. This parameter applies only when the HyLDA flag is enabled. Example: ad.acid=Acid |
| Default Ad Capabilities | ad.metr | Defines the default capabilities for all ads. Set this parameter to an integer that maps bits to capabilities. Example: ad.metr=8 Default Value: 7 |
| Asset Network ID | ad.asnw | Adds a video asset network ID (videoAsset@videoAssetNetworkId) to the FreeWheel GET ad request. Example: ad.asnw=14611k |
| Custom Asset ID | ad.caid | Sets the custom asset ID (videoAsset@customId) included with the FreeWheel GET ad request. Syntax: @[Key-Value-Name] Sends the value assigned to an asset's key-value pair to FreeWheel. Example: ad.caid=@custom_id |
| Key-Value Pairs | ad.kv | Passes or retrieves key-value pairs using the FreeWheel GET ad request. Example: ad.kv=key_1,value_1,key_2,value_2 |
| Key-Value Separator | ad.kvsep | Determines the delimiter used when defining key-value pairs through the Key-Value Pairs parameter. Example: ad.kvsep=/ Default Value: , |
| Site Section Network ID | ad.ssnw | Sets the site section network ID (siteSection@siteSectionNetworkId) included with the FreeWheel GET ad request. Example: ad.ssnw=112233 |
| Video Asset Fallback ID | ad.afid | Sets the video asset fallback ID (videoAsset@fallbackId) included with the FreeWheel GET ad request. This ID is used when an ad request's video asset ID is not recognized. Example: ad.afid=AssetFallBackId |
| Visitor Custom ID | ad.vcid | Sets the visitor's custom ID included with the FreeWheel GET ad request. This ID is equivalent to the visitor/@customId attribute in the XML request. Example: ad.vcid=CustomVisitorID |
| Site Section Fallback ID | ad.sfid | Sets the site section fallback ID included with the FreeWheel GET ad request. This ID is used when an ad request's site section ID is not recognized. Example: ad.sfid=global |
| Pre-Roll Ad Unit | ad.preroll | Requests a pre-roll ad unit. Set this parameter to 1. Example: ad.preroll=1 Default Value: 0 |
| Ad Units | ad.slau | Determines whether pre-roll, mid-roll, and post-roll ad units will be requested from FreeWheel. Valid values are: preroll, midroll, postroll |
| Asset Duration | ad.vdur | Overrides an asset's duration (videoAsset@duration). Example: ad.vdur=3600 |
| Tag (FreeWheel Ad Request) | ad.tag | Sets a FreeWheel GET ad request URL that will be used instead of a POST Smart XML request. Example: ad.tag=http://demo.v.fwmrm.net/ad/g/1?... |
| Primary Content Type | ad.prct | Defines a global primary content type for all non-temporal, user-generated ad units. Example: ad.prct=text/html_lit_js_wc_nw Default Value: text/html_lit_js_wc_nw |
| Client IP Address | ad.vip | Overrides the client's IP address included with the FreeWheel GET ad request. Example: ad.vip=192.168.1.1 Default Value: The IP address of the device that requested playback of your content. |
| Client Referrer | ad._fw_h_referer | Overrides the Referer header value included with the FreeWheel GET ad request. Example: ad._fw_h_referer=http://www.sampledomain.com Default Value: By default, the Referer header from the playback request is included with the FreeWheel GET ad request. |
| Client User Agent | ad._fw_h_user_agent | Overrides the User-Agent header value included with the FreeWheel GET ad request. Example: ad._fw_h_user_agent=user-agent%3A%20Mozilla%2F5.0%20... Default Value: By default, the User-Agent header from the playback request is included with the FreeWheel GET ad request. |
| Customer ID | ad.customer_id | **Required when Server URL is undefined.**The Server URL parameter (ad.serverurl) takes precedence over this parameter. Do not specify this parameter if you plan to pass the Server URL parameter. Example: ad.customer_id=demo |
| Custom Site Section ID | ad.csid | **Required when Location Description is undefined.**The Location Description parameter (ad.locationDesc) takes precedence over this parameter. Do not specify this parameter if you plan to pass the Location Description parameter. Example: ad.csid=web |
| End-User ID | ad.euid | The Visitor Custom ID parameter (ad.vcid) takes precedence over this parameter. Do not specify this parameter if you plan to pass the Visitor Custom ID parameter. Example: ad.euid=CustomVisitorID |
| Skip Preroll | skippreroll | If the ad.preroll=1 URL parameter is specified in the Uplynk playback URL, the URL parameter skippreroll=1 forces Uplynk to look ahead in the stream and skip the pre-roll ad if the mid-roll is within 60 seconds of the stream start. Example: skippreroll=1 |
Enable FreeWheel Video View Feature
The parameter to enable FreeWheel's Video View by Callback feature varies depending on the version of the ping API you are using. This feature requires both the Preplay and Ping APIs.
- Version 3: If you are using version 3 of the ping API (the current version), add
2to the value of thead.pingfparameter in your preplay request. (See the "Calculating the pingf Parameter" section of the Features portion of the ping API v3 documentation.) - Version 2: If you are using version 2 of the ping API (a past version), include the
ad.svv=1parameter in your preplay request.
This feature also requires the Smart XML response type, as Video Views are not supported by VAST.
FreeWheel Creative Parameters
An ad response from FreeWheel may include creative parameters such as:
- _fw_ad_position_in_pod
- _fw_ad_title
- _fw_ad_unit_name
- _fw_advertiser_name
- _fw_asset_thumbnail_url
- _fw_campaign_name
- _fw_creative_name
- hulu_industry
- moat
These creative parameters are automatically included in preplay and ping responses to the client. The client may then use these parameters for custom integrations (e.g., integrating FreeWheel with Moat Analytics).
Ad Configuration
An ad configuration allows you to define default values for use with third-party ad servers (e.g., FreeWheel).
To define an ad configuration:
- Navigate to the Ad Server page via Settings > Ad Server.
- Select + Ad Config.
- In the Ad config name option, enter the name for your ad configuration.
- From the Select ad server option, select "FreeWheel."
- Select Create.
- In the serverURL option, enter your FreeWheel
GETad request URL. - In the networkID option, enter the distributor's FreeWheel network ID (
adRequest@networkId). - Define default values for any other desired FreeWheel parameters.
- Select Save.
Updated 4 days ago
Did this page help you?