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 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

Riddle quiz maker

Lead generation form in your 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’

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

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.