Content Linking and Transitions

Overview

Content Linking allows an administrator to create multi-step user journeys by defining how a user is redirected from one content item to another based on in-content events. This mechanism uses Transitions—a type of routing trigger available on specific content screens—and is managed within the context of a Content Set.

With Content Linking, a single scanning session can seamlessly guide users across multiple content items, enabling complex flows such as:

  • Showing a coupon only to users who finish a game on time.

  • Redirecting users who lose a game into an additional challenge.

  • Building multi-step gamification funnels, dynamic reveals, or progressive engagement journeys.

Content Linking is transparent to the user: transitions occur automatically, and the user receives only the content they are meant to see next.

How Content Linking Works

1. Transitions Occur Only Within a Content Set

A Transition is valid only inside the Content Set it is configured in.

  • If a content item with an activated transition appears in multiple content sets, each set may configure different destinations for the same transition.

  • Transitions do not work when content is added directly to a campaign without a content set.

  • A campaign containing content with open transitions must be built using a content set.

This ensures complete control over user journeys per campaign.

2. Transition Triggers

Transitions fire automatically when a specific in-content event occurs.

Content Type
Screens With Transition Support

Image Search & Recognition

Winner, Loser

Rating Game

High Rating, Low Rating

Multiplayer Trivia

Finished on time, Timeout

Word Jumble

Finished on time, Timeout

Pick a Box

Winner, Loser

Polls

Final Screen

A transition also becomes available through a Call-to-Action button, allowing users to trigger transitions manually via buttons where applicable.

3. Automatic Redirection Behaviour

When a transition is triggered:

  1. The system immediately redirects the user to the destination content defined in the Content Set.

  2. This may chain multiple times (Content A → B → C → …) until:

    • The next content has no configured transition, or

    • The next content is replayable (e.g., its replay limit is exhausted).

  3. User results and state are maintained across the entire multi-content journey.

  4. When the user rescans the marker later, the system restores them to the last valid point in their journey.

The goal is a unified and seamless experience, where transitions feel like part of the game flow.

Activating Transitions in Content

Where Transitions Are Configured

Transitions are activated in the Content Editor: in call-to-action buttons and on each supported final screen:

  • Winner Screen

  • Loser Screen

  • High Rating / Low Rating Screen

  • Other result screens depending on the content type

These screens now offer two configuration modes:

  1. Static Screen (default behaviour)

  2. Activate Transition (enables content linking)

Activating a Transition

When enabling “Activate Transition”:

  • The system creates an Open Transition, which must later be configured at the Content Set level.

Example:

Important Note (displayed to the admin):

"An activated transition requires configuration at the content set level. Content with an activated transition cannot be used independently in a campaign, outside of a content set. To use this content in a campaign, add it to a content set and configure the activated transition."

Restrictions When Editing Content With Transitions

To preserve routing integrity:

If content is used in a campaign:

  • Activating transitions is prohibited. You must remove the content from all active campaigns before transitions can be turned on.

If the content has active transitions and is used in a content set:

  • Deactivating transitions is prohibited. You must remove the content from all content sets before closing transitions.

Content Browser Indicators

  • Contents with open transitions are labelled: Open Transitions

  • A filter is available:

    • Contents With Transitions

    • Contents Without Transitions

Configuring Transitions in a Content Set

Once transitions are activated in content, they must be fully configured inside a Content Set.

Content Set Structure

A Content Set now includes:

  1. Initial Routing

    • Existing mechanism for defining which content loads on a successful scan.

  2. Transitions Configuration

    • Defines destinations for all open transitions in the set.

The Transitions Configuration tab is only enabled when at least one content item in Initial Routing has active transitions.

Transition Configuration Logic

Only transitions that meet the following criteria are shown:

  • They are activated in content included in Initial Routing, or

  • They originate from content that has been added to the set through other transitions (Linked Contents).

Each open transition must be assigned a destination content.

Valid Destinations

  • Any active, non-archived content in the project except the same content where the transition originates.

Required

  • Each transition’s destination is a required field.

  • The entire Content Set cannot be saved until all transitions are configured.

UI Structure of the Transitions Configuration Tab

Example of Transitions configuration in the Content Set editor. In this example, a landing page has a call-to-action button with a transition to a recipe card. The recipe card has another call-to-action button with a transition that leads back to the landing page.

1. Initial Content Blocks

Displayed at the top in Initial Routing order.

Each block includes:

  • Content: Default Content or Special Content

  • Content Icon + Name

  • A list of open transitions:

    • Transition Name: depends on the content type and whether the transition is from a screen or a call-to-action button

    • A dropdown selector for choosing a destination content

      • Includes search-as-you-type

2. Linked Content Blocks

These appear after initial content blocks and include any content added because another content routes to them.

Each block includes:

  • Content Icon + Name

  • Delete button:

    • Removes the content from all transitions in the content set

  • The same transition list and destination selectors as initial contents

Validation Rules

A Content Set cannot be saved unless:

  • Every open transition has a configured destination.

  • All required fields across all blocks are completed.

  • No circular dependencies or invalid parent/self-selection exist.

Using Transitions in Call-to-Action Buttons

Content Editor with a Call-to-Action button to a Transition

Call-to-Action buttons include the action type: Transition.

Behaviour

  • When a user taps the button, the system redirects them to the selected destination content.

  • Valid everywhere CTA buttons are supported.

Restrictions

  • If the content is used in a campaign, transitions cannot be enabled.

  • If transitions are active and the content is used in a content set, transitions cannot be disabled.

Last updated