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
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/vero/index.md
+20-34Lines changed: 20 additions & 34 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
title: Vero Destination
3
3
id: 54521fdc25e721e32a72ef03
4
4
---
5
-
Our Vero destination code is all open-source on GitHub if you want to check it out: [JavaScript](https://github.com/segmentio/analytics.js-integrations/tree/master/integrations/vero), [Server](https://github.com/segmentio/integration-vero).
5
+
The Vero destination code is all open-source on GitHub if you want to check it out: [JavaScript](https://github.com/segmentio/analytics.js-integrations/tree/master/integrations/vero){:target="_blank"}, [Server](https://github.com/segmentio/integration-vero){:target="_blank"}.
6
6
7
7
## Getting Started
8
8
@@ -13,42 +13,40 @@ When you enable Vero in the Segment web app, your changes appear in the Segment
13
13
14
14
Vero is supported on the client-side, server-side and mobile.
15
15
16
-
- - -
17
-
18
16
19
17
## Identify
20
18
21
19
22
20
### Client Side
23
21
24
-
When you call [`identify`](/docs/connections/spec/identify/) on analytics.js, we augment`traits` to have `traits.id` set to the `userId`, and then call Vero's `user` with the augmented traits object. You should provide both a `traits.email` and a `userId` for Vero to work best.
22
+
When you call [Identify](/docs/connections/spec/identify/) on analytics.js, Segment augments`traits` to have `traits.id` set to the `userId`, and then call Vero's `user` with the augmented traits object. You should provide both a `traits.email` and a `userId` for Vero to work best.
25
23
26
24
If no `email` is attached, the user is created in Vero but cannot be emailed. If you send omit the `userId`, Vero will use the email as the ID, which is is not recommended. Check out the [Vero docs](https://help.getvero.com/workflows/articles/creating-and-matching-vero-customer-ids/){:target="_blank"} for more information.
27
25
28
-
A `userId` is a required value for all types of calls. Be sure you call `identify` with a `userId` for subsequent `track` calls to populate into Vero correctly. For server side calls, you will have to manually pass in the `userId` at the top level.
26
+
A `userId` is a required value for all types of calls. Be sure you call Identify with a `userId` for subsequent `track` calls to populate into Vero correctly. For server side calls, you will have to manually pass in the `userId` at the top level.
29
27
30
28
### Server Side
31
29
32
-
When you call [`identify`](/docs/connections/spec/identify/) from one of our server-side languages, we'll call Vero's REST API and update the traits for the customer with that `userId`. If your `userId` is an email, we'll also set the trait `email` as your `userId` in the update call.
30
+
When you call [Identify](/docs/connections/spec/identify/) from one of Segment's server-side languages, Segment calls Vero's REST API and update the traits for the customer with that `userId`. If your `userId` is an email, Segment sets the trait `email` as your `userId` in the update call.
33
31
34
32
35
33
## Track
36
34
37
-
When you call [`track`](/docs/connections/spec/track/), we'll send the event to Vero with the event `name` and `properties` you provide. Events will be matched to the current user.
35
+
When you call [Track](/docs/connections/spec/track/), Segment sends the event to Vero with the event `name` and `properties` you provide. Events will be matched to the current user.
38
36
39
-
You can also unsubscribe users by sending a `track` event, passing in the user's ID as a `property`, like so:
37
+
You can also unsubscribe users by sending a Track event, passing in the user's ID as a `property`, like so:
40
38
41
39
```javascript
42
40
analytics.track('Unsubscribe', {
43
41
id:'12345'
44
42
});
45
43
```
46
44
47
-
Note: If you'd like to explicitly specify a user's email with track events that is not an event metadata, you can send that under `context.traits.email`!
45
+
Note: If you'd like to explicitly specify a user's email with track events that is not an event metadata, you can send that under `context.traits.email`.
48
46
49
47
## Sending Data from Vero
50
48
51
-
Vero supports sending [email events](/docs/connections/spec/email) to other tools on the Segment platform. These events will be sent as `track` calls to the other destinations you've turned on.
49
+
Vero supports sending [email events](/docs/connections/spec/email) to other tools on the Segment platform. These events will be sent as Track calls to the other destinations you've turned on.
52
50
53
51
To enable this feature,
54
52
@@ -62,17 +60,17 @@ To enable this feature,
62
60
63
61
## Group
64
62
65
-
When you call [`group`](/docs/connections/spec/group/), the `traits` included in the call will be set to the current user's **Group** property in Vero.
63
+
When you call [Group](/docs/connections/spec/group/), the `traits` included in the call will be set to the current user's **Group** property in Vero.
66
64
67
65
## Alias
68
66
69
-
Our [`alias`](/docs/connections/spec/alias/) method can be used from your server to "re-identify" an existing user identity to a new one.
67
+
Segment's [Alias](/docs/connections/spec/alias/) method can be used from your server to "re-identify" an existing user identity to a new one.
70
68
71
69
Most of the time this happens when you identify a visitor by their email address after they opt in, then later re-identify with a database ID when they become registered users.
72
70
73
-
To connect the two identities you'll need to [`alias`](/docs/connections/spec/alias/) their current identity to their new one.
71
+
To connect the two identities you'll need to [Alias](/docs/connections/spec/alias/) their current identity to their new one.
74
72
75
-
Here's a python example of using [`alias`](/docs/connections/spec/alias/) to update the identity from an email address to a database ID:
73
+
Here's a python example of using [Alias](/docs/connections/spec/alias/) to update the identity from an email address to a database ID:
The destination is capable of both adding and removing tags in Vero for a given user. Because `tags` is not a common property of events, this functionality is invoked using an [destination specific option](/docs/connections/sources/catalog/libraries/website/javascript/#selecting-destinations-with-the-integrations-object).
83
+
The destination is capable of both adding and removing tags in Vero for a given user. Because `tags` is not a common property of events, this functionality is invoked using an [destination specific option](/docs/connections/sources/catalog/libraries/website/javascript/#managing-data-flow-with-the-integrations-object).
86
84
87
85
To start using this feature, pass an object called `tags` with the following properties:
88
86
89
-
<table>
90
-
<tr>
91
-
<td>`id` optional</td>
92
-
<td>String</td>
93
-
<td>The user Id to associate tags with. If this is not specified, the destination will simply use the userId from the event itself.</td>
94
-
</tr>
95
-
<tr>
96
-
<td>`action` required</td>
97
-
<td>String</td>
98
-
<td>Must be either 'add' or 'remove'. Indicates whether you would like to add or remove the tags for the given user.</td>
99
-
</tr>
100
-
<tr>
101
-
<td>`values` required</td>
102
-
<td>Array</td>
103
-
<td>An array of strings representing the tags to either add or remove.<td>
|`id`|_optional_| String | The user Id to associate tags with. If this is not specified, the destination will simply use the userId from the event itself. |
90
+
|`action`|_required_| String | Must be either 'add' or 'remove'. Indicates whether you would like to add or remove the tags for the given user. |
91
+
|`values`|_required_| Array | An array of strings representing the tags to either add or remove. |
92
+
93
+
Here is an example using Segment's Node.js library:
0 commit comments