Editing Standalone Intercepts
What's on this page
Qtip: If you don’t have access to any of the features described on this page, reach out to your Account Executive. For more information about the differences between Digital Feedback and CustomerXM for Digital, see Digital Feedback vs. CustomerXM for Digital.
About Editing Standalone Intercepts
Once you’ve built a creative, the next step is to set conditions for when it will display and what the targets on your creative should be linking to. This is where the intercept comes in. Intercepts manage when your creatives appear and where they link to.
Once you’ve generated a new intercept, you can edit it in the Edit section.
Understanding Intercepts
An intercept is organized into parts called action sets. Each of these action sets will contain specific conditions (logic) under which the creative should appear, the creative that should appear, and where the visitor should be redirected if they click the creative (target).
You can have just one action set or multiple. Having multiple action sets allows you to display different creatives and targets under different conditions, or to randomize action sets, so you can perform A/B testing.
Qtip: When should you have one intercept with multiple actions and when should you have several intercepts with one action each? In many cases, either method will get the job done, but there are some important differences. For more information, check out our Multiple Action Sets support page.
Selecting a Creative
Each action set connects to a creative. Click the Select a Creative to show dropdown, highlight the type of creative, and then select the creative to show.
Selecting a Target
The target is where your creative should link to. In the case of an embedded target, it’s the content that should be embedded right on the creative. For example, instead of linking visitors away to a Qualtrics survey, you may want them to complete it as soon as the creative appears.
Qtip: See the Edit Creative Section on adding target text to your creative.
To add a target, click the Select a target for your Creative to link to dropdown.
From there, you can do one of the following:
- A Qualtrics Survey: Choose one of the Qualtrics surveys you’ve built.
- My Own Web Page: Add any link you’d like. Type the URL in the field and click Link.
- No Target: Your Creative will not link the visitor to anything.
Action Set Logic
Action set logic is how you decide when the corresponding action set’s creative should be shown to your site’s visitors.
Adding Action Set Logic
Qtip: For more information on how to use the Move to a new logic set option, see the page on Advanced Action Set Logic.
Types of Logic
You can base logic on several different kinds of conditions.
- Browsing Session Conditions
- Website Conditions
- Date Time Conditions
- Web Service Conditions
- Intercept Conditions
- Qualtrics Survey Conditions
- Action Conditions
- User Conditions
Adding Another Action Set
Sometimes your intercept will require multiple action sets.
Example: You store’s website has two major annual sales: your summer vacation sale and your winter holiday sale. You have made a creative for summer and a second one for winter, and you want to make sure the correct creative appears at the correct time of year. You would need two action sets: one to specify the summer sale and the other to specify the winter sale.
To add an action set, click Add Another Action Set.
To learn more about how multiple action sets work together, see the linked support page.
Targeting Logic
Targeting logic applies to the entire intercept instead of just one action. If you have logic that applies to every action set in the intercept, it’s a good idea to apply it as targeting logic instead.
To add logic that applies to the entire intercept, click Add targeting logic.
Setting up targeting logic is exactly the same as setting up action set logic.
Action Set Options
Every action set has an Options button to the upper-right of it.
From here, you can do much more with your action set. To learn more about these options, see the following pages:
- Action Set Advanced Options (includes Advanced Options, Rename, Copy Action Set, Add Javascript, and Delete Action Set)
- Embedded Data in Website Feedback
- Adding Event Tracking & Triggering (includes Add Event)
Intercept Selection Menu
When you enter the Edit, Options, Test Intercept, or Statistics sections, a menu will appear to the left listing all the intercepts you’ve created in this project. You can switch easily between intercepts by clicking their names.
Using the Search bar, you can search intercepts by name, or change the Sort by Date dropdown to sort your intercepts by a different criteria.
Green icons indicate activated intercepts. Gray icons indicated intercepts that haven’t been activated yet, or have been deactivated.
FAQs
When should I use logic on my action sets?
When should I use logic on my action sets?
For example, since creatives are not responsive to screen size, many users like to implement action set logic focused on whether a website viewer is/is not using a mobile device or whether the website is being displayed on a certain screen size. By using logic in this instance, you are able to target a properly formatted and sized creative to the appropriate person.
Action set logic based on location can even be used to make sure that website viewers are seeing a creative that is written in the language that most likely applies to them.
I activated my intercept, but it‘s not showing up on my site. Why not?
I activated my intercept, but it‘s not showing up on my site. Why not?
- Logic: intercept targeting logic and action set logic are the conditions that must be met in order for an intercept to be displayed to a visitor. Checking this logic will be helpful in discovering why the Intercept is not displaying on a page.
- Logic sets that use “Contains”: A common cause of logic error is the use of the “Contains” vs. “Is.” To say a condition “Contains” means that the parameter you are basing the logic off (i.e., Current URL) will have the specified value present in addition to more information. For example, if I had logic that read as Current URL contains ‘qualtrics’, this would cause the intercept to display on any URL that has the word qualtrics present. The other option you have is using Current URL is [URL]. This condition depends on the visited URL being an exact match. Any differences or additional characters will prevent the intercept logic from passing.
- Intercept Revisions: When making edits to intercepts, changes are not made live until the intercept is published. When publishing an Intercept, a version of the intercept, or a “revision,” is saved. Reviewing the revisions that have been made is very useful for identifying any changes that may have suddenly prevented the intercept from appearing.
- Debug Window: The debug window is an invaluable tool for testing why an intercept is not displaying on a particular page.
For intercepts whose deployment code was implemented before March 2019, to enable the debug window, append a query string to any given URL called Q_DEBUG. This must be prefixed with a ? or a & like the following examples: https://www.qualtrics.com?Q_DEBUG, https://www.qualtrics.com/blog?item=value&Q_DEBUG.
For intercepts whose deployment code was implemented after March 2019, run the following JavaScript snippet in the Console of your web page:
QSI.API.unload();
QSI.isDebug = true;
QSI.API.load();
QSI.API.run();Qtip: The Website Insights debugger does not function if the code has been implemented using a tag manager. Also, if the URL already has a query string with a ?, then the debugger will require a & instead.
- Network Request: Most browsers possess a developer tools menu that allows a user to see a site’s source code, resources, cookies, and network calls. Website Insights possesses a distinct presence in the Network section of these tools. To check for these scripts running, open the developer tools and navigate to the Network section. Once here, reload the webpage and the menu should begin to populate with all network requests being made by the website. To identify Website Insights code, look for calls that begin with ?Q_ZID or ?Q_SID. This is the code itself running checks on the display logic. If you cannot find anything matching this format, then there is an issue with the implementation of your project code. You can refer to our support page on implementation for advice on where is best to place the code.
- Content Security Policy Issues: If you receive a console log that violates a Content Security Policy, there is most likely a restriction on your website that is blocking our intercepts from deploying. We recommend reaching out to your web-development team to resolve. To ensure your intercepts work, we generally recommend allowlisting the following items in your Content Security Policy headers:
- connect-src https://*.qualtrics.com
- frame-src https://*.qualtrics.com
- img-src https://siteintercept.qualtrics.com
- script-src https://*.qualtrics.com
- SPA URL Handling: If your site uses a single-page application (SPA) framework, make sure your code triggers history.pushState() when navigating between views. Some frameworks may re-render or update the URL without pushing a new history entry, which can prevent intercepts from firing. If you're using useEffect or similar lifecycle hooks, make sure your intercept logic runs after navigation is complete.
Can I capture information from my website visitors in my intercept's survey? How?
Can I capture information from my website visitors in my intercept's survey? How?
Aside from simply setting a static value that you want carried into the survey, the embedded data menu also comes pre-built with other options that can be carried into the survey. For example, you will be able to automatically capture the ID of both the intercept and creative shown, the URL of the page that displayed the intercept, the person‘s site history, or even how much time was spent on the site. You will even be able to capture information from a cookie that appears on that person‘s web browser or you can write a JavaScript expression that captures a particular variable that you are interested in.
If you are running a survey in Qualtrics, then you can also add the embedded data in the Survey Flow to save this information to the survey response.
What is the difference between zone code and intercept code? Now that it’s called “project code” in the new interface, what does this mean?
What is the difference between zone code and intercept code? Now that it’s called “project code” in the new interface, what does this mean?
Zones (now “Projects”) act as collections for multiple creatives and intercepts. Zone codes contain all the intercepts in the zone. This allows you to implement a single code on your site instead of continually adding codes for individual intercepts. This can save a lot of time, since every time you activate content on the zone, it’s automatically added to the code, requiring no change.
Projects are the equivalent of zones, so project deployment code is the equivalent of old zone codes.
I have built my intercept but would like to test it before activation. How can I do that?
I have built my intercept but would like to test it before activation. How can I do that?
What is the difference between displaying On Load, On Focus, On Exit Intent, and Manually?
What is the difference between displaying On Load, On Focus, On Exit Intent, and Manually?
- On Load: The On Load option is the most basic display option. With this option selected, an intercept fires on a valid page as soon as the page itself loads. This means that a website visitor could load a URL in a separate tab or browser instance and have a creative shown to them without seeing it themselves.
- On Focus: The On Focus option allows us to more reliably ensure that a website visitor is active on a page before encountering an intercept. When a page loads that would display an intercept, the On Focus setting prevents the script from running until the visitor is active on the page. This is determined by mouse movement and clicking. This means that if the URL loads in a new tab, for example, the user will need to navigate to that tab and interact with the page first before the script runs. This is useful if your creatives are set to display on a timer.
- On Exit Intent: This option aims to display a creative when the website visitor attempts to leave your site. When deployment code is present on a page, we can detect the movement of a user’s mouse within the bounds of the browser. The Exit Intent feature detects the moment a cursor moves to the upper regions of a browser and triggers the intercept at this moment. Thus, when someone attempts to close a tab, you can catch their attention.
- Manually: This option is primarily used in Single Page Application setups. Selecting this will prevent anything from being displayed automatically. Instead, the Website Insights API must be run by the site itself to make the script fire and a creative display. Commonly, this is used when you want an intercept to trigger when certain elements on a single page are changed, such as changing filter values or loading elements within the same URL.
That's great! Thank you for your feedback!
Thank you for your feedback!