Intended Audience: Qualtrics survey programmers / developers responsible for embedding fraud and bot detection into market-research studies.

Objective: Step-by-step instructions for integrating the dtect JavaScript SDK into a Qualtrics survey, fetching security results, persisting them via Qualtrics.SurveyEngine.setEmbeddedData and branching or terminating participants based on their dtect score and/or individual security flags.

Overview of Flow

Follow these steps to integrate dtect into your Qualtrics survey:

1. Add Javascript to your survey
2. Initialize the dtect SDK with your clientId and apiKey
3. Show dtect’s Quality Questions to participants, collect responses, and create a security result for the current participant.
4. Persist the returned results in Qualtrics using Qualtrics.SurveyEngine.setEmbeddedData()

1. Adding the dtect’s SDK into your Qualtrics survey

You will need to add JavaScript to your survey by adding a <script> tag to your Header and have dtect collect data about your participants.

1. Navigate to the Survey tab → open the Look and feel menu → click on General → click on Header

1. Click on the “code” symbol to add our script tag

1. Copy and paste the script below and replace the following variables

• CLIENT_ID ← Replace with your Public Client ID available at https://dashboard.dtect.io/settings/credentials
  • If you don’t have access, please contact us
• API_KEY ← Replace with your Public API Key available at https://dashboard.dtect.io/settings/credentials
• VISITOR_ID ← Replace with a unique ID for your participant. We use this value to check for duplicate ID feature. If you don’t have one, keep the ${e://Field/SessionID} , but participants will never be flagged by the Duplicate ID feature.
• RESPONDENT_TYPE ← The script has “general” as the default respondent type, this value defines the type of questions the participant you will see. You can find all the available respondent types at: https://docs.dtect.io/frontend/quality-question-and-ai-detection#supported-respondent-types