Braze Connector Setup Guide

[#1]

This article describes how to set up the Braze connector in your Customer Data Hub account.

In this article:

Table of Contents Placeholder

Connector Actions

Action Name	AudienceStream	EventStream
Track User	✓	✓
Delete User	✓	✓

Consent Categories

• Analytics
• Mobile
• Personalization

Configure Settings

Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector.

After adding the connector, configure the following settings:

• API Endpoint
  • Required.
  • Select API endpoint for the instance your account is provisioned to.
  • For more information, see API Endpoints.
• API Key
  • Required.
  • Provide API key with "users.track" and "users.delete" permissions enabled.
  • Use Authentication to ensure that your API key is valid.
  • For more information, see App Group REST API Keys.

For additional information see Braze Documentation Braze Technology Partners: Tealium.

Action Settings - Parameters and Options

Click Next or go to the Actions tab. This is where you configure connector actions.

This section describes how to set up parameters and options for each action.

The Track User action contains functionality that is the same for AudienceStream and EventStream. As a best practice, Tealium recommends using User Attribute features with AudienceStream and Event and Purchase features with EventStream. Use cases that do not fit these criteria may ignore this best practice.

Action - Track User

Tealium recommends mapping all User ID parameters for this section. When an action triggers, Tealium evaluates which User IDs to send to Braze for the best performance. When multiple IDs provided, the first non-blank values is selected based on the following priority order:

• User ID Parameters (Required)
• External ID
• Braze ID
• Alias Name
• Alias Label

For more information, see vendor documentation for User Track.

Batch Limits

This action uses batched requests to support high-volume data transfers to the vendor. Requests are queued until one of the following three (3) thresholds is met:

• Max number of requests: 75
• Max time since oldest request: 10 minutes
• Max size of requests: 1 MB

Parameter	Description
External ID	External ID of the user to be tracked. When importing Push Tokens, External ID and Braze ID should not be specified.
Braze ID	Braze ID of the user to be tracked. When importing Push Tokens, External ID and Braze ID should not be specified.
User Alias Name	The alias name of the user to be tracked. When specifying a user alias, Alias Name and Alias Label should both be set.
User Alias Label	The alias label of the user to be tracked. When specifying a user alias, Alias Name and Alias Label should both be set.

User Attributes Parameters (Optional)

Tealium recommends using the Braze best practice of sending only changed user attributes and avoiding sending unchanged attributes. You can do this using Visit and Visitor attribute enrichments and rules that recognize when an attribute has changed. For more information, see Enrichment Rules.

Parameter	Description
Country	The country of the user to be tracked. Empty values are converted to null and removed from the Braze user profile.
Current Location - Latitude	The current latitude for the user to be tracked Empty values are converted to null and removed from the Braze user profile..
Current Location - Longitude	The current longitude for the user to be tracked. Empty values are converted to null and removed from the Braze user profile.
Date of First Session	The date of the first session of the user to be tracked. Empty values are converted to null and removed from the Braze user profile.
Date of Last Session	The date of the last session of the user to be tracked. Empty values are converted to null and removed from the Braze user profile.
Date of Birth	The date of birth for the user to be tracked. Empty values are converted to null and removed from the Braze user profile.
Email Address	The email address for the user to be tracked. Empty values are converted to null and removed from the Braze user profile.
Email Subscription Status	The email subscription status for the user to be tracked. Empty values are converted to null and removed from the Braze user profile.
Facebook	The Facebook account for the user to be tracked. Empty values are converted to null and removed from the Braze user profile.
First Name	The first name of the user to be tracked. Empty values are converted to null and removed from the Braze user profile.
Gender	The gender of the user to be tracked. Values are Male (m) or Female (f). Empty values are converted to null and removed from the Braze user profile.
Home City	The home city for the user to be tracked. Empty values are converted to null and removed from the Braze user profile.
Image URL	Optional The URL for the user's image. Empty values are converted to null and removed from the Braze user profile.
Language	The language preference of the user to be tracked. Empty values are converted to null and removed from the Braze user profile.
Last Name	The last name of the user to be tracked. Empty values are converted to null and removed from the Braze user profile.
Marked Email As Spam At	User marked email as spam. Empty values are converted to null and removed from the Braze user profile.
Phone Number	The telephone number of the user to be tracked. Empty values are converted to null and removed from the Braze user profile.
Push Subscription Status	The Push Subscription status of the user to be tracked. Empty values are converted to null and removed from the Braze user profile.
Push Tokens ID Array	Array. The Push Token ID for the user to be tracked. Empty values are converted to null and removed from the Braze user profile.
Push Tokens Array	Push tokens array. Empty values are converted to null and removed from the Braze user profile.
Push Tokens Device ID Array	The Push Token Device ID for the user's device. Empty values are converted to null and removed from the Braze user profile.
Time Zone	The time zone for the user to be tracked. Empty values are converted to null and removed from the Braze user profile.
Twitter	The Twitter account for the user to be tracked. Empty values are converted to null and removed from the Braze user profile.
Update Existing Only (Users)	Optional Values are true or false. If no user value exists, one is created by default. If set to true, only existing users are updated and no new users are created. Empty values are converted to null and removed from the Braze user profile.

Modify User Attribute Parameters (Optional)

Parameter	Description
Modify User Attributes	Increment Integer attributes by positive or negative integers. Modify Array attributes by adding or removing values from existing arrays.

Event Parameters (Optional)

To map data for events, you must map a value for the Braze event name. If the Tealium and Braze event names are not mapped, no data is sent to Braze.

Parameter	Description
App ID	The User App ID to be tracked.
Name	Required The application name to be tracked.
Time	Time
Update Existing Only (Events)	Optional Values are true or false. If no event value exists, one is created by default. If set to true, only existing events are updated and no new events are created Map Array type attributes to add multiple events. Array type attributes must be of equal length. Single value attributes can be used and will apply to each event.

Purchase Parameters (Optional)

To map data for purchases, you must map the values for Product ID, Currency, and Price.

Example:

The following code sample shows a Braze best practice example for receiving a single Tealium purchase event containing purchases for multiple products:

// event to Tealium:
{
  [...]
  "tealium_event": "purchase,
  "product_name": ["Backpack","Pencil","Notebook"],
  "product_quantity": [1,5,3],
  "product_category": ["Travel","Office","Office"],
  "product_price": [39.95,1.99,3.99],
  "order_currency": "USD"
}

Map the corresponding product arrays to Braze as follows:

• product_name > Product ID
• product_quantity > Quantity
• product_price > Price

The results of this example sends the following purchases object to Braze, representing each product accordingly:

// payload to Braze via Tealium Connector:
{
  "purchases": [
    {
      "external_id" : "user1",
      "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
      "product_id" : "Backpack",
      "currency" : "USD",
      "price" : 39.95,
      "time" : "2013-07-16T19:20:30+01:00",
    },
    {
      "external_id" : "user1",
      "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
      "product_id" : "Pencil",
      "currency" : "USD",
      "price" : 1.99,
      "time" : "2013-07-16T19:20:30+01:00",
    },
    {
      "external_id" : "user1",
      "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
      "product_id" : "Backpack",
      "currency" : "USD",
      "price" : 3.99,
      "time" : "2013-07-16T19:20:30+01:00",
    }
  ]
}

Parameter	Description
App ID	The Event Application ID to be tracked.
Product ID	Required for every mapped purchase.
Currency	Required for every mapped purchase.
Price	Required for every mapped purchase.
Quantity	Map Array type attributes to add multiple purchase items. Array type attributes must be of equal length.
Purchase Time	Time of purchase. Automatically set to "now" unless explicitly mapped.
Update Existing Only (Purchases)	Optional Values are true or false. If no purchase value exists, one is created by default. If set to true, only existing purchases are updated and no new purchases are created. Map Array type attributes to add multiple events. Array type attributes must be of equal length. Single value attributes can be used and will apply to each event.

Action - Delete User

Parameters

Parameter	Description
External ID	Required Must be mapped. External ID of the user to delete. When multiple IDs are specified, the first non-blank values is selected based on the following priority order: External ID Braze ID Alias Name Alias Label For more information, see User Delete Endpoint.
Braze ID	Required Must be mapped. Braze ID of the user to delete. When multiple IDs are specified, the first non-blank values is selected based on the following priority order: External ID Braze ID Alias Name Alias Label Must include either External ID or Braze ID.
User Alias Name	Required The alias name of the user to be deleted. When specifying a user alias, Alias Name and Alias Label should both be set. For more information, see User Delete Endpoint.
User Alias Label	Required The alias label of the user to be deleted. When specifying a user alias, Alias Name and Alias Label should both be set.

Frequently Asked Questions

How does this connector complement or replace other Braze integrations with Tealium?

In addition to the Track User API, Braze has additional data collection methods, both of which support mapping of user attributes in Braze. Tealium supports Braze SDKs for Web and Native Mobile in the following two independent, but similar integrations:

• Braze Web SDK Tag Setup, Braze Initial SDK Setup
• Tealium Remote Command for Braze on Android and iOS/Swift (Learn more)

These integrations are alternative methods used for Braze to collect user behavior data that is similar to the data collected by the Events and Purchases features of the Braze connector.