Skip to main content
  • Customer Experience
    Customer Experience
  • Employee Experience
    Employee Experience
  • Brand Experience
    Brand Experience
  • Product Experience
    Product Experience
  • Core XM
    Core XM
  • Design XM
    Design XM

Website / App Feedback Technical Documentation

What's on This Page:

Was this helpful?

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!

What is a Website / App Feedback project, and why are we using it on our site?

Qualtrics Website / App Feedback helps organizations measure and enhance the experience a web visitor has within their digital media. Present cool graphics on your website with links and embedded surveys to get feedback on your visitors’ experience, let them know about your latest deals and promotions, and more!

You and your colleagues have power over the appearance of the graphic (also known as a creative), the conditions under which it appears (the intercept), and the code used to deploy it.

Once the code for your project is added to your website, you can make all kinds changes without ever having to change the code or alert your IT team. Just do the work in Qualtrics, and your websites’ creatives and intercepts will change accordingly.

Is it secure?

We do not pass any data to Qualtrics servers unless it’s needed for targeting logic. That said, we do not store any of this data in our system.

To secure this data over the wire and protect it from man-in-the-middle attacks, Qualtrics always uses the “HTTPS” protocol. Protocol refers to how content is delivered to the visitors’ web browser.

Where can I locate the project code for deployment?

Deployment code (or project deployment code) can be found by going to the Deployment section of the Settings tab within your Qualtrics account. You can simply copy the code and send it to your web development team for implementation. No modifications need to be made to the code.

Deployment code in the Settings section

Deployment code displays any intercept that has been built within that entire project.

How does the code work?

Deployment code is asynchronous, meaning that it only runs after everything else on the page has loaded. This means that deployment code will not prevent any other aspect of your page from loading because it will only run once the onLoad event is triggered.

Let’s run through the process of what happens when a visitor views a page that contains deployment code:

  • A website visitor will view a page in their browser containing the deployment code.
  • The deployment code (usually placed in the HTML head) will run right away upon page load and will insert another <script> tag at the end of the Html body when the page onLoad event is triggered.
  • This <script> tag will request JavaScript code (Orchestrator) from Qualtrics servers that is cached in a content delivery network (CDN).
  • The Orchestrator makes a targeting call to Qualtrics servers to determine which creatives to show. This call is not cached in the CDN.
    • If necessary, a second targeting request is sent to the servers to obtain the required data (ex: JavaScript expression or cookie targeting).
    • Qualtrics obtains the Website / App Feedback definition from the database and builds the code appropriately.
  • Based on the targeting response, the Orchestrator makes additional calls to get the different content needed to render on the page. The number of requests made varies depending on the number of creatives to show that pass targeting logic. All this content is cached in the CDN, so it will be fast to load.
  • The creative(s) appear(s) on the page.

The code is also dynamic, meaning that changes made to intercepts and creatives from within the Website / App Feedback project interface will not cause the code itself to change. Thus, changes can be made to Website / App Feedback projects from within an account, and code will not need to be exchanged on the website for the changes to be seen.

How do I deploy a Website / App Feedback project?

1. Add Code Directly to Your Web Pages

Deployment code can be added anywhere on a web page. Because the code runs asynchronously, it will only start loading once a web page has completely loaded all content (including images, script files, CSS files, etc.).

Our requests start happening once the onLoad event is triggered:

Additionally, the location of where creatives actually appear on the web page is determined by settings determined within the Qualtrics interface. (See information on Custom Position.) Thus, the location of the code within the page does not affect where on the page content will appear.

2. Global Header/Footer (Recommended)

We recommend that you add deployment code to either the Global Header or Footer. This applies the code globally across the entire site all at once. This method is the easiest way to deploy because you don’t need to repeatedly add code to more pages as you go, which can be a lengthy process. If code has been added globally to your site in this way, you can then use Current URL logic within an intercept to control on which pages an intercept actually appears.

3. Use Tag Managers

Another option for implementing Website / App Feedback on your site is to add it to a Tag Management system, instead of applying it directly to the site code. Code can be copied and pasted from the Qualtrics interface right into a Tag Manager.

Qtip: Qualtrics currently has an extension with Adobe Launch as a Tag Management system. See this support page for more information.
Qtip: Qualtrics is not able to fully troubleshoot issues with code applied to Tag Managers as we aren’t able to view the settings that have been enabled on your end. Please refer to our Using Tag Managers page.

Common Tag Management systems that our clients use in conjunction with Website / App Feedback are Adobe Launch, Tealium, Ensighten, and Google Tag Manager. Tealium in particular has a wizard built that allows for easy implementation of Website / App Feedback. You will simply need the Zone ID for the project you are implementing and your Organization ID.

The Organization ID can be obtained by going to the Account Settings menu and selecting the Qualtrics IDs tab.

Finding the Organization ID in the Qualtrics IDs section of the Account Settings

The Zone ID will begin with ZN_ and can be found:

  1. In the URL of the project when you’re inside it, or
    The zone ID starting with ZN can be found in the URL
  2. In the deployment code of the project.
    Zone ID in the deployment code of the project, starting with ZN

Who is typically involved in Website / App Feedback implementation?

Someone within your organization that has access to add content to your company’s website. Typically these are individuals on an IT team, Web Content team, etc.

Will Website / App Feedback slow down our site?

Deployment code is asynchronous, meaning that it only runs after everything else on the page has loaded. This means that deployment code will not prevent any other aspect of your page from loading because it will only run once the onLoad event is triggered.

What if Qualtrics is down? Will that cause issues with our website?

If Qualtrics is experiencing any outages or issues, the intercepts will simply not show up on the page. Beyond that, there will be no impact to the visitor’s experience on your sites.

How quickly will the code run on my website?

We expect the deployment code to load within 300 milliseconds for more than 50% of requests and within 750 milliseconds for more than 90% of requests. Speed will vary based on user’s geographic location and how many intercepts and creatives a project has.

Troubleshooting Tips

Intercept Logic and Action Set Logic

  • Make sure the values are correct.
  • Examine your use of “Is” vs. “Contains.”
  • Examine your use of And/Or logic.
  • Watch out for spaces in the values.

Revision History

Make sure the published version is the most recent (or the version that you would expect).

Watch For the Website / App Feedback Network Request

  1. Open Developer Tools on your browser.
  2. Look at the network request for ?Q_ZID etc.
    • No network request: The implementation is not working.
    • Network request: Check the parameters of the request for inconsistencies. Sometimes the code is implemented using a tag management system. There are cases where this implementation messes with the parameters in our request for current URL, etc.
    • Network request with an error: Check if your project is activated.

Look For Other Hanging Script Requests That Might Be Interfering With Our Script

  1. Right click anywhere in your browser.
  2. Select Inspect Element.
  3. Choose Console (this is where errors appear).
Qtip: You will also want to right click and select View Page Source to verify that your deployment code is actually on the page.