Pages

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from this space and version 12.0

The Frosmo Segments for Contentful app integrates the Frosmo Platform with Contentful. The point of integration are segments, which the app makes available in Contentful through a segment selector field. You can add the field to any content type. Once added to a content type, the field allows you to attach segments to an entry of that content type. This, in turn, allows the entry to be targeted to visitors in those segments.

Integrating the Frosmo Platform with Contentful through segmentsImage Added

Figure: Integrating the Frosmo Platform with Contentful through segments (click to enlarge)

Frosmo Segments for Contentful extends the built-in Array field type ("Short text, list") with a segment selector UI widget, which you can select as the appearance for an Array field. In the Contentful web app, the widget renders the Array field as a drop-down menu for selecting segments, with selected segments displayed as removable boxes below the menu.

The following figures show the settings of a content type that includes a segment selector field and the settings of an entry based on the content type, respectively.

Content type with a segment selector fieldImage Added

Figure: Content type with a segment selector field

Segment selector field settings (content type)Image Added

Figure: Segment selector field settings (content type)

Entry with a segment selector fieldImage Added

Figure: Entry with a segment selector field

Frosmo Segments for Contentful fetches the available segments from the Frosmo Platform using the Graniitti API. The segment selector UI widget displays all available segments. While the widget displays the segments by name, under the hood, the app handles the segments by their IDs.

The site from which the app fetches the segments is defined by the app configuration in Contentful. The app can only fetch segments from a single site at a time.

The following figure shows the Frosmo Segments for Contentful configuration in the Contentful web app. In addition to setting up the site connection, the configuration view allows you to convert existing Array fields into segment selectors.

Frosmo Contentful App configuration and field conversion in the Contentful web appImage Added

Figure: Frosmo Segments for Contentful configuration and field conversion in the Contentful web app

Where to go next