Braze Onboarding Automation Setup for Retail Brands in APAC

Getting your Braze onboarding automation setup for a retail brand right the first time saves months of rework and directly impacts 90-day customer retention. This tutorial walks through the exact event taxonomy, Canvas configurations, data pipeline architecture, and channel cadences that Branch8 deploys for retail clients across Singapore, Malaysia, the Philippines, and the wider Asia-Pacific region.

Whether you're a US or European retail brand expanding into APAC, or a regional retailer scaling cross-border, this guide covers the practical steps — including code snippets and tool-specific configurations — to build onboarding flows that convert first-time buyers into repeat customers.

Why Does Onboarding Automation Matter for APAC Retail?

Retail brands operating across Asia-Pacific face a unique challenge: each market has different dominant messaging channels, language preferences, and purchase behaviors. A single global onboarding sequence won't work when your Singapore customers prefer email and WhatsApp, your Philippine customers respond to push notifications and Viber, and your Malaysian audience engages most on SMS.

According to Braze's 2024 Global Customer Engagement Review, brands using cross-channel messaging in onboarding see a 73% higher purchase rate within 30 days compared to single-channel approaches (Braze, 2024). That gap widens in APAC markets where channel fragmentation is more pronounced than in North America or Europe.

The goal of a Braze onboarding automation setup for any retail brand is straightforward: guide new customers from account creation or first purchase through a structured sequence that builds brand familiarity, drives a second purchase, and collects the preference data you need for long-term personalization.

How to Structure a Braze Data Pipeline for Retail

Before you touch Braze's Canvas builder, you need clean data flowing in. The most common mistake Branch8 sees with retail clients is building onboarding Canvases before the data pipeline is properly structured. Here's how to structure a Braze data pipeline for retail that supports both onboarding and lifecycle marketing.

Related: our guide on how to structure

Define Your Event Taxonomy First

Every retail Braze implementation needs a standardized event taxonomy. Here's the minimum event set we recommend for onboarding:

1{
2  "events": [
3    {
4      "name": "account_created",
5      "properties": {
6        "signup_source": "string",
7        "market": "string",
8        "language_preference": "string",
9        "opt_in_email": "boolean",
10        "opt_in_sms": "boolean",
11        "opt_in_push": "boolean"
12      }
13    },
14    {
15      "name": "first_purchase_completed",
16      "properties": {
17        "order_id": "string",
18        "order_value": "number",
19        "currency": "string",
20        "product_categories": "array",
21        "payment_method": "string"
22      }
23    },
24    {
25      "name": "product_viewed",
26      "properties": {
27        "product_id": "string",
28        "product_category": "string",
29        "price": "number",
30        "currency": "string"
31      }
32    },
33    {
34      "name": "added_to_cart",
35      "properties": {
36        "product_id": "string",
37        "quantity": "number",
38        "cart_value": "number"
39      }
40    },
41    {
42      "name": "onboarding_preference_submitted",
43      "properties": {
44        "preferred_categories": "array",
45        "preferred_channel": "string",
46        "skin_type": "string"
47      }
48    }
49  ]
50}

The market and currency properties are critical for APAC. A customer in the Philippines (PHP) has fundamentally different price sensitivity thresholds than one in Singapore (SGD) or Australia (AUD). Bake market context into every event from day one.

Choose Your Data Integration Path

For Shopify Plus stores — which represent the majority of our APAC retail clients — you have three main options for piping data into Braze:

Related: Top 7 ERP Integrations for Shopify Plus APAC Merchants

• Direct Braze SDK + Braze Shopify Integration: Braze's native Shopify integration (available since 2023) handles purchase events, abandoned carts, and customer data syncing. It's the fastest path to production but offers limited transformation capabilities.
• Segment or mParticle as a CDP layer: If you're operating in 3+ APAC markets, a CDP like Segment (Twilio Segment) or mParticle gives you a single event schema that feeds Braze, your analytics warehouse, and ad platforms simultaneously. According to Twilio's 2024 State of Customer Engagement report, companies using a CDP alongside their engagement platform see 16% higher customer lifetime value (Twilio, 2024).
• Custom webhook pipeline via Shopify Flow: For mid-market brands not ready for a full CDP investment, Shopify Flow can trigger webhooks to Braze's /users/track API endpoint for key events.

Here's an example Segment track call that feeds into Braze via the Segment-Braze destination:

