Skip to content

thatrebeccarae/claude-marketing / skills/braze

Braze customer engagement platform expertise. Audit campaigns, Canvases, segments, messaging channels, and data architecture. Use when the user asks about Braze, customer engagement, push notifications, in-app messaging, cross-channel orchestration, or lifecycle marketing at scale.

FileKindSize
.env.exampleother933 B
EXAMPLES.mdmarkdown23.2 KB
LICENSEother1.0 KB
REFERENCE.mdmarkdown8.7 KB
SKILL.mdskill md5.7 KB

REFERENCE.md

View on GitHub
# Braze Reference

## Data Model

### Users (Profiles)
- **external_id** — Primary identifier (from your system)
- **braze_id** — Braze-assigned internal ID
- **email** — Email address (for email channel)
- **phone** — Phone number with country code (for SMS/WhatsApp)
- **push_tokens** — Device tokens for push notifications
- **Standard Attributes** — first_name, last_name, email, phone, gender, dob, country, city, language, time_zone
- **Custom Attributes** — Any key-value pair (string, number, boolean, array, date, object)
- **Custom Events** — Timestamped actions with optional properties

### Events & Attributes

#### Standard Events
- `Purchase` — With product_id, currency, price, quantity
- `Session Start` / `Session End` — App session tracking
- `Push Notification Open` — Push engagement
- `Email Open` / `Email Click` — Email engagement

#### Custom Events
```json
{
  "name": "added_to_cart",
  "time": "2024-01-15T10:30:00Z",
  "properties": {
    "product_id": "SKU123",
    "product_name": "Widget Pro",
    "price": 49.99,
    "category": "electronics"
  }
}
```

### Subscription States
- **Email**: opted_in, subscribed (default), unsubscribed
- **Push**: opted_in, subscribed, unsubscribed
- **SMS**: subscribed, unsubscribed (requires explicit opt-in)
- **Subscription Groups** — Granular topic-based preferences

## Canvas Flow Reference

### Entry Schedule Types
| Type | Description | Use Case |
|------|-------------|----------|
| Scheduled | Recurring or one-time | Daily digest, weekly recap |
| Action-Based | Triggered by event | Abandoned cart, purchase |
| API-Triggered | Via REST API | Transactional, external trigger |

### Canvas Steps

#### Message Step
- Send email, push, SMS, in-app, Content Card, or webhook
- Supports Intelligent Timing, rate limiting, quiet hours
- A/B testing within step (up to 8 variants)

#### Action Paths
Branch users based on actions taken within a time window:
```
Action Paths
├── Purchased (within 3 days) → Thank you path
├── Added to Cart (within 3 days) → Nudge path
└── Everyone Else → Re-engage path
```

#### Audience Paths
Branch by user attributes/segments at a point in time:
```
Audience Paths
├── VIP Customers → Premium offer
├── New Customers → Welcome discount
└── Everyone Else → Standard message
```

#### Experiment Paths
A/B/n testing with statistical significance tracking:
- Winner auto-selection based on open rate, click rate, conversion, or revenue
- Configurable confidence level and holdout group

#### Decision Split
Binary yes/no filter on user attributes or behaviors

#### Delay
- Fixed time delay (hours, days)
- Until specific day/time
- Intelligent Timing (per-user optimal time)

#### User Update
Modify user attributes or subscription status within Canvas

### Canvas Settings
- **Re-eligibility** — Can users re-enter? After how long?
- **Rate limiting** — Max messages per minute
- **Frequency capping** — Max messages per channel per time period (global setting)
- **Exception events** — Exit Canvas early if event occurs (e.g., user converts)
- **Entry limits** — Max users entering per schedule

## Segmentation Reference

### Filter Categories
- **User Profile** — Standard and custom attributes
- **Engagement** — Email/push/SMS interactions, session recency
- **Purchase** — Purchase history, product, total spend
- **Custom Events** — Event occurrence, count, property values
- **Retargeting** — Clicked card, received campaign, in Canvas step
- **Technology** — App version, device model, OS, carrier
- **Location** — Country, city, most recent location
- **Testing** — A/B test membership, random bucket number

### Segment Extensions (Advanced)
For complex queries beyond standard filters:
- Event property filtering (e.g., "purchased product where category = electronics")
- Nested AND/OR logic
- Time-windowed event counts
- Regex matching on string properties

### Predictive Suite
- **Predictive Churn** — Likelihood to churn score (0-100)
- **Predictive Purchases** — Likelihood to purchase score (0-100)
- Both require 30+ days of data and sufficient user base

## Liquid Templating Reference

### Basic Variables
```liquid
{{${first_name} | default: "there"}}
{{${email}}}
{{custom_attribute.${loyalty_tier}}}
```

### Conditional Logic
```liquid
{% if ${first_name} != blank %}
  Hi {{${first_name}}},
{% else %}
  Hi there,
{% endif %}
```

