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/exponea/index.md
+32-35Lines changed: 32 additions & 35 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,62 +1,59 @@
1
1
---
2
-
title: Exponea Destination
2
+
title: Bloomreach Engagement Destination
3
3
rewrite: true
4
4
beta: true
5
5
id: 5d4d88bbd02041672e51e3ca
6
6
---
7
-
[Exponea](https://exponea.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners) is a Customer Data & Experience Platform (CDXP) which creates a unified source of customer intelligence in real-time, ready for immediate activation using its own built‑in omnichannel marketing systems (web, email, push, mobile, text messages,etc.) powered by customer-centric analytics and artificial intelligence (product recommendations and predictions).
7
+
[Bloomreach Engagement](https://www.bloomreach.com/en/products/engagement?spz=learn_orig/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank”} is a Customer Data & Experience Platform (CDXP) which creates a unified source of customer intelligence in real-time, ready for immediate activation using its own built‑in omnichannel marketing systems (web, email, push, mobile, text messages,etc.) powered by customer-centric analytics and artificial intelligence (product recommendations and predictions).
8
8
9
-
This destination is maintained by Exponea. For any issues with the destination, contact [the Exponea Support team](mailto:[email protected]).
9
+
This destination is maintained by Bloomreach Engagement. For any issues with the destination, contact [the Bloomreach Engagement Support team](mailto:[email protected]).
10
10
11
11
12
12
{% include content/beta-note.md %}
13
13
14
14
15
15
## Getting Started
16
16
17
-
18
-
19
-
20
17
1. From the Segment web app, click **Catalog**.
21
-
2. Search for "Exponea" in the Catalog, select it, and choose which of your sources to connect the destination to.
22
-
3. Create a [public API group](https://docs.exponea.com/reference#setting-up-access-keys) for your Segment integration in your Exponea project. Don't forget to set the appropriate [group permissions](https://docs.exponea.com/v2/reference#section-modifying-the-access-of-your-api-group) to allow recieveing events and customer updates.
23
-
4. Fill in the "API Base URL", "API key" and "Project Token" into your Segment Settings UI. You can find all of the above in the API settings page of your Exponea project.
24
-
5. Enter your Exponea hard ID and soft ID names into the corresponding fields to specify Segment's userId and anonymousId mapping into your Exponea ID structure.
18
+
2. Search for "Bloomreach Engagement" in the Catalog, select it, and choose which of your sources to connect the destination to.
19
+
3. Create a [public API group](https://documentation.bloomreach.com/engagement/reference/authentication){:target="_blank”} for your Segment integration in your Bloomreach Engagement project. Don't forget to set the appropriate [group permissions](https://documentation.bloomreach.com/engagement/reference/authentication#using-the-api-groups){:target="_blank”} to allow recieveing events and customer updates.
20
+
4. Fill in the "API Base URL", "API key" and "Project Token" into your Segment Settings UI. You can find all of the above in the API settings page of your Bloomreach Engagement project.
21
+
5. Enter your Bloomreach Engagement hard ID and soft ID names into the corresponding fields to specify Segment's userId and anonymousId mapping into your Bloomreach Engagement ID structure.
25
22
26
23
27
24
## Common fields
28
25
29
-
If you have not had a chance to review our spec, take a look tounderstand what the [Common fields](/docs/connections/spec/common/) are.
26
+
If you have not had a chance to review the Segment spec, take a look to understand what the [Common fields](/docs/connections/spec/common/) are.
30
27
31
-
The `userId` and `anonymousId` common fields are used for all types of calls to identify the user in Exponea. Mapping of the IDs is based on the destination settings:
28
+
The `userId` and `anonymousId` common fields are used for all types of calls to identify the user in Bloomreach Engagement. Mapping of the IDs is based on the destination settings:
32
29
33
-
| Segment |Exponea|
30
+
| Segment |Bloomreach Engagement|
34
31
| -------- | -------- |
35
-
| userId |Exponea hard ID (e.g registered) |
36
-
| anonymousId |Exponea soft ID (e.g cookie) |
32
+
| userId |Bloomreach Engagement hard ID (e.g registered) |
33
+
| anonymousId |Bloomreach Engagement soft ID (e.g cookie) |
37
34
38
35
39
36
40
-
Other common fields are used only for `track`, `page` and `screen` calls which are translated into Exponea events. The following common fields are mapped to Exponea:
37
+
Other common fields are used only for `track`, `page` and `screen` calls which are translated into Bloomreach Engagement events. The following common fields are mapped to Bloomreach Engagement:
41
38
42
39
43
-
| Segment |Exponea|
40
+
| Segment |Bloomreach Engagement|
44
41
| -------- | -------- |
45
42
| timestamp | timestamp (string date is parsed to unix timestamp) |
If you have not had a chance to review our spec, take a look tounderstand what the [Page method](/docs/connections/spec/page/) does.
48
+
If you have not had a chance to review the Segment spec, take a look to understand what the [Page method](/docs/connections/spec/page/) does.
52
49
53
-
Page calls will be sent to Exponea as a `page_visit` event with the `properties` field mapped into event properties and the `name` field mapped into the `page_name` property.
50
+
Page calls will be sent to Bloomreach Engagement as a `page_visit` event with the `properties` field mapped into event properties and the `name` field mapped into the `page_name` property.
54
51
55
52
Example of page call:
56
53
57
54
```js
58
55
analytics.page("Home", {
59
-
url:"https://exponea.com",
56
+
url:"https://Bloomreach Engagement.com",
60
57
referrer:"http://google.com"
61
58
})
62
59
```
@@ -65,18 +62,18 @@ This `page` call is translated into a `page_visit` event with the following prop
65
62
66
63
```js
67
64
"page_name":"Home",
68
-
"url":"https://exponea.com",
65
+
"url":"https://Bloomreach Engagement.com",
69
66
"referrer":"http://google.com"
70
67
```
71
68
72
-
An optional event `session_ping` can be tracked along with `page_visit` for [automatic session tracking](https://docs.exponea.com/docs/system-events#section-first-session-session-start-session-end). You can adjust this behavior in your Exponea destination settings by toggling on and off the 'Track session ping' settings. The Exponea soft ID must be set to `cookie` and the `anonymousId` field must be present in the `page` call for session events to work.
69
+
An optional event `session_ping` can be tracked along with `page_visit` for [automatic session tracking](https://documentation.bloomreach.com/engagement/docs/system-events#section-first-session-session-start-session-end){:target="_blank”}. You can adjust this behavior in your Bloomreach Engagement destination settings by toggling on and off the 'Track session ping' settings. The Bloomreach Engagement soft ID must be set to `cookie` and the `anonymousId` field must be present in the `page` call for session events to work.
73
70
74
71
75
72
## Screen
76
73
77
-
If you have not had a chance to review our spec, take a look tounderstand what the [Screen method](/docs/connections/spec/screen/) does.
74
+
If you have not had a chance to review the Segment spec, take a look to understand what the [Screen method](/docs/connections/spec/screen/) does.
78
75
79
-
Screen calls will be sent to Exponea as a `screen_visit` event with the `properties` field mapped into event properties and the`name` field mapped into the `screen_name` property.
76
+
Screen calls will be sent to Bloomreach Engagement as a `screen_visit` event with the `properties` field mapped into event properties and the`name` field mapped into the `screen_name` property.
80
77
81
78
Example of screen call:
82
79
@@ -92,13 +89,13 @@ This `screen` call is translated into a `screen_visit` event with the following
92
89
"Feed Type": "private"
93
90
```
94
91
95
-
An optional event `session_ping` can be tracked along with `screen_visit` for [automatic session tracking](https://docs.exponea.com/docs/system-events#section-first-session-session-start-session-end). You can adjust this behavior in your Exponea destination settings by toggling on and off the 'Track session ping' settings. The Exponea soft ID must be set to `cookie` for session events to work and `anonymousId` field must be present in the `screen` call for session events to work.
92
+
An optional event `session_ping` can be tracked along with `screen_visit` for [automatic session tracking](https://documentation.bloomreach.com/engagement/docs/system-events#section-first-session-session-start-session-end){:target="_blank”}. You can adjust this behavior in your Bloomreach Engagement destination settings by toggling on and off the 'Track session ping' settings. The Bloomreach Engagement soft ID must be set to `cookie` for session events to work and `anonymousId` field must be present in the `screen` call for session events to work.
96
93
97
94
## Track
98
95
99
-
If you have not had a chance to review our spec, take a look tounderstand what the [Track method](/docs/connections/spec/track/) does.
96
+
If you have not had a chance to review the Segment spec, take a look to understand what the [Track method](/docs/connections/spec/track/) does.
100
97
101
-
Track calls will be sent to Exponea as events under name provided in the event field. The `properties` field will be mapped into event properties (objects will be flattened using underscore).
98
+
Track calls will be sent to Bloomreach Engagement as events under name provided in the event field. The `properties` field will be mapped into event properties (objects will be flattened using underscore).
102
99
103
100
Example of track call:
104
101
@@ -118,9 +115,9 @@ This track call is translated into a `Registered` event with the following prope
118
115
119
116
## Identify
120
117
121
-
If you have not had a chance to review our spec, take a look tounderstand what the [Identify method](/docs/connections/spec/identify/) does.
118
+
If you have not had a chance to review the Segment spec, take a look to understand what the [Identify method](/docs/connections/spec/identify/) does.
122
119
123
-
Identify calls will be sent to Exponea as customer updates with traits set as customer properties.
120
+
Identify calls will be sent to Bloomreach Engagement as customer updates with traits set as customer properties.
This identify call is translated into a customer update for user with Exponea hard id `userId123` with properties:
135
+
This identify call is translated into a customer update for user with Bloomreach Engagement hard id `userId123` with properties:
139
136
140
137
```js
141
138
"name":"John Doe",
@@ -146,7 +143,7 @@ This identify call is translated into a customer update for user with Exponea ha
146
143
147
144
## Alias
148
145
149
-
If you have not had a chance to review our spec, take a look tounderstand what the [Alias method](/docs/connections/spec/alias/) does.
146
+
If you have not had a chance to review our spec, take a look to understand what the [Alias method](/docs/connections/spec/alias/) does.
150
147
151
148
The alias call can be used to merge two user identities and their data to one. The `previousId` field should always contain a previously used `anonymousId`, as merging users by specifying two `userIds` is not supported. Sending an alias event with `previousId` and no `userId` will cause the event to be ignored. Note that users are also merged when any call specifies both a userId and an anonymousId, which previously belonged to two separate users.
If you have not had a chance to review our spec, take a look tounderstand what the [Group method](/docs/connections/spec/group/) does.
157
+
If you have not had a chance to review the Segment spec, take a look to understand what the [Group method](/docs/connections/spec/group/) does.
161
158
162
-
Group calls will be sent to Exponea as customer updates with group traits as customer properties prefixed with `group_` and `groupId` into `group_id`. For example:
159
+
Group calls will be sent to Bloomreach Engagement as customer updates with group traits as customer properties prefixed with `group_` and `groupId` into `group_id`. For example:
163
160
164
161
```js
165
162
analytics.group("123", {
166
-
name:"Exponea",
163
+
name:"Bloomreach Engagement",
167
164
industry:"Technology"
168
165
});
169
166
```
@@ -172,7 +169,7 @@ will be translated into a customer update with properties:
0 commit comments