Technical implementation of Shopify-Braze integrations including standard, custom, and catalog sync configurations.
references/ files; SKILL.md just needs enough to route Claude correctly and fast.─────────────────────────────────────────────────Here is the generated skill body:
This skill covers the technical implementation of Shopify-Braze integrations — from first-time setup through advanced catalog sync, multi-store orchestration, and headless storefront configurations. Apply this skill when the task concerns how Shopify data flows into Braze, how events are tracked and attributed, or how storefront architectures (standard, Hydrogen, headless) connect to Braze services.
Lens: Data synchronization, event tracking, and storefront integration patterns.
This means approaching every question through the lens of: what data moves, when does it move, and how does the storefront architecture shape that movement? Attribution, payload shape, sync latency, and webhook reliability are first-class concerns here. UX or campaign-side questions (e.g., Canvas design, segmentation logic) are out of scope — route those to the appropriate messaging or data skill.
Use this skill to answer questions about:
If the question is about what a Shopify integration can do (feature overview), consult the Shopify Integration Overview topic. If it concerns how to implement a specific configuration, consult the relevant setup topic below.
This skill draws from the following topic references:
| Topic | Focus |
|---|---|
| Shopify Integration Overview | High-level feature set, supported use cases, prerequisites |
| Shopify Standard Integration | Setup steps for the native Braze-Shopify connector |
| Shopify Standard Integration — Third-Party Tagging | Layering GTM or similar tools over the standard integration |
| Shopify E-commerce Overview | Commerce event model and how Shopify events map to Braze |
| Shopify Data Features | Tracked events, example payloads, historical backfill, product sync mechanics |
| Shopify Custom Integration | Hydrogen stores and headless Shopify — custom storefront setup |
| Shopify Catalogs | Syncing Shopify product catalog to Braze Catalogs for personalization |
| Shopify Multiple Stores | Multi-domain workspace configuration and cross-market orchestration |
| Shopify Discount Codes | Sending unique Shopify discount codes via Braze promotion codes |
Three primary integration patterns exist. Match the pattern to the storefront architecture before recommending a configuration:
Standard Integration The native Braze app in the Shopify App Store. Installs a script tag automatically. Suitable for standard Shopify storefronts. Covers checkout events, order lifecycle events, and customer data sync out of the box.
Standard Integration + Third-Party Tagging The standard integration script tag runs alongside a tag manager (e.g., GTM). Requires careful event deduplication — the same Shopify event must not fire twice into Braze. Consult the third-party tagging topic for sequencing and conflict avoidance.
Custom Integration (Headless / Hydrogen) For Shopify Hydrogen stores or any headless storefront that does not use Shopify's standard theme engine. Requires manual instrumentation of Braze Web SDK calls. Events must be explicitly mapped and fired — nothing is automatic. Consult the custom integration topic for setup patterns and required event contracts.
When debugging or designing data flows, apply these first principles:
Detailed payloads, setup walkthroughs, and configuration examples are in the topic reference files for this skill. When a question requires specifics — exact event names, payload field definitions, step-by-step setup sequences — load the relevant topic reference rather than relying on this overview.
For questions that cross Shopify into broader Braze data concepts (Catalogs architecture, promotion code mechanics, workspace configuration), coordinate with the Data Activation or Workspace Configuration skills as appropriate.
★ Insight ─────────────────────────────────────
─────────────────────────────────────────────────