Braze Currents Data Source Setup Guide

[#1]

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:

• Prerequisites
• How It Works
• Braze Currents Data Source
• Braze Currents Setup
• Events and Attributes
• Vendor Documentation

Prerequisites

• Tealium EventStream and/or Tealium AudienceStream
• Braze account with Currents enabled

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.

How It Works

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.

Braze Currents Data Source

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. 

Braze Currents Setup

After you connect Braze to your Tealium Customer Data Hub profile, configure Braze Currents using the following steps: 

1. Log in to your Braze account and navigate to the Currents page in the Integrations section of your Braze Dashboard.
2. From the Create Current menu, select Tealium as the Currents connector or Partner.
3. Enter the custom endpoint URL created by adding the Braze data source to your Tealium profile. For example, 
   

   https://collect-us-east-1.tealiumiq.com/integration/event/{account}/{profile}/{data_source_key}

4. Select Message Engagement Events, Customer Behavior, and User Events to be sent to Tealium.
5. Enable and save the current.

Events and Attributes

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.

Vendor Documentation

• Setting up Currents
• Braze Currents
• Customer Behavior Events
• Message Engagement Events