Ads

Brightspot provides robust ad capability for your pages.

This section will provide you with the information you need to successfully place and publish ads on your pages.

Ad placement hierarchy

You can configure ad modules to appear at different levels in the content hierarchy.

Brightspot sends an ad request with the highest priority available in the content hierarchy. Referring to the following table, Brightspot checks if a particular asset has an ad feed (priority 1). If there is no such ad feed, Brightspot checks if one is configured for the content type (priority 2), and so on. As a best practice, configure a default ad feed at the global level so that all of your published content contains an ad—even for those levels in the content hierarchy for which you did not configure a tailored ad.

Level	Scope	Priority
Asset	You can tailor an ad or ad feed for an individual asset. For example, if you published an article about the final game of the World Series, you can tailor a distinct ad feed for that event.	1
Content type	The same ad or ad feed appears in all assets of a particular content type. For example, if you have blog posts, videos, and galleries, you can tailor a distinct ad feed for each content type.	2
Section-Content type	The same ad or ad feed appears in all assets of a specified type included in the section. For example, if you have a gardening section that has blog posts, you can tailor a distinct ad feed for the blog posts that appear in that gardening section.	3
Section	The same ad or ad feed appears in all assets of a section, not only certain types. For example, if you have a gardening section and a cooking section, you can tailor a distinct ad feed for each section.	4
Site-Content type	The same ad or ad feed appears in all assets of a specified type included in the site. For example, if you have a sports site that has a baseball section, you can tailor a distinct ad feed for the assets that appear in that site's baseball section. (That section may have overrides by content type, in which case you can tailor an ad feed at the site-section-content type level.)	5
Site	The same ad or ad feed appears in all assets on the site.	6
Global-Content type	The same ad or ad feed appears in all assets of a specified content type. For example, if you have a baseball section in any of your sites, you can tailor a distinct ad feed for the assets that appear in that baseball section. (That section may have overrides by content type, in which case you can tailor an ad feed at the section-content type level.)	7
Global	The same ad or ad feed appears in all assets on all your sites.	8

Ad considerations

The following sections provide guidelines you should consider as you design your ad feed.

Ad sizes

Typically, ads appearing as banners are wide and short, while ads appearing within text are square. Googles Ad Manager also provides an option for specifying an ad size based on the size of the visitor’s browser window. If the browser window is small, you can request a small ad; if the browser window is large, you can request a large ad.

Ad layout

Determine where on a page you want ads to appear. Publishers place ads above each item, below each item, wrapped inside each item, or combinations of all three. See the illustration in Modules for examples of where you can place ads.

Blocking ads

You can use a query string to block an ad feed. The key for the query string is disableAds, and you can configure the value. For example, if you chose a value 567abcded, then the following URL blocks an ad feed.

Configuring ad layout

This section describes how to lay out your ads at various levels in the content hierarchy.

Global level

1. Click > Admin > Sites & Settings > Sites > Global.
2. From the Front-End tab, expand the Layout cluster.
3. Scroll down to one of the drop-down lists Above, Aside, or Below, and select Replace.
4. Click , and in the module picker select Ad.
5. From the Ad list, select an ad module.
6. Click Save.

Global-content type level

1. Click > Admin > Sites & Settings > Sites > Global.
2. From the Front-End tab, expand the Type Specific Overrides cluster.
3. Under Type Specific Overrides, click .
4. From the Types list, select the content types for which you are configuring an ad layout at the global level.
5. Scroll down to one of the drop-down lists Above, Aside, or Below, and select Replace.
6. Click , and in the module picker select Ad.
7. From the Ad list, select an ad module.
8. Click Save.

Site level

1. Click > Admin > Sites & Settings.
2. From the Sites widget, select the site for which you want to deliver ads.
3. From the Front-End tab, expand the Layout cluster.
4. Scroll down to one of the drop-down lists Above, Aside, or Below, and select Replace.
5. Click , and from the Add widget select Ad.
6. From the Ad list, select an ad module.
7. Click Save.

Site-content type level

1. Click > Admin > Sites & Settings.
2. From the Sites widget, select the site for which you want to deliver ads.
3. From the Front-End tab, expand the Type Specific Overrides cluster.
4. Under Type Specific Overrides, click .
5. From the Types list, select the content types for which you are configuring an ad layout at the site level.
6. Scroll down to one of the drop-down lists Above, Aside, or Below, and select Replace.
7. Click , and in the module picker select Ad.
8. From the Ad list, select an ad module.
9. Click Save.

Section level

