In This Guide

With the Tealium integration, you can import audiences into Brightspot and publish content variations for them.

See also:

Configuring the Tealium integration

To configure the Tealium integration:

  1. Obtain the following settings from your Tealium console:

    • Account name
    • Profile from which you want to import audiences
    • Environment (usually Dev, QA, or Prod)
    • Webhook username
    • Webhook password
  2. Click menu > Admin > Sites & Settings.
  3. In the Sites widget, select Global. The Edit Global widget appears.
  4. Under Front-End, do the following:

    1. Expand Tag Manager.
    2. From the Tag Manager list, select Tealium Tag Manager.
    3. In the AccountProfile, and Environment fields, paste the values from step 1.
    4. From the Default Event Supplier list, select an event supplier.
  5. Under Integrations, do the following:

    1. Expand Tealium.
    2. From the Webhook Settings list, select Set.
    3. In the Username and Password fields, paste the values from step 1.
    4. Expand Audience Size.
    5. In the Audience Size Grace Period field, enter the number of months during which Brightspot does the following:

      • Uses the estimated Tealium audience size configured in Brightspot. For information about setting the estimated audience size, see Creating audiences using Tealium targets.
      • Accumulates visitor counts to determine the actual audience size.

      After the grace period, Brightspot uses the actual audience size.

  6. Click Save.

Understanding grace period and initial audience size

Audiences are an important part of delivering the best content possible to visitors. When creating content, you want to tailor that content to the audience.

Knowing an audience’s size is also important. In most scenarios, you want to focus effort on large audiences. For example, if you have a weekend audience with one million visitors, and a weekday audience with 5,000 visitors, you normally dedicate more effort to providing content appropriate for the weekend audience, and a bit less effort to the weekday audience.

Brightspot calculates audience size based on data acquired from Tealium, updating that number daily as a rolling total over the grace period. For example, if the grace period is 2 months, Brightspot computes the audience size on December 15 as the number of visitors during the period October 15 through December 15.

To enable rolling audience counts for Tealium-based audiences, you need to configure two items:

  • Initial audience size—An estimate of the audience’s actual size used during the initial grace period.
  • Grace period—Period of time during which Brightspot computes rolling audience totals based on actual Tealium counts.
    Grace Period.png
    Grace period example

Referring to the previous illustration—

  • During the grace period (months 1 and 2) the estimated audience size is 100,000.
  • At the end of month 3, for the previous two months, Brightspot detected approximately 80,000 visitors.
  • At the end of month 4, for the previous two months, Brightspot detected 110,000 visitors.
  • At the end of month 5, for the previous two months, Brightspot detected 140,000 visitors.

Consider using the following guidelines when determining the grace period and initial audience size:

  • Initial audience size:

    • Use the number indicated in your Tealium Audience Dashboard.
    • Use the size of similar existing audiences. If you already have a stable weekend audience using mobile devices, its size may be a good guess for a new weekend audience using laptops.
    • Use a competitive analysis from analytics providers.
    • Use the number of searches for terms in your site.
  • Grace period:

    • A large number of visitors typically justifies a short grace period; a small number of visitors requires a longer grace period to achieve a steady state.
    • Try to be consistent with your grace period across audiences, so you can effectively compare and contrast their audience sizes.

Creating audiences using Tealium targets

As a Tealium user, you can create Tealium audiences from website traffic data ingested from your site, and pass those audiences to Brightspot as targets. The following procedure describes how to configure a Brightspot audience using a Tealium target.

To create an audience from a Tealium target:

  1. From the Navigation menu, select Admin > Audiences. The New Audience widget appears.
  2. In the Name field, enter a name that reflects the audience you are defining. For example, Weekend Visitors reflects an audience that views content on weekends.
  3. From the Content Type Group field, select Create New. A content edit page appears.
    New content group form.png
    New content type group form
  4. In the content edit page, do the following:

    1. In the Name field, enter a name for the content type group, such as Landing Pages.
    2. From the Types list, select the content types that you want to apply to this audience.
    3. Click Save.
    4. Click Back. You return to the New Audience widget.
  5. From the Content Type Group list, select the content type group that you just created.
  6. Under Sites, click add_circle_outline and select the sites to which the audience applies, or leave blank to apply the audience to all sites.
  7. Under Targets, do the following:

    1. Click add_circle_outline, and select Tealium Target.
    2. From the Target selection field, click search and select a target from the content picker. (If there are no Tealium targets in the content picker, check your configuration as described in Configuring the Tealium integration, or wait a few days until Tealium accumulates traffic from your site.)
    3. In the Description field, enter a description for this target. Brightspot displays this description in the content edit form.
    4. If you want to establish a tentative audience size while Tealium accumulates counts during the grace period, do the following:

      1. In the Target field, click edit. A content edit form appears.
      2. In the Initial Size field, enter the target’s tentative size prior to the grace period. During the grace period, Brightspot ingests the target counts from Tealium. After the grace period, Brightspot uses the total count as the updated audience size.
      3. Click Back.
    5. Repeat steps a–d to configure additional targets.
  8. Click Save.

You can now create variations for the audience; for details, see Creating content variations.