Blue State Digital quiz integration

Quizzes are powerful lead generation and marketing tools. We designed Riddle’s quiz maker to easily connect to all kinds of email marketing tools (like MailChimp, AWeber, and more). Now you can use our new Blue State Digital quiz integration to automatically send all quiz responses and leads to your Blue State Digital account.

Quizzes are powerful lead generation and marketing tools. Use our Blue State Digital quiz integration to automatically send your quiz responses and leads to your Blue State Digital account.

(If you don’t know who Blue State Digital are – they were the digital masterminds behind both of President Obama’s election campaigns. They’ve created a brilliant outreach and marketing tool for both companies and non-profits.)

Activating your Blue State Digital quiz integration

Here’s how to get started:

  • Create any type of Riddle quiz – we recommend our ‘pop quiz’ to start out with our Blue State Digital quiz integration.
  • In the ‘collect leads’ step of your quiz – create a lead generation form to collect information (choose from 16 types of data fields).
  • Go to Blue State Digital – then go to “Advanced Configuration” and create a “New API User”:
    • Enter “Name” and “ID/Application” (examples: ‘Quizleads’ and ‘Riddle’)
    • Assign the following permissions:
      • api_signup > methods > process_signup
      • api_signup > methods > list_forms
      • api_signup > methods > list_form_fields
      • api_signup > methods > get_form
  •  
Blue State Digital quiz

 

  • Blue State Digital quiz signup forms
    • Create whatever fields as you want but note that only text fields are possible inside BSD.
      • Don’t worry – you can use any of Riddle’s 16 data fields like dropdowns, radio buttons, etc. in Riddle.
      • All data will be sent as text to your text fields in Blue State Digital.
    • Auto-subscribe users: at bottom of your BSD form, set how users will be added to your subscriber list.
      • Edit form => choose ‘User opt-in’
      • Email opt-in label => ‘Yes, subscribe me’ – or you can customize this text
      • Set the email opt-in default => we recommend leaving as ‘unchecked’.
      • You can see these options – and how they will appear on a Riddle quiz lead generation form below:

 

BSD Control Panel

Blue State Digital quiz

 

Riddle quiz maker

Blue State Digital quiz

 

Lead generation form in your quiz

Blue State Digital quiz

 

Setting up your Blue State Digital quiz in Riddle

Next up, you need to configure your Blue State Digital quiz integration to communicate with Riddle’s quiz maker.

  • When editing your Riddle quiz, go to the ‘Collect leads’ step.
  • Go to ‘Step 2: Connect’ – then select ‘Blue State Digital’
Blue State Digital quiz
  • Enter the API permissions: API ID, API secret key and the API URL.
    • The description is the ‘Name’ of your new API user created under BSD.
    • You’ll find your “ID” and “Secret key” in your BSD Tools account under the “Advanced Configuration” section.
    • The API URL is the URL where your BSD Tools account is reachable (check browser address bar – without the ending “/”).
      Example: https://yourtestsite.cp.bsd.net
    • Note: all fields are case sensitive 
Blue State Digital quiz
  • Select your sign up form.
  • Next – map your fields from your Riddle form to your BSD form.
    • For example, map the field collecting emails (‘Email’) to your email field in BSD.

 

Blue State Digital quiz integration – troubleshooting

  • One note – post codes/zip codes can sometimes cause issues. If you’re having any trouble, please check “Enforce Country-Specific Postal Code/Phone Rules” is selected as ‘Yes’ when editing your form in Blue State Digital.

Blue State Digital quiz

  • Don’t forget about our REGEX field options – ideal for ensuring all data is entered in a consistent format such as:
    • ZIP/post codes: set all post codes to follow the standard format such as NW18 7FF – instead of NW187FF.
    • Phone numbers: you can require your fields to be entered as +1 (###) (###-####), instead of ###.###.#### or the like.