1. Create or open the section in the content edit form.
2. Expand Overrides > Layout Overrides.
3. Scroll down to one of the drop-down lists Above, Aside, or Below, and select Replace.
4. Click , and in the module picker select Ad.
5. From the Ad list, select an ad module.
6. Complete your site's workflow and publish the asset.

Section-content type level

1. Create or open the section in the content edit page.
2. Expand Overrides > Type Specific Overrides.
3. Under Type Specific Overrides, click .
4. From the Types list, select the content types for which you are configuring ad layout at the section level.
5. Scroll down to one of the drop-down lists Above, Aside, or Below, and select Replace.
6. Click , and in the module picker select Ad.
7. From the Ad list, select an ad module.
8. Complete your site's workflow and publish the asset.

Content type level

1. Create a content template based on the content type as described in Content templates.
2. Expand Overrides > Layout Overrides.
3. Scroll down to one of the drop-down lists Above, Aside, or Below, and select Replace.
4. Click , and in the module picker select Ad.
5. From the Ad list, select an ad module.
6. Complete your site's workflow and publish the asset.

Asset level

1. Create or open the asset in the content edit form.
2. Expand Overrides > Layout Overrides.
3. Scroll down to one of the drop-down lists Above, Aside, or Below, and select Replace.
4. Click , and in the module picker select Ad.
5. From the Ad list, select an ad module.
6. Complete your site's workflow and publish the asset.

Creating ad modules

Ad modules allow Google ad feeds to appear in your published site. The ads appear in an asset's above, aside, or below layout blocks. (For information about layout blocks, see Layout structure.)

Google AdSense

1. From your Google AdSense console, identify the slot you want to use for ad feeds in your Brightspot site.

2. Click > Ads.

3. Under Create, select Google AdSense, then click New.

4. In the Name field, enter a name. Brightspot uses this name in various widgets, such as Edit Site.

5. In the Slot field, enter the slot number you identified in step 1.

6. From the Ad Size list, select an existing ad size, or create a new one by doing the following:

   1. Select Create New.
   2. In the New Ad Size form, enter a width and height in pixels.
   3. Click Save, then click Back.
   4. From the Ad Size list, select the ad size you just created.

7. Click Save.

Google DFP

Note

This section describes incorporating ad feeds from Google DFP (DoubleClick for Publishers). While Google retired DFP in favor of Google Ad Manager, the terms in the following procedure apply to both DFP and Google Ad Manager.

1. From your Google DFP console, identify the slot you want to use for ad feeds in your Brightspot site.

2. Click > Ads.

3. Under Create, select Google DFP Ad, then click New.

4. In the Name field, enter a name. Brightspot uses this name in various widgets, such as Edit Site.

5. In the Slot field, enter the slot number you identified in step 1.

6. From the Sizes list, select an existing ad size, or create a new one by doing the following:

   1. Click .
   2. Select Create New.
   3. In the New Ad Size form, enter a width and height in pixels.
   4. Click Save, then click Back.
   5. From the Sizes list, select the ad size you just created.

7. In the Size Mappings field, configure the mapping between a browser's window size and the size of the ad feed. (For example, if the browser's window size is 1920×1080, you can ensure that ads of size 300×250 and 468×60.)

   1. Click .

   2. From the Minimum Window Size, select an existing browser window size, or create a new one by doing the following:

      1. Select Create New.
      2. In the New Window Size form, enter a width and height in pixels.
      3. Click Save, then click Back.
      4. From the Minimum Window Size list, select the window size you just created.

   3. From the Ad Sizes, select an ad size you want to be fed to the window size. Select an existing ad size, or create a new one by doing the following:

      1. Click .
      2. Select Create New.
      3. In the New Ad Size form, enter a width and height in pixels.
      4. Click Save, then click Back.
      5. From the Ad Sizes list, select the ad size you just created.

   4. Repeat step c to add additional ad sizes for the current window size.

8. Toggle on Hide on Mobile to hide this ad from displaying on mobile versions.

9. Toggle on Hide on Desktop to hide this ad from displaying on desktop versions.

10. Toggle on Out Of Page to allow this module to feed out-of-page ads.

11. In the Google Dfp Targeting Map List field, enter a list of key-value pairs that help DFP feed ads appropriate for your site. For information about key-value pairs, see About key-values.

12. Click Save.

Injecting ads

Body text

You can inject ads between paragraphs in an asset's body text.

To inject ads into body text:

1. Configure an ad module.

2. Click > Admin > Sites & Settings.

3. In the Sites widget, select the site for which you are injecting ads into body text, or select Global to inject ads into all assets' body text.

