thatrebeccarae/claude-marketing / skills/braze
braze
VerifiedBraze 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.
| File | Kind | Size |
|---|---|---|
| .env.example | other | 933 B |
| EXAMPLES.md | markdown | 23.2 KB |
| LICENSE | other | 1.0 KB |
| REFERENCE.md | markdown | 8.7 KB |
| SKILL.md | skill md | 5.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%.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |