Skip to main content
Gainsight Inc.

Install and Configure Adobe Launch Extension

This article explains how to install and configure the Gainsight PX Adobe Launch extension. 

Overview

Use the Gainsight PX Launch extension to install the Gainsight PX tag for your application. To install the Gainsight PX Launch extension, click here

Key Terms

  • Adobe Launch: Adobe Launch is an Adobe Platform where you can create extensions. You can consider Adobe Launch to be an OS.
  • Extensions: Extensions are the integrations created by Adobe or Adobe partners to add more functionalities to your application. If Adobe Launch is considered to be an OS, Extensions are the apps that can be installed.
  • Property: A Property is a placeholder in Adobe launch. You can store your Extensions and other key elements in a Property. 
  • Gainsight PX Launch: Gainsight PX Launch is a Gainsight extension in the Adobe Launch platform. 
  • Adobe Rules: An Adobe rule is used to perform various tasks automatically. Adobe Rules have three elements; Events, Conditions, and Actions. The rule works with the logic  “when an Event(s) is recorded with the set Condition(s), perform the Action(s)”.   

Prerequisite

Configure a Property for your application in the Adobe launch Platform, before you install and configure Gainsight PX Launch. For more information about properties, refer to the Companies and properties article from the Additional Resources section. 

Add Gainsight PX Launch Extension to Property

A property in Adobe is a placeholder to store your extensions, rules, and data elements. After you create a property for your application, add the Gainsight PX Launch extension to your property. For more information about adding extensions to properties, refer to the Extensions from the Additional Resources section.

To add the PX Extension to your property;

  1. Log in to your Adobe Launch account. 
  2. Click the Extensions tab.

pasted image 0.png

  1. Search for the Gainsight PX extension and click Install.

2..png

Configure PX Extension with Product Key

After you add the Gainsight PX Extension to your property, configure the extension with the Product key of your PX instance. 

To configure PX Extension with Product key:

  1. Log in to Gainsight PX.
  2. Navigate to Administration > Products and copy your product key.  

admin_product_tag.png

  1. Switch to Adobe Launch Gainsight PX extension. 
  2. Paste the Product key in the Gainsight PX Product Key field. 
  3. Click Advanced to expand the menu. 
  4. Configure the following options: 
  • Independent iframe: Check this box only if PX is installed in an iframe that does not have PX installed in the parent document. This is not the usual case, typically PX is installed in both parent window and child iframe. For more information about this scenario, refer to the Application is running as a tenant iframe under a different application section of Install Gainsight PX in iframes article from the Additional Resources section.
  • Identify from iframes: if you want to support calling the identify call from an iframe instead of the parent document. In this case Gainsight PX is also installed in the parent document but you still want the iframe to make the identify call.
  • CSS Nonce: Enter the nonce value in this field. For more information on this, refer to Using PX with Content Security Policy (CSP) article.
  • Enable PX Environments: Check this box to send PX events to a different PX environment based on the Launch environment. If you select this option, the events are sent to the environments according to the mapping defined in the table. If you do not select this option, all events are stored in the production PX environment. For more information on PX environments, refer to the Gainsight PX Environment Settings article from the Additional Resources section. A typical environment setup is given in the following screenshot.
    Note: If you have customized any of your environment names, identify the default names before performing the mapping.
  1. Click Save

image-20201118-195104.png

Create Rules

After you install the Gainsight PX extension, create rules to load Gainsight PX and identify users and accounts. This section explains the process to create rules to:

Create Load Rule 

This sub-section explains how to create a rule that loads PX into your application. 

To create a data load rule: 

  1. Log in to your Adobe Launch account. 
  2. Click the Rules tab.
  3. Click Create New Rule. The Create Rule window is displayed. 

5..png

  1. Enter a name for the rule in the Name field.
  2. Click Add under the Events section. The Event Configuration window is displayed.

6..png

  1. Select Core from the Extension drop-down menu.
  2. Select Library Loaded (Page Top) from the Event Type drop-down menu.
  3. Click Keep Changes.

