Discover Appcues
Appcues develops an on-boarding and user experience optimization solution dedicated to product teams. Better user experiences lead to faster and more profitable growth, that’s why Appcues develops a product-led growth platform. Appcues makes it easy to deliver exceptional user experiences at scale and unify your organization around the product as its greatest lever for growth.
- onboard and engage new users
- drive adoption of new and advanced features
- collect contextual feedback and user-declared data
- deliver targeted in-product campaigns
- provide scalable, self-service support
Find out more here: https://www.appcues.com/
AT Connect Appcues
The AT Connect Appcues allows you to measure the performance of your various onboarding campaigns, customer satisfaction and NPS surveys. Follow a centralized view of users interactions with your Apccues flows and identify the main points of improvement for your UX product strategy. Go beyond the simple product scope by analyzing data throughout the overall user journey.
- Centralize the performance of your Appcues flows, onboardings, surveys, NPS flows (flows, steps, interactions, and errors).
- Go beyond the simple product scope by analysing Appcues interactions in a global context (product, website, mobile application, etc.).
- Segment your users to apply differentiated strategies based on different levels of engagement or activity.
- Optimize your product's UX devices and user journey based on the performance analysed.
- Export the most relevant KPIs to your dashboarding tools and share this data with your product teams.
Concept and requirements
The AT Connect Appcues allows you to track the performance of your user onboarding campaigns. Thanks to this connector, you can measure the use of your product, the success of the various experiences offered and the adoption of users over time.
This connector allows you to display the Appcues events and properties related to your different onboarding flows.
In particular, you will be able to follow these elements:
- Flow ID: The flow ID.
- Flow Name: The title of the flow.
- Flow Type: The type of flow (journey, etc.).
- Flow Version: The version of the flow.
- Event Session ID: Identifier of a particular session of a user, which corresponds to a particular initialization of the Appcues script.
- Event Name: Status of the flow (flow started, flow skipped, completed, step started, aborted, etc.).
- Event Step ID: The ID of the step.
- Event Step Type: The type of step (hotspot-group, modal, etc.).
- Event Interaction Type: Nature of user interaction with the step (click, hover, submit, etc.).
- Event Error: A text detailing the reason of an error.
-…
Prerequisites to implement the AT Connect Appcues:
- Have an Appcues account.
- Have an Piano Analytics account.
- Activate the Events plugin in Tag Composer.
Activation of the events plugin in Tag Composer
First you need to check that you have activated the Events plugin in Tag composer on the Piano Analytics side. Indeed this plugin is prerequisite for the proper functioning of this connector.
You must therefore go to Piano Analytics (Explorer> Configuration> Data Collection Portal> Tagging> Tag Composer), select the tag deployed on your site and verify the correct activation of the Events plugin (see screenshots below).
Flow installation and creation in Appcues
Your new Appcues Flows, like your existing Flows, will be tracked by the connector. You can install Appcues on your platform and deploy your Flows as you usually do. The creation of Flows is done in a few clicks from the Appcues interface.
Appcues allows you to easily deploy different on-boarding scenarios to your product interface. Here is an example of Appcues onboarding in the Piano Analytics interface.
More information about Appcues installation via this link: Appcues installation documentation.
Connector activation
You must then deploy the script below on your product pages (in the body) to set up the connector between Piano Analytics and Appcues. This script allows you to track the events and Appcues properties related to your different on-boarding flows.
<script type="text/javascript">
var tag = new ATInternet.Tracker.Tag();
tag.page.set({
name: 'hitdepage' //You can customize this part
});
tag.dispatch();
Appcues.on("all", function(eventName, event) {
tag.events.send('appcues.launch', {
'appcues_flow_id': event.flowId,
'appcues_flow_name': event.flowName,
'appcues_flow_type': event.flowType,
'appcues_flow_version': event.flowVersion,
'appcues_sessionid': event.sessionId,
'appcues_id': event.id,
'appcues_name': event.name,
'appcues_step_id': event.stepId,
'appcues_step_type': event.stepType,
'appcues_step_childnumber': event.stepChildNumber,
'appcues_interaction_type': event.interactionType
});
});
Appcues.on("step_child_error", function(event) {
tag.events.send('appcues.launch', {
'appcues_flow_id': event.flowId,
'appcues_flow_name': event.flowName,
'appcues_flow_type': event.flowType,
'appcues_flow_version': event.flowVersion,
'appcues_sessionid': event.sessionId,
'appcues_id': event.id,
'appcues_name': event.name,
'appcues_step_id': event.stepId,
'appcues_step_type': event.stepType,
'appcues_step_childnumber': event.stepChildNumber,
'appcues_interaction_type': event.interactionType,
'appcues_error': event.error,
'appcues_details': event.details
});
});
</script>
You have to declare the appcues.launch custom event and the various associated custom properties in your Data Management > Data Model interface allowing this data to be correctly displayed (Data Management documentation).
The tables below summarize the elements to declare, you can of course customize the name of this event / the associated properties (be careful to adapt the code accordingly).
Event to create:
Name | Scope |
appcues.launch | On site |
Properties to create:
Name | Type | Description |
appcues_flow_id | string | The ID of the Appcues flow object |
appcues_flow_name | string | Human-readable title of this Appcues flow |
appcues_flow_type | string | Type of Appcues Flow |
appcues_flow_version | integer | Indicates a particular version of a flow |
appcues_sessionid | integer | Identifier for a particular session of a user, which corresponds to a particular initialization of the Appcues script |
appcues_id | string | Snake case identifier for the event type |
appcues_name | string | Human-formatted name of the event type |
appcues_step_id | string | The ID of the step-group object |
appcues_step_type | string | The type of pattern of this step-group (hotspot-group, modal, etc) |
appcues_step_childnumbrer | integer | The index (zero-based) of the step child in which the user performed an interaction |
appcues_interaction_type | string | How the user interacted with the step-group (click, hover, submit, etc) |
appcues_error | string | A text summary of the error |
appcues_details | string | A more detailed explanation of the error, usually referencing step child errors that raised this step-level error |
Below is a screenshot of these Appcues custom properties in the Data Management interface.
Appcues analysis in Piano Analytics
Once AT Connect Appcues is activated you can measure the performance of your different on-boarding flows in Piano Analytics. This way you can easily measure Appcues usage and product adoption over time.
For example, you can access the performance of your flows (events and associated properties) in the Events analysis of Explorer (Content>Events). You can customize the display, save views for reuse, or create audience segmentation from Appcues data.
You can also filter on the values of these properties in your different analysis. Here is an example of error analysis from the Appcues on-boarding. You can thus identify these errors, quantify them and implement corrective actions.
Finally you can integrate these elements in your Data Query datasets. Below is a dataset containing the Appcues event and the associated properties. You can export these data via CSV files or API URL for example.
Other resources
Here is a list of additional resources that can help you understand and deploy this connector.
- Events developer documentation: Technical information about custom event tagging - https://developers.atinternet-solutions.com/events-en/custom-event-tagging-sdk-en/
- Properties developer documentation: Technical information about marking custom properties - https://developers.atinternet-solutions.com/events-en/tagging-custom-properties-sdk-en/
- Appcues events developer documentation: Technical information about Appcues events tracking - https://docs.appcues.com/article/301-client-side-events-reference
- Appcues JS callbacks developer documentation: Technical information about Appcues JS callbacks - https://docs.appcues.com/article/161-javascript-api
Privacy
Activating this partnership activates the import of Appcues data into Piano Analytics tools. Only the data necessary for the proper functioning of the bridge are imported.