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/sources/catalog/libraries/mobile/react-native/destination-plugins/braze-react-native.md
+10-10Lines changed: 10 additions & 10 deletions
Original file line number
Diff line number
Diff line change
@@ -5,14 +5,14 @@ strat: react-native
5
5
6
6
[Braze](https://www.braze.com/), formerly Appboy, is an engagement platform that empowers growth by helping marketing teams to build customer loyalty through mobile, omni-channel customer experiences.
7
7
8
-
Braze’s destination plugin code is open source and available on GitHub. You can view it [here.](https://github.com/segmentio/analytics-react-native/tree/master/packages/plugins/plugin-braze).
8
+
Braze’s destination plugin code is open source [and available on GitHub](https://github.com/segmentio/analytics-react-native/tree/master/packages/plugins/plugin-braze){:target="_blank"}.
9
9
10
10
## Getting Started
11
11
12
12
1. From the Segment web app, click **Catalog**.
13
13
2. Search for "Braze" in the Catalog, select it, and choose which of your sources to connect the destination to.
14
14
3. In the Destination Settings, add the **API Key**, found in the Braze Dashboard in *App Settings > Manage App Group*.
15
-
4. Set up a new App Group REST API Key in the Braze Dashboard in *App Settings > Developer Console > API Settings*. For more information, see [Creating and Managing REST API Keys](https://www.braze.com/docs/api/basics/#creating-and-managing-rest-api-keys) in the Braze documentation.
15
+
4. Set up a new App Group REST API Key in the Braze Dashboard in *App Settings > Developer Console > API Settings*. For more information, see [Creating and Managing REST API Keys](https://www.braze.com/docs/api/basics/#creating-and-managing-rest-api-keys){:target="_blank"} in the Braze documentation.
16
16
- Select the `users.track` endpoint in the **User Data** section.
Run `pod install` after the installation to autolink the Braze SDK.
33
33
34
-
See [Braze React SDK](https://github.com/braze-inc/braze-react-native-sdk) for more details of this dependency.
34
+
See [Braze React SDK](https://github.com/braze-inc/braze-react-native-sdk){:target="_blank"} for more details of this dependency.
35
35
36
36
## Using the Plugin in your App
37
37
38
-
Follow the [instructions for adding plugins](https://github.com/segmentio/analytics-react-native#adding-plugins) on the main Analytics client:
38
+
Follow the [instructions for adding plugins](https://github.com/segmentio/analytics-react-native#adding-plugins){:target="_blank"} on the main Analytics client:
39
39
40
-
In your code where you initialize the analytics client call the `.add(plugin)` method with an`BrazePlugin` instance:
40
+
In your code where you initialize the analytics client, call the `.add(plugin)` method with a`BrazePlugin` instance:
@@ -94,7 +94,7 @@ Pass one of the many identifiers that may exist on an anonymous user profile to
94
94
95
95
Choose an identifier that is available on the user profile at that point in the user lifecycle.
96
96
97
-
For example, if you pass device_id to the User by Identifier endpoint:
97
+
For example, if you pass `device_id` to the User by Identifier endpoint:
98
98
99
99
```js
100
100
{
@@ -131,12 +131,12 @@ Segment's special traits recognized as Braze's standard user profile fields (in
131
131
|`address.country`|`country`|
132
132
|`gender`|`gender`|
133
133
134
-
Segment sends all other traits (except Braze's [reserved user profile fields](https://www.braze.com/docs/api/objects_filters/user_attributes_object/#braze-user-profile-fields)) to Braze as custom attributes. You can send an array of strings as trait values but not nested objects.
134
+
Except for Braze's [reserved user profile fields](https://www.braze.com/docs/api/objects_filters/user_attributes_object/#braze-user-profile-fields){:target="_blank"}, Segment sends all other traits to Braze as custom attributes. You can send an array of strings as trait values but not nested objects.
135
135
136
136
## Track
137
137
138
138
> info "Tip"
139
-
> To lower [Data Point](https://www.braze.com/docs/user_guide/onboarding_with_braze/data_points/) use, limit the events you send to Braze to those that are relevant for campaigns and segmentation to the Braze destination. For more information, see [Schema Controls](/docs/protocols/schema/).
139
+
> To lower [Data Point](https://www.braze.com/docs/user_guide/onboarding_with_braze/data_points/){:target="_blank"} use, limit the events you send to Braze to those that are relevant for campaigns and segmentation to the Braze destination. For more information, see [Schema Controls](/docs/protocols/schema/).
140
140
141
141
If you're not familiar with the Segment Specs, take a look to understand what the [Track method](/docs/connections/spec/track/) does. An example call looks like:
142
142
@@ -152,7 +152,7 @@ track('View Product', {
152
152
When you `track` an event, Segment sends that event to Braze as a custom event.
153
153
154
154
> note ""
155
-
> Braze requires that you include a `userId` or `braze_id` for all calls made in cloud-mode. Segment sends a `braze_id` if `userId` is missing. When you use a device-mode connection, Braze automatically tracks anonymous activity using the `braze_id` if a `userId` is missing.
155
+
> Braze requires that you include a `userId` or `braze_id` for all calls made in cloudmode. Segment sends a `braze_id` if `userId` is missing. When you use a device-mode connection, Braze automatically tracks anonymous activity using the `braze_id` if a `userId` is missing.
156
156
157
157
> note ""
158
158
> Segment removes the following custom properties reserved by Braze:
@@ -185,7 +185,7 @@ The example above would have "Purchased Item" as its `productId` and includes tw
185
185
-`revenue`
186
186
-`currency`
187
187
188
-
Braze supports currency codes as specified in [their Purchase Object Specification](https://www.braze.com/docs/api/objects_filters/purchase_object/). Be aware that any currency reported other than USD displays in [the Braze UI in USD based on the exchange rate on the date it was reported](https://www.braze.com/docs/developer_guide/platform_integration_guides/web/analytics/logging_purchases/#logging-purchases).
188
+
Braze supports currency codes as specified in [their Purchase Object Specification](https://www.braze.com/docs/api/objects_filters/purchase_object/){:target="_blank"}. Any currency reported other than USD displays in [the Braze UI in USD based on the exchange rate on the date it was reported](https://www.braze.com/docs/developer_guide/platform_integration_guides/web/analytics/logging_purchases/#logging-purchases){:target="_blank"}.
189
189
190
190
You can add more product details in the form of key-value pairs to the `properties` object. The following reserved keys are not passed to Braze if included in your Track call's `properties` object:
0 commit comments