1analytics.track('first_purchase_completed', {
2  order_id: 'ORD-2024-SG-88291',
3  order_value: 127.50,
4  currency: 'SGD',
5  product_categories: ['skincare', 'moisturizer'],
6  payment_method: 'grabpay',
7  market: 'SG'
8});

Note the payment_method field — in APAC, payment method choice (GrabPay, GCash, Touch 'n Go, PayNow) is a strong signal for channel and offer personalization.

Set Custom Attributes for Market-Specific Segmentation

Beyond events, configure these custom attributes in Braze for each user profile:

1{
2  "custom_attributes": {
3    "primary_market": "SG",
4    "preferred_language": "en",
5    "customer_tier": "new",
6    "first_purchase_category": "skincare",
7    "first_purchase_value_usd": 94.20,
8    "days_since_signup": 0,
9    "total_orders": 1,
10    "preferred_messaging_channel": "whatsapp"
11  }
12}

The preferred_messaging_channel attribute is particularly important. In a 2023 Branch8 project for a Hong Kong-based skincare retailer expanding into Southeast Asia, we discovered through A/B testing that WhatsApp onboarding messages in Singapore achieved a 4.2x higher click-through rate than email. In the Philippines, push notifications outperformed both email and SMS by 3.1x. We set this attribute dynamically based on which channel each user engaged with first during the onboarding sequence, then used it to weight channel priority in subsequent lifecycle Canvases. The full implementation — from Segment event taxonomy design through Braze Canvas launch across three markets — took Branch8 seven weeks using a team of two CRM engineers and one strategist.

How Should You Configure Braze Canvas Entry Criteria?

The entry criteria for your onboarding Canvas determine who enters, when, and how they're segmented from the start. Getting this wrong means irrelevant messaging and inflated send volumes.

Primary Entry: Action-Based on Account Creation

In Braze Canvas, configure your entry as:

• Entry type: Action-Based
• Trigger action: Custom Event — account_created
• Entry window: Open (no end date for an evergreen onboarding flow)
• Entry limits: Once per user (critical — you don't want re-triggers)

Add Entry Audience Filters

Apply these filters to prevent existing customers from accidentally entering:

• total_orders equals 0 OR equals 1 (depending on whether you trigger onboarding at signup or first purchase)
• customer_tier equals "new"
• Has not received Canvas with tag "onboarding" (prevents overlap if you're migrating from an older flow)

Split by Market at Entry

Immediately after entry, add a Decision Split step based on the primary_market custom attribute:

• Path 1: SG (Singapore)
• Path 2: MY (Malaysia)
• Path 3: PH (Philippines)
• Path 4: Everybody Else

This split is essential because each path will have different channel priorities, language content, and compliance requirements. Singapore's PDPA, Malaysia's PDPA, and the Philippines' Data Privacy Act each have different consent mechanisms — your onboarding flow must respect market-specific opt-in status.

What Channel Cadences Work Best for Each APAC Market?

Here's the channel-specific cadence framework Branch8 uses for retail onboarding across Southeast Asia. These cadences assume the customer has opted into the relevant channels.

Singapore (SG) — 14-Day Sequence

• Day 0 (Immediate): Email — Welcome + brand story + 10% first-order incentive (if no purchase yet)
• Day 1: WhatsApp — Quick product quiz to capture preferences (using Braze's WhatsApp integration via Twilio)
• Day 3: Push notification — Curated product recommendations based on quiz results or browse behavior
• Day 5: Email — Social proof content (reviews, UGC from SG customers)
• Day 7: WhatsApp — Gentle nudge if no second purchase; highlight free shipping threshold
• Day 10: Push notification — Limited-time offer on previously viewed category
• Day 14: Email — Loyalty program introduction

Singapore's email open rates for retail hover around 21.5% according to Mailchimp's 2024 benchmarks (Mailchimp, 2024), but WhatsApp open rates consistently exceed 85% in our client data. Prioritize WhatsApp for high-intent messages.

Malaysia (MY) — 14-Day Sequence

• Day 0 (Immediate): Email — Welcome in English or Bahasa Malaysia (split by preferred_language)
• Day 1: SMS — Short welcome with app download CTA (SMS penetration remains strong in MY)
• Day 3: Push notification — Product recommendations
• Day 5: Email — Educational content about brand values
• Day 7: SMS — Ramadan/festive-specific offers (if applicable — use date-based Liquid logic)
• Day 10: Push notification — Cart reminder or category offer
• Day 14: Email — Referral program introduction

Philippines (PH) — 10-Day Sequence

Filipino consumers tend to convert faster but churn more quickly. According to Meta's 2024 APAC Commerce Report, the Philippines has the highest social commerce adoption rate in Southeast Asia at 68% (Meta, 2024). The onboarding cadence should be shorter and more offer-driven:

• Day 0 (Immediate): Push notification — Welcome + flash incentive (urgency-based)
• Day 0 (+2 hours): Email — Full brand introduction
• Day 2: Push notification — Trending products in their category
• Day 4: Email — GCash-specific payment promotion (payment method relevance)
• Day 6: Push notification — Social proof + UGC
• Day 8: Email — Bundle offer or free shipping threshold push
• Day 10: Push notification — Final onboarding offer with clear expiry

Implementing Liquid Logic for Multi-Market Content

Rather than building entirely separate Canvases for each market, use Braze's Liquid templating within shared message steps where the structure is similar:

1{% if ${custom_attribute.primary_market}} == 'SG' %}
2  Free shipping on orders over S$60!
3{% elsif ${custom_attribute.primary_market}} == 'MY' %}
4  Free shipping on orders over RM120!
5{% elsif ${custom_attribute.primary_market}} == 'PH' %}
6  Free shipping on orders over ₱2,500!
7{% else %}
8  Free shipping on qualifying orders!
9{% endif %}

For language switching:

1{% if ${custom_attribute.preferred_language}} == 'ms' %}
2  Selamat datang ke {{ brand_name }}! Nikmati diskaun 10% untuk pesanan pertama anda.
3{% else %}
4  Welcome to {{ brand_name }}! Enjoy 10% off your first order.
5{% endif %}

Which Shopify Plus Apps Support APAC Market Expansion?

Your Braze onboarding automation doesn't operate in a vacuum. The data quality and customer experience depend heavily on your Shopify Plus stack. Here are the top Shopify Plus apps for APAC market expansion that directly impact onboarding automation quality.

Multi-Currency and Localization

• Shopify Markets Pro: Shopify's native multi-market management handles currency conversion, duties estimation, and localized checkout. Essential for brands selling from a single Shopify Plus store into multiple APAC markets.
• Langify or Weglot: For storefront translation. Weglot supports auto-translation with manual override — critical for getting Bahasa Malaysia, Tagalog, or Traditional Chinese right.

Loyalty and Rewards Integration

• Smile.io or LoyaltyLion: Both integrate with Braze via webhooks or Segment. When a customer earns onboarding bonus points, you can trigger a Braze event (loyalty_points_earned) that feeds into your Canvas.
• Yotpo Loyalty: Offers deeper Shopify Plus integration and can pass review-submission events to Braze for social proof triggers in onboarding sequences.

Payments and Checkout

• GrabPay, Touch 'n Go, GCash via Shopify Payments or Checkout Extensions: Local payment method availability directly impacts conversion. According to a 2024 JP Morgan Payments report, e-wallets account for 60% of e-commerce transactions in Southeast Asia (JP Morgan, 2024). If your checkout doesn't support these, your onboarding flow is trying to retain customers who couldn't even complete a purchase.

Customer Data and CDP

• Littledata: Connects Shopify Plus server-side events to Segment with high accuracy, solving the client-side tracking gaps that iOS privacy changes introduced.
• Elevar: Another strong option for server-side tracking that feeds clean event data to your CDP and ultimately to Braze.

When evaluating the top Shopify Plus apps for APAC market expansion, prioritize those that emit clean, structured events compatible with your Braze event taxonomy. An app that doesn't expose event data to your CDP or Braze is a black box in your onboarding pipeline.

How Do You Measure Onboarding Automation Performance?

Set up these metrics as Braze Currents exports or via the Braze dashboard's Canvas analytics:

Primary KPIs

• Second purchase rate within 30 days: This is the north-star metric for retail onboarding. Benchmark varies by vertical, but Branch8 targets 18-25% for beauty/skincare and 12-18% for fashion across APAC.
• Onboarding completion rate: Percentage of users who reach the final step of your Canvas without churning out. Track via a custom event onboarding_completed triggered when the last message is sent.
• Channel engagement by market: Click-through rates segmented by primary_market and channel (email, push, WhatsApp, SMS). This data feeds back into your channel priority weighting.

Secondary KPIs

