How to Create a Targeting Rule

To create a Targeting Rule, perform the following steps:

  1. Go to the Portal by clicking here.

    NUI_Create_Targeting_Rule_001.jpeg

  2. Hover over 'MONETIZATION' in the Portal menu and select 'TARGETING RULES'. The targeting rules page is displayed.

  3. Click on 'Add a New Targeting Rule'. The targeting rule edit page is displayed.

    NUI_Create_Targeting_Rule_002.jpeg

  4. Apply the required fields according to the following table:

    Note: Mandatory fields are marked with an asterisk '*'.  

    Field Name Description
    Company

    Click on this field and select the Company that will own this Targeting Rule.

    Note: This Targeting Rule will only be eligible to players under this company.

    Active Selecting this check box defines if this Targeting Rule is currently active or disabled.
    Rule Name Enter a name for your Targeting Rule. 
    Marketplace

    Optional: Click on this field to apply this Targeting Rule to a specific Marketplace. The Targeting Rule will only be available to the Companies defined in the Marketplace settings.

    Note: For further details, please see What are Marketplaces?



  5. Click on the 'Rights Type' field and select the required option from the drop down list according to the following options. This field will determine the general weight range that will apply to this Targeting Rule.
    • No Ads - Selecting this option to prohibit ads from running on players. The relevant weight range for this type is between 900-1000 (Highest in the scale).
    • Exclusive - Selecting this option to define First Right of Sale ads that are of the highest priority. The relevant weight range for this type is between 400-899.
    • Standard - Select this option to define Direct Sold ads. The relevant weight range for this type is between 300-399.
    • Reseller - Select this option for Network, Reseller and Backfill ads. The relevant weight range for this type is between 0-299.

      Note: The following fields in the Targeting Rule change dynamically according to the selected Rights Type.

  6. Apply the required fields according to the following table:

    Field Name Description
    Ranking Override

    Optional: Click on this field and select the required Ranking Override option according to the following options: 

    • None - Selecting this option will deactivate the ranking override functionality.

    • Absolute Last - Selecting this option will prevent other Targeting Rules from returning to the Player if their weight is lower than the weight set in this Targeting Rule.

      For example: If this Targeting Rule's weight is set to 700, all other eligible Targeting Rules with a weight bellow 700 (including those outside the Company scope), will be disregarded.

    • Partner Last - Selecting this option will prevent Targeting Rules from this Company's scope from returning to the Player if their weight is lower than the weight set in this Targeting Rule.

      For example: If this Targeting Rule's weight is set to 700, all other eligible Targeting Rules from the same Company with a weight bellow 700, will be disregarded. But Targeting Rules with lower weights from other Companies will still be eligible.

    Note: This field is displayed only when the 'Standard' Rights Type is selected.

    Weight

    Optional: Enter a numeric value between 0 to 1000 to define the importance of this Targeting Rule. The higher the weight of the Targeting Rule, the higher the likelihood it will be selected and displayed by the Player. The weight value is automatically populated with a default value according to the selected 'Rights Type'. This field allows you to manually enter a numeric value to fine tune your ads priorities.

    Note: This field is displayed when one of the following Rights Types are selected: 'No ads', 'Exclusive' or 'Standard'.

    Min Weight 

    Optional: Enter a numeric value between 0 to 299 to define the minimum importance weight of this reseller Targeting Rule.

    Note: This field is displayed only when a 'Reseller' Rights Type is selected.

    Max Weight 

    Optional: Enter a numeric value between 0 to 299 to define the maximum importance weight of this reseller Targeting Rule.

    Note: This field is displayed only when a 'Reseller' Rights Type is selected.



  7. Apply the required fields according to the following table:

    Field Name Description
    Rule CPM($)

    Optional: Enter the expected CPM (cost per thousand ad impressions) provided by your ad vendor. This value is used for reporting and revenue optimization. For Reseller/Network campaigns, this is often an estimate since the ad vendor will often have a floor and expected range.

    Note: If you do not know the value, please ask your Ad Vendor for this information.

    Note: If you set this value to 0, your reports will not reflect any revenue from this Targeting Rule.

    Start Date Optional: Deselect the 'No Start Date' check box to define a custom start date from which this Targeting Rule will be available.
    End Date Optional: Deselect the 'No End Date' check box to define a custom end date from which this Targeting Rule will no longer be available.
    Custom Labels

    Optional: If you have defined custom labels in your Company, this area will allow you to tag your Targeting Rule with one or more of your custom labels. This is mainly used to filter and manage your targeting rules.

    For example: Let's say I have 3 custom labels on my company level: FRoS, Network and Direct. I can tag my Targeting Rule as 'FRoS' just by selecting the available tag (a selected tag is highlighted in blue).

    Note: Custom labels can be added under the Pricing & Ads tab of your Company edit page. 

    Frequency Cap

    Allows you to set how many times per given period this Targeting Rule will be applied per a single user.



  8. Go to the 'Rule Frequency Budget' area and apply the required fields according to the following table:

    Field Name Description
    Overall Impressions

    Optional: Enter a numeric value to set the overall limit of impressions upon which this Targeting Rule will be stopped from applying to players.

    For example: Setting this field to 10,000 means that when the whole Targeting Rule ad request reaches 1000 impressions this Targeting Rule will not apply anymore.

    Note: By default this field is set to infinity, meaning that the Targeting Rule will continue to serve ads forever.

    Daily Impressions

    Optional: Enter a numeric value to set the daily limit of impressions upon which the Targeting Rule will be stopped from applying to players within a 24 hour timeframe.

    For example: Setting this field to 500 means that if I gained 500 impressions until 8:00 pm, the Targeting Rule will be paused from being served until 5:00 AM the following morning.

    Note: The day time range is considered between 5AM UTC to 5AM UTC.



  9. Go to the 'Ad Detailed Section' area and apply the required fields according to the following table:

    Field Name Description
    Ad Vendor

    Select an ad vendor to associate with this Targeting Rule.

    Note: If you do not have any predefined ad vendors please refer to How to create an ad vendor.

    Note: This field is displayed when one of the following Rights Types are selected: 'No ads', 'Exclusive' or 'Standard'. When a 'No Ads' Rights Type is selected this field is not displayed.

    Ad Engine

    Select an ad engine type from the drop down list according to the following options: This defines how the player will serve ads.

    • VAST (Default) - Video Ad Serving Template, a universal XML schema for serving ads.  This should be used for the majority of ad vendors.  Use this engine type when you are required to enter a VAST 2.0 ad tag.
    • IMA - Interactive Media Ads, an SDK for serving ads from Google. This engine type should be used whenever the ad tag is coming from a Google ad server (DFP and DFP small business).  You can also use this engine type you are required to enter a VAST 3.0 ad tag.
    • VMAP - Video Multiple Ad Playlist by the IAB is an XML template used to schedule multiple ads using a single tag.
    • YuMe - YuMe Ads, consists of a base pre-roll unit that features automatic hooks into Facebook, Twitter, YouTube campaigns and features supplemental brand awareness and response elements.
    • FreeWheel - This engine type provides support for serving ads via FreeWheel's MRM Platform.

    Note: If you are unsure what ad engine to select, you can ask your Account Manager. 

    Note: This field is displayed when one of the following Rights Types are selected: 'No ads', 'Exclusive' or 'Standard'. When a 'No Ads' Rights Type is selected this field is not displayed.

    Use direct AdSets

    Selecting this check box allows you to add a single or multiple Ad Sets that contain only direct Ad Campaigns.

    VAST URL

    Enter the required ad API request in URL form. This is most commonly a VAST API request that is provided by your ad vendor. An error message is displayed if an unsupported URL is entered. When a URL is entered, a preview is displayed, as shown above.

    Note: All ad request URLs must include a protocol declaration of http:// or https://.

    Note: This field is displayed when one of the following Rights Types are selected: 'No ads', 'Exclusive' or 'Standard'. When a 'No Ads' Rights Type is selected this field is not displayed.

    Ad Types

    Select what type/s of ad/s this Targeting Rule should fill from the drop down menu according to the following options:

    • Preroll - Ads that are run at the before a content video.
    • Midroll - Ads that are run during a content video.
    • Overlay - An overlay that is displayed on top of the player during the content video to create engagement with the viewer.
    • All - A combination of more than one of the ad types listed above.
    Uses Shim

    Optional: Selecting this check box will define this ad Targeting Rule as using a VPAID shim.

    Note: The Ad vendor screen has an identical check box to this.
    If the 'Uses shim' check box is not selected in the Targeting Rule level, it will inherit this definition from the Ad vendor settings screen if the 'Uses shim' check box is selected there. 

    For example: If the ad vendor is defined as "Uses Shim" and the Targeting Rule is not selected, the Targeting Rule will inherent the "Uses Shim" selection even though the checkbox is not selected.

    Note: For further details see What is a VPAID shim?

    Use Inline Player Optional: Selecting this check box will allow to apply the Mobile Ad Autoplay functionality to this Targeting Rule. This will enable to run this ad as an autoplay unit on mobile devices without needing the user to interact with a native player (by clicking).

    Important! This option is only enabled if the 'Engine Type' field is set to 'VAST' and the assigned Player is configured to run only one (1) ad preroll ad opportunity. For further details, please see How to Setup Preroll Mobile Ad Autoplay for Mobile Devices. 



    NUI_Create_Targeting_Rule_003.jpeg


  10. Click on the 'Destination' Tab. The destination tab is displayed.

  11. Go to the 'Destination Section' and apply the required fields according to the following table:

    Field Name Description
    Geo Target Optional: Enter a country name and select the appropriate country from the drop down list to define geographic target for this Targeting Rule. You can enter multiple countries in this field. After selecting the required countries you can then select either the Include (whitelist) or Exclude (Blacklist) the countries you have entered.
    Player Type

    Select one or more of the following Player types that this Targeting Rule will apply to according to the following options:

    • FLASH - Selecting this option will apply this Targeting Rule to FLASH Players.
    • HTML5 - Selecting this option will apply this Targeting Rule to HTML5 Players.
    • MOBILE - Selecting this option will apply this Targeting Rule to Mobile Players.
    • All - Selecting this option will apply this Targeting Rule to all three types players above.

      Note: When this option is selected the other check boxes cannot be selected.
    Tab Type

    Select one or more of the following Tab types for a playback of a player this Targeting Rule will apply to according to the following options:

    • Active - Selecting this option will apply this Targeting Rule to players played back in Active tabs.
    • Inactive - Selecting this option will apply this Targeting Rule to players played back in Inactive tabs.
    • All - Selecting this option will apply this Targeting Rule to players played back in all types of tabs.

      Note: When this option is selected the other check boxes cannot be selected.
    Ad Creative Support

    Select one or more of the following ad creative types for which this Targeting Rule will apply to according to the following options: 

    • SWF - Selecting this option will apply this Targeting Rule to FLASH supported ad creatives.
    • HTML5 - Selecting this option will apply this Targeting Rule to HTML5 supported ad creatives.
    • VAST_ONLY - Selecting this option will apply this Targeting Rule to VAST only supported ad creatives.
    • All - Selecting this option will apply this Targeting Rule to all three types ad creative types above.

      Note: When this option is selected the other check boxes cannot be selected.
    Players Optional: Click on this field and select a Player to which this Targeting Rule will apply to. This will make this Targeting Rule eligible only for the selected players you add here.

    Note: You can select multiple players by repeating this action for all your required players.

    Player Companies

    Optional: Include (whitelist) or Exclude (blacklist) players from this Targeting Rule by selecting Companies or Company Groups. After selecting Include or Exclude enter either the required Company names or the required Company Groups and click 'Add To List'.

    Platfroms

    Optional: Select the required platforms to which this Targeting Rule will apply to according to the following options:

    • Desktop - Selecting this check box will apply this Targeting Rule to desktop devices.
    • Mobile - Selecting this check box will apply this Targeting Rule to mobile devices.
    • Tablet - Selecting this check box will apply this Targeting Rule to tablet mobile devices.
    • Connected TV - Selecting this check box will apply this Targeting Rule to both digital media receivers and game consoles.
      • Digital media receiver - Selecting this check box will apply this Targeting Rule only to digital media receiver devices.
      • Game console - Selecting this check box will apply this Targeting Rule only to game consoles.
    • Native applications - Selecting this check box will apply this Targeting Rule to native applications. You can enter the native application names in the field bellow the check box.
    • All - Selecting this option will apply this Targeting Rule to all platforms above.

      Note: When this option is selected the other check boxes cannot be selected.

    Whitelist Patterns

    Optional: Enter any domain URLs you would like to whitelist in this field. Each domain should be entered in a new line without any http:// or https:// prefixes or backslash suffixes. For example: on.aol.com

    Note: If you have decided to whitelist domains, you cannot add domains to the blacklist field.

    Note: You can apply a wildcard to any domain by adding a double asterisk to any of your domains. For example, to whitelist any prefix for aol.com domain enter the following **.aol.com.

    Blacklist Patterns 

    Optional: Enter any domain URLs you would like to blacklist in this field. Each domain should be entered in a new line without any http:// or https:// prefixes or backslash suffixes. For example: on.aol.com

    Note: If you have decided to blacklist domains, you cannot add domains to the whitelist field.

    Note: You can apply a wildcard to any domain by adding a double asterisk to any of your domains. For example, to blacklist any prefix for aol.com domain enter the following **.aol.com.

    Single Entry

    Optional: Selecting this check box will allow you to add single domain URLs to either the Whitelist or Blacklist fields individually. When not selected you can add a bulk list of domains (new line separated without spaces or commas). 


    NUI_Create_Targeting_Rule_004.jpeg


  12. Click on the 'Content' Tab. The content tab is displayed.

  13. Go to the 'Content Section' and apply the required fields according to the following table:

    Field Name Description
    Content Owner

    Optional: Include (whitelist) or Exclude (blacklist) videos from this Targeting Rule by selecting Companies or Company Groups. After selecting Include or Exclude enter either the required Company names or the required Company Groups and click 'Add To List'. 

    For example: To apply this Targeting Rule to all videos from all content owners under the AOL Network, select the 'Include' check box and use the 'Company Group' field to select the 'AOL' group.

    Playlist

    Optional: Click on this field and select a Playlist to apply this Targeting Rule to videos in the defined playlist.

    For example: To apply this Targeting Rule to videos only in your 'News' Playlist click on this field and select the required playlist.

    Note: You can select multiple Playlists by repeating this action for all your required Playlists.

    Video

    Optional: Click on this field and select a Video to which this Targeting Rule will apply to. This will make this Targeting Rule eligible only for the selected Videos you add here.

    For example: To apply this Targeting Rule only to a specific video, click on this field and select the required video.

    Note: You can select multiple videos by repeating this action for all your required videos or by using the 'Add multiple videos by IDs' field.

    Add Multiple Videos by IDs

    Optional: This field allows you to enter manual Video IDs to which this Targeting Rule will apply to. This is an alternate method to using the 'Video' field above, and allows you to enter one or more Video IDs (comma separated). After entering the relevant Video IDs click on 'Add' and also select if you want to either Whitelist or Blacklist the selected videos.

    For example: enter the following IDs: 581b790cdb4bc655f7bee672,5829620adb4bc655f7c34164.

    IAB Categories

    Optional: Click on the plus '+' icon to expand the IAB categories drop down list and select the relevant category check boxes you would like to apply for this Targeting Rule.

    Note: You can select 'All Categories' instead of manually selecting all check boxes separately.

    Video Start Date / Video Age

    Optional: Apply this Targeting Rule to videos according to a defined Start Date or Video age either by range or specific date. First select the relevant options as either 'Video Start Date' or 'Video Age'.

    After that select the required operator according to the following options: 

    • = - Equal
    • < - Smaller than
    • <= - Equal or smaller than
    • > - Bigger than
    • >= - Equal or bigger than

    finally, enter the relevant date according to the following syntax: [YYYY-MM-DD] or [YYYY-MM]

    For example: To apply this Targeting Rule to all videos that are available form February 1st use the following: 'Video Start Date >= [2016-02-01]'

     

    Video Duration Optional: Apply this Targeting Rule to videos according to a defined video duration time. First select the required operator according to the following options: 
    • = - Equal
    • < - Smaller than
    • <= - Equal or smaller than
    • > - Bigger than
    • >= - Equal or bigger than

    Then enter the duration of the video in seconds. 

    For example: to apply this Targeting Rule to all videos that are longer than 2:30 minutes use the following: '> 150'

    Player Volume Optional: Apply this Targeting Rule to players according to a defined player volume. First select the required operator according to the following options:

    • = - Equal
    • < - Smaller than
    • <= - Equal or smaller than
    • > - Bigger than
    • >= - Equal or bigger than

    Then enter the required player volume.

    Video Type

    Click on this field and select the required Video Type to apply this Targeting Rule, according to the following options:

    • VOD - Selecting this option will apply this Targeting Rule to on demand videos only.
    • LIVE - Selecting this option will apply this Targeting Rule to live stream videos only.
    • 360 - Selecting this option will apply this Targeting Rule to 360 videos only.
    • All Types - Selecting this option will apply this Targeting Rule to all platforms above.
    Content Rating Select the required Content Rating assigned to videos this Targeting Rule will apply to, according to the following options:

    • Adults Only - Appropriate for adults only.
    • Age 17 And Above - Appropriate for ages 17 and above.
    • Age 14 And Above - Appropriate for ages 14 and above.
    • Age 10 And Above - Appropriate for ages 10 and above.
    • Age 7 And Above - Appropriate for children ages 7 and above.
    • For All Children - Appropriate for all children.
    • For All Ages - Appropriate for all ages.
    • Not Rated - Not rated content.


    NUI_Create_Targeting_Rule_005.jpeg

  14. Click on the 'Advanced' Tab. The advanced tab is displayed.

  15. Go to the 'Fraud' field and apply the required fraud setting according to the following options:

    Note: Before setting these options we suggest reviewing our Brand Safety and Fraud articles.

    • = - Equal.
    • < - Smaller than.
    • <= - Equal or smaller than.
    • > - Bigger than.
    • >= - Equal or bigger than.
    • Off - Selecting this option will disable fraud settings for this Targeting Rule.
    • Overall - Selecting this option will allow you to set an overall brand safety and fraud threshold, that when crossed will not allow the Targeting Rule's ad to display.
    • Specific - Selecting this option will allow you to set specific thresholds for each 3rd party fraud service we are integrated with: Pixalate, Distill Networks, Integrated Ad Science and WhiteOps.

      After selecting the relevant option you will be able to select an operator and set a value. The operator options are:
  16. Go to the 'Brand Safety' field and apply the required brand safety setting according to the following table:

    Note: Before setting these options we suggest reviewing our Brand Safety and Fraud articles.


    Field Name Description
    Overall Optional: Allow this Targeting Rule to display an ad when the Brand Safety level is according to a specified level. First select the required operator according to the following options: 
    • = - Equal
    • < - Smaller than
    • <= - Equal or smaller than
    • > - Bigger than
    • >= - Equal or bigger than

    Then enter the brand safety overall value level according to the following options:

    • Green - Sites/Domains that are Brand Safe.
    • Yellow - Site/Domains that require caution regarding brand safety.
    • Red - Site/Domains that are not brand safe as they contain adult content or parked domains.
    • Black - Site/Domains that are not brand sage as they contain malicious malware/phishing elements. 
    Match if Brand Safety or Fraud Value is Unknown Optional: Selecting this check box will make this Targeting Rule eligible if one or more of our Brand Safety or Fraud scores are return without a value. 
    Accessible once per (sec)

    Optional: Enter a value in seconds to limit the number of times this Targeting Rule will be requested.

    For example: Setting this field to 3 will allow this Targeting Rule to be requested only every 3+ seconds. This reduces the number of times the Targeting Rule will be requested for evaluation in Player runtime.




  17. Optional: Go to the 'Custom Attributes' area and apply the required fields according to the following table:

    Note: The custom attributes area is used to target Players by their passed macros.

    Field Name Description
    Add Attribute

    Optional: Click on this button to add a new macro attribute that will apply to this Targeting Rule according to a defined Macro name and value.

    For example: Apply this Targeting Rule only to Players that include a click to play Macro ('m.playback=click').

    Attribute Name

    Optional: Enter a valid macro name with an 'm.' prefix.

    For example: To apply this Targeting Rule to Players that include a click to play playback Macro enter 'm.playback' in this field.

    Attribute Value

    Optional: Enter the appropriate macro value.

    For example: To apply this Targeting Rule to Players that include a click to play playback Macro enter 'click' in this field. as this is the valid value for the defined macro above in this context.



  18. Optional: Go to the 'Search Statements' area and apply the required fields according to the following table:

    Note: The search statements area is used pass custom parameters and values back to the Ad server using a placeholder set in the VAST URL address query string.

    Field Name Description
    Add Search Statement

    Optional: Click on this button to apply this Targeting Rule when a defined search statement is fulfilled.
    After clicking this button a new search statement area is displayed with the following fields: 'Search query', 'Macro name', 'Macro key', 'Macro value' and the 'Encode equals between macro key and value' check box. 

    Note: You can add multiple search statements. 

    Search Query

    Optional: Enter a search query to apply this Targeting Rule when the defined query is fulfilled.

    Note: The search query is evaluated on the following video attributes: Title, Description, Keywords, Categories and Duration. For further details, please see Video Object Indexed Properties.

    For example: To apply this Targeting Rule each time a video includes the word 'Disaster' in the title enter the following statement in the Search query field: name:"disaster".

    Macro Name

    Optional: Enter a placeholder name that can be used to send a Macro Key and Value back to an Ad server when the search query is fulfilled. You can enter any placeholder name in this field.

    For example: If you want to pass a parameter and value of 'x=y' to the ad server each time a video that is playing back includes the word 'video' in it's title, we will enter an arbitrary placeholder name, say 'passBack'. This placeholder will then need to be added to the VAST URL address query string. For further details, please see How to add your Macro Name Placeholder to your Targeting Rule VAST URL.

    Note: Go back to the 'General' tab of this Targeting Rule and add your placeholder to the 'VAST URL' field query string between a set of square brackets. http://the.ad.server.com?[passBack]

    Your macro name placeholder will be replaced upon fulfillment with the following Macro key and value as you define them.

    Macro Key

    Optional: Enter an ad server supported parameter name to pass back to the Ad server when the search statement is fulfilled.

    For example: If I want to pass to the ad server a parameter of 'negativeNews=true' each time a video that is playing back includes the keyword 'Disaster' in it's title, enter the the parameter name 'negativeNews' in this field.

    Macro Value

    Optional: Enter an ad server supported parameter value to pass back to the Ad server when the search statement is fulfilled.  

    For example: If I want to pass to the ad server a parameter of 'negativeNews=true' each time a video that is playing back includes the keyword 'Disaster', enter the ad server supported parameter 'true'. 

    Encode equals between macro key and value

    Optional: Selecting this check box will ensure that the equals symbol '=' between your custom Macro Key and Value pair will be passed to the Ad server after it has been encoded.

    Note: This is required when passing an Ad server macro to ONE Video (Adap.tv).



  19. Optional: Go to the 'Player Parameters' area and apply the required fields according to the following table:

    Note: These fields are used to pass specific parameters and values to enforce Player functionality.

    Field Name Description
    Add Attribute

    Optional: Click on this button to pass a supported parameter and value to the player when this Targeting Rule is eligible. After clicking this button a new attribute name and value fields will be displayed.

    Note: Currently the only supported player parameter is 'minibar=true'.

    Attribute Name

    Optional: Enter a supported player parameter name in this field.

    For example: If you want to enforce the player Minibar ad controls to this player, enter 'minibar' in this field.

    Attribute Value

    Optional: Enter a supported player parameter value in this field.

    For example: If you want to enforce the player Minibar ad controls to this player, enter 'true' in this field.



  20. Optional: Go to the 'Viewability' area and apply the required fields according to the following table:

    Note: This field is used to apply this Targeting Rule when certain Player viewability requirements are met.

    Field Name Description
    MOAT Viewable Opportunity

    Optional: Enter a value on a scale of -1 to 100 indicating the player viewability level required for this Targeting Rule to be eligible (-1 means that the value us undetectable, while 0 means that the player is not in view in the browser's viewport).

    For example: If you want this Targeting Rule to be eligible for Players that are more than 50% viewable according to MOAT viewability tracking enter a value of 50 in this field.

    adap Prebid

    Optional: Select a player viewability status required for this Targeting Rule to be eligible according to the following options:

    • Viewable.
    • Not Viewable.
    • Unknown.
    • All.

      Note: When this option is selected the other check boxes cannot be selected.



  21. Click on 'Save'. Your Targeting Rule is saved and active.
Have more questions? Submit a request