tester-data-exports

Validate Braze export and analytics data completeness and format.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/delta-and-beta/braze-agency --skill tester-data-exports
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tester-data-exports
Source: https://github.com/delta-and-beta/braze-agency/tree/main/skills/tester-data-exports
Command: npx skills add https://github.com/delta-and-beta/braze-agency --skill tester-data-exports

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides a comprehensive testing and validation workflow for Braze data exports and analytics so teams can detect incomplete exports, format errors, pagination issues, and cross-endpoint inconsistencies that lead to incorrect reporting or data loss.

Core Features & Use Cases

  • Bulk export lifecycle validation: Poll async export jobs, verify S3/Azure object prefixes or download URLs, and parse newline-delimited JSON files to confirm record counts and field shapes.
  • Analytics cross-checks: Compare segment and campaign analytics time series (DAU, revenue, sends, canvas) against raw exports to detect pipeline or attribution mismatches.
  • Edge-case and permission testing: Exercise cancellation semantics, rate-limit behavior, pagination cursors, and API key permission isolation to ensure robust error handling.
  • Use case: Run a large segment export, cancel mid-flight, and assert that no new output files appear while verifying segment size estimates match the assembled export within tolerance.

Quick Start

Run the tester-data-exports skill to poll a segment export job, download and parse NDJSON outputs, and compare exported user counts and key metrics against segment and campaign analytics for consistency.

Frequently Asked Questions about tester-data-exports

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate Braze export completeness and check for missing records?

You can validate Braze export completeness by polling asynchronous bulk export jobs, parsing NDJSON output files, and aggregating record counts to assert they match segment size estimates within configured numeric tolerance thresholds.

How do I compare Braze analytics time series against raw user exports?

Compare Braze analytics against raw exports by querying time-series endpoints for sends, canvas, kpi, and events, then cross-checking those metrics against assembled NDJSON export data to detect pipeline or attribution mismatches.

Does this data validation workflow handle pagination cursors and NDJSON parsing?

Yes, the workflow handles pagination cursor management for synchronous endpoints and parses newline-delimited JSON files from bulk exports to verify data consistency, format correctness, and complete record aggregation across pages.

How do I test Braze API key permission scopes and rate limits during data exports?

Test Braze API permission scopes and rate limits by exercising cancellation semantics during active export jobs, checking API key isolation, and verifying robust error handling when hitting pagination boundaries or permission restrictions.

What is the best way to verify Braze global control group export consistency?

The best way to verify Braze global control group export consistency is to poll the asynchronous export job, download the output files, parse the NDJSON records, and cross-reference aggregated user counts against analytics endpoints.

Why do my Braze segment exports show mismatched counts compared to analytics dashboards?

Mismatched counts between Braze segment exports and analytics dashboards often result from pagination issues, varying retention windows across endpoints, or pipeline attribution errors that require cross-endpoint consistency checks and NDJSON aggregation to detect.