Salesforce

Header Bidding with Prebid.js - UI setup

Printable View
« Go Back
Information
Header Bidding with Prebid.js - UI setup
Header-Bidding-with-Prebid-js-UI-setup
Details

About this article

This article explains the prebid.js setup in Equativ’s user interface. The setup of Equativ as a bidder on the client side (publisher's website) is explained here. Read here for the setup of Prebid Server in Equativ’s UI.

Activation

Using Equativ as a demand source in prebid.js requires activation. Get back to your Technical Account Manager to see if you are eligible. Without activation, Equativ will send empty ad responses ("noad").

Sign in to the user interface

Go to Equativ's user interface and sign in using your Manage ID and Password. The Manage ID has the format yourUserName@networkName (example: johnsmith@mediaxyz).

Create Formats

Formats represent sizes of ad slots (e. g. 300x250 / medium rectangle).
Go to Inventory > Formats and click “+”.

User-added image

  • define a format name
  • select Web to run desktop ads, mobile web ads and out-stream video ads
  • define the width (e. g. 300) and height (e. g. 250) of the format in the “Desktop” fields; there is no need to create additional formats for similar sizes; for instance, it is sufficient, to have one "300x250" format, which accepts both 300x250 and 300x300. Size handling is explained in detail below - see chapter "About acceptable sizes".
  • Click Save
  • Repeat the process for each format

If you need to run in-stream video ads, ask your contact at Equativ to enable it for you in your network. In-stream video formats are created by Equativ - no manual creation required. The in-stream formats are called Video - Linear and Video - Non Linear.

Create Websites

Go to Inventory > Sites & pages and click New.

User-added image

Create at least one website. Creating an individual website for each "real" website is only necessary, if you need granular reporting ("by website").

  • define the Site Name
  • make sure you enter the Site URL (in the format: http://domain.com) since it is required to identify the site in RTB in case Equativ cannot read it from the ad request
  • with the Ad Network rate (%) field, ad networks can define a revenue share to make Equativ send the net price to the publisher, taking the defined revenue share into account. This net price will then compete against other bidders in the header auction without the publisher being aware of the ad network's revenue share.
    Usage of this feature in case of prebid.js integrations requires activation in your network — get back to your contact at Equativ to have it enabled.
    Note that the percentage you enter in the Ad network rate (%) field is applied to the winning bid price (i. e. the amount returned by the DSP), just like the Equativ revenue share. For instance:
    • DSP winning bid: 100%
    • Ad network rate (%): 13.5%
    • Equativ revenue share: 20% (varies depending on conditions of contract with Equativ)
    • ==>  In this example, 66.5% of the DSP winning bid would be sent to the publisher site and compete against other bidders
  • click Save

Create Page groups

User-added image

Click New page group and enter a name.

User-added image
Edit the page group as shown above.
In the format list, enable all the needed formats and click Save.

Create pages

User-added image

Click on New page; enter a Page name and click Save.

Get the Ids for bid parameters  

Once you are done with the setup, you need to get the site IDs / page IDs / format IDs and forward them to the developer who does the client-side integration. The Ids will be used as bid parameters.

Go to Inventory > Sites & pages, click on the website in the left column and click on Download all tags for the site.

User-added image


On the following page, select Type Standalone and Standalone VAST 4 as shown in this screenshot:

User-added image

Click on Generate to download the txt file. The txt file contains:

  • code snippets for each format on each page of the site (in case of formats for display, mobile web and out-stream video ads)
  • a Preroll, Midroll and Postroll URL for each page of the site (in case of in-stream video formats)


Example code snippet for display, mobile web and out-stream video formats:

<!-- Format : 728x90 (728x90) -->
<script type="application/javascript" src="https://ced.sascdn.com/tag/73/smart.js" async></script>
<div id="sas_9689"></div>
<script type="application/javascript">
    var sas = sas || {};
    sas.cmd = sas.cmd || [];
    sas.cmd.push(
        function () {
            sas.call(
                { siteId: 20697, pageId: 415762, formatId: 9689, tagId: "sas_9689" },
                { networkId: 73, domain: "https://diff.smartadserver.com" /*, onNoad: function() {} */ }
            );
        }
    );
</script>
In the example above, you must copy the following IDs and forward them to the developer who does the client-side integration: siteId: 20697, pageId: 415762, formatId: 9689


Example code snippet for in-stream video formats: 
// Preroll
https://diff.smartadserver.com/ac?siteid=20697&pgid=1102773&fmtid=27153&ab=1&tgt=&oc=1&out=vast4&ps=1&pb=0&visit=S&vcn=s&tmstp=[timestamp]

In the example above, you must copy the following IDs and forward them to the developer who does the client-side integration: siteid=20697&pgid=1102773&fmtid=27153

Create RTB campaign

In the top navigation bar, click on Campaigns, then New campaign.

image.png
  • select RTB
  • define a Name
  • define the Start and end date (select an end date far in the future, e. g. 2 years from now)
  • select an existing advertiser or create a new one (you can also create a new advertiser under Administration > Advertisers); in case of a new advertiser, define the Name, User group (more details in User management); the Agencies selection can be ignored for this setup
  • click Create

Create RTB insertion

From the insertion list of the campaign, click New insertion.

image.png

 

General settings

The General settings section contains the main criteria defining the insertion.

image.png

  • Name - name of the insertion
  • Ad type - select the impression type and the environment Web; available impression types:
    • Display - ads on desktop/mobile websites
    • In-stream video - video ads embedded in a video stream (e. g. pre-rolls)
    • Out-stream video - for out-stream video ads using the mediaType banner (allows for the use of Equativ’s out-stream video creative templates, such as Smart Video-Read, Video Parallax etc.) or for out-stream video ads using the mediaType video (context outstream); in this case, Equativ only sends the VAST ad; publishers must implement their own video ad renderer; for more about these two types of out-stream video ad implementations, see chapter "Prebid.js out-stream video example" here
  • Priority - disable “Holistic Yield” and select the priority Exclusive 2 
  • Start and end date / Start and end time / Time zone - fill in the appropriate information

Placement

  • Select the appropriate formats
  • select one or multiple Site(s), Page(s) and/or Pack(s)

Creative template

image.png

The configuration in the Creative template section depends on the Ad type selected in the General settings section (see above).

Ads on desktop/mobile websites: 
  • works when the impression type Display is selected in the General settings section
  • use the preselected creative template RTB Default Banner 
  • add Acceptable sizes, if appropriate; if the "Acceptable sizes" field of the selected RTB insertion is empty, the sizes specified in the client configuration are used; if there is one or multiple sizes specified in the "Acceptable sizes" field, any sizes in the client side configuration are ignored completely; the acceptable sizes field allows you to retrieve custom sizes from Equativ without impacting the sizes returned by other SSPs;
  • for rich media ad formats, click on Library and choose from the available creative templates; before selecting one, first search for the creative template name in this Help Center and check if it supports Header Bidding

Out-stream video ads using the mediaType video with context outstream
  • for a better understanding of the two out-stream video implementations (using either mediaType video or mediaType banner) see chapter "Prebid.js out-stream video example" here
  • works when the Out-stream video impression type has been chosen in the General settings section
  • Warning: do not use the preselected creative template RTB+ Smart Video-Read
  • instead, click Library and select the creative template  [RTB+ VIDEO] VAST x (depending on the capabilities of your VAST video player)
  • configure the parameters of the selected creative template
  • make sure you set the parameter Video Placement Type to either In-Banner, In-Article, In-Feed or Interstitial/Slider/Floating
Out-stream video ads using the mediaType banner
  • for a better understanding of the two out-stream video implementations (using either mediaType video or mediaType banner) see chapter "Prebid.js out-stream video example" here
  • works when the Out-stream video impression type has been chosen in the General settings section
  • use the preselected creative template Smart Video-Read or click Library to select another out-stream video creative template; before selecting one, first search for the creative template name in this Help Center and check if it supports Header Bidding
  • configure the parameters of the selected creative template;
In-stream video ads
  • works when the In-stream video impression type has been chosen in the General settings
  • use the preselected creative template [RTB+ VIDEO] VAST x
  • configure the parameters of the selected creative template
  • make sure you set the parameter Video Placement Type to In-stream
Once you are done with the configuration, click Save and put online.
Powered by