How to Troubleshoot Your Surveys When Not Displaying
Troubleshoot issues related to the display of Qualaroo surveys on your website. If you find that your surveys are not appearing as expected, follow these steps to identify and resolve the problem.
Verify Your Nudge™ Installation
Find Your Survey
On your Qualaroo dashboard, find the nudge you want to verify installation for and click ‘Verify Installation’ link.
.png?Policy=eyJTdGF0ZW1lbnQiOlt7IlJlc291cmNlIjoiaHR0cHM6Ly9kemY4dnF2MjRlcWhnLmNsb3VkZnJvbnQubmV0L3VzZXJmaWxlcy8yMDg2LzM5NDA5L2NrZmluZGVyL2ltYWdlcy9xdS8yMDI0L251ZGdlKDEpLnBuZyIsIkNvbmRpdGlvbiI6eyJEYXRlTGVzc1RoYW4iOnsiQVdTOkVwb2NoVGltZSI6MTc0Njc4NTI3MX19fV19&Signature=FuG7ww~tgKJhu-InXFoy6OduWENomEka6ghhNqmUkJugGepXFA1psZ6D3dAGgOiL~9yJVsEM3lNHZEQDAnst7KkLi4KutL39LKuNl5-bBU-Z~vyQ4zv3VJ~3TPOFK9jH5KsdyzXgoAzG7VZe76MhOf~dX1vydU7yb7yemu94yS0Rvkz1QtaN5BDAdRfl0hboaYtnHfxHAXT4~z8b19t7q8kHdAMWz5glNeQTZMTty2rrLP1~w9tQDiEK7r3Umev04mpBFZJcp4O35XgiPFx-6vxa-ZptY2PMMV7VVLLfSUS7sECyPJbSPNen1WvfSE-UXAg3S-Ro-hmVvwAu8gVU6w__&Key-Pair-Id=K2TK3EG287XSFC)
Enter your site URL & Initiate Verification
Make sure you enter the URL where you have added the code and click ‘Verify Installation.’
.png?Policy=eyJTdGF0ZW1lbnQiOlt7IlJlc291cmNlIjoiaHR0cHM6Ly9kemY4dnF2MjRlcWhnLmNsb3VkZnJvbnQubmV0L3VzZXJmaWxlcy8yMDg2LzM5NDA5L2NrZmluZGVyL2ltYWdlcy9xdS8yMDI0L1ZlcmlmeV9JbnN0YWxsYXRpb25fXzFfKDEpLnBuZyIsIkNvbmRpdGlvbiI6eyJEYXRlTGVzc1RoYW4iOnsiQVdTOkVwb2NoVGltZSI6MTc0Njc4NTI3MX19fV19&Signature=rUIdDE0cx4ThTqektYlsqHqcLhsqxHlWnvzce8QFY2CIGxRE-4jVV3DGVTDJHIMngCcte1l0~rU~zpSrssjUXKjafpdLKflorId4y~8g-mvWkxyv55eV6GM1CwBGEItT3RMDr1yRkRzStIoSDvTqbtAWu3YYBlEmt2k2ajgFcgAhfQnXJDrFhOTMa47LLwrA3orRK4PuW8SK3x9I8VFEYjStEpImIlSyMgiy394gFf1rc4x2TqIrtE~pv1U3gQcUFEoiKOcPWbp7OO~Jjhgpb6xqaNwMC8qap46RIvsbGBObSqbJm-uftQ0K2AjgB6fVuJr5aYVb2MSP40zA8Ran7g__&Key-Pair-Id=K2TK3EG287XSFC)
The system will automatically check whether the nudge script is correctly installed on your website.
.png?Policy=eyJTdGF0ZW1lbnQiOlt7IlJlc291cmNlIjoiaHR0cHM6Ly9kemY4dnF2MjRlcWhnLmNsb3VkZnJvbnQubmV0L3VzZXJmaWxlcy8yMDg2LzM5NDA5L2NrZmluZGVyL2ltYWdlcy9xdS8yMDI0L3ZlcmlmeV9pbnN0YWxsYXRpb25fMigxKS5wbmciLCJDb25kaXRpb24iOnsiRGF0ZUxlc3NUaGFuIjp7IkFXUzpFcG9jaFRpbWUiOjE3NDY3ODUyNzF9fX1dfQ__&Signature=idmgulgY-XVOHLtLHqpdduq-AYngRVouvZGllT1UqYLvlTraZtbKzG489fqTOYW2SOKY1nAiZq5usIgwkmF9ApgYvRGHe9Tq83I6-CFdSAsrf7CIwbJnGS-UC~o5Z7~KM1WR8-eRMC~cqp8rCO53tr0hJ5AZwsdIUsWEc1etVh~RX1qS3duL313KoojE1xJT1OxFbsGqixZM~XmSCEA4z9iewd0ychKzL3tyilXmLITzX3~W1b4ZAZDixTBZ2ei1PapUdWJ9NFMvDIkr~flw-bwi-F4ciAaZIwQKoux4ce5Lf--muVeaAPHQGEyOqYdIbr~4FJ6MxoFMhktrwMH0Dg__&Key-Pair-Id=K2TK3EG287XSFC)
Review the Results
-
A confirmation message will appear if the nudge script functions correctly.
-
If there’s an issue, the system will notify you, allowing you to take corrective steps (e.g., re-installing the script or updating its placement).
Verify the Activation Scheduler
Problem: Surveys may not display if the activation scheduler is misconfigured.
Solution: To ensure your survey remains active for the desired duration, check the activation scheduler settings in the TARGETING section for your survey. Adjust the deactivation date if necessary.
Confirm the Presence of Qualaroo Code
Problem: The absence of Qualaroo code can prevent surveys from displaying.
Solution:
- Right-click on your survey page and select "View Page Source."
- Search for "kiq" in the page source to confirm the Qualaroo code block's presence below the <body> tag.
Search for “kiq” in your page source and ensure the Qualaroo code block is below the <body> tag.
Check Domain-Specific JavaScript Code
Problem: Incorrect JavaScript code can hinder survey display, especially on plans that support multiple domains.
Solution: Compare the JavaScript code in your Qualaroo account to the code on your website to ensure they match.
Verify Survey Configuration for the Correct URL
Problem: Incorrect URL configuration can lead to surveys not displaying on the intended pages.
Solution: Ensure the URL of the page matches the URL pattern for which the survey is configured.
Matches with
Test Survey Display
Problem: Surveys may not display due to targeting conditions not being met.
Solution: To force a survey to display for testing purposes, append "?qualaroo_preview" to the URL (e.g., http://proprofs.com/?qualaroo_preview). If it displays, review your targeting conditions to ensure they align with visitor behavior.
Avoid Multiple Surveys Targeting the Same Group
Problem: Having multiple surveys targeting the same group can lead to inconsistent results.
Solution: It is recommended to avoid this setup. Qualaroo defaults to displaying the first created survey in such cases. Adjust targeting or pause and run surveys at different times for more predictable results.
Verify Browser Compatibility
Problem: Outdated web browsers may not support Qualaroo surveys.
Solution: Ensure your visitors are using up-to-date web browsers that are compatible with Qualaroo surveys.
Handle Special Characters in Target URLs
Problem: Special characters in URLs can cause issues.
Solution:
- For letters (A-Z, a-z) and numbers (0-9), no changes are needed.
- Characters '.', '-', '~', and '_' should also be left as-is.
- Replace spaces with '+'.
- For all other characters, encode them as %xx. For example, replace double quotation marks with %22.
Handling URLs with Query Strings
Problem: URLs with query strings require special handling.
Solution: To target pages with query strings, use Regular Expressions and click "Validate this regular expression(recommended)."
Following these troubleshooting steps should help you identify and resolve issues preventing Qualaroo surveys from displaying on your website. If you still encounter any issues or have any questions, feel free to contact our support team.