4. From the Front-End tab, expand the Injection cluster. Ensure that it is toggled off.

5. Under Injection Profiles, click Add Item.

6. Click Create New and select Rich Text Injector.

   Note

   The steps listed here go through the entire process of creating a new rich text injector profile. If the rich text injector profile you need already exists, you can select it from the Injection Profiles list and then click Save to complete this process.

   

7. Toggle on Enabled.

8. From the Types list, select the content types into which you want to inject ads.

9. In the Rich Text Element field, select Ad Module.

10. In the Ad field, select the ad module to be injected.

11. In the Offset field, enter the number of components before which no ad appears. For example, if you enter 3, Brightspot injects the first ad after the third component in the content type selected.

12. In the Frequency field, enter the number of components between each ad. For example, if you enter 4, Brightspot injects an ad after each four components.

13. In the Limit field, enter the maximum number of ads to appear in a listicle. For example, if you enter 2, Brightspot injects up to two ads in the content type selected.

14. In the Count Enhancements in Frequency field, do one of the following:

    • Toggle on if you want your entries in the Offset, Frequency, and Limit fields to account for enhancements (such as images, videos, or audios).
    • Toggle off if you want your entries in the Offset, Frequency, and Limit fields to account only for paragraphs.

    See the examples below.

15. Click Save.

16. Click Back.

17. In the Injection Profiles field, select the rich text injector you just created, and close the content picker.

18. Click Save.

Example 1: Ad injection accounting for enhancements

Assume you configure ad injection as follows:

• Offset is 2.
• Frequency is 3.
• Limit is 3.
• Count enhancements in frequency is on.

The following drawing provides an example of ad injection with this configuration.

• The first ad appears after the second paragraph.
• The second ad appears after two paragraphs and one image enhancement.
• The third and final ad also appears after two paragraphs and one image enhancement.

Example 2: Ad injection ignoring enhancements

Assume you configure ad injection as follows:

• Offset is 2.
• Frequency is 3.
• Limit is 3.
• Count enhancements in frequency is off.

The following drawing provides an example of ad injection with this configuration.

• The first ad appears after two paragraphs.
• The second ad appears after three paragraphs (ignoring the image).

Listicle

You can inject ads between items in a listicle.

To inject ads into a listicle:

1. Configure an ad module.

2. Click > Admin > Sites & Settings.

3. In the Sites widget, select the site for which you are injecting ads into listicles, or select Global to inject ads into all listicles.

4. From the Front-End tab, expand the Injection cluster.

5. Toggle off Disable All Injection.

6. Under Injection Profiles, click Add Item.

7. Click Create New and select Listicle Ad Injection Profile.

   Note

   The steps listed here go through the entire process of creating a new listicle ad injection profile. If the listicle ad injection profile you need already exists, you can select it from the Injection Profiles list and then click Save to complete this process.

8. Toggle on Enabled.

9. In the Offset field, enter the number of components before which no ad appears. For example, if you enter 3, Brightspot injects the first ad after the third component in the listicle.

10. In the Frequency field, enter the number of components between each ad. For example, if you enter 4, Brightspot injects an ad after a set of four components.

11. In the Limit field, enter the maximum number of ads to appear in a listicle. For example, if you enter 2, Brightspot injects up to two ads in the listicle.

12. In the Content field, select Set.

13. In the Ad field, select from the available ad modules.

14. Click Save.

15. Click Back.

16. In the Injection Profiles field, select the listicle ad injection profile you just created, and close the content picker.

17. Click Save.

Assets

When you subscribe to an ad feed, your published assets retrieve ads from the feed. Brightspot injects those ads into modules that you lay out at any point in the content hierarchy. Consider leveraging as much as possible the content hierarchy when configuring ad injection. If you configure ad injection at the global level, all assets flowing down from that level inherit the same configuration. Some publishers configure ad injection at the site level, then override the configuration at specific section levels.

To inject ads into assets:

1. Search for and open the asset to which you want to add an ad feed.

2. Expand Overrides > Layout Overrides.

3. From the Above, Aside, or Below list, select one of the following:

   • Add After—Inherits the block’s modules from the parent level and adds an ad under them.
   • Add Before—Inherits the block’s modules from the parent level and adds an ad above them.
   • Replace—Replaces the block’s modules inherited from the parent level with an ad.

   For more information about layout blocks, see Layout structure.

4. Click .

5. In the module picker, click Misc, then click Ad. You return to the content edit page.

6. From the Ad list, select one of the available ad layouts. (For information about creating an ad layout, see Creating ad layouts for AdSense slots.)

7. Complete your site's workflow and publish the asset.