NetEase Cloud Music Tracking Management Platform: Architecture and Implementation Practices

This article introduces the tracking management platform developed by NetEase Cloud Music (云音乐) for managing client-side data tracking events. The platform is built upon the "Dawn Tracking" (曙光埋点) solution, which implements unified automated tracking and链路追踪 based on a consistent multi-end tracking object tree.

The platform addresses the entire tracking R&D lifecycle including metadata management, tracking design, development, testing, and deployment. It adopts a version-controlled approach similar to Git, with features like requirement groups (branches), change lists, and version tags, but adapted for client R&D workflows with support for partial change deployment and complex hierarchical object structures.

The article details solutions to three major challenges encountered during implementation:

1. Quality Issues: Implemented real-time tracking validation that generates validation trees based on task requirements, validates client-reported logs, and blocks deployment if validation fails. Also built online audit functionality using ClickHouse for log analysis, detecting issues like missing parameters, incorrect parameter values, and attribution errors. This reduced online tracking errors by 95%.

2. Efficiency Issues: Developed template engine to automatically generate tracking code for Android, iPhone, Web, and React Native platforms. Created tracking DIFF functionality to visualize changes (additions, modifications, deletions) with color-coded backgrounds.

3. Stale Tracking Issues: Implemented automatic rebase functionality that pulls latest Master changes for tracking items in development but not yet released, calculating atomic change lists and merging them automatically.

The platform also supports "bridge" mode for handling embedded scenarios where one app (e.g., Cloud Music APP) embeds other services (e.g., LOOK Live APP, H5 pages), allowing tracking trees from different spaces to be connected.

Future plans include extending the platform to support server-side tracking and hybrid client-server tracking scenarios.