• Time to second purchase: Shorter is better. Track this as a custom attribute updated via a webhook from Shopify or your CDP when order #2 is placed.
• Preference data capture rate: What percentage of onboarding users complete a product quiz or preference center? According to Salesforce's 2024 State of Marketing report, 73% of customers expect companies to understand their unique needs (Salesforce, 2024). Capturing preferences during onboarding is your best window.
• Unsubscribe rate by Canvas step: Identify which messages in the sequence are causing opt-outs. If step 4 has a 3x higher unsub rate, the content or timing needs rework.

Setting Up a Braze Currents Export for Deeper Analysis

Braze Currents streams event-level data to your data warehouse (BigQuery, Snowflake, or Redshift). Configure a Currents connector to export:

• Canvas step engagement events (sends, opens, clicks)
• Custom events (purchase, preference submission)
• Unsubscribe and bounce events

This data, joined with Shopify order data in your warehouse, gives you the full picture of how onboarding messages drive revenue — something the Braze dashboard alone can't fully answer.

What Are Common Mistakes in Retail Braze Onboarding?

After implementing Braze onboarding automation for retail brands across five APAC markets, Branch8 sees these errors repeatedly:

Ignoring Timezone Differences Within a Single Market

Indonesia spans three time zones. Malaysia's East Malaysia (Sabah/Sarawak) has different lifestyle patterns than Peninsular Malaysia despite sharing a timezone. Use Braze's Intelligent Timing or at minimum set delivery to local timezone rather than a fixed UTC offset.

Over-Indexing on Discounts

A 10% welcome discount is standard, but if every onboarding message contains a discount, you're training customers to wait for promotions. Alternate between value-driven content (educational, social proof, brand story) and offer-driven messages at a 2:1 ratio.

Not Accounting for Festive Calendars

Ramadan, Chinese New Year, Deepavali, Christmas, and Hari Raya occur at different times and carry different significance across markets. Your onboarding Canvas should include Liquid-based conditional blocks that adjust messaging tone and offers during major festive periods.

Treating the Data Pipeline as an Afterthought

How to structure a Braze data pipeline for retail is not a question you answer after launch. If your event taxonomy is inconsistent — purchase_complete in one integration and order_placed in another — your Canvas entry criteria and filters will break silently. Define the taxonomy in a shared document before any engineering work begins.

Putting It All Together: Your Implementation Checklist

Here's the sequence Branch8 follows for every Braze onboarding automation setup for a retail brand entering or scaling within APAC:

• Define event taxonomy and custom attributes (Week 1)
• Configure data pipeline: Shopify Plus → Segment/mParticle → Braze (Week 2-3)
• Build Canvas structure with market splits and channel cadences (Week 3-4)
• Write and translate message content for each market (Week 4-5)
• QA data flow: verify every event fires correctly in Braze's Event User Log (Week 5-6)
• Soft launch to 10% of new signups per market (Week 6)
• Analyze early metrics, adjust timing and channel weighting (Week 7)
• Full launch with Currents export to data warehouse for ongoing optimization (Week 7-8)

This eight-week timeline assumes one dedicated CRM strategist and one integration engineer. Compress it at your own risk — the QA phase is where most teams find data pipeline issues that would have corrupted months of customer data.

If you're planning a Braze onboarding automation setup for your retail brand across APAC markets, Branch8's CRM engineering team can scope the implementation, configure your data pipeline, and launch market-specific Canvases. Reach out at branch8.com/contact to discuss your project.

Sources

• Braze (2024). Global Customer Engagement Review. https://www.braze.com/resources/reports-and-research/customer-engagement-review
• Twilio (2024). State of Customer Engagement Report. https://www.twilio.com/en-us/state-of-customer-engagement
• Mailchimp (2024). Email Marketing Benchmarks by Industry. https://mailchimp.com/resources/email-marketing-benchmarks/
• Meta (2024). APAC Commerce Discovery Report. https://www.facebook.com/business/news/apac-commerce-discovery
• JP Morgan (2024). E-Commerce Payments Trends: Asia-Pacific. https://www.jpmorgan.com/merchant-services/insights/reports/asia-pacific
• Salesforce (2024). State of Marketing Report, 9th Edition. https://www.salesforce.com/resources/research-reports/state-of-marketing/
• Braze Documentation. Canvas Entry Settings. https://www.braze.com/docs/user_guide/engagement_tools/canvas/create_a_canvas/create_a_canvas