Appcues
Step-by-step guide to send your event data from RudderStack to Appcues
Last updated
Was this helpful?
Step-by-step guide to send your event data from RudderStack to Appcues
Last updated
Was this helpful?
Appcues is a popular product marketing platform that makes it easy for you to deliver scalable user experiences and accelerate your business growth. With Appcues' cutting-edge growth platform, you can effectively monitor your customers' product behavior, and design personalized customer experiences and in no time.
RudderStack supports sending your event data to Appcues from our native web SDKs, to help you understand your customers better.
Find the open-source transformer code for this destination in our GitHub repo.
Before configuring your source and destination on the RudderStack, please check whether the platform you are sending the events from is supported by Appcues. Please refer the following table to do so:
Connection Mode
Web
Mobile
Server
Device mode
Supported
-
-
Cloud mode
Supported
Supported
Supported
If you would like to use the entire functionality of Appcues like displaying flows, checklists, and surveys, please use Appcues device mode and not cloud mode.
To know more about the difference between Cloud mode and Device mode in RudderStack, read the RudderStack connection modes guide.
Once you have confirmed that the platform supports sending events to Appcues, perform the steps below:
From your RudderStack dashboard, add the source and select Appcues from the list of destinations.
Name your destination, and click on Next. You should be able to see the following screen:
Connection settings for Appcues destination
Enter the relevant details and click on Next to complete the setup. To get the API Key & Account ID field, please login to Appcues and navigate to Settings - Account. Here, copy the values of both your API key and the Account ID.
You need to make an identify call before making any call to Appcues.
The identify call is used to uniquely identify a user in Appcues. For more information on the identify call, please refer to the RudderStack API Specification documentation.
A sample identify call looks like the following snippet:
The above call is directly passed on to Appcues via its Appcues.identify(userId,[properties]) call.
A track call lets you track custom events as they occur in your web application. For more information on the track call, please refer to the RudderStack API Specification documentation.
A sample track call looks like the following:
The above call is directly passed on to Appcues via its Appcues.track(eventName, [eventProperties]) call.
A page call contains information such as the URL or the name of the web page visited by the user. For more information on the page call, please refer to the RudderStack API Specification documentation.
A sample page call looks like the following:
In device mode, the page call is directly passed on to Appcues via its Appcues.page() call, along with any additional properties passed to it. Appcues will check to see if a user qualifies for an experience every time the page changes. When you first make the page call via RudderStack’s rudderanalytics object, Appcues checks if there are any current flows associated with the given user and loads them, if necessary.
In the cloud mode, the above page call is sent as a track event with the name as Visited a Page, along with any additional properties passed to it. It also updates the properties associated with the user profile such as User ID, Last Browser Language, Updated At, User Agent, Current Page URL, Current Page Title .
The screen call is available only in the RudderStack Cloud mode.
The screen method allows you to record whenever a user sees the mobile screen, along with any associated optional properties.
A sample screen call looks like the following code snippet:
In the above snippet, we capture information related to the screen being viewed, such as screen's name and category.
The above call is sent as a track event with the name Viewed a Screen, along with any additional properties passed to it.
You can find the Appcues Account Id on the Appcues Settings Page.
If you come across any issues while configuring Appcues with RudderStack, please feel free to contact us. You can also start a conversation in our Slack community; we will be happy to talk to you!
