Appcues

Appcues is a popular product marketing platform that helps you deliver scalable user experiences and accelerate business growth.

RudderStack supports Appcues as a destination to which you can send your event data.

Find the open source transformer code for this destination in the GitHub repository.

Connection compatibility

Destination info
Status: Generally Available Supported sources: Android, iOS , Web, Unity, AMP , Cloud, Warehouse, React Native , Flutter, Cordova, Shopify Refer to it as APPCUES in the Integrations object.

Connection modes
Source	Cloud mode	Device mode	Hybrid mode
AMP
Android
Cloud
Cordova
Flutter
iOS
React Native
Shopify
Unity
Warehouse
Web

Supported message types
Source	Identify	Page	Track	Screen	Group	Alias
Cloud mode
Supported sources
Device mode
Web

In the web device mode integration, that is, using JavaScript SDK as a source, RudderStack loads the Appcues native SDK from the https://fast.appcues.com/ domain.

Based on your website’s content security policy, you might need to allowlist this domain to load the Appcues SDK successfully.

Get started

Once you have confirmed that the platform supports sending events to Appcues, follow these steps:

1. From your RudderStack dashboard, add the source. Then, from the list of destinations, select Appcues.
2. Assign a name to the destination and click Continue.

Connection settings

To successfully set up Appcues as a destination, you will need to configure the following settings:

• Account ID: Enter your Appcues account ID. To get the ID, log in to your Appcues account and navigate to Settings > Account.
• Client-side Events Filtering: This setting lets you specify which events should be blocked or allowed to flow through to Appcues. See Client-side Events Filtering for more information.
• Consent management provider: Configure the consent management settings for the specified source by choosing the consent management provider from the dropdown. If you choose Custom, make sure to pass the custom consent data to SDK.

Web SDK settings

• Appcues JavaScript Native SDK URL: Enter the URL for hosting the native Appcues JavaScript SDK. If not specified, RudderStack sets it to https://fast.appcues.com/${<your_account_id>}.js by default.
• Use device mode to send events: Turn on this setting to enable sending events to Appcues in device mode.

Identify

You can use the identify call to uniquely identify a user in Appcues.

Note that:

• You must make an identify call before making any other call to Appcues.
• RudderStack flattens any objects/array properties in the identify call before sending it to Appcues by leveraging their Appcues.identify(userId,[properties]) call.

A sample identify call looks like the following snippet:

rudderanalytics.identify("userId", {
  name: "John Doe",
  title: "CEO",
  email: "name.surname@domain.com",
  company: "Company123",
  country: "US",
  state: "TX",
})

Track

Use the track call to track custom events as they occur in your application.

A sample track call looks like the following:

rudderanalytics.track("Clicked button", {
  color: "red",
  buttonText: "Get started",
})

RudderStack sends the track call information to Appcues using its Appcues.track(eventName, [eventProperties]) call.

Page

A page call contains information such as the URL or the name of the web page visited by the user.

A sample page call looks like the following:

rudderanalytics.page("homepage")

Note that:

• In device mode, RudderStack passes the page call information to Appcues using its Appcues.page() call along with any additional properties passed to it. Appcues checks to see if a user qualifies for an experience every time the page changes. When you first make the page call, Appcues checks if there are any current flows associated with the given user and loads them, if necessary.
• In cloud mode, RudderStack sends the above page call as a track event with the name as Visited a Page along with any associated properties. It also updates the properties associated with the user profile like user ID, user agent, current page URL, browser langugage, current page title, etc.

Screen

The screen call is available only in the 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:

[[RSClient sharedInstance] screen:@"Main" properties:@{@"prop_key" : @"prop_value"}];

In the above snippet, RudderStack captures screen-related like the screen name and category.

RudderStack sends the above call is sent as a track event with the name Viewed a Screen, along with any additional properties passed to it.

Group

The group call lets you link an identified user with a group like a company, organization, or an account. You can also record any custom traits associated with that group like the company name, number of employees, etc.

A sample group call sent to Appcues is shown:

rudderanalytics.group("5ea6247", {
  name: "Company Inc.",
  industry: "Technology",
  employees: 4500,
  plan: "basic"
})

FAQ

How do I get the Appcues Account ID?

You can find the Appcues Account ID in the Appcues Settings Page.

Questions? Contact us by email or on Slack