Skip to content

Commit

Permalink
Merge pull request #4290 from braze-inc/BD-1681
Browse files Browse the repository at this point in the history
Update Mparticle calculated attribute feed
  • Loading branch information
KellieHawks authored Oct 25, 2022
2 parents 462d2fa + dcad2a4 commit b9f868b
Show file tree
Hide file tree
Showing 4 changed files with 16 additions and 14 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -205,7 +205,7 @@ Turning off this setting won't check for changing data. It will, however, preven
There are a few considerations to be aware of when turning off **Include Enriched User Attributes**:
1. The server-to-server integration uses the mParticle events API to send events to Braze. Each request is triggered by an event. When a user attribute is changed, such as updating an email address, but is not associated with a specific event (e.g., a profile update custom event), the new value is only passed to an output like Braze as an "enriched attribute" in the payload of the next event triggered by the user. When **Include Enriched User Attributes** is turned off, this new attribute value unassociated with a specific event will not be passed to Braze.
- To solve this, we recommend creating a separate "user attribute updated" event that only sends the specific user attribute(s) that have been updated to Braze. Note that with this approach, you are still logging an additional data point for the "user attribute updated" event, but data point consumption will be far less than sending all user attributes on every call with the feature enabled.
2. Calculated attributes are only passed to Braze as an enriched user attribute, so these will not be available to customers who turn off "Enriched User Attributes".
2. Calculated Attributes are passed to Braze as an enriched user attribute, so when "Enriched User Attributes" is turned off these will no longer be passed to Braze. To forward calculated attributes to Braze when "Enriched User Attributes" are turned off, a [calculated attribute feed](https://docs.mparticle.com/guides/platform-guide/calculated-attributes/using-calculated-attributes/#forward-calculated-attributes-in-the-calculated-attributes-feed) could help without pushing all the attributes. The feed will fire an update downstream to Braze when a calculated attribute changes.

### Sending unnecessary or duplicative data to Braze
Braze counts a data point each time an attribute is passed to Braze, even if the value is unchanged. For this reason, Braze recommends only forwarding data needed to action on within Braze and ensuring that only deltas of attributes are being passed.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,8 @@ guide_featured_list:
- name: Segment
link: /docs/partners/data_and_infrastructure_agility/customer_data_platform/segment/segment/
fa_icon: fas fa-user-circle
- name: Segment Personas
link: /docs/partners/data_and_infrastructure_agility/customer_data_platform/segment/segment_personas/
- name: Segment Engage
link: /docs/partners/data_and_infrastructure_agility/customer_data_platform/segment/segment_engage/
fa_icon: fas fa-users
- name: Segment for Currents
link: /docs/partners/data_and_infrastructure_agility/customer_data_platform/segment/segment_for_currents/
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ search_tag: Partner
> [Segment][5] is a customer data platform that helps you collect, clean, and activate your customer data.
The Braze and Segment integration allows you to track your users and route data to various user analytics providers. Segment allows you to:
- Sync [Segment Personas]({{site.baseurl}}/partners/data_and_infrastructure_agility/customer_data_platform/segment/segment_personas/) to Braze for use in Braze campaign and Canvas segmentation.
- Sync [Segment Engage]({{site.baseurl}}/partners/data_and_infrastructure_agility/customer_data_platform/segment/segment_engage/) to Braze for use in Braze campaign and Canvas segmentation.
- [Import data across the two platforms](#integration-options). We offer a side-by-side SDK integration for your Android, iOS, and web applications and a server-to-server integration for syncing your data to Braze’s REST APIs
- [Connect data to Segment through Currents]({{site.baseurl}}/partners/data_and_infrastructure_agility/customer_data_platform/segment/segment_for_currents/).

Expand Down
Original file line number Diff line number Diff line change
@@ -1,20 +1,22 @@
---
nav_title: Segment Personas
article_title: Segment Personas
nav_title: Segment Engage
article_title: Segment Engage
page_order: 1.3
alias: /partners/segment_personas/
alias: /partners/segment_engage/
alias: /partners/data_and_infrastructure_agility/customer_data_platform/segment/segment_personas/

description: "This article outlines the partnership between Braze and Segment, a customer data platform that collects and routes information between sources in your marketing stack."
page_type: partner
search_tag: Partner

---

# Segment Personas
# Segment Engage

> [Segment](https://segment.com) is a customer data platform that helps you collect, clean, and activate your customer data. This article will give an overview of the connection between [Braze and Segment Personas](https://segment.com/docs/destinations/braze/#personas), as well as describe requirements and processes for proper implementation and usage.
> [Segment](https://segment.com) is a customer data platform that helps you collect, clean, and activate your customer data. This article will give an overview of the connection between [Braze and Segment Engage](https://segment.com/docs/destinations/braze/#Engage), as well as describe requirements and processes for proper implementation and usage.
The Braze and Segment integration allows you to use [Personas](https://segment.com/docs/personas/), Segment's built-in audience builder, to create segments of users based on data you have already collected across various sources. These users will then be assigned [custom attributes]({{site.baseurl}}/user_guide/data_and_analytics/custom_data/custom_attributes/) or [custom events]({{site.baseurl}}/user_guide/data_and_analytics/custom_data/custom_events/#custom-events) that can be used to create Braze segments to use in campaign and Canvas retargeting.
The Braze and Segment integration allows you to use [Engage](https://segment.com/docs/engage/), Segment's built-in audience builder, to create segments of users based on data you have already collected across various sources. These users will then be assigned [custom attributes]({{site.baseurl}}/user_guide/data_and_analytics/custom_data/custom_attributes/) or [custom events]({{site.baseurl}}/user_guide/data_and_analytics/custom_data/custom_events/#custom-events) that can be used to create Braze segments to use in campaign and Canvas retargeting.

## Prerequisites

Expand All @@ -28,15 +30,15 @@ The Braze and Segment integration allows you to use [Personas](https://segment.c

### Step 1: Create a Segment computed trait or audience

1. In Segment, navigate to the **Computed Traits** or **Audiences** tab in **Personas**, and click **New**.
1. In Segment, navigate to the **Computed Traits** or **Audiences** tab in **Engage**, and click **New**.
2. Create your computed trait or audience. A lightning bolt in the top corner of the page will indicate if the computation updates in real-time.
3. Next, select **Braze** as your destination.
4. Preview your audience by clicking **Review & Create**. By default, Segment queries all historical data to set the current value of the computed trait and audience. To omit this data, uncheck **Historical Backfill**.
5. In the computed trait or audience settings, adjust the connection settings based on how you would like your data sent to Braze.

#### Computed traits and audiences

[Computed traits](https://segment.com/docs/personas/computed-traits/) and [audiences](https://segment.com/docs/personas/audiences/) can be sent to Braze as custom attributes or custom events.
[Computed traits](https://segment.com/docs/engage/audiences/computed-traits/) and [audiences](https://segment.com/docs/Engage/audiences/) can be sent to Braze as custom attributes or custom events.
- Traits and audiences sent using the `identify` call will appear in Braze as custom attributes.
- Traits and audiences sent using the `track` call will appear in Braze as custom events.

Expand All @@ -47,7 +49,7 @@ You can choose which method to use (or choose to use both) when you connect the

You can send computed traits and audiences to Braze as `identify` calls to create custom attributes in Braze.

For example, if you have a Personas computed trait for “Last Product Viewed Item,” you would find `last_product_viewed_item` in the user’s Braze profile under **Custom Attributes**. If this were instead a Personas audience, you would find your audience listed under **Custom Attributes** set as `true`.
For example, if you have an Engage computed trait for “Last Product Viewed Item,” you would find `last_product_viewed_item` in the user’s Braze profile under **Custom Attributes**. If this were instead an Engage audience, you would find your audience listed under **Custom Attributes** set as `true`.

| Computed Trait | Audiences |
| -------------- | --------- |
Expand All @@ -58,7 +60,7 @@ For example, if you have a Personas computed trait for “Last Product Viewed It

You can send computed traits and audiences to Braze as `track` calls to create custom events in Braze.

Continuing the previous example, if a user has a computed trait for “Last Product Viewed Item”, it will appear on users' Braze profiles as `Trait Computed` with the corresponding count and most recent timestamp under **Custom Events**. If this were instead a Personas audience, you would find your audience, count, and most recent timestamp listed under **Custom Attributes** set as `true`.
Continuing the previous example, if a user has a computed trait for “Last Product Viewed Item”, it will appear on users' Braze profiles as `Trait Computed` with the corresponding count and most recent timestamp under **Custom Events**. If this were instead an Engage audience, you would find your audience, count, and most recent timestamp listed under **Custom Attributes** set as `true`.

| Computed Trait | Audiences |
| -------------- | --------- |
Expand All @@ -77,7 +79,7 @@ Once saved, you can reference this segment during Canvas or campaign creation in

## Sync time

Though the default setting for the Braze to Segment Personas connection is `Realtime`, there are some filters that will disqualify the persona from syncing in real-time, including some time-based filters which restrict your audience's size at the time of message send.
Though the default setting for the Braze to Segment Engage connection is `Realtime`, there are some filters that will disqualify the persona from syncing in real-time, including some time-based filters which restrict your audience's size at the time of message send.

## Segment debugger testing

Expand Down

0 comments on commit b9f868b

Please sign in to comment.