skills/analyst-tracking/SKILL.md
Configuring and analyzing user tracking for email, installs, segments, and influenced opens.
npx skillsauth add delta-and-beta/braze-agency analyst-trackingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
★ Insight ─────────────────────────────────────
This is a reference-type skill (domain knowledge, not a discipline-enforcing rule). The structure differs: prioritize "when to use" triggers, a lens description, and topic summaries that act as a lookup index — not Red Flags tables or rationalization counters.
─────────────────────────────────────────────────
Here is the generated skill file body:
This skill covers how Braze captures, exposes, and enables analysis of user behavior signals — from the moment a push arrives to the moment a user uninstalls. Use it when configuring tracking infrastructure, interpreting engagement metrics, building attribution models, or diagnosing gaps in behavioral data.
This skill approaches tracking from the perspective of what caused a user action — not just whether an action occurred. Attribution in Braze is inherently multi-signal: a user may open an app because of a push, a follow-up email, or independently. Each tracking mechanism below produces a different kind of attribution signal, with different reliability characteristics.
Key analytical principles to apply throughout:
Provides the conceptual foundation for Braze's user tracking capabilities. Covers the data model for behavioral signals, how tracking state is stored on user profiles, and the scope of what Braze can and cannot measure natively. Start here when orienting a new analyst or auditing a workspace's tracking configuration.
Controls open and click tracking at the user-profile level via API. Useful for regional privacy compliance (e.g., disabling tracking for EU users). Covers the relevant profile fields, how to set them via REST API, and the downstream effect on email engagement metrics in dashboards and exports.
Attribution note: Open pixel tracking is inherently imprecise — Apple MPP pre-fetches pixels, inflating open counts. Click tracking is more reliable for behavioral attribution.
Distinguishes two push-attribution types:
Influenced opens extend the attributable impact of push campaigns beyond tap-throughs. The attribution window is workspace-level and should be calibrated to typical user re-engagement latency for your app.
Analyst watch-out: Widening the influenced open window inflates attributed opens. Treat influenced open volume as a sensitivity-dependent metric when comparing campaigns.
Braze detects uninstalls via silent push tokens rejected by FCM/APNs. Because the signal depends on OS-level token invalidation timing, counts are directional indicators — not exact figures. Silently rejected tokens may arrive delayed, and some devices never invalidate tokens cleanly.
Use uninstall data to identify trends (e.g., spike after a campaign) rather than as a precise cohort count. Uninstall rates work best as relative metrics: cohort A vs. cohort B, not as absolute churn figures.
Enables historical session, event, and revenue analysis for a specific segment. Without this setting enabled, only real-time statistics are available. Must be turned on explicitly per segment — it is not retroactive.
When diagnosing missing historical data in segment reports, check whether analytics tracking was active during the relevant time window.
Braze captures a user's most recent foreground location via GPS when the app is opened. Location data powers segmentation (e.g., users within X miles of a store), geotargeting for campaigns, and location-based filters.
Analyst note: "Most recent location" is a single point — not a history. Campaigns built on location data reflect where a user was when they last opened the app, which may lag their current location by hours or days.
| Signal | Reliability | Pitfall | |---|---|---| | Email opens | Low–Medium | Apple MPP inflates pixel-based opens | | Click-throughs | High | Best email attribution signal | | Direct push opens | High | Requires user to tap notification | | Influenced opens | Medium | Window width directly affects count | | Uninstall counts | Low–Medium | FCM/APNs timing makes exact counts unreliable | | Location | Medium | Single-point snapshot, not real-time | | Segment analytics | High | Only available if tracking was enabled beforehand |
★ Insight ─────────────────────────────────────
The Quick Reference table at the end is the most reusable pattern here — it gives future Claude instances a one-glance reliability calibration for each signal type, which is exactly what an attribution analyst needs when deciding which metrics to include in a report or stakeholder deck.
─────────────────────────────────────────────────
development
Cross-platform audience synchronization design across advertising platforms including Facebook, Google, TikTok, LinkedIn, and programmatic networks.
development
Defines cross-cutting API patterns for authentication, provisioning, preference management, and content delivery.
development
Covers API basics, authentication, rate limits, error codes, endpoint overview, data retention policies, and Postman collection usage.
development
Integration architecture for AI model providers including OpenAI, Google Gemini, and Anthropic within Braze messaging workflows.