### Connected Content (Dynamic API Calls)
```liquid
{% connected_content https://api.example.com/recommendations?user={{${user_id}}} :save recs %}
{% if recs.products.size > 0 %}
  Check out: {{recs.products[0].name}}
{% endif %}
```

### Catalogs (Built-in Product Data)
```liquid
{% catalog_items your_catalog_name {{custom_attribute.${favorite_product_id}}} %}
{{items[0].name}} - {{items[0].price}}
```

### Aborting Messages
```liquid
{% if ${email_subscribe} == "unsubscribed" %}
  {% abort_message("User unsubscribed") %}
{% endif %}
```

### Date Formatting
```liquid
{{${date_of_birth} | date: "%B %d"}}
{{ "now" | date: "%Y-%m-%d" }}
```

## API Reference

### Base URLs
```
REST API:  https://rest.iad-01.braze.com  (US-01)
           https://rest.iad-02.braze.com  (US-02)
           https://rest.fra-01.braze.eu   (EU-01)
SDK:       sdk.iad-01.braze.com (varies by instance)
```

### Authentication
```
Authorization: Bearer {REST_API_KEY}
```

### Key Endpoints

#### User Data
```
POST /users/track          # Send events, attributes, purchases
POST /users/identify       # Alias to external_id
POST /users/delete         # Delete users (GDPR)
POST /users/export/ids     # Export user data
POST /users/export/segment # Export segment
```

#### Messaging
```
POST /messages/send              # Immediate send
POST /messages/schedule/create   # Scheduled send
POST /campaigns/trigger/send     # API-triggered campaign
POST /canvas/trigger/send        # API-triggered Canvas
```

#### Catalogs
```
POST /catalogs                    # Create catalog
POST /catalogs/{name}/items       # Add items
PUT  /catalogs/{name}/items/{id}  # Update item
```

#### Subscription Groups
```
POST /subscription/status/set     # Update subscription
GET  /subscription/status/get     # Check subscription
```

### /users/track Example
```json
{
  "attributes": [{
    "external_id": "user123",
    "first_name": "Jane",
    "custom_attribute_key": "custom_value"
  }],
  "events": [{
    "external_id": "user123",
    "name": "viewed_product",
    "time": "2024-01-15T10:30:00Z",
    "properties": {"product_id": "SKU123"}
  }],
  "purchases": [{
    "external_id": "user123",
    "product_id": "SKU123",
    "currency": "USD",
    "price": 49.99,
    "time": "2024-01-15T10:35:00Z"
  }]
}
```

## Currents (Data Export)

### Supported Destinations
- Amazon S3, Google Cloud Storage, Azure Blob
- Snowflake, BigQuery, Databricks
- Mixpanel, Amplitude, Segment
- Custom webhook

### Event Types Exported
- Message engagement (sends, deliveries, opens, clicks, bounces)
- User behavior (sessions, custom events, purchases)
- Subscription changes
- Campaign/Canvas enrollment and conversion

### Data Format
- Avro format (default)
- JSON lines (configurable)
- Partitioned by event type and date

## Channel-Specific Reference

### Push Notifications
- **iOS**: Requires APNs certificate/key, provisional authorization available (iOS 12+)
- **Android**: FCM server key required
- **Web**: Service worker + VAPID keys
- Rich push: Images (2:1 ratio), action buttons (up to 4), custom sounds
- TTL (Time to Live): Default 30 days, configurable per message

### In-App Messages
- **Types**: Slideup, modal, full-screen, custom HTML
- **Triggers**: Session start, custom event, push click
- **Priority**: Can stack, configure display priority
- **Dark mode**: Automatic support with color tokens

### Content Cards
- **Types**: Banner, captioned image, classic (icon + text)
- **Persistence**: Stay in feed until dismissed or expired
- **Personalization**: Liquid + Connected Content supported
- **Analytics**: Impressions, clicks, dismissals

### Email
- Drag-and-drop editor or custom HTML
- Dynamic content with Liquid/Connected Content
- AMP for Email support
- Link aliasing for click tracking
- Preference center (built-in or custom)

### SMS/MMS
- Short code, long code, or alphanumeric sender ID
- Keyword processing (STOP, HELP, custom)
- Link shortening with tracking
- MMS: Images, GIFs, vCards

## IP Warming Schedule

| Week | Daily Volume | Target Audience |
|------|-------------|-----------------|
| 1 | 5,000-10,000 | Most engaged (opened in 30 days) |
| 2 | 20,000-40,000 | Engaged (opened in 60 days) |
| 3 | 50,000-100,000 | Active (opened in 90 days) |
| 4 | 200,000+ | Broader audience |
| 5+ | Full volume | Full list with sunset |

Monitor: Delivery rate >97%, bounce rate <3%, spam complaint <0.08%.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall