Digioh Passport: Braze

Overview

Digioh Passport for Braze connects your Digioh pop-ups, forms, and banners with your Braze customer data. With this extension, you can recognize visitors who already exist in Braze, personalize content using their profile, control campaign display rules based on segments and attributes, and track campaign interactions back to Braze – all automatically and without heavy development work.

Once enabled, Digioh can:

• Recognize returning visitors and link them to their Braze profile
• Keep Braze profiles up to date when users submit Digioh forms
• Personalize campaign content using Braze profile fields (name, membership tier, purchase history, etc.)
• Display or hide campaigns based on Braze segment membership
• Track campaign views, form submissions, clicks, and interactions as Braze events
• Avoid duplicate Braze profiles by maintaining consistent visitor identity across sessions and devices

What Makes a Visitor “Known”?

Digioh considers a visitor “known” to Braze if any of the following has occurred:

• Digioh collected their email on that device (via a campaign form submission)
• They arrived at your site via a Braze campaign email link
• The Braze Web SDK is installed and the visitor has engaged with Braze before on that browser

Prerequisites

Braze Setup

• Active Braze account with API access
• Braze Web SDK installed on your site
• Segments and custom attributes configured in Braze (as needed for targeting)

Digioh Setup

• Active Digioh account with JavaScript extensions enabled
• Digioh campaigns (pop-ups, forms, banners) ready to use
• Braze integration added in Digioh (see Step 1 below)

Setup Instructions

Step 1: Install the Extension

1. In Digioh, hover over your profile icon in the top right and select Extensions.
2. Scroll to the Platform Interoperation section.
3. Find Owned Identity for Braze and click Install.
4. Click Publish to Your Site to push the extension live.

Step 2: Connect Braze

1. In Digioh, go to Integrations and click Add Integration. Search for Braze and select it.
2. Enter your Braze API credentials.
3. Save the integration id: Note the 5-digit Integration ID shown on the Integrations page – you will need this in Step 3.

Step 3: Add Account Metadata

This step links the extension to your Iterable integration.

1. From the profile menu (top right), select Account Metadata.
2. Add the following key-value pair:
   Key:   tpau_proxy_integration_id
   Value: [Your Braze Integration ID from Step 1]
   
3. Click Save, then go to Campaigns and select More > Publish Account.

Once this is complete, Passport for Braze becomes active on your site.

Using Passport in Digioh Campaigns

How It Works

When a visitor arrives on your site:

1. The extension checks whether you already know who this visitor is in Braze.
2. If they are known, their Braze profile data loads instantly.
3. Campaign content updates based on who they are and which conditions are met.
4. All interactions (views, submissions, clicks) are tracked automatically to Braze.
5. Any new data captured updates their Braze profile.

Example Scenarios

New Visitor

• Sees a standard welcome message
• Signs up for your newsletter
• A new Braze profile is created
• Next visit shows a personalized message

Returning Customer

• Recognized instantly via their Braze profile
• Sees a VIP welcome message and special offers
• All actions are tracked to their profile

 Email Subscriber Clicking from a Campaign

•  Arrives via a Braze campaign email
• Identified automatically – no form submission needed
• Personalized on-site content appears right away

Targeting Ideas

Use Braze segment data to control which campaigns are shown:

• VIP Customers: show special offers to your best customers
• New Subscribers: welcome new email sign-ups
• Lapsed Customers: re-engage people who have not purchased in a while
• Location-Based Offers: tailor messages by city, state, or country

Targeting Condition Examples

Below are examples of the JavaScript Variable conditions you can use in Digioh campaign display rules:

Show to Active Subscribers:

tpau.known === true && tpau.email_subscription_status === ‘subscribed’

Target High-Value Customers:

tpau.known === true && tpau.lifetime_value > 500

Recent Purchasers:

tpau.known === true && tpau.days_since_last_purchase < 30

Personalization Examples

Use merge tags in your Digioh campaign text to pull in Braze profile data. These follow the format:

[BRAZE_FIELD|field_name|default_value]

Greet returning users:

Welcome back, [BRAZE_FIELD|first_name|there]!

Display membership level:

Your membership level: [BRAZE_FIELD|membership_tier|Standard]

Reference recent purchase:

Based on your recent purchase of [BRAZE_FIELD|last_product|our products]…

Tracking Events Automatically

The extension automatically records the following events to Braze:

• When campaigns are shown or closed
• When forms are submitted
• When users click or interact with campaigns
• Which pages users see in multi-step campaigns

Tip: You can also set up custom events for things like button clicks or time spent viewing content.

Best Practices

Clean Data

• Keep emails consistent across platforms (avoid typos)
• Remove duplicate Braze profiles regularly

Smart Segmentation

• Create meaningful audience groups in Braze before building targeting rules
• Update segments as your list grows

Respect Privacy

• Always include clear privacy notices in your campaigns
• Offer easy opt-out paths
• Follow applicable privacy laws

Test and Optimize

• Start with simple personalization and build from there
• A/B test personalized messages vs. generic ones
• Monitor engagement and conversion rates over time

Advanced Tips

• Dynamic Content: show tailored product recommendations based on Braze purchase history attributes.
• Cross-Channel Follow-Ups: trigger Braze emails, SMS, or push notifications after campaign interactions.

Getting Started Checklist

• Braze account set up and configured
• Braze Web SDK installed on your site
• Braze integration connected in Digioh
• Passport extension installed and published
• Targeting and personalization rules created for relevant campaigns
• Test completed using ?boxqamode on your site

For questions or assistance, contact the Digioh support team at support@digioh.com.