Conditional Main Page Skip Extension

Overview

The Conditional Page Skip extension allows you to bypass the main page of your Digioh campaign and automatically redirect users to a specific page based on various conditions. This is useful for:

• Directing users from email campaigns directly to a specific step in a quiz
• Showing different content based on geographic location
• Time-based promotions that skip to specific pages during campaign windows
• Personalized experiences based on user data in the dataLayer

Installation

From the profile menu (top right), navigate to Extensions and install the extension "Conditional Page Skip".

Configuration

The extension uses page-level metadata to configure skip rules. All metadata must be configured on the page you want to skip from (typically the main page).

Metadata Keys

Condition Syntax

Conditions are configured in the skip_condition metadata value. Multiple conditions can be combined with && (AND logic).

URL Parameter Conditions

Check if a URL parameter exists or has a specific value.

Examples:

• url_param:source=email - Skip when ?source=email is in the URL
• url_param:vip - Skip when ?vip is present (any value)

DateTime Conditions

Skip based on the current date and time.

Examples:

• datetime:>2024-12-01 - Skip after December 1, 2024
• datetime:<2025-01-31 - Skip before January 31, 2025
• datetime:2024-12-15~2024-12-25 - Skip during December 15-25, 2024

Geo Location Conditions

Skip based on the user's country. Requires country data in the dataLayer (country, geo_country, or user_country fields).

Examples:

• geo:US - Skip for US visitors
• geo:FR,DE,IT,ES - Skip for European visitors

DataLayer Conditions

Check values in the Digioh dataLayer.

Examples:

• email - Skip if email is in the dataLayer
• customer_type=vip - Skip if customer_type equals "vip"

Combining Conditions

Use && to require multiple conditions (AND logic):

{!{code}!}czo0MjpcInVybF9wYXJhbTpzb3VyY2U9ZW1haWwgJmFtcDsmYW1wOyBnZW86VVMNClwiO3tbJiomXX0={!{/code}!}

This would skip only when both conditions are true: the URL has ?source=email AND the user is in the US.

Setup Examples

Example 1: Skip to Quiz Results from Email

Use Case: Users clicking from a promotional email should skip directly to the results page.

Page-level Metadata on Main Page:

Email Link: https://yoursite.com/quiz?source=email

Example 2: Time-Based Holiday Skip

Use Case: During the holiday promotion window, skip to a special holiday page.

Page-level Metadata on Main Page:

Example 3: VIP Customer Experience

Use Case: Recognized VIP customers (from dataLayer) skip to exclusive content.

Page-level Metadata on Main Page:

Example 4: Multiple Skip Rules with Priority

Use Case: Different skip destinations based on different conditions, with priority ordering.

Page-level Metadata on Main Page:

First rule (checked first due to higher priority):

Second rule:

Third rule (checked last, lowest priority):

Valid Target Pages

The skip_to_page value must be one of:

• main - Main page
• thx - Thank you page
• ep1 through ep99 - Extra pages

Note: The target page must be published (have content linked to it) or an error will be thrown.

Testing

1. Use ?boxqamode on your site to see the extension's notification messages
2. The notifications panel will show:
   • Which skip rules are being checked
   • Whether each condition is MET or NOT MET
   • Which page the user is being skipped to (if any)

Test URLs

Build test URLs with the appropriate parameters:

• https://yoursite.com/page?boxqamode&source=email
• https://yoursite.com/page?boxqamode&vip=true&source=campaign

Troubleshooting

Problem: Skip not occurring

• Verify metadata is configured at page level (not campaign or element level)
• Check that all conditions in skip_condition are being met
• Ensure the target page exists and is published
• Use ?boxqamode to see the condition evaluation in the notifications panel

Problem: Error: "must be configured at page level"

• Move the metadata from campaign/element level to page level
• Page-level metadata is configured in Campaign Editor > Page > Layout > Metadata section

Problem: Error: "Target page is unpublished"

• Ensure the target page has content added to it
• The page must have at least one element for Digioh to consider it "published"

Problem: Geo conditions not working

• Verify country data is available in the dataLayer
• Check for country, geo_country, or user_country fields
• Country codes must be uppercase two-letter codes (US, CA, UK, etc.)

Problem: DateTime conditions not matching

• Use ISO date format: YYYY-MM-DD
• For datetime: YYYY-MM-DDTHH:mm
• Check timezone considerations - dates are evaluated in the user's local time

Technical Notes

• The extension runs in the After DOM Ready event
• Skip rules are only evaluated when the user is on the main page
• Multiple skip rules are evaluated in priority order (highest priority first)
• The first rule with all conditions met triggers the skip
• If no conditions are specified on a rule, that rule is skipped (no unconditional skips)