Brightspot CMS User Guide

Injecting ads into 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 as described in Creating ad modules.
  2. Click menu > 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. Click search, located to the left of more_horiz, and type Ads.
  5. Toggle off Disable All Ad Injection.
  6. Under Ad Injection Profiles, click add_circle_outline.
  7. Click search.
  8. In the Create widget, select Rich Text Ad Injector, and then click New.
    Rich text ad injector Rich text ad injector
    Creating a rich-text ad injector
  9. In the New Rich Text Ad Injector form, toggle on Enabled.
  10. From the Types list, select the content types into which you want to inject ads.
  11. From the Ad list, select one of the available ad modules.
  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 asset'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 examples below.

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

    Disable ads query string Disable ads query string

    Referring to the previous illustration, disableAds=567abcded is the query string that prevents ads from appearing in the site's assets. When a visitor includes that query string in an asset'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 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

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 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 ad modules
Next Topic
Injecting ads into a listicle
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.

Dashboards
Publishing
Workflows
Admin configurations
A guide for installing, supporting and administering code on the Brightspot platform.

Field types
Content modeling
Rich-text elements
Images
A guide for configuring different integrations to support a multitude of use cases.

Google Analytics
Shopify
Apple News