You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[UserGuiding](https://userguiding.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank”} is a product adoption platform that helps product teams automate in-app experiences that turn new users into champions..
8
+
[UserGuiding](https://userguiding.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank”} is a product adoption platform that helps product teams automate in-app experiences that turn new users into champions.
6
9
7
-
This is an [Event Cloud Source](/docs/sources/#event-cloud-sources) which can not only export data into your Segment warehouse, but can also federate the exported data into your other enabled Segment Destinations.
8
10
9
11
This source is maintained by UserGuiding. For any issues with the source, [contact their Support team](mailto:[email protected]).
10
12
@@ -14,77 +16,79 @@ This source is maintained by UserGuiding. For any issues with the source, [conta
14
16
2. Search for "UserGuiding" in the Sources Catalog, select UserGuiding, and click **Add Source**.
15
17
3. On the next screen, give the Source a name configure any other settings.
16
18
17
-
- The name is used as a label in the Segment app, and Segment creates a related schema name in your warehouse. The name can be anything, but we recommend using something that reflects the source itself and distinguishes amongst your environments (eg. SourceName_Prod, SourceName_Staging, SourceName_Dev).
19
+
- The name is used as a label in the Segment app, and Segment creates a related schema name in your warehouse. The name can be anything, but we recommend using something that reflects the source itself and distinguishes amongst your environments (eg. UserGuiding_Prod, UserGuiding_Staging, UserGuiding_Dev).
18
20
19
21
4. Click **Add Source** to save your settings.
20
22
5. Copy the Write key from the Segment UI.
21
-
6. Log in to your UserGuiding account - navigate to Settings > Integrations > Segment Integration and paste the key in the API Key textbox in the *Userguiding as a source* section to connect.
23
+
6. Log in to your UserGuiding account - navigate to Settings > Integrations > Segment Integration and paste the key in the API Key textbox in the *UserGuiding as a source* section to connect.
22
24
23
25
## Stream
24
26
25
-
UserGuiding uses our stream Source component to send Segment event data. It uses a server-side `track` method to send data to Segment. These events are then available in any destination that accepts server-side events, and available in a schema in your data warehouse, so you can query using SQL.
27
+
UserGuiding uses a stream Source component to send Segment event data. It uses a server-side `track` method to send data to Segment. These events are then available in any destination that accepts server-side events, and available as a schema in your data warehouse so you can query using SQL.
26
28
27
29
UserGuiding sends user identifiers in the `user_id` attribute in the event payload. This is the same identifier that is used in the `identify` call to UserGuiding.
28
30
29
31
## Events
30
32
31
33
The table below lists events that UserGuiding sends to Segment. These events appear as tables in your warehouse, and as regular events in other Destinations. UserGuiding includes the `userId` if available.
| Guide started (userguiding)| It means that a user previews the first step of a Guide|
36
-
| Guide completed (userguiding)| It means that the user has completed all steps of a Guide |
37
-
| Hotspot interacted (userguiding)| It means that the user interacted with a Hotspot group and saw a Hotspot as content. (remember, Hotspot groups can have multiple Hotspots as contents) |
38
-
| Checklist item trigger (userguiding | It means that the user triggers a Checklist Guide |
39
-
| Checklist item url click (userguiding)| It means that the user clicks a URL item on a Checklist |
40
-
| Checklist completed (userguiding) | It means that the user completed a Checklist |
41
-
| Resource center guide trigger (userguiding) | It means that the user triggered a Resource Center Guide |
42
-
| Resource center checklist guide trigger (userguiding) | It means that a Guide in a Checklist put in a Resource Center as a module is triggered by a user |
43
-
| Resource center checklist item url click (userguiding) | It means that a URL item in a Checklist put in a Resource Center as a module is clicked by a user |
44
-
| Resource center external URL click (userguiding) | It means that a user clicks an external URL in a Resource Center |
45
-
| Resource center article link click (userguiding) | It means that a user clicks a search article in a Resource Center |
46
-
| Resource center survey trigger (userguiding) | It means that a user has triggered a survey in a Resource Center |
47
-
| Survey shown (userguiding) | It means a survey was shown to a user |
48
-
| Survey question answer (userguiding) | It means a survey question was answered by a user |
| Guide Started | It means that a user previews the first step of a Guide |
38
+
| Guide Completed | It means that the user has completed all steps of a Guide |
39
+
| Hotspot Interacted | It means that the user interacted with a Hotspot group and saw a Hotspot as content. (remember, Hotspot groups can have multiple Hotspots as contents) |
40
+
| Checklist Item Trigger | It means that the user triggers a Checklist Guide |
41
+
| Checklist Item Url Click | It means that the user clicks a URL item on a Checklist |
42
+
| Checklist Completed | It means that the user completed a Checklist |
43
+
| Resource Center Guide Trigger | It means that the user triggered a Resource Center Guide |
44
+
| Resource Center Checklist Guide Trigger | It means that a Guide in a Checklist put in a Resource Center as a module is triggered by a user |
45
+
| Resource Center Checklist Item Url Click | It means that a URL item in a Checklist put in a Resource Center as a module is clicked by a user |
46
+
| Resource Center External URL Click | It means that a user clicks an external URL in a Resource Center |
47
+
| Resource Center Article Link Click | It means that a user clicks a search article in a Resource Center |
48
+
| Resource Center Survey Trigger | It means that a user has triggered a survey in a Resource Center |
49
+
| Survey Shown | It means a survey was shown to a user |
50
+
| Survey Question Answer | It means a survey question was answered by a user |
49
51
50
52
51
53
## Event Properties
52
54
53
55
The table below list the properties included in the events listed above.
|`hotspotGroupName`| Subject line of the email | str |
63
-
|`hotspotId`| Subject line of the email | int |
64
-
|`hotspotTitle`| Subject line of the email | str |
65
-
|`checklistName`| URL of the link clicked | str |
66
-
|`checklistId`| URL of the link clicked | int |
67
-
|`checklistItemUrl`| URL of the link clicked | str |
68
-
|`resourceCenterName`| URL of the link clicked | str |
69
-
|`resourceCenterID`| URL of the link clicked | int |
70
-
|`resourceCenterId`| URL of the link clicked | int |
71
-
|`externalUrl`| URL of the link clicked | str |
72
-
|`articleLink`| URL of the link clicked | str |
73
-
|`surveyId`| URL of the link clicked | int |
74
-
|`surveyName`| URL of the link clicked | str |
75
-
|`questionId`| URL of the link clicked | str |
76
-
|`questionName`| URL of the link clicked | str |
77
-
|`score`| URL of the link clicked | int |
78
-
|`surveyQuestion`| URL of the link clicked | str |
79
-
|`emojiScore`| URL of the link clicked | str |
80
-
|`choices`| URL of the link clicked | str |
81
-
|`feedback`| URL of the link clicked | str |
82
-
57
+
| Property Name | Description |
58
+
| --------------- | ------------------------- |
59
+
|`user_id`| User identifier | str |
60
+
|`guide_id`| ID of the guide | int |
61
+
|`guide_name`| Name of the guide | str |
62
+
|`page_url`| URL of the page the material was interacted at | str |
63
+
|`hotspot_group_id`| Group ID of the hotspot | int |
64
+
|`hotspot_group_name`| Group name of the hotspot | str |
65
+
|`hotspot_id`| ID of the hotspot | int |
66
+
|`hotspot_title`| Title of the hotspot| str |
67
+
|`checklist_name`| Name of the checklist | str |
68
+
|`checklist_id`| ID of the checklist | int |
69
+
|`checklist_item_url`| Item URL of the checklist | str |
70
+
|`resource_center_name`| Name of the resource center| str |
71
+
|`resource_center_id`| ID of the resource center | int |
72
+
|`external_url`| External URL of resource center url click event | str |
73
+
|`article_link`| Link to the article in resource center where click event happened | str |
74
+
|`survey_id`| ID of the survey | int |
75
+
|`survey_name`| Name of the survey | str |
76
+
|`question_id`| ID of the question in a survey | str |
77
+
|`question_name`| Name of the question | str |
78
+
|`score`| Score in a survey question answer | int |
79
+
|`survey_question`| Question text of a survey | str |
80
+
|`emoji_score`| Emoji score in a survey question answer | str |
81
+
|`choices`| Choices in a survey question | str |
82
+
|`feedback`| Feedback left in survey question answer | str |
83
83
84
84
## Adding Destinations
85
85
86
-
Now that your Source is set up, you can connect it with Destinations.
86
+
Now that your Source is set up, you can connect it to Destinations.
87
87
88
88
Log into your downstream tools and check to see that your events appear as expected, and that they contain all of the properties you expect. If your events and properties don’t appear, check the [Event Delivery](/docs/connections/event-delivery/) tool, and refer to the Destination docs for each tool for troubleshooting.
89
89
90
90
If there are any issues with how the events are arriving to Segment, [contact the UserGuiding support team](mailto:[email protected]).
91
+
92
+
## Regional Data
93
+
94
+
If you want to use the [Regional Segment](https://segment.com/docs/guides/regional-segment/) feature to store your data in EU regional data centers. Use the radio button in the Userguiding as a Source section in Integrations Page to select the Data Residency.
0 commit comments