- TLC Home Home
- Discussions & Ideas Discussions & Ideas
- Product Guides Product Guides
- Knowledge Base Knowledge Base
- Developer Docs Developer Docs
- Education Education
- Blog Blog
- Support Desk Support Desk
This article describes how to use Braze as a data source to send actionable events to Tealium EventStream API Hub and Tealium AudienceStream CDP using Braze Currents.
For additional information about Partner Integrations and Tealium Server-Side data sources, see Data Sources.
In this article:
A Currents connector is already included in many Braze pro- and enterprise-level packages. If you do not already have access to Currents, contact your Braze account manager.
The Braze platform tracks a variety of event data from your Braze integration for analysis, retargeting, and other use-cases within your systems. To connect Braze with Tealium EventStream or Tealium AudienceStream, use Braze Currents to send Braze data source to your Tealium account.
After you configure Braze Currents, you can create subscriptions based on topics and receive related push notifications to automate use cases, stay informed, and increase productivity.
Adding the Braze data source to your Tealium Customer Data Hub profile generates a unique URL to use in your Currents configuration in following format:
https://collect.tealiumiq.com/integration/event/ACCOUNT/PROFILE/DATA_SOURCE_KEY
To add the Braze data source to your Tealium Customer Data Hub profile, see Data Sources. After adding and connecting the data source, save and publish your profile.
After you connect Braze to your Tealium Customer Data Hub profile, configure Braze Currents using the following steps:
https://collect-us-east-1.tealiumiq.com/integration/event/{account}/{profile}/{data_source_key}
Braze event parameters are pre-defined based on the Engagement behavior or the Customer behavior events you select in your Currents configuration. Events are grouped and sent to the custom endpoint as a JSON array containing all events. For example, {"events": [event1, event2, event3, etc...]}
, where each element in the array is a JSON object representing a single event.
For example, Braze generates the following JSON event object when a Braze Canvas email makes it successfully to the end-users inbox:
users.messages.email.Delivery { "event_type": "users.messages.email.Delivery", "id": "663628f0-3f46-484e-8b6c-51d0a67764e0", "time": 1646162118, "timezone": "America/Chicago", "user": { "external_user_id": "62181fc031c9ba304eecb255" }, "properties": { "canvas_id": "c176e77e-33ba-44d6-809c-c89483d1e3d7", "canvas_name": "My Cool Canvas", "canvas_step_name": "Initial Email", "canvas_variation_id": "31234567-89ab-cdef-0123-456789abcdef", "canvas_variation_name": "Variant 1", "canvas_step_id": "d8e31e8e-0584-43dd-8e4e-b657707df800", "dispatch_id": "621e70c403115018b55ee12cc214a515", "email_address": "test1@tealium.com", "sending_ip": "167.89.14.251", "subscription_group_id": "41234567-89ab-cdef-0123-456789abcdef" }
}
All incoming Braze event attributes are automatically prefixed with braze_
. For example, when Currents sends id
, the matching EventStream event attribute is braze_id
(all lowercase). The Tealium Braze data source flattens the events as custom JSON objects as shown in the following example:
{ "tealium_event": "users.messages.email.Delivery", "braze_event_type": "users.messages.email.Delivery", "braze_id": "663628f0-3f46-484e-8b6c-51d0a67764e0", "braze_time": 1646162118, "braze_timezone": "America/Chicago", "braze_user_external_user_id": "62181fc031c9ba304eecb255", "braze_properties_canvas_id": "c176e77e-33ba-44d6-809c-c89483d1e3d7", "braze_properties_canvas_name": "My Cool Canvas", "braze_properties_canvas_step_name": "Initial Email", "braze_properties_canvas_variation_id": "31234567-89ab-cdef-0123-456789abcdef", "braze_properties_canvas_variation_name": "Variant 1", "braze_properties_canvas_step_id": "d8e31e8e-0584-43dd-8e4e-b657707df800", "braze_properties_dispatch_id": "621e70c403115018b55ee12cc214a515", "braze_properties_email_address": "test1@tealium.com", "braze_properties_sending_ip": "167.89.14.251", "braze_properties_subscription_group_id": "41234567-89ab-cdef-0123-456789abcdef"
}
Note that the tealium_event
attribute inherits the value of the event_type
parameter from Currents.
The following image is an example of an inbound event into the Tealium Live Events tool and contains parameters passed by the email delivery event:
For a full list of supported events, see the Currents Event Glossary in the Braze Currents documentation.
Copyright All Rights Reserved © 2008-2022