How to Create an Ad Campaign

What is an Ad Campaign?

Ad campaigns are used to manage your advertisement settings on one or more players. Each campaign represents an ad request to an ad vendor with the goal of receiving an ad/s for your player.

Note: Ad campaigns are added to Ad sets which are then linked to players. For further details, please see Introduction to our Player ad serving logic.

 

Create an Ad Campaign

This process only describes mandatory steps. Each image is followed by a step-by-step description.

To assign create an ad campaign, perform the following steps:

  1. Log in to the Portal by clicking here.

    NUI_Create_Ad_Campaign_001.jpeg

  2. Hover over 'MONETIZATION' in the Portal menu and select 'AD CAMPAIGNS'. The ad campaigns page is displayed.

  3. Click on 'Create New'. An ad campaign edit page is displayed.

    NUI_Create_Ad_Campaign_002.jpeg

  4. Enter a name for your ad campaign in the 'Ad Campaign name' field.

  5. Click on the x button and enter the name of the required company in the Company name field to change the ownership of this ad campaign to one of your affiliates or back to your white label.

    Note: The default company is inherited from the user's company context menu.

  6. Click on the 'ENABLED' button to make this ad campaign available for use with players.

    Note: Keep this check box deselected if your ad campaign settings have not been completed.

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

    Field Name Description
    CAMPAIGN TYPE

    Select one of the following options from the drop down menu:

    • Direct - Select Direct for Direct sold ads, where there will always be an ad available. The Direct Sold campaign could be hosted by a network such as LiveRail, Adap.tv, etc, but ads will always be available. This is the default.
    • Network - Select Network if this is a call to an ad network, such as LiveRail, Adap.tv, etc. and when the call may or may not return an ad.

    Important: If you want the player to perform its advertising media logic (similar to a waterfall but more advanced), you must have all of the campaigns in your ad set set as the campaign type of "network".  If you have a mixture of "network" and "direct" campaigns the ad server will only delivery the single highest priority "direct" campaign.  This disregards any type of multi-ad tag mediation (more advanced waterfall).

    Note: For further details, please see Direct vs. Network ad campaigns and Ad prioritization logic.

    VENDOR

    Select an ad vendor to associate with this ad campaign.

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

    EXPECTED CPM Enter the CPM (cost per thousand ad impressions) provided by your ad vendor. This value is used for reporting and revenue optimization. For Network campaigns (see the Campaign type field above),  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. 
    CLIENT COST CPM Enter the CPM to be charged to the company's client.
    CPM PER PUBLISHER Allows you to add a CPM fixed for a specific Publisher(s).
    ENGINE TYPE

    Select an ad engine type for the player from the drop down menu according to the following options: This defines how the player can 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, an XML schema that allows you to define ad breaks and their timing within a content video. These ad breaks can then be filled with VAST ad responses.
    • Video - The source of the ads are videos placed in the Portal itself.

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

    MEDIA TYPE

    Select on what target devices the ad campaign will be served from the drop down list according to the following options: 

    • All (Default) - The ad campaign will be served on all devices (mobile and desktops).
    • Mobile - The ad campaign will be served only when viewing the player on mobile devices.
    • Desktop - The ad campaign will be served only when viewing the player on computers (Mac, PC's etc.)
    URL Enter the required ad campaign 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://.
    ALLOW OVERDELIVERY Allows the Ad Campaign to continue being delivered after reaching set limits of impressions ('OVERALL IMPRESSIONS' and 'DAILY IMPRESSIONS') or after the 'END DATE' expiration. 
    START DATE The date this Ad Campaign should be available and begin running ads. The default is the current day. If no Start Date is specified, the ad impressions will begin immediately.

    Note: The timezone used for the date selection is UTC.
    END DATE

    The date this Ad Campaign should stop being available. If no End Date is specified, the ad impressions will run forever.

    Note: The timezone used for the date selection is UTC.

    MINIMUM PLAYER WIDTH

    Enter a minimum player width requirement (in pixels) for this ad campaign to run. Players that are smaller than the specified width will not be able to request this ad campaign.

    ACCESSIBLE ONCE PER (SEC)

    Enter a value in seconds to limit the number of times this Ad Campaign will be requested.

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

    FREQUENCY CAP Allows you to set how many times per given period this Ad Campaign will run for a single user.
    OVERALL IMPRESSIONS

    Enter an overall limit of impressions upon which the ad campaign will stop running.

    Note: The default is set to infinity, meaning that the ad campaign will continue to serve ads forever.

    OVERALL PACING

    Allows you to define filling target impressions during the entire period of this Ad Campaign availability according to the following options:

    • Greedy - Impressions are not distributed.
    • Evenly - Impressions are evenly distributed during the whole period of this Ad Campaign.
    DAILY IMPRESSIONS Enter a daily limit of impressions upon which the ad campaign will stop running during that day (24 hours).
    DAILY PACING

    Allows you to define filling target impressions during a day according to the following options:

    • Greedy - Impressions are not distributed.
    • Evenly - Impressions are evenly distributed during a day and/or during the whole period of this Ad Campaign.
    PER PUBLISHER IMPRESSIONS Allows you to enter a number of impressions to evenly divide the impressions amongst the publishers.
    INDIVIDUAL PER PUBLISHER IMPRESSIONS Allows you to set a specific number of impressions for a specific publisher.
    CAMPAIGN CATEGORIES Allows you to add one or more categories to your Ad Campaign to run it on domains that have the same categories.

    Note: Your Ad Campaign will only run on domains owned by the owning Company for this Ad Campaign. 
    GEO TARGET Enter a country name and select the appropriate country from the drop down list to define geographic targeting for this ad campaign. You can add multiple countries by repeating this process. 
    AVAILABILITY SCOPE

    Allows you to define where your Ad Campaign will be available for viewing according to the following options:

    • Everywhere - your Ad Campaign will be available on any portal as long as the user has access permissions to them.
    • Only on my white label - your Ad Campaign will be available only on your white label (your private branded exchange).

    ACCESSIBILITY

    Allows you to define who will be able to view ads served with this Ad Campaign according to the following options:

    • Public - All users (in either the portal or white label) will be able to view ads served with this Ad Campaign.
    • Private - Only you and administrator users (in either the portal or white label) will be able to view ads served with this Ad Campaign.
    • BlackList/WhiteList - Selecting this option will allow you to define, on a more granular level, who will be able to view ads served with this Ad Campaign (in either the portal or white label).
    SITE TARGET

    Allows you to blacklist/whitelist specific domains.

    DELIVER ONLY ON OWN CONTENT Click on this button to serve ads through this Ad Campaign only against video content that is owned by the same company that owns this Ad Campaign.
    TARGET SPECIFIC CONTENT Allows you to map ads served with this Ad Campaign to specific videos.
    COMPANY GROUP TARGETING Select a Company Group(s) to serve ads with this Ad Campaign against video content owned by it. Ads will be served only if the Publisher's company belongs to the selected Company Group. 
    AD TYPE

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

    • Preroll - Ads that are run before a content video.
    • Midroll - Ads that are run during a content video.
    • Postroll - Ads that are run after a content video.
    • Overlay - An overlay that is displayed on top of the player during the content video to create engagement with the viewer.
    • Bumper - A six-second ad that is typically run before a content video.
    • Promo - A short (usually 15 seconds) ad that is typically run before a content video.
    • All - A combination of more than one of the ad types listed above.
    PRIORITY BOOST

    This field is used to boost the priority of the current campaign (in relation to others) when starting out the ad campaign. The value entered here acts as a multiplier on the expected CPM without changing the entered value of the 'Expected CPM' field (see above).

    Important! Our ad serving logic prioritizes ad campaign not only based on your defined 'Priority boost' and 'CPM', but also on the ad campaign's performance since it has begun. This means that if the ad campaign has already started, the 'Priority boost' cannot be used to prioritize your ad campaigns on the fly. 

    Important! The boost priority field will affect all 'Ad sets' across the system to which this campaign was linked. For further details see Priority calculation.

    IMPRESSION TRACKER

    Allows you to apply a custom tracking pixel URL if you want.

    Note: Custom macros can be included in the impression tracker. For more information and steps of implementation, see Passing Custom Macros from the Player Tag to Third Party Tag.

    PARSE LOGIC This field is not in use.
    ALLOW MULTIBURN Selecting this check box will allow this ad campaign to request ads when multiple players have been implemented on the same page.
    STRICT SITE CHECK

    Selecting this check box will prevent the player from requesting ads from this campaign if the player's embed code URL parameter value is not identical to players dynamically detected URL when loaded. 

    Note: For further details see How strict site check works.

    USES SHIM

    Selecting this check box will define this ad campaign 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 Ad campaign 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 ad campaign is not selected, the ad campaign 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

    Selecting this check box will apply the Mobile Ad Autoplayer functionality to this Ad Campaign.

    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.

    SYNC GROUP NAME

    This field is used to aggregate shimmed ad campaigns that are requested from the same ad vendor (for example, multiple ad campaign from Adap.tv). Entering a name in this field will prioritize ad requests from the same ad vendor (that have been given the same 'Sync group name')  to prevent too many ad requests from going out at the same time.

    This field is used to designate two or more ad campaigns that cannot be loaded at the same time.  By assigning a sync group name to a series of ad campaigns, this will ensure that they are never requested/loaded at the same time within the player.

    Note: If this field is left blank, it will inherent the ad campaign's ad vendor's sync group name.

    Note: For further details see What are sync group names.

     
    NUI_Create_Ad_Campaign_003.jpeg

  8. Click on 'ADVANCED'. The 'ADVANCED' tab is displayed.

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

    Field Name Description
    FRAUD Apply the required fraud setting according to the following options:

    • Off - Selecting this option will disable fraud settings for this Ad Campaign.
    • Overall - Selecting this option will allow you to set an overall brand safety and fraud threshold, that when crossed will not allow the Ad Campaign'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, Integral Ad Science, WhiteOps, and DoubleVerify.

      After selecting the relevant option you will be able to select an operator and set a value. The operator options are:

    • = - Equal.
    • < - Smaller than.
    • <= - Equal or smaller than.
    • > - Bigger than.
    • >= - Equal or bigger than.
    BRAND SAFETY - Overall Allows this Ad Campaign to display an ad when the Brand Safety level is according to a specified level. 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.
    Turn on DoubleVerify Fraud Source Select this check box to activate fraud detection service from DoubleVerify.
    Match if Brand Safety or Fraud Value is Unknown Selecting this check box will make this Ad Campaign eligible if one or more of our Brand Safety or Fraud scores are return without a value. 
    MOAT VIEWABLE OPPORTUNITY

    Enter a value on a scale of -1 to 100 indicating the player viewability level required for this Ad Campaign 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 Ad Campaign to be eligible for Players that are more than 50% viewable according to MOAT viewability tracking enter a value of 50 in this field.

    Select an operator and set a value. The operator options are:

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

    Enter any custom attributes (parameters and values) using the 'Name' and 'Value' fields. Your Ad Campaign will serve ads that have the same custom attributes.


  10. Click on 'SAVE'. Your ad campaign may now be assigned to an Ad set.

 

 

 

 

Have more questions? Submit a request