API Reference

Auto-Redirect User Guide: Language & Country-Based Redirects

Overview

The Auto-Redirect feature allows you to automatically redirect users to different versions of your quizzes and paywalls based on their browser language or geographical location. This helps you provide localized experiences for your global audience.

πŸ”’ Advanced Plan Feature

⚠️ IMPORTANT: Auto-Redirect functionality is exclusively available with the Advanced Plan as part of our premium feature package. This includes both language-based and country-based redirects for quizzes and paywalls.

Need to upgrade? Contact your account manager or use the in-app chat feature for immediate assistance.

🌍 Visual Indicators in Lists

When browsing your quizzes and paywalls, you'll see several visual indicators:


Globe Icon (🌍)

  • Appears after the URL when auto-redirect is enabled
  • Tooltip shows:
    • "Auto redirects by language" (language-based)
    • "Auto redirects by country" (country-based)

Language & Country Flags

  • Language flag emoji (πŸ‡ΊπŸ‡Έ πŸ‡©πŸ‡ͺ πŸ‡«πŸ‡·) shows the target language
  • Country code badge (US, DE, FR) shows the target country
  • Example: πŸ‡©πŸ‡ͺ DE means German language for Germany

Translation Relationships

  • "Source: #1234" - Shows this is a translation of paywall #1234
  • "Translations: πŸ‡©πŸ‡ͺ πŸ‡«πŸ‡·" - Shows available translation languages



πŸš€ How to Set Up Auto-Redirect

Step 1: Create Your Main Quiz/Paywall

  1. Create your primary content in English (recommended as the main language)
  2. Set the language to "English" in the settings
  3. Leave "Auto Language Detection" set to "No auto redirect" for now
  4. Save and publish your content

Step 2: Create Translation Copies

  1. Go to your main quiz/paywall
  2. Click the duplicate button in the actions column in Quiz/Paywall list
  3. For each target market, create a copy:
    • German market: Set Language = "German", Country = "DE"
    • French market: Set Language = "French", Country = "FR"
    • US market: Set Language = "English", Country = "US"

Step 3: Set Up Source Relationships

For each translation copy:

  1. Edit the translation
  2. In the "Source" field, select your main quiz/paywall
  3. This creates the parent-child relationship needed for redirects
  4. Save the translation

Step 4: Enable Auto-Redirect on Main Content

  1. Go back to your main quiz/paywall
  2. In settings, find "Auto Language Detection"
  3. Choose your redirect method:
    • "Redirect by language" - Users get redirected based on browser language
    • "Redirect by country" - Users get redirected based on IP location
  4. Save changes


βš™οΈ Configuration Options

Language Property Effects

The Language setting affects:

  • System messages (button text, error messages, UI elements)
  • Automatic translations of built-in text
  • Language-based redirect matching

Country Property Effects

The Country setting affects:

  • Country-based redirect matching

Auto Language Detection Options

OptionDescriptionUser Experience
No auto redirectUsers stay on the current pageStatic experience
Redirect by languageMatches browser language to available translationsAutomatic localization
Redirect by countryMatches user's country to available translationsGeographic targeting

πŸ“‹ Setup Checklist

For Language-Based Redirects:

  • Main content has English language set
  • Translation copies created with target languages
  • Each translation has "Source" pointing to main content
  • Main content has "Redirect by language" enabled
  • Advanced plan subscription (required)

For Country-Based Redirects:

  • Main content created (language optional)
  • Translation copies created with target countries
  • Each translation has "Source" pointing to main content
  • Main content has "Redirect by country" enabled
  • Advanced plan subscription (required)

🎯 Best Practices

Content Organization

  1. Use descriptive names: "Fitness Quiz (German)" vs "Fitness Quiz Copy"
  2. Maintain consistent structure across translations
  3. Test all redirect paths before going live

Language Strategy

Main Content (English) β†’ Auto-detects and redirects to:
β”œβ”€β”€ German Translation (DE language, DE country)
β”œβ”€β”€ French Translation (FR language, FR country)
└── Spanish Translation (ES language, ES country)