7..png

  1. Click Add under the Actions section. The Action Configuration window is displayed.
  2. Select Gainsight PX from the Extension drop-down menu.
  3. Select Load from the Action Type drop-down menu. 
  4. Click Keep Changes.

8..png

A new rule is created. 

9..png

  1. Click Save.

Gainsight PX supports the ability to send custom events via API. Trigger an API call to create a custom event using the name for the custom event as well as properties/values for that event. For more information on this refer to the Use Custom Event API article.

Alternatively, you can create custom events by navigating to the Administration > Events page.

This sub-section explains how to create a rule that triggers a custom event in Gainsight PX based on an action in your application.

To create a rule to trigger a Gainsight PX Custom Event:

  1. Click the Rules tab.
  2. Click Add Rule
  3. From the Extension dropdown select Gainsight PX, from the Action Type dropdown select Add Custom Event. 
  4. In the Add Custom Event screen, enter the Event Name and Event Attributes. Click Keep Changes. The rule is now created.

image-20201118-195137.png

Set Global Context

Gainsight PX Web SDK supports the ability to set a Global Context (super properties) for all user interactions captured by the Gainsight PX tracking tag.  Setting the context automatically attaches/assigns those properties/values to all auto-tracked events. For more information on this, read the Use Global Context API article.

This sub-section explains how to create a rule that sets a Global Context in Gainsight PX based on an action in your application.

To create the rule:

  1. Click the Rules tab.
  2. Click Add Rule.
  3. From the Extension dropdown select Gainsight PX, from the Action Type dropdown select Set Global Context. 
  4. In the Set Global Context screen, enter Global Context properties. Click Keep Changes. The rule is now created.

image-20201118-195322.png

Configure Event Listener

Gainsight PX's Javascript Event Listener allows you to easily send Engagement Analytics data to other applications. For more information on this refer to the Javascript Event Listener API article.

This sub-section explains how to create a rule that triggers an action in your application based on Gainsight PX events.

To create the rule:

  1. Click the Rules tab.
  2. Click Add Rule.
  3. From the Extension dropdown select Gainsight PX, from the Event Type dropdown select the event you need to trigger in Gainsight PX.
  4. Configure the required action in your application.

image-20201118-195233 (1).png

Create Identify Rule

This sub-section explains how to create a rule that maps User and Account attribute data from your application to Gainsight PX. 

To create the rule: 

  1. Click the Rules tab and click Add Rule.

10..png

  1. Enter a name for the rule in the Name field.
  2. Click Add under the Events section. The Event Configuration window is displayed.

11..png

  1. Configure an event that triggers when your application has access to the user identity information. In some cases (like page refresh) your users are unlikely to proceed through your application’s login screen, so this event should not depend on that. 
    The following image is an example and may vary for your application. Contact your development team for the values.
  2. Click Keep Changes.

event - config.png

  1. Click Add under the Actions section. The Action Configuration window is displayed.
  2. Select Gainsight PX in the Extension field.
  3. Select Identify user in the Action Type field. 
  4. Click Keep Changes.

13..png

  1. Click the Data element chooser icon next to the User ID field.

14..png

  1. Select data elements that identify a user. This data is sent to PX from your application and helps PX identify your users. 

15..png

For more information about Data elements, refer to the Data elements article from the Additional Resources section.

  1. (Optional) Click Add attribute, if you have multiple data elements which pass unique user identifier data to Gainsight PX. 
  2. Add the name of the Gainsight PX attribute in the PX Attribute Name field, for each unique identifier configured.

16..png

Navigate to Administration > Attributes on Gainsight PX to view the Account and User identifiers. 

attributes.png

  1. (Optional) Configure a unique identifier for Account as well.
  2. Click Keep Changes.
  3. Click Save.

18..png

After you complete these configurations, publish them in Adobe Launch. Use the publishing workflow to publish and promote the changes to production, after you complete testing. For more information about Adobe launch approval workflow, refer to the Approval Workflow article from the Additional Resources section.

  • Was this article helpful?