|
| 1 | +--- |
| 2 | +title: WorkRamp Source |
| 3 | +beta: true |
| 4 | +id: 7GmYZcBQyw |
| 5 | +--- |
| 6 | +{% include content/source-region-unsupported.md %} |
| 7 | + |
| 8 | +[WorkRamp](https://www.workramp.com/products/external-learning/customer-academy/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners) is the All-in-One Platform that powers learning as a growth engine for the modern enterprise. |
| 9 | + |
| 10 | +This is an [Event Cloud Source](https://segment.com/docs/sources/#event-cloud-sources) which can not only export data into your Segment warehouse, but also federate data into other enabled Segment Destinations. |
| 11 | + |
| 12 | +This source is maintained by WorkRamp. For any issues with the source, [contact the WorkRamp support team](mailto:support@workramp.com). |
| 13 | + |
| 14 | +> info "The WorkRamp source is in Beta" |
| 15 | +> WorkRamp are actively developing the source. This doc was last updated on June 2, 2022. If you are interested in joining their beta program or have any feedback to help improve the WorkRamp Source and its documentation, contact [support@workramp.com](mailto:support@workramp.com) |
| 16 | +
|
| 17 | + |
| 18 | + |
| 19 | +## Getting started |
| 20 | + |
| 21 | +1. From your workspace's [Sources catalog page](https://app.segment.com/goto-my-workspace/sources/catalog) click **Add Source**. |
| 22 | +2. Search for "WorkRamp" in the Sources Catalog, select WorkRamp, and click **Add Source**. |
| 23 | +3. On the next screen, give the Source a nickname configure any other settings. |
| 24 | + * The nickname is used as a label in the Segment app, and Segment creates a related schema name in your warehouse. The nickname can be anything, but Segment recommends something that reflects the source itself and distinguishes amongst your academies or environments (for example, `WorkRamp_CustomerAcademy`, `WorkRamp_PartnerAcademy`, `WorkRamp_staging`). |
| 25 | +5. Click **Add Source** to save your settings. |
| 26 | +6. Copy the Write key from Segment, in your Source's Settings > API Key. |
| 27 | +7. Log in to your WorkRamp account - navigate to Academies > Your Academy > Integrations (for example, `https://app.workramp.com/admin/academies/[academy_id]/integrations`), toggle on the Segment integration, then paste your Segment Write Key in the "Write Key" field to connect. |
| 28 | + |
| 29 | + |
| 30 | +## Events |
| 31 | + |
| 32 | +The table below lists events tracking user interaction in WorkRamp Academy. WorkRamp sends these events to Segment, which appear as tables in your warehouse, and as regular events in other Destinations. |
| 33 | + |
| 34 | +| Event Name | Description | |
| 35 | +| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |
| 36 | +| Registers | The user registers for academy. All custom registration fields appear under user unless they are marked as “hidden” or a password. | |
| 37 | +| Signed In | The user logs into academy. | |
| 38 | +| Signed Out | The user clicks **Logout** from the User menu. | |
| 39 | +| Search | The user types a query into the Search bar. | |
| 40 | +| Search Result Clicked | The user clicks on a search result from the Search bar. | |
| 41 | +| Starts Training | The user clicks **Get Started** from `/training/:training_id/overview/`. | |
| 42 | +| Enters Path Training | The user clicks **Get Started** or **Continue** from `/paths/:path_id`. | |
| 43 | +| Enters Certification Training | The user clicks **Get Started** or **Continue** from `/certifications/:certification_id`. | |
| 44 | +| Resumes Training | The user clicks **Continue** from `/training/:training_id/overview`. | |
| 45 | +| Reviews Training | The user clicks on search result from the Search bar. | |
| 46 | +| Checkout Initiated | The user clicks **Purchase Guide: [Price]** from `/training/:training_id/overview/`. | |
| 47 | +| Task Viewed | The user visits `/guides/:guide_id/tasks/:task_id/`. | |
| 48 | +| Completes Training | The user clicks **Finish** in a Course. Similar to **Exits Course**, this event populates the fields of `certificationId/pathId` depending on the content type. | |
| 49 | +| Completes Path | The user clicks **Finish** within a Course. Similar to **Exits Course**, this event populates the fields of `certificationId/pathId` depending on the content type. | |
| 50 | +| Completes Certification | The user clicks **Finish** within a Certification Course. Similar to **Exits Course**, this event populates the fields of `certificationId/pathId` depending on the content type. | |
| 51 | +| Copies Public Link to Certification | The user clicks **Copy Public Link** on `/certifications/:certification_id`. | |
| 52 | +| Clicks “Adds Certification to LinkedIn” | The user clicks **Add to LinkedIn** on `/certifications/:certification_id/`. | |
| 53 | +| Downloads Certification | The user clicks **Download** on `/certifications/:certification_id/`. | |
| 54 | +| Exits Course | The user clicks the back arrow within a Training. If the course is part of path or certification, the associated fields will populate. | |
| 55 | +| Views Content | The user clicks **Show Content**. | |
| 56 | +| Hides Content | The user clicks **Hide Content**. | |
| 57 | +| Views Event | The user visits `/events/:event_id`. | |
| 58 | +| Clicks Session URL | The user clicks **Register Now** (the session URL) from the events page. | |
| 59 | + |
| 60 | + |
| 61 | + |
| 62 | + |
| 63 | + |
| 64 | +## Event properties |
| 65 | + |
| 66 | +The table below list the properties included in the events listed above. |
| 67 | + |
| 68 | +| Property Name | Description | |
| 69 | +| -------------------------------------------------- | --------------------------------------------------------------------- | |
| 70 | +| `academyTitle` | Name of the Academy. | |
| 71 | +| `timeStamp` | Time captured for the event, for example, '2022-05-25T21:29:53.429Z'. | |
| 72 | +| `accessedDate` | Timestamp for when the content was started by user. | |
| 73 | +| `id` | The user’s ID. | |
| 74 | +| `email_subject` | Subject line of the email. | |
| 75 | +| `email` | The user’s Email Address. | |
| 76 | +| `name` | The user’s Name. | |
| 77 | +| Custom registration fields `department`, `title`) | URL of the link clicked. | |
| 78 | +| `searchTerm` | Query entered in search bar. | |
| 79 | +| `contentId` | ID for the content (for example, guide ID). | |
| 80 | +| `contentTitle` | Name of the content (for example, guide name). | |
| 81 | +| `contentType` | Type of content (for example, guide). | |
| 82 | +| `certificationId` | ID for the Certification. | |
| 83 | +| `certificationShortId` | Public facing awarded certification URL. | |
| 84 | +| `pathId` | ID for the Path. | |
| 85 | +| `taskId` | ID for the Task. | |
| 86 | +| `assignmentScore` | Score user received on content. | |
| 87 | + |
| 88 | +## Adding destinations |
| 89 | + |
| 90 | +Once the source is configured, you can connect it to Destinations. |
| 91 | + |
| 92 | +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. |
| 93 | + |
| 94 | +If there are any issues with how the events are arriving to Segment, [contact the WorkRamp support team](mailto:support@workramp.com). |
0 commit comments