Quick-start guide

This quick start guide will walk you through a basic ad serving setup. It will show you how to create a publisher with zones for serving ads to, and an advertiser with a campaign to assign to that zone.

The steps shown in this guide assume you understand the basic elements of AdButler. If you have not yet done so, read how AdButler serves ads ...

Step 1: Creating a Publisher

  1. Navigate to the publisher section by clicking "Publishers" from the left-hand navigation panel.


  1. Click on "Add New" above the table.


  1. Give your publisher a name and click "Save". For this guide, we'll use the name "Example Publisher"



Step 2: Creating a Zone

  1. Click on the publisher you just created, named "Example Publisher".


  1. This will open up the publisher and show you all of the zones that currently exist for that publisher. Click the "Add New" button above the Zones table and select a zone type from the dialogue window that pops up. For this guide, we will create a "Banner Zone" so choose that from the list.


  1. Give this banner zone a name and choose a size. It helps to name your zones clearly and consistently so that you can identify it as it appears throughout the AdButler interface. For this guide, we are going to create a run-of-site 300x250 zone, so I'll give it the name "ROS - 300x250".
Banner zones and e-mail zones are restricted by size, which you can select from a list of presets in the dropdown or enter custom pixel dimensions in the fields to the right. Alternatively, you can select the "Dynamic" checkbox to remove specific dimensions if this zone needs to be responsive or resized. Read more about zones...


  1. Click the "Create" button to finish setting up your zone. It will now appear under “Zones” in your Publisher dashboard. The details shown in the table are the zone name, type, and size, as well as the number of banners and campaigns contained within it. There is also a quick link to retrieve zone tags that we will explain later in this guide.


  1. If you click into the zone, you’ll see all the available options for each zone. You can upload Banners directly to a zone as a fallback ad, assign advertiser campaigns to serve in this zone, and create popup ads that fire according to certain rules.


Now that you have a publisher set up with a zone available to receive ads, we will move on to creating the Advertiser that will be assigned to serve ads to our publisher's zone.




Step 3: Creating an Advertiser

  1. Navigate to the advertiser section by clicking "Advertisers" from the left-hand navigation panel.

  2. Click on "Add New" above the empty list of advertisers.


  1. Give your advertiser a name, for this guide we'll use the name "Example Advertiser". Click "Save" and you should now see your new advertiser show up in the list.




Step 4: Creating a Campaign

  1. Click on the advertiser we just created named "Example Advertiser" to view that advertisers dashboard. There will be three empty tables listed, "Banner Campaigns", "Text Campaigns" and "VAST Campaigns".


  1. For this guide, we will create a "Banner Campaign" to serve to our "Banner Zone" that we just created. Click on "Add New" under "Banner Campaigns".


  1. Enter the name for this campaign and set the size to match the Publisher zone we created. For this example, we'll name our campaign "Example Campaign - 300x250" and make sure the 300x250 Medium Rectangle ad is selected from the drop-down. Click "Save" to finish creating your campaign.

  2. Once you have created the new campaign, you'll see it added to our Banner campaigns table. Click on it to view the contents of that campaign.




Step 5: Creating a Banner

  1. Inside your campaign, you can see all the banners and zone assignments associated with that campaign. The first step is to upload a banner, click on the “Add New” button in the “Banners” list to create one.


  1. Choose "Image Banner" from the list of options. Each type of ad you are serving requires a specific banner type to be used.


  1. In this screen, you will give your banner a name, assign it a destination URL and upload the banner creative. The rest of the fields are optional and allow you to add more details and behaviours to your ad. For this example, the name is "Example Banner", the destination URL is "https://www.adbutler.com" and we're going to upload an image file by selecting the "Library" checkbox and clicking on "Browse" to locate our ad image file.


  1. Click on "Save" to complete the banner set up.




Step 6: Assigning the Campaign to a Zone

Now that we have a banner in our campaign we need to direct it to serve to an existing publisher zone by creating a zone assignment.

You can also navigate to the zone you would like to assign a campaign to and choosing “Assign a Campaign” under the “Assigned Campaigns” table.
  1. Click the “Assign to Zone” button under the “Zone Assignments” table on the campaign page.


The next screen shows you a list of all available zones that you can assign this campaign to. You will only be able to see zones that match the campaign type and size as the campaign you are currently trying to assign.

  1. Click the zone we created in Step 2 called "Example Zone" to set up your zone assignment.


  1. The next screen displays all the assignment settings that will control how this ad is served. For now, we can leave these settings at their defaults and click on "Save" at the bottom of the page.


You will now see the zone you've assigned your campaign to listed under the "Zone Assignments" table.




Placing Zone Tags

Now that your Advertiser campaign and Publisher Zone is set up and connected with a Campaign Assignment, we’ll need to place the Zone Tag script on the publisher’s website to allow the ad to serve when the page is loaded.

  1. Navigate to the Publisher Zone we created in Step 2 and click the “Get Zone Tags” button at the top right of the screen.


  1. The tags dialogue box allows you to configure the custom parameters and choose the tag type needed for your specific implementation. Adjusting these settings will update the zone tag shown in the block of code in the large text field below. In most cases, we recommend using the default zone tag settings.
If you are serving ads on a secured domain (https) you will need to make sure the "Use Secure Tags" option is selected to ensure your ads are able to be delivered to sites using SSL.


  1. Select and copy the zone tag shown in the block of code and paste it in the publishers' website HTML code, wherever the ad is supposed to show up on the page.
If you are the website owner, you can place the code yourself, or email the tag directly to your publisher for them to add it to their page.




Your campaign should now successfully serve to the website where the zone tag was placed. Each time the page loads, the tag will make a request to AdButler's servers and the page will receive the ad that was assigned to the zone. This setup outlines the core functionality of serving ads with AdButler, but there are many more complex settings that can be applied for more custom ad serving solutions.

We encourage you to read through our documentation to learn more about AdButler or get in touch with our support team by opening a support ticket.

Can't find what you're looking for?

Send us an email

hello@adbutler.com