The Campaign Manager is user administration component of the RTB4FREE platform. It interfaces directly the bidders via Crosstalk, and the ELK data store (if employed) The Campaign Manager is a Ruby on Rails version 4.2 application. The source code with program description can be found here: https://github.com/rtb4free/campaignmanager
Features at a glance:
The Campaign Manager is a simple web application that allows you to setup and control campaigns. It provides targeting, budgeting, frequency capping, and reporting capabilities.
The default user-name is firstname.lastname@example.org and password is rtb4free. After you login, hit the Refresh button to show the Dashboard page of the Campaign Manager.
To summarize, use the following sequence to define a new campaign:
The campaign is accessed via the "Campaigns" panel. Example:
Pressing the New Campaign button will bring up the following screen:
Fields with "*" indicate a required field. Most of the fields are self-explanatory, with the exception of Region, and Rules. A Region is a bidding region. It is the name given to a group of bidders controlled by Crosstalk. Only one Region can be specified. If you are set up to bid in the US, then use US as the region. If in Asia, use AP, and if in Europe use EU.
Rules are specific constraints applied to the campaign gathered from the bid requests and are discussed further in a later Rules section.
Once you have a campaign created, you can add Banner and Video ads.
A video creative is a Video that plays in a VAST player. The video creative is accessed via the the "Videos" panel. An example is shown below:
A campaign is the offering of one or more creatives over a certain time period, and with specific targets. We use the term target to mean common constraints that filter out those bid requests to match your target market. When we say creative we mean a banner ad, a video or a native ad.
Here is a Target screen from the campaign manager:
The most commonly used contraints are available for you to choose. Specifically you can target:
If you need finer grained or custom selection selection contrainats, see the "Rules" section.
The rules for pricing are this:
Deals are set up within the Video and Banner creatives by checking the . You can add one or more deals. Example:
To eliminate the need to hard code things in the Banner and Video creatives, and to allow you to pass information about the bid request, macro substitutions are provided for you. Here is a list of Macro definitions understood by the RTB4FREE bidder:
Note, the RTB exchange can make substitutions in the ADM field as it delivers it to the web site. The RTB exchange will reflect the ADM back on the win notification, and you can ask for the RTB exchange to also substitute fields as well. See the RTB 2.5 specification for supported macro names.
These are the macros substituted by the Exchange, not the
bidder. so these will return via the RTB win notification and
as the ad is delivered into the web page.
You can set hourly, daily and total budgets on the Campaign and Banner and Video creatives. Simply go to the Campaign, Banner and Video panel and put your desired budgets in. Example:
A frequency cap can be set on creatives which sets forth how often your ad will appear to the same device. It is set in minutes and the frequency within that time period. It is set on the Banner and Video panels. Example:
A rule is simply a question applied to the values on the bid request against a constraint defined in the Campaign or Creative. The question is framed such that the response will be True or False. An informal rule might be "Is user.id equal to "XXX", or "Is user.id contained in the set "my_cookies".
A series of rules are used to "filter" the Bid Request against the definition of the campaign.
Selection of a campaign, and the creatives within a campaign is a function of a list of "rules" that are applied to attributes of the incoming bid request. Each rule is applied in turn to the bid request. Each rule returns a value of True or False. A value of True means as far as that individual rule is concerned, the Campaign/creative is a candidate for making a bid. If at any time, a rule evaluates to false the Campaign/creative is not a candidate for making a bid and rule processing for that Campaign/creative is terminated.
A rich set of operators is provided for the RTB to work with. This list includes all the actions we have encountered over the past several years.
Rules are defined with the Rules panel. Here is an example:
The dashboard gives you a quick overview of how all your campaigns are performing over the last hour, day, week and total. Example:
All the RTB4FREE configuration files are designed to work in concert with Docker compose files so that key parameters can be changed with environment variables. See the Deploy section for details.
You can define additional user logins for the Campaign Manger. After logging in to the campaign manager, using credentials email@example.com/rtbfree, navigate on the left part of the screen to Admin Users. The screen will look like this
To add a a new user, Select the New User button and fill it out. Note! Check the Administrator checkbox, to allow give this user the ability to create users and edit the documentation options.. Press Update to save the user.