We’ve migrated our documentation to a new site, which means some URLs have changed.
Subscriptions

Contextual Segments in Composer Experiences

The Contextual Segments section offers a new way to segment your web pages based on their content profile. By leveraging machine learning, natural language processing, and data analysis, you can enhance your segmentation strategy using IAB classifications, and custom segments from Piano Audience.

At the top of the section, the proportion of total pages that match the selected segmentation criteria is displayed in a graph. Composer dynamically reads contextual segments from Piano Audience, displaying only those categories with one or more segments. If no segments exist for a category, it is not shown.

Please contact Piano Support at support@piano.io or your Account Manager to enable this feature on your application.

How to access?

  • Site page view Experiences: Contextual Segments can be used within the Effective Pages card.

  • AMP page view Experiences: Contextual Segments can be used within the Effective Pages card.

  • Mobile execution Experiences: Contextual Segments can be used within the Effective Pages card.

  • API Interaction on Server Experiences: This functionality is available in the Content Segmentation card.*

*Please be aware that the API Interaction on Server Experiences have not yet been officially released. At this time, it is available to a limited number of clients. Wider availability will be communicated once the feature is fully released.

Targeting Criteria

image-30.png

It's possible to configure whether you'd like to ignore or target these segments using a toggle, with "Target" being the default option.

Important: Predefined and machine-learning segments are available to all clients who have implemented Composer 1x. However, creating and using custom segments requires a Piano Audience license.

  1. Machine Learning Propensity: Includes the CLtC Propensity Model, providing estimates based on the last 30 days of user behavior or traffic events.

  2. Predefined Segments: Segment webpages by using articles that have specific IAB categories.

    • IAB Categories: Segment pages based on predefined IAB categories to align content with advertising standards.

  3. Piano Audience Segments: Leverage custom segments from Piano Audience to target specific pages.

These categories are structured to work together under the 'AND' logic, while segments within the same category interact according to the 'OR' logic.

Error States

If an error is displayed in the Experience canvas indicating that the segments are empty, it typically means that the segments that were initially populated and saved with the experience have since become unavailable or invalid. This issue can arise if the source data for those segments has changed, such as the removal or modification of contextual segments, Audience segments, or other criteria used in the experience. To resolve this, you may need to review and update the segmentation criteria to ensure they align with the current data.

Last updated: