Submit Article Requests

Do you have a suggestion for an article you would like to see created?
Feel free to submit this form and add your suggestions to our document board.

Please fill out the contact form below and we will reply as soon as possible.

  • Appcues Certifications & Training
  • Integration Hub
  • Contact Us
  • Docs home
  • Installation & Developers
  • Troubleshooting

Testing Appcues on a Wrapped Webapp

Guidance for testing Appcues on wrapped web applications, such as a Chromium or Electron-based desktop applications.

Updated at July 1st, 2024

Submit Article Requests

Do you have a suggestion for an article you would like to see created?
Feel free to submit this form and add your suggestions to our document board.

Please fill out the contact form with the details about the help content you'd like to see.

  • Installation & Developers
    Installing Appcues Web Installing Appcues Mobile API & Data Troubleshooting Extras
  • Web Experiences
    Building Web Experiences Targeting Studio Customization & Styling Use Cases Troubleshooting FAQ
  • Mobile Experiences
    Installation & Overview Building Mobile Experiences Mobile Analytics & Integrations Troubleshooting
  • Workflows
    Building & Configuration Use Cases Workflow Analytics and Integrations
  • Account Management
    Subscription Users & Data
  • Analytics
    Experience and Event Analytics Data
  • Best Practices
    Best Practices Use Cases Pro Tips Product-led Growth
  • Integrations
    Integration Documents Use Cases Extras
  • System Status
    System Status & Incidents
+ More

Table of Contents

Installation Building Testing

The objective of this document is to provide guidance for testing Appcues on wrapped web applications, such as a Chromium or Electron-based desktop application.
Wrapped web applications are an edge case for Appcues and require extensive technical compatibility testing pre-purchase to confirm viability and uncover any potential challenges.
Here are our recommended steps for technical compatibility testing:

Installation

Appcues can be installed in your Chromium or Electron application via the same method as standard web applications.
Start by adding the javascript snippet available in your account: https://studio.appcues.com/settings/installation/guide/overview

The snippet should include the following:

  • Core script: <script src="//fast.appcues.com/{{youraccountID}}.js"></script>
  • An identify call with the unique user ID you associate to each end user
  • A page call to tell Appcues when to reinitialize if your application does not reload when moving to a new view, route or page
  • At least one user profile attribute and one event (client side if you’d like to use event triggering) to test targeting

Learn more about which user properties & events to send here.

Building

A key requirement of building Appcues content on top of any application is the use of our Chrome extension builder. To build on top of your Chromium or Electron application, you’ll need to open the app in a Chrome window, rather than building from the Desktop view.

We recommend building a modal followed by a tooltip to ensure Appcues will be able to find the CSS selectors used for tooltips when loaded within the wrapped web app version.

Testing

Once you’ve built a combination of the patterns above, it’s important to publish “live” and test a few key scenarios:

  • Targeting content to show to specific users. We want to confirm that Appcues will be able to identify user profile attributes and events and only show content to users who are qualified to see a flow based on this information.
  • Triggering content the moment an event occurs. Assuming you want to be able to leverage this functionality, rather than only collecting new data on a page load, testing this will tell us if Appcues is able to listen for events from your Chromium or Electron application in real time.
  • Targeting content based on pages by targeting a flow that begins with a modal to a specific URL. If it appears on the correct page, test to see if it also shows up on any other pages. We’ve seen that some wrapped web apps have URLs loading behind the scenes for each page, so the content can still be targeted to specific URLs even though they are not visible to the end user. We want to test to find out if this is the case. If not, you’ll need to begin each flow with a tooltip or hotspot so that it will only show if a specific selector is visible to prevent flows from showing up on the wrong pages.
chromium electron wrapped web applications technical compatibility testing

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Launchpad v1 Custom Install
  • Installation Guide for Developers
  • Launchpad v1 Standard Install
  • Anonymous Users (Developer)
Appcues logo

Product

Why Appcues How it works Integrations Security Pricing What's new

Use cases

Appcues Integration Hub User Onboarding Software Feature Adoption Software NPS & Surveys Announcements Insights Mobile Adoption

Company

About
Careers

Support

Developer Docs Contact

Resources

The Appcues Blog Product Adoption Academy GoodUX Case studies Webinar Series Made with Appcues Appcues University

Follow us

Facebook icon Twitter icon grey Linkedin icon Instagram icon
© 2022 Appcues. All rights reserved.
Security Terms of Service Privacy Policy

Knowledge Base Software powered by Helpjuice

Expand