Skip to contentSkip to navigationSkip to topbar
On this page
Looking for more inspiration?Visit the
(information)
You're in the right place! Segment documentation is now part of Twilio Docs. The content you are used to is still here—just in a new home with a refreshed look.

UserGuiding Destination


Destination Info
  • Accepts Identify and Track calls.
  • Refer to it as UserGuiding in the Integrations object
  • This integration is partner owned. Please reach out to the partner's support for any issues.
  • This destination is in Beta

UserGuiding(link takes you to an external page) is a product adoption platform that helps product teams automate in-app experiences that turn new users into champions.

This destination is maintained by UserGuiding. For any issues with the source, contact the UserGuiding Support team.


Getting Started

getting-started page anchor
  1. From your workspace's Destination catalog page(link takes you to an external page) search for UserGuiding.
  2. Select UserGuiding, and click Add Destination.
  3. Choose the source you want to connect UserGuiding destination to.
  4. Give the destination a name.
  5. Enter the API key provided in the UserGuiding integrations page(link takes you to an external page).
  6. Select the data residency region for your UserGuiding account.

If you're not familiar with the Segment Spec, take a look to understand what the Identify method does. An example call would look like:

1
analytics.identify('user_id_123', {
2
email: 'john.doe@example.com',
3
firstname: 'john',
4
lastname: 'doe'
5
});

Using the Identify method triggers a call to UserGuiding's Identify(link takes you to an external page) method. For more information about user identification in UserGuiding, see UserGuiding's Sending user attributes and tracking user actions(link takes you to an external page) documentation.


If you're not familiar with the Segment Spec, take a look to understand what the Track method does. An example call would look like:

analytics.track('Visited Products Page')

Using the Track method triggers a call to UserGuiding's userGuiding.track method. For more information about tracking user action in UserGuiding, see UserGuiding's Sending user attributes and tracking user actions(link takes you to an external page) documentation.


You can send computed traits and audiences generated using Engage to this destination as a user property. To learn more about Engage, schedule a demo(link takes you to an external page).

For user-property destinations, an identify call is sent to the destination for each user being added and removed. The property name is the snake_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Engage sends an Identify call with the property order_completed_last_30days: true. When the user no longer satisfies this condition (for example, it's been more than 30 days since their last order), Engage sets that value to false.

When you first create an audience, Engage sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync.

(information)

Real-time to batch destination sync frequency

Real-time audience syncs to UserGuiding may take six or more hours for the initial sync to complete. Upon completion, a sync frequency of two to three hours is expected.


Segment lets you change these destination settings from the Segment app without having to touch any code.

Property nameTypeRequiredDescription
API Keystring
required

Your userguiding api key


Regionselect
required

Your UserGuiding region.