This article describes how to use the Split Segmentation extension with the Content Modification extension.

In this article:

Table of Contents Placeholder

How it Works

To use split segmentation with content modification, you must first divide visitors into two (2) or more groups using the Split Segmentation extension. Once configured, add and configure the Content Modification extension for each of the groups.

Divide Users Into Groups Using the Split Segmentation Extension

First, use the Split Segmentation Extension to divide visitors into two (2) groups, as follows:

  1. In the left sidebar, go to iQ Tag Management > Extensions.
  2. Click + Add Extension and select the Advanced tab.
  3. Scroll down to the Split Segmentation extension and click + Add.
  4. Enter a title for the extension.
    Example: The title Split Segmentation for Content Modification lets users know that this extension is for our content modification efforts.
  5. In the Scope drop-down list, select Pre Loader.
    This scope ensures that visitors will be divided into the different groups before content starts to load.
  6. In the Destination Cookie drop-down list, click the plus sign (+) to the left to add a new cookie variable.
    Split Segment Extension_Add New Cookie Variable.jpg
  7. Enter a name for the new cookie.
    For example, content_mod lets users know that this cookie exists for segmenting the visitors for your content modification efforts.
    • Under Source, enter the name of the variable exactly as it appears in your site's source code
    • Under Alias, enter a description to help you identify this cookie value later.
    • Under Notes, enter any notes or a longer description.
      Add Variable for Content Modification Cookie 2.jpg
    • Click Apply.​
  8. Leave the Cookie Domain field blank.
    When left blank, this value defaults to your domain.
  9. Leave the Duration field set to the default value, Session.
  10. Add the number of segments you want to divide the visitors into.
    In this example, the visitors are divided into two (2) groups.
    • In the Segment Label field, enter A.
    • In the Percent drop-down list, select 50%.
    • To add a second Segment Label, click the plus sign (+) to the right of the Percent field
    • In the new Segment Label field, enter B.
    • For Percent drop-down list, select 50%.
      Split Segmentation Extension for Content Modification_Groups A and B.jpg
  11. Follow the steps in the next section to set up the Content Modification extension to serve specific content to each of the groups you configured.

Serve Specific Content to Each Group Using the Content Modification Extension

You have now set up the Split Segmentation extension to divide the visitors into two groups. The next step is to set up the Content Modification extension to serve specific content to each group. This step requires setting up a unique instance of the Content Modification extension for each group. In this example, there are two (2) segments so we need to set up the extension twice; once for Segment A and once for Segment B.

Use the following steps to set up the Content Modification extension to serve specific content to each of your groups:

  1. In the left sidebar, go to iQ Tag Management > Extensions.
  2. Click + Add Extension and select the Advanced tab.
  3. Scroll down to the Content Modification Extension extension and click + Add.
  4. Enter a title for the extension.
    Example: The title Content Modification for Segment A lets users know that this extension is used to serve content to the Segment A group created in the previous steps.
  5. In the Scope drop-down list, select DOM Ready.
    DOM Ready is the default value.
  6. Use the following steps to select the page element to replace with specialized content:
    • From the Element Typedrop-down list, select Dom ID.

      Tealium does not recommend using the Xpath to identify the element. Modifying the content on the page can change the Xpath and cause content modification efforts to fail.

    • In the Identifier field, enter the Dom ID of the element.
      In this example, id-of-modified-element is used.
    • From the Position drop-down list, select Replace Node Content.
      This selection replaces the current content the new content.
    • In the Content field, enter the HTML for the content you want to deliver, in standard HTML format.
      Example:
      <img src="/assets/img/your-image-for-segment-A.jpg"
         width="960" height="350" alt="Text associated with this image"
         class="segmented-content">
  7. Next to Condition, click Add Condition.
    This step ties the Split Segmentation extension to the Content Modification extension.
  8. In the first drop-down list, select the content_mod cookie value created when you set up the Split Segmentation extension.
  9. In the next drop-down list, select equals.
  10. In the next field, enter the segment label assigned to the first group, which is A in this example.
    Content Modification Extension for Segment A.jpg
  11. Repeat the steps all steps above to create another instance of the extension for Group B.
    Name the second instance Content Modification for Segment B and replace "A" with "B" in the condition field and ensure that you modify the HTML content to specify Segment B.
    Content Modification Extension for Segment B.jpg
  12. You have now finished setting up the two (2) Content Modification extensions.
    One Extension delivers content to visitors placed into Segment A, and the other delivers content to visitors placed into Segment B.
  13. Save and Publish your work.
Version history
Revision #:
8 of 8
Last update:
‎10-22-2020 09:45 PM
Updated by: