Event Tracking?

[arnold-drita-abm]

Hello!

We would like to know when a flow was complete so we can push that event to our firebase events (we have a centralized KPI dashboard that pulls data from firebase and other sources).

I saw that on the Web JS api, there was the Appcues.on() method designed specifically for this. However, I'm not finding anything similar on the React Native API.

https://docs.appcues.com/dev-api-data/javascript-api-developer#on-eventname-callbackfn-context-7

I did look at https://github.com/appcues/appcues-react-native-module/blob/main/docs/AnalyticObserving.md however, unless I'm misunderstanding it, it does not do what I would like to do.

The events we're interested in capturing are:

flow_completed
flow_skipped

Is there any way I can capture when those events are dispatched?

Thank you!

[mmaatttt]

Hi @arnold-drita-abm,

You're on the right track with looking at the analytics observer. Specifically, you'll want to filter for events with the values appcues:v2:experience_completed and appcues:v2:experience_dismissed (the mobile equivalent to flow_skipped), so something like this:

Appcues.analyticsEventEmitter.addListener('analytics', ({analytic, value, properties, isInternal}) => {
  if (analytic === 'EVENT' && ['appcues:v2:experience_completed', 'appcues:v2:experience_dismissed'].includes(value)) {
    // TODO: track to firebase
    console.log(analytic, value, properties, isInternal);
  }
});

[arnold-drita-abm]

Hey @mmaatttt !

Thanks for the quick reply. I did try this, but no event is emitted. I am logging everything that comes from the 'analytics' event, but the callback is never called.

    Appcues.setup(AppCuesAccountId, AppCuesAppId)
      .then(() => {
        Appcues.analyticsEventEmitter.addListener(
          'analytics',
          ({ analytic, value, properties }) => {
            console.log('Appcues Event', { analytic, value, properties });
          }
        );
      })

I'm not sure how to debug it. I'm on 4.4.4 and Expo SDK 53. Any ideas?

[mmaatttt]

I tried your exact snippet and the console logs are coming through as expected.

To help debug it, you can launch the Appcues mobile debugger with Appcues.debug() (doc). It will show you all the events that are flowing through the SDK. If an event shows in the debugger but not the analytics observer, that would be a new bug for us to investigate.

A few notes:

1. Previewing an Appcues flow does not generate analytic events, so you will not see those in the debugger or analytics observer.
2. You must have an active appcues session (started with Appcues.identify(...)) for any events to be generated. The debugger will show an ❌ next to "User Identified" if this is the case.

[arnold-drita-abm]

@mmaatttt
Okay, that's very helpful. I tested the same code on both platforms, and on Android, everything works as expected. On iOS, the callback is never called. I ran the debugger on iOS, and the events are shown in the debugger, but the event listener callback is not called. Seems like an iOS-only issue? Anything I can do on my end to help investigate?

[mmaatttt]

I've tested Expo 53 (RN 0.79) on iOS and it works ok for me.

If you can do a bit of investigating to see where the disconnect is, that would be helpful! If you can run your app from Xcode (expo prebuild and then open ios/*.xcworkspace and run the app) with a couple breakpoints, that will hopefully tell us what's not right:

L135 here passes the event into the RN event emitter. If that line isn't being called, add a breakpoint on L208 here to see if the internal Appcues SDK delegate is working as expected.