Implementation Guide

Setting up your account

You will receive an email notification once your GumGum.com account has been activated. Follow the link in the email to set a password for your account. Please note you will need to provide your payment information on GumGum.com in order to gain access to the full dashboard and begin servng GumGum ads.

Creating Zones

Zones distinguish different sites and ad placements across your account for reporting and ad targeting purposes. If you have multiple sites, you will need to create a unique zone for each of them. If your site has multiple different types of content such News, Sports, Entertainment, Technology, etc, or if you need to have precise control over which types of ads appear on different sections of your site, it is also recommended to create a unique zone for each section. Each zone has its own unique ID and Javascript embed code.

To create a zone, go to the "Manage" page on the GumGum.com publisher dashboard. When you create a new zone you will need to enter the site name, domain and vertical. Once your zone is created, you will have access to the Javascript embed code to place on your site. Additionally, you will have the ability to enable and disable ad services for your zone. Note that each Javascript embed code is specific to the domain approved for that zone and the embed code will not work if placed on a different domain. Once you have placed the embed code on your site, the site content will be manually reviewed by GumGum's trust and safety team. Ads will not begin to appear until your site has been reviewed and approved. This typically takes 24 hours or less.

Deploying the GumGum embed code

Please choose the option that best describes your site:

I host my own site

You will have to edit your site template in order to add the GumGum code.

  1. Insert the GumGum code immediately above the closing body tag, which will generally be located in the "Footer" section of your template. You can find it by searching for: </body>
  2. Save your changes and re-publish your site if necessary.
I have a Wordpress site

Manual deployment

  • In your Wordpress admin dashboard, navigate to the "Appearance" option, and then to the "Editor".
  • Open the file footer.php for editing.
  • Paste your GumGum embed code directly above the closing body tag (</body>).

Using the GumGum WP Plugin

  1. Download the GumGum for WordPress plugin, and install it using the WordPress oficial instructions.
  2. Once the unzipping is complete, check the Plugins > Installed menu to make sure the plugin is present. If it's present but an "Activate" link shows below the title, then the plugin needs to be Activated. Click "Activate" to do so.
  3. Click Settings > GumGum and follow instructions to configure your ad services to your Zone(s).

Note: be sure to enter your Zone ID - the unique combination of 8 letters and/or numbers that is assigned to each Zone. Ad services will not be activated unless a Zone ID is provided. You can find your Zone ID(s) on the "Management" page on the GumGum Publisher Center.

I use a different blog platform

You'll have to edit the template for your blog in order to add the GumGum code. Most blog platforms have a setting for "Edit HTML" or "Edit Template" where you can modify the code directly. Locate this setting and do the following:

  1. Insert the GumGum code immediately above the closing body tag, which will generally located in the "Footer" section of your template. You can find it by searching for: </body>
  2. Save your changes and re-publish your blog if necessary.
I want to load GumGum through an ad server

If you do not serve your ad units inside an iFrame, you can use a 1x1 ad call to load our Javascript tag.

If you are serving through an IFrame, there are two basic steps.

  1. Place the GumGum IFrame-Buster file on the domain where you will be using the ad server to load ads.
  2. Deploy the IFrame-Ready GumGum embed code.

IFrame Buster File

Copy the following file and make it available on the web server(s) at the domain(s) on which GumGum services will run:

http://ads.gumgum.com/com/gumgum/ib/gumgum.html

Below is an example of how the IFrame-Buster URL path will look when the file has been placed correctly at the root of your domain:

http://www.publisher.com/gumgum.html

IFrame-Ready Embed Code

In the ad server please setup the 1x1 unit with the following code:

<!DOCTYPE HTML>
<iframe src="http://{DOMAIN}/gumgum.html?{ZONE_ID}" frameborder="no" scrolling="no" width="0" height="0"></iframe>

Important: Replace the {DOMAIN} and {ZONE_ID} tokens with the site domain and GumGum-issued zone ID respectively.

For example, if the domain is www.publisher.com and the Zone ID is abcd1234, the final embed code should look like this:

<iframe src="http://www.publisher.com/gumgum.html?abcd1234" frameborder="no" scrolling="no" width="0" height="0"></iframe>

Note: www.publisher.com and publisher.com would be considered 2 separate domains and would require 2 different instances of the embed code.