GuidesAnnouncementsCommunity Discussion
GuidesCommunity DiscussionAnnouncementsLog In
Guides

Custom Segments

What are custom segments?

Custom segments allow publishers to use contextual signals and/or their own 1st-party data to provide a personalized Taboola experience.

Using this capability, publishers can:

  1. Track performance for a given audience.
  2. Provide a given audience with a unique, personalized experience, in accordance with publisher-specific goals and KPIs.

Some common use cases

  • Serve a (more) organic Feed to subscribed users.
  • Add a "Subscribe" unit for users that are likely to subscribe (according to the publisher’s algorithm).
  • Tailor a promotion to a specific audience - e.g. users that already use a competing service.

🚧

Custom development

The value of cseg is determined dynamically (using contextual signals and/or 1st-party data).

As such, this flow typically requires custom development.

🚧

Guidelines

  1. To track performance for a custom segment, submit the cseg param, as described below.
  2. To target a custom segment, reach out to Taboola to configure the relevant targeting.

For a given placement, the cseg param is optional.

Example

Code snippets are provided below for both standard web pages and AMP:

_taboola.push({
    mode: '<mode>',
    container: '<container>',
    placement: '<placement>',
    target_type: '<target_type>',
    // Optional `cseg` param:
    // Pass the relevant custom segment, as determined by contextual signals and/or 1st-party data.
    // For each placement, pass 1 custom segment *only*.
    cseg: '<custom_segment>'
  });
<!-- 
See optional `cseg` param, below.
Pass the relevant custom segment, as determined by contextual signals and/or 1st-party data.
For each placement, pass 1 custom segment *only*. 
-->
<amp-embed width=100 height=100
  data-block-on-consent='_till_responded'
  type='taboola'
  layout='responsive'
  data-publisher='publisher-id'
  data-mode='mode'
  data-placement='placement'
  data-target_type='mix'
  {page-type}='auto'
  cseg='<custom_segment>'
  data-url=''>
</amp-embed>

🚧

Flow

  1. Pass the relevant cseg value, as determined by contextual signals and/or 1st-party data.

    For each placement, pass 1 custom segment only.
    Use Taboola reporting (Revenue Summary) to track performance.

  2. To target a custom segment for a given placement, reach out to Taboola.

    Provide the Taboola team with the exact segment name being passed.


This flow typically requires custom development.