skills/analyst-reporting/SKILL.md
Performance measurement across push, webhooks, content cards, LINE, KakaoTalk, banners, and landing pages.
npx skillsauth add delta-and-beta/braze-agency analyst-reportingInstall 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 ─────────────────────────────────────
The skill development guide establishes a clear tension: SKILL.md should be lean (~1,500–2,000 words) while the topic list here spans 24 distinct areas. The right approach is to synthesize themes and direct Claude toward topic references rather than restating every metric — this is exactly the "progressive disclosure" pattern the guide enforces.
─────────────────────────────────────────────────
This skill provides analytical guidance for measuring and interpreting campaign performance across all Braze messaging channels — including push notifications, webhooks, Content Cards, LINE, KakaoTalk, banners, and landing pages. Apply this skill to diagnose campaign health, benchmark channel performance, attribute conversions, and navigate Braze's reporting infrastructure to surface actionable insights.
The analytical lens here is metric interpretation, performance benchmarking, and conversion attribution — not configuration or send mechanics. Use this skill when the question is "how is it performing?" not "how do I set it up?"
Each Braze channel surfaces metrics through the campaign details page or Canvas analytics. The measurement approach differs by channel — particularly around open and click tracking:
Push Notifications Push reporting follows the standard messaging analytics structure: impressions, opens, direct opens, influenced opens, bounces, and conversions. When benchmarking push performance, distinguish between direct and influenced opens, as influenced opens reflect background engagement that wouldn't appear in direct-click attribution.
Webhooks Webhook reporting tracks delivery and error rates rather than engagement metrics. Successful delivery is confirmed at the HTTP response level. Because webhooks drive backend actions (not user-facing impressions), analyze them by error rate, retry behavior, and downstream conversion events — not open or click rates.
Content Cards Content Card reporting operates at both campaign and Canvas step level. Key metrics include impressions, clicks, dismissals, and card-level CTR. Content Cards persist in the feed, so retention of card views over time matters more than single-send opens.
LINE Open and click statistics for LINE are calculated only for users who have opted into Braze's tracking. Report on message-level delivery and conversion events; do not treat raw open rates as representative of full audience reach.
KakaoTalk KakaoTalk campaign and Canvas reports are available through the standard Braze dashboard. Apply the same messaging analytics model as other channels — impressions, opens, conversions — calibrated to the KakaoTalk delivery context.
Banners Banner analytics provide campaign-level and message-level performance data. Navigate to the Banner campaign in the Braze dashboard to access impression, click, and conversion breakdowns.
Landing Pages
Landing page tracking integrates with the Braze Web SDK. The SDK initializes on form submission or when a {% landing_page_url %} Liquid tag resolves for a known user. Track form submission events as conversion events; link submitted profiles to existing Braze users via the Liquid tag to avoid duplicate profile creation.
Conversion events are the primary mechanism for measuring campaign impact beyond direct engagement. When analyzing conversions:
To isolate the causal impact of messaging (rather than correlation with user behavior), use Global Control Group reporting. Compare conversion behavior between:
This methodology controls for organic user activity. When reporting campaign ROI, reference Global Control Group data to separate lift from baseline.
Funnel reports visualize user progression through a series of events after receiving a campaign or Canvas. Key parameters:
Use funnel reports when conversion is multi-step (e.g., receive → open → add to cart → purchase). Single-step conversion events won't reveal where users abandon the flow.
Report Builder (New) enables granular, customizable reports using campaign and Canvas data. Supports:
Legacy Report Builder supports multi-campaign comparison in a single view. Use for identifying which engagement strategies most affected key metrics across time periods. Supports CSV export.
Engagement Reports aggregate engagement statistics for campaigns and Canvases and deliver them as email with downloadable CSV files. Requires Export User Data permission. Schedule these for recurring stakeholder reporting.
Retention reports track whether users return and perform a defined action over time after an initial event. Use retention reports to measure whether a campaign improves long-term behavioral patterns, not just immediate conversions.
Located at Analytics > Revenue Report. View revenue over time, by product, and as total app revenue. Filter by:
Cross-reference revenue spikes with campaign send dates to identify revenue attribution opportunities.
Break down performance metrics by segment using Query Builder report templates. Analytics tracking must be enabled for each segment before use. Segment-level breakdowns reveal whether a campaign performs differently across audience cohorts — critical for personalization benchmarking.
Dashboard Builder enables custom reporting dashboards combining multiple data visualizations. Use for executive reporting or ongoing channel health monitoring across campaigns.
When interpreting performance, apply this hierarchy:
Avoid comparing raw open counts across channels — delivery mechanics differ. Use rates (open rate, CTR, conversion rate) for cross-channel benchmarking.
Braze sends a weekly email analytics report summarizing app and campaign performance automatically. To manage subscriptions:
For custom reporting schedules, use Engagement Reports (for campaign CSVs) or the Report Builder with scheduled delivery.
The following topic files in references/ contain detailed metric definitions, dashboard navigation paths, and channel-specific reporting nuances:
| Topic | File | Content |
|---|---|---|
| Analytics Overview | references/analytics-overview.md | Dashboard entry points |
| Campaign Analytics | references/campaign-analytics.md | Campaign-level metrics |
| Canvas Analytics | references/canvas-analytics.md | Canvas step metrics |
| Push Reporting | references/push-reporting.md | Push-specific metrics |
| Webhook Reporting | references/webhook-reporting.md | Delivery and error tracking |
| Content Cards Reporting | references/content-cards-reporting.md | Card-level CTR and retention |
| LINE Reporting | references/line-reporting.md | Open/click tracking scope |
| KakaoTalk Reporting | references/kakaotalk-reporting.md | KakaoTalk dashboard access |
| Banner Analytics | references/banner-analytics.md | Banner impression and click data |
| Conversion Events | references/conversion-events.md | Attribution windows and types |
| Landing Page User Tracking | references/landing-page-user-tracking.md | Liquid tag and SDK init |
| Landing Page Tracking Data | references/about-landing-page-tracking-data.md | Web SDK initialization details |
| Reporting Overview | references/reporting-overview.md | Dashboard navigation |
| Revenue Report | references/revenue-report.md | Revenue filters and views |
| Retention Reports | references/retention-reports.md | Long-term behavioral retention |
| Report Metrics | references/report-metrics.md | Metric definitions glossary |
| Report Builder | references/report-builder.md | Current Report Builder guide |
| Report Builder (Legacy) | references/report-builder-legacy.md | Legacy comparison reports |
| Global Control Group | references/global-control-group-reporting.md | Causal lift measurement |
| Funnel Reports | references/funnel-reports.md | Multi-step funnel analysis |
| Engagement Reports | references/engagement-reports.md | CSV export and scheduling |
| Data by Segments | references/data-by-segments.md | Segment breakdown queries |
| Configuring Reporting | references/configuring-reporting.md | Weekly report setup |
| Dashboard Builder | references/dashboard-builder.md | Custom dashboard creation |
Apply this skill when questions involve:
★ Insight ─────────────────────────────────────
The topic reference table at the end is a deliberate architectural choice — it maps human-readable topics to file paths so Claude can load only the relevant reference file rather than scanning all 24 topics. This keeps the SKILL.md body under 2,000 words while keeping the full knowledge base accessible.
─────────────────────────────────────────────────
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.