Brightspot CMS User Guide

Injecting ads into body text


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


To inject ads into body text:

  1. Configure an ad feed as described in Configuring an ad feed.
  2. Click menu> Admin > Sites & Settings.
  3. In the Sites widget, click the site for which you are injecting ads. (This must be the same site for which you configured the Google ad feed.)
  4. Expand Front-End > Ads.
  5. Toggle off Disable All Ad Injection.
  6. Under Ad Injection Profiles, click add_circle_outline. A selection field appears.
  7. Click search. A content picker appears.
  8. In the Create widget, select Rich Text Ad Injector, and then click New. A content edit page appears.
  9. Toggle on Enabled.
  10. From the Types list, select Article.
  11. From the Ad list, select one of the ad feeds you configured in step 1.
  12. In the Offset field, enter the number of paragraphs or enhancements before which no ad appears. For example, if you enter 3, Brightspot injects the first ad after the third paragraph.
  13. In the Frequency field, enter the number of paragraphs or enhancements between each ad. For example, if you enter 4, Brightspot injects an ad after each four paragraphs.
  14. In the Limit field, enter the maximal number of ads to appear in an article's body. For example, if you enter 2, Brightspot injects up to two ads in the body.
  15. 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 following examples.

  16. Click Save.
  17. Click Back. You return to the content picker.
  18. Select the ad injector you just created, and close the content picker. You return to the Edit Global widget.
  19. In the Disable Ads Parameter Value field, enter a query string that blocks an ad feed.

    Disable ads query string

    Referring to the previous illustration, disableAds=567abcded is the query string that blocks ads in the article. When a visitor includes that query string in an article's URL, Brightspot does not retrieve ads.

  20. 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.

Ad Injection Rich Text With Enhancements

  • 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.

Ad Injection Rich Text Without Enhancements

  • The first ad appears after two paragraphs.
  • The second ad appears after three paragraphs (ignoring the image).
Previous Topic
Creating new ad sizes
Next Topic
Configuring an ad feed
Was this topic helpful?
Thanks for your feedback.
The elements that get you up and running in a matter of days, from pre-built content types, to modules, to landing pages.

Content types
Modules
Landing pages
Everything you need to manage and administer content within Brightspot CMS, including plug-and-play integrations.

Dashboards
Publishing
Workflows
Admin configurations
A guide for installing, supporting and administering code on the Brightspot platform, including integrations requiring developer support to use.

Field types
Content modeling
Rich-text elements
Images