LogoLogo
DocsUse CasesCreator GuideIntegration Guide
  • Introduction
  • Why Monterosa?
  • Platform Buyer FAQ
  • Engagement Use Cases
    • Event Centres
    • Prediction Games
    • Voting
    • Trivia Challenges
    • Competitions & Sweepstakes
    • Sports Data Visualisation
    • Native Apps
    • Global Replication
  • Core Platform Concepts
    • Platform Components
    • App Settings
    • Schedule & Events
    • Timeline
    • Elements
    • Extensions
    • EnMasse Mesh
  • 🎨Creator Guide
    • Welcome
      • Getting an Account
    • Spaces
      • Projects
        • Events
          • Event Templates
          • Event Settings
          • Timeline
            • Elements
            • OpenAI Integration
            • Live Stats
            • Preview
            • Embedding
              • Embedding an Element
          • Analytics
        • Project Settings
          • Localisation
          • Experience URL
          • Content Creation Limits
        • App Settings
        • Activity Log
      • Content
        • Asset Library
        • Automation
          • 🔃Bulk Content Uploader
          • ⚡Live Data Connector
      • Setup
        • Space Settings
        • Apps
        • Integrations
          • Opta Graphics
          • Tagboard
        • Extensions
          • Identify
          • Gamify
          • Forms
          • Geo-Verify
          • Content Bridge
          • Vote Verification
    • Experiences
      • Experience Creator
        • Customising your UI
        • Retrieving Event URLs
    • Team
      • Two-Factor Authentication
      • Setting Up SSO to log in the Monterosa platform
      • User Roles
    • Scaling & Capacity
    • Creator FAQs
  • 🚀Integration Guide
    • Overview
    • Standalone Pages
    • Web Page Embedding
      • Hosting an Experience on your domain
      • Auto-resizing embedded Experiences
    • Native App Embedding
    • Embed using the SDK
    • Discovering Events Programmatically
    • Audience Profiles
      • Audience Profiles Dataset Reference
        • Users dataset
        • Projects dataset
        • Events dataset
        • Elements dataset
        • Interactions dataset
        • Leaderboard (Event) dataset
        • Leagues dataset
        • Form entries dataset
      • Monterosa Identifiers
    • Integrating IAM & SSO
      • Simple integration with SDK & JWT
        • Advanced SDK integration
      • JWT based SSO integration
      • Ad-hoc SSO integration
      • SSO Integration guidelines
    • Consent Management integration
      • Client-Side Data Storage Explained
    • Analytics integration
    • Integration FAQs
  • 📱FanKit
    • Overview
    • How it works
    • Elements
      • Polls & Voting
        • Brand Survey
        • Poll
        • Reaction Rater
        • Ladder Poll
        • Swing Poll
        • Smash Rater
        • Category Wrapper
        • Category Vote
        • Standalone Vote
        • Team Selector
      • Predictors
        • Predictor
        • Sweepstake
        • Number Predictor
        • Podium Predictor
        • Score Predictor
        • Score Predictor (High)
        • Player Predictor
      • Trivia
        • Trivia
        • Free Type Trivia
        • Ladder Trivia
        • Sorting Trivia
        • Word Trivia
        • Video Trivia
        • Number Trivia
      • Editorial & Media
        • Article
        • External Article
        • Commentary
        • Gallery
        • Image
        • Video
        • Video Carousel
        • Shareable URL
        • Social Embed
        • Form
        • Element Carousel
        • Match Event
        • Substitution
        • Goal
        • Time Event
      • Quiz
        • Quiz Wrapper
        • Quiz Question
      • Series Prediction
        • Series Wrapper
        • Series Score Predictor
        • Series Predictor
        • Series Number Predictor
        • Series Player Predictor
      • Multi Rater
        • Ratings Wrapper
        • Ratings Slider
      • Sports Statistics
        • Opta Widget
        • Stat Callout
        • Stat Comparison
      • Gamification
        • Scoreboard (Event)
        • Scoreboard (Round)
        • Leaderboard (Project)
        • Leaderboard (Event)
        • Leaderboard (Round)
        • Leaderboard (Group)
    • Tips, tricks, tutorials & guides
      • Advanced CSS Overrides
      • Using points and leaderboards
      • Content containers
    • Display Modes
    • Converters
      • Access Gate
      • Form
      • Cards
      • Share Image
      • Featured Links
      • Sponsors
      • Promo Banner
      • Google Ads
    • Localisation
    • Supported Browsers
    • Release Notes
  • 👣DEVELOPER GUIDE
    • Overview
    • Platform Terminology
    • Interaction SDK
      • Download & Initialise the SDK
      • Supported Devices & Operating Systems
      • Roadmap
      • Release Notes
        • React Native
          • v0.2.2
        • JavaScript
          • v0.16.16
          • v0.16.15
          • v0.16.14
          • v0.16.13
          • v0.16.12
          • v0.16.11
        • iOS
          • v0.16.12
          • v0.16.11
        • Android
          • v0.16.13
      • SDK FAQs
    • Embedding Apps
      • Static Embedding
      • Dynamic Embedding
        • Web Behaviours
        • iOS Behaviours
        • Android Behaviours
        • Preloading
        • Caching Content
        • Shared Storage
      • Configure your app
      • Communicate with embedded apps
      • Video Stream Sync
      • React Native
        • Events in React Native SDK
      • Integrate with Flutter
    • Building Apps
      • Quick Start Guide
      • How to build your first app
        • Getting started
        • Get your app running locally
        • Install the Interaction SDK
        • Define your App
        • Set up Studio
        • Develop your App
        • Enable Dynamic Configuration
      • Core SDK Functions
        • Getting and displaying Events
        • Managing Elements
        • Reacting to live updates
        • Dynamic runtime configuration
        • Time
        • Localisation
    • Content Automation
      • Discovering Events
      • Connecting to Google Sheets
      • Connecting to Zapier
      • Connecting to Sports Feeds
    • App Specs
      • App Spec Reference
        • Root Spec
        • Elements Spec
        • Project Settings Spec
        • Event Settings Spec
        • Expressions (beta)
        • Data Sources (beta)
        • External data source
        • Field Types
          • Boolean
          • Collection
          • Colour
          • Datetime
          • External
          • File
          • Freetext
          • Image
          • List
          • Number
          • WYSIWYG
        • Field, Field set, Field section
      • Customising App Specs
    • Available APIs
    • Integrating TV Graphics
    • Advanced Topics
      • Listings
      • Accesssing user concurrency values from your app
      • Custom analytics Extension
      • Front-end app communication protocols
      • Multi Vote
      • Reveal answer on vote
  • ⚙️CONTROL API
    • Overview
    • Objects Definitions
    • Element Reference
    • Organisations
      • Get Organisations
      • Get Organisation
      • Create Organisation
      • Update Organisation
      • Delete Organisation
    • Spaces
      • Get Spaces
      • Get Space
      • Create Space
      • Update Space
      • Delete Space
    • Apps
      • Get Apps
      • Get App
      • Create App
      • Reload App
    • App Settings
    • Projects
      • Get Projects
      • Get Project
      • Create Project
      • Update Project
      • Delete Project
    • Events
      • Get Events
      • Get Event
      • Get Event Service Feeds
      • Create Event
      • Create Event From Template
      • Update Event
      • Delete Event
    • Event Templates
      • Get Event Templates
      • Get Event Template
      • Create Event Template
      • Update Event Template
      • Delete Event Template
    • Elements
      • Get Elements
      • Get Element
      • Get Event Template Elements
      • Create Element
      • Update Element
      • Delete Element
    • Assets
      • Get Assets
      • Upload Assets
      • Update Asset
      • Delete Asset
      • Get Asset Media Types
      • Get Asset Uploaders
      • Asset Tags
        • Add Tag to Asset
        • Remove Tag from Asset
    • Tags
      • Get Tags
      • Get Tag
      • Create Tag
      • Update Tag
      • Delete Tag
  • ⚙️REFERENCE
    • Public Feeds
      • Graphics Feed
    • Listings
    • Elements
    • Event History
    • Demographics
    • Identify
    • Gamify
      • Gamification Mechanics
      • Public API
      • Private API
    • Geo-Verify
    • Browser Support
    • Audience API (Preview)
      • Authentication
        • Monterosa Access Token
        • Public client authentication
      • Batched operations
      • Loyalty API
      • Connections API
    • Image Resizing API
  • ⛓️Extensions
    • Overview
    • Instance handshake
    • Project handshake
    • Project delete
    • Tabs
    • Event Tabs
    • Setup
    • Listings notification
    • Elements notification
    • Analytics
    • Assets
    • Event-level feed
    • Webhooks
  • ⚖️COMPLIANCE
    • Data Requests
    • Data Sub-processors
    • Hosting Locations
    • Third party software
    • ISO27001
  • 🗒️RELEASE NOTES
    • Studio
      • v29.0
      • v28.0
      • v27.0
      • v26.0
      • v25.0
    • FanKit
      • v24.41.0
      • 24.42.0 Preview
    • Archive
      • v24 releases 2022-23