Country Strategy

Main Content (Any language) β†’ Auto-detects and redirects to:
β”œβ”€β”€ Germany Version (Country: DE)
β”œβ”€β”€ France Version (Country: FR)
└── Spain Version (Country: ES)

⚠️ Important Notes

Requirements

  • Advanced Plan subscription required for auto-redirect
  • Source relationship must be set correctly
  • Edit mode parameter (?edit_mode=1) disables redirects for content editing

Limitations

  • Only main content (without source) can have auto-redirect enabled
  • Edit mode (?edit_mode=1) bypasses redirects

πŸ”„ Translations Switcher Block

What is the Translations Switcher?

The Translations Switcher is a dynamic UI component that can be embedded in your quiz to allow users to manually switch between different language/country versions in real-time. This gives users control over their experience while maintaining seamless functionality.


How It Works

  1. Displays available translations - Shows a list/dropdown of all available quiz translations
  2. Dynamic switching - Users can change to different versions without page reload
  3. Real-time updates - Quiz content, language, and country settings change instantly
  4. Analytics integration - quiz_id parameter updates automatically for accurate tracking

Key Features

FeatureDescriptionBenefit
Live switchingChanges quiz content instantlySmooth user experience
Analytics trackingUpdates quiz_id parameter when switchingAccurate analytics per translation
Visual indicatorsShows language flags and country codesClear translation identification

Setup Requirements

To enable the Translations Switcher:

  1. Create translation relationships (same as auto-redirect setup)
  2. Add the switcher block to your quiz design
  3. Configure which translations to show (all available or specific subset)
  4. Style the switcher to match your quiz design

User Experience

For visitors:

  • See available language/country options
  • Click to instantly switch translations
  • Experience seamless content changes
  • Continue with quiz in their preferred language/region

For analytics:

  • Each translation switch creates a new analytics entry
  • quiz_id parameter automatically updates
  • Track user preferences and translation usage
  • Monitor which translations are most popular

Implementation Notes

  • Works with any plan - Unlike auto-redirect, translation switcher doesn't require Advanced plan
  • Complements auto-redirect - Can be used together for maximum flexibility
  • Analytics continuity - Quiz progress may reset when switching translations

πŸ’° Multi-Currency Paywalls Setup

Overview

Use country-based redirects to automatically show different paywalls with localized currencies. Users see prices in their local currency, increasing conversion rates.

Quick Setup

  1. Create currency-specific paywalls for each market
  2. Set country codes on each regional paywall (US, DE, GB, etc.)
  3. Link to main paywall using "Source Paywall" field
  4. Enable "Redirect by country" on main paywall
  5. Configure prices in local currencies for each paywall

Example Structure

Main Paywall (USD) β†’ Redirects to:
β”œβ”€β”€ EU Paywall (EUR, Country: DE)
β”œβ”€β”€ UK Paywall (GBP, Country: GB)
└── Canada Paywall (CAD, Country: CA)

Setup Checklist

  • Advanced Plan activated (required)
  • Currency-specific paywalls created
  • Country codes set for each regional paywall
  • Source relationships configured (regional β†’ main)
  • Prices created in appropriate currencies
  • Payment processors configured for each currency
  • VPN testing completed

πŸ’‘ Example Scenarios

Scenario 1: Multi-Language Support

Goal: Redirect users to their browser language

Setup:

  1. Main: "Fitness Quiz" (English, Auto: Redirect by language)
  2. Translation: "Fitness Quiz (German)" (German, Source: Main)
  3. Translation: "Fitness Quiz (French)" (French, Source: Main)

Result: German browsers β†’ German version, French browsers β†’ French version

Scenario 2: Geographic Targeting

Goal: Show different pricing by country

Setup:

  1. Main: "Premium Paywall" (Auto: Redirect by country)
  2. Translation: "Premium Paywall (EU)" (Country: DE, Source: Main)
  3. Translation: "Premium Paywall (US)" (Country: US, Source: Main)

Result: German IPs β†’ EU pricing, US IPs β†’ US pricing