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
  • Contact Us
  • Home
  • Mobile
  • Troubleshooting

Using the mobile debugger

Updated at December 9th, 2022

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 Installing Appcues Mobile API & Data Troubleshooting Extras
  • User Experiences
    Web Experiences Building Web Experiences Building Mobile Experiences Customization & Styling Targeting Studio Troubleshooting Use Cases FAQ
  • Mobile
    Installation & Overview Building Mobile Experiences Mobile Analytics Troubleshooting Mobile Use Cases
  • Account Management
    Subscription Users & Data
  • Analytics
    Experience and Event Analytics Data
  • Best Practices
    Use Cases Pro Tips PLG FAQ
  • Integrations
    Integration Documents Use Cases Resources
  • Post-mortem
    System Incidents
+ More

Table of Contents

Overview Launching the debugger Interacting with the debugger

Overview

Once the mobile SDK is installed on iOS, Android, or cross platform, your application can take advantage of the Appcues Mobile Debugger tool inside of your app. This tool is bundled as part of the SDK. Use cases for the debugger include:

  • Validating the SDK is installed correctly and sending data to Appcues
  • Inspecting the Screen names and Event names being sent to Appcues for usage in flow targeting
  • Inspecting auto-properties being collected by the SDK for use in Audience segmentation or other flow targeting needs
  • Viewing the fonts available in the application that can be used in the mobile builder when building flows

Launching the debugger

There are multiple options to open the debugger inside of your mobile application - any of the following can be used:

  1. In your application code, call appcues.debug() directly, from a button or menu inside of the application. Note that this is not always feasible and is not something you want to make visible to the end-users of your application, so other options exist.
  2. Execute a deeplink to the Appcues SDK that will launch the debugger. The link is of the form appcues-{application_id}://sdk/debugger . This link can be tapped on the device and it will open your app and open the debugger on top. Note that this requires the SDK to have been properly installed with the URL scheme for the Appcues SDK configured. Please refer mobile developers to the SDK installation docs for these details.
  3. Coming soon - scan a QR code inside of your Appcues Studio settings page. This option will make it quick and easy to launch the debugger using the same underlying deeplink mechanism noted in #2 above - and requires the same SDK installation setup for the URL scheme deeplink.

Interacting with the debugger

When the debugger launches, a small floating button with the Appcues logo will appear on top of your app's content. This button can be dragged around the screen to reposition and dragged to the bottom center of the screen to dismiss.

Tap on the button to open the expanded view of the debugger.  This view allows you to confirm that your SDK is installed, connected to Appcues, a user has been identified and screens are being tracked.  These are the basic diagnostics to use to confirm a successful SDK installation.

At the bottom of the page, there is a section titled "All Recent Events".  This tracks recent analytics sent from the Appcues SDK, and you can tap on each line to inspect more details. These analytics will include: screens tracked, custom events, user identification, and flow events.  Tapping on a screen tracking item will allow you to see the name of each screen, which can then be used in Studio when setting up targeting for specific screens by name. In the example below, the screen name is "Home" - this would be the exact text you would need to type into the flow targeting for this screen.

When the debugger is minimized, you can browse around the app and see the screen names in a small floating text bubble above the Appcues floating debugger button, for quick reference.  Screen names being tracked are dependent on how the SDK was installed and configured by the mobile developer for your application.  If screens are not being tracked as expected, please ask your mobile developer to consult the SDK installation documentation.  Similarly, any custom events your application is tracking will be displayed on the floating text in the minimized debugger state, or in the "All Recent Events" section when the debugger is maximized.

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Previewing Mobile Flows
  • Mobile Overview
  • Styling Mobile Modals
  • Targeting and Publishing Mobile Flows
Appcues logo

Product

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

Use cases

User Onboarding Software
Feature Adoption Software
NPS & Surveys
Announcements
Insights
Mobile Adoption

Company

About
Careers
we're Hiring

Support

Developer Docs
Contact

Resources

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

Follow us

Facebook iconTwitter icon greyLinkedin iconInstagram icon
© 2022 Appcues. All rights reserved.
SecurityTerms of ServicePrivacy Policy
Expand