Quick-start guide

Let's make a basic ad serving setup. You will learn:

  1. How to create a publisher.
  2. How to create a zone.
  3. How to create an advertiser.
  4. How to create a campaign.
  5. How to create an ad item.
  6. How to assign a campaign to a zone.
  7. How to place zone tags.
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 and The AdButler interface.

Step 1: Create a publisher

The main Publishers section in AdButler

  1. Click on Publishers in the left navigation menu to go to the main Publishers section.


  1. Click Add Publisher. The New Publisher page will appear.


  1. Give your publisher a name then click Create Publisher. To follow this guide, use the name Example Publisher. The other fields are optional, so you can leave them as they are. The newly created publisher will appear in the table of publishers in the main Publishers section.
If you choose to add a URL in the domain field, do not add the scheme, which is usually https://. Enter only the domain itself, e.g. example.com.
For more information about publisher properties and settings, read Publisher overview.



Step 2: Create a zone

A new Publisher's section in AdButler

  1. Click on the publisher you created in Step 1 (Example Publisher) to go to its section. Among other things, the publisher's section is where you manage zones, which are spaces on the publisher's site where ads will be shown.


  1. Click Add Zone. A window to select which zone type to create will appear. To follow this guide, click on Standard Zone.


  1. Give the zone a name then choose its size. It helps to name zones clearly and consistently to make them easy to identify throughout the AdButler interface. To follow this guide, create a fixed 300x250 zone and name it Example Zone.

Creating a standard zone in AdButler

You can select from a list of preset sizes in the dropdown or enter pixel dimensions in the fields to the right of the dropdown. If you wish to show various sizes in a single zone (for example, a 728x90 to desktop users and a 320x50 ad to mobile users) select Dynamic instead of Fixed. For more information, read Zone overview.


  1. Click Create Zone to finish setting up your zone. The newly created zone will appear in the table of zones in the section of the publisher to which it belongs. The table shows the name, type, and size of created zones, as well as the number of ad items and campaigns in each zone. There is also a handy button that lets you get zone tags, which are explained later in this guide.


Click on the zone to go to its section, where you can manage campaigns, ad items, and header bidders assigned to that zone. For more information, read Zone overview, Campaign overview, Ad item overview, and Setting up header bidding zones.


Now that you have a publisher and a zone inside that publisher, you can create an advertiser that will serve ads to the zone.



Step 3: Create an advertiser

The main Advertisers section in AdButler

  1. Click Advertisers in the left navigation menu to go to the main Advertisers section.


  1. Click Add Advertiser. The New Advertiser page will appear.


  1. Give your advertiser a name then click Save this Advertiser. To follow this guide, use the name Example Advertiser. The newly created advertiser will appear in the table of advertisers in the Advertisers section.
For more information about advertiser properties and settings, read Advertiser overview.




Step 4: Create a campaign

An advertiser's section in AdButler

  1. Click on the advertiser you created in step 3 (Example Advertiser) to go to its section.


  1. Click Add Campaign on the top right of the Campaigns table. A window to select which campaign type to create will appear. To follow this guide, click Standard Campaign.


  1. Give the campaign a name then click Create Campaign. To follow this guide, use the name Example Campaign. The newly created campaign will appear in the table of campaigns in the section of the advertiser to which it belongs.

Creating a standard campaign in AdButler

Click on the campaign to go to its section, where you can manage ad items and zone assignments. For more information, read Ad item overview, How to Assign Campaigns to Zones or Channels, and Assignment overview. Step 6 of this guide will also show you how to assign your campaign to your zone, but you have to do Step 5 first.




Step 5: Create an ad item

A campaign section in AdButler

  1. Click on the campaign you created in Step 4 (Example Campaign) to go to its section.
You can also assign ad items directly to a zone. However, we recommend doing this only for default, fallback, or house ads.


  1. Click Add Ad Item on the top right of the Ad Items table. A window to select which ad item to create will appear. To follow this guide, click on Image. The New Ad Item page will appear.

The Add Ad Item window in AdButler


  1. Give your ad item a name. To follow this guide, use Example Ad Item. Under Image source, click Library then Browse... and upload an image. Under Size, you must select or enter a resolution that matches the one in the zone to which this ad item will be served. If you've been following this guide, the zone you created in Step 2 has a resolution of 300x250, so that's what you should select for this ad item as well. Leave the other fields as they are. For more information about image ad item fields, read Creating an image Ad item.

The Create New Image Ad Item page


  1. Click Save Ad Item to finish creating the ad item. It will appear in the table of ad items in the section of the campaign to which it belongs. You can check what the ad looks like by clicking on its name in the table then clicking Preview.


Now that you have an ad item in your campaign, you can assign the campaign to an existing publisher zone.

For more information on ad item types and properties, read Ad item overview.




Step 6: Assign the campaign to the zone

A campaign section in AdButler

  1. From a campaign's section, click Assign to Zone on the top right of the Zone Assignments table. A window to select eligible zones will appear.
The window will list only the zones that match the type and size of the campaign.


  1. Click on the zone you created in Step 2 (Example Zone). The assignment details page will appear. You will be asked to select which serve method to use. For more information, read Serve Method Options. To follow this guide, select Fixed Delivery.


  1. The rest of the assignment details fields will appear. To follow this guide, leave them as they are. For more information, read Pacing & Schedule, Financial settings, Frequency Capping, and Targeting. Click Save. The name of the zone to which you assigned the campaign will appear in the Zone Assignments table in the campaign page.

Assigning a campaign to a zone


Now that you've assigned a campaign to a zone, you can generate a zone tag. It's a snippet of code that must be placed on the publisher's website to allow the ads in the campaign to be served when the page is loaded.



Step 7: Place the zone tag into your site

The Zone Tags button in a publisher section

  1. Click Publishers in the left navigation menu to go to the main Publishers section.

  2. Click on the publisher you created in Step 1 (Example Publisher) to go to its section.

  3. Click on Get Tags in the Zone Tags column of the zone you created in Step 2 (Example Zone). The Zone Tags window will appear. To follow this guide, leave the fields as they are. For more information, read Zone tag overview.

You can also get to the Zone Tags window from a zone's section (Your AdButler > Publishers > Your Publisher > Your Zone). Click on Get Zone Tags/ JSON Ad API in the right menu to make the window appear.

The Get Zone Tags button in a specific zone's section

The Zone Tags window in AdButler

To serve ads on a secured domain (https), keep the Use Secure Tags (https) option enabled.
  1. If you are the publisher, you can copy and paste the code on your website. You can also email the zone tag from this window.


This concludes the guide. The campaign you created should be able to serve ads to the website where the zone tag was placed. Each time the page loads, the tag will make a request to AdButler's servers. The page will then receive the ad that was assigned to that zone.

This demonstrates the core function of AdButler, but there are many ways to customize your ad serving setup. We encourage you to read more of our documentation. You can also get in touch with our support team by opening a support ticket while you are logged in to your account.


Can't find what you're looking for?

Send us an email

hello@adbutler.com

Visit the blog

For more ad serving tips, industry news and AdButler insights.