Powered by GitBook
On this page
  • How to setup and use the Forms Extension
  • Geo-restriction
  • Winner Picker

Was this helpful?

  1. Creator Guide
  2. Spaces
  3. Setup
  4. Extensions

Forms

Features and capabilities of the Forms extension

Was this helpful?

Welcome to Forms, the Monterosa solution for your data capture needs. Forms is a powerful form builder and secure data storage extension that allows you to create custom forms and store data.

Forms supports use cases including competitions, lead generation, or user generated content submissions.

The interface makes it easy for you to build custom forms that can be seamlessly integrated into your apps. You can customise your forms by adding your logo, choosing from a variety of themes, and adding form fields of your choice. Once your form is ready, you can securely store all your data in one place.

How to setup and use the Forms Extension

To set up the Forms extension, follow these steps:

  1. Ensure that Forms is enabled for your Project. If it is not, email to create a support ticket and enable the Forms extension.

  2. If you are creating a new form, click on "CREATE NEW FORM" on the Forms tab in your Project. Give the form a name.

  3. Populate the content of your form under the Header and Form tabs. Add UI elements like Input Text, Drop Down Lists, Radio Buttons, Images, Postcodes, etc. You can also add validation to these fields, like mandatory or optional fields, email format, only numbers, postcode with a custom format, etc. Validation for any field can be extended to any format using Regex. You can also configure each field to accept unique values.

  4. Setup the "Thanks for Voting" screen and "Submission is closed" screen, if desired.

  5. Add custom CSS and JS to add some style to the form. This is known as Skin, which can be assigned to a submission form. Here are some examples:

  1. Publish the form within the event to allow users to vote and submit results. You can view the results online by clicking on "View Records".

  2. Set up the trigger for the form. You can trigger the form when the app loads, when the user passes a specified points threshold, before entering the app, when the user answers a question correctly, or when the user participates in a poll or rating. The form can also be manually triggered by the producer.

  3. Display the list of forms as a list on a separate tab in the app, if desired.

  4. Configure and use several different forms per Project. For example, one form can be displayed for users who scored 100pts, and another for users who scored 200pts.

  5. Schedule the forms to automatically close at a set date and time, or close them manually

Geo-restriction

With our forms service, you can now specify the locations in which your forms are displayed to your users. This feature allows you to set up multiple forms on a single page, but only the relevant ones will be displayed based on the user's location. This way, you can show specific forms to specific regions, ensuring that your users get the most relevant content.

To set up location-specific forms, simply follow these easy steps:

  1. Go to the form configuration/management panel

  2. Click on the "GEOLOCATION" tab

  3. Toggle on the Geolocation button

  4. Choose your preferred geo-verification operator

  5. Select the countries/locales that the operator applies to

  6. Click on the "Update Form Availability" button

That's it. Your forms are now set up to display only to users in the specific locations you've chosen. This helps you ensure that your users are getting the right forms for their needs, improving their experience and engagement with your content.

Winner Picker

Welcome to our Forms Winner Picker functionality. This feature is designed to facilitate the selection of winner records from your forms. Here's how to use it:

  1. On your Forms project panel forms listing, click on the trophy icon on the right.

  2. In the modal that appears, fill in a name for the draw, number of winners, and any other optional fields, then click on the “Pick Winners“ button.

  3. To access the winning draws and the records that they hold, click on the value on the “Winner Draws“ column for the specific form.

  4. A list of the winner draws is then shown. By selecting a draw, you will be able to see the draw name (a), the number of records selected as winners (b), and the date and time of the draw (c). You can also start a new draw (d) or invalidate the draw (e) by clicking on the respective buttons.

  5. When you click on the “Invalidate Draw“ button, a confirmation modal will appear requiring a reason for the invalidation. Invalid draws then appear highlighted in the winner draw listing, which can be expanded to show the full details of the invalidated draw.

  6. To export records, first enable exports within your system configuration. Once enabled, you will see the appropriate buttons for export within the draws panel.

With the Forms Winner Picker functionality, it is possible to pick winning records from the same form multiple times. Each winner selection is termed as a draw, and you can show different draws to different user regions. We hope this feature makes it easier for you to manage and pick winners from your forms.

Other Features Supported

In addition to its core functionality, our Forms service offers several other useful features that you may find helpful. These include the ability to create single or multiple stepped forms, and a user-friendly form builder that uses building blocks to make the process easy and intuitive.

You can also customise the look and feel of your forms using our simple skin.css feature, and even add custom JavaScript to further tailor the user experience.

When it comes to analysing the data you collect through forms, the service makes it easy to export results in CSV format directly from the Forms tab. And if you need to schedule or manually export your data to AWS, the services supports that too.

🎨
support@monterosa.co
Example Form
Example Form
Winner Picking