Metric Filter Management¶
Overview¶
Metric Filter Management is a feature that excludes event data generated from QA servers or test app IDs when aggregating metrics.
It defines exclusion targets based on server ID or app ID conditions for event data, rather than at the user level.
Note
The menu and list are visible to all users. Adding, deleting, and editing are available only to users registered in Settings > Metric Settings > Access Permission Management.
What Can You Do?¶
Business/Marketing Users¶
- If metric values look abnormally high, you can quickly resolve the issue simply by asking an administrator to check whether QA server or test app filters are configured.
Data Analysts¶
- By checking the metric filter list, you can immediately see which server or app data is excluded from current aggregation.
- If there is an anomaly in metric values, reviewing the filter settings can help you find the cause quickly.
Quick Start¶
If you are adding a metric filter for the first time, follow the steps below to exclude a QA server or test app ID.
- Click Settings > Metric Settings > Metric Filter Management in the left sidebar.
- Click the + Register button in the top right.
- Enter a filter name.
- After selecting a Project, choose the attribute type to filter as either Server ID or App ID, then select a value.
- Click the Save button.
Note
For detailed features such as metric filter registration and deletion, refer to Full Features.
Full Features¶
Key Concepts¶
| Concept | Description |
|---|---|
| Metric Filter | A rule that excludes specific event data from aggregation based on server ID or app ID conditions |
| Server ID | A server identifier for test environments such as QA or staging. Events generated on that server are not actual user data |
| App ID | An app identifier used for development or testing. Events sent with that app ID need to be excluded from aggregation |
View Metric Filter List¶
View the list of metric filters currently applied. 
| Display Item | Description |
|---|---|
| Management Name | Name used to identify the metric filter |
| Project | Project to which the metric filter applies |
| Attribute | Name of the attribute the filter applies to (server ID or app ID) |
| Attribute Value | Filter value according to the attribute |
Create Metric Filter¶
Define conditions for server ID or app ID to exclude from aggregation.
| Item | Description |
|---|---|
| Management Name | Name used to identify the metric filter |
| Project | Project to which the metric filter applies |
| Attribute | Name of the attribute the filter applies to (server ID or app ID) |
| Attribute Value | Filter value according to the attribute |
Delete Metric Filter¶
- Editing is not supported. If conditions need to change, delete and register again.
- After deletion, the user's event data will be included in aggregation again.
Example Use Cases¶
Exclude QA Server Events¶
Management Name: QA Server
Project: Analytics
Attribute: Server ID
Attribute Value: select "qa-server-001", "qa-server-002"
-> All events generated on the QA server are excluded from metric aggregation.
Exclude Test App ID¶
Management Name: FGT App ID
Project: Analytics
Attribute: App ID
Attribute Value: select "com.example.analytics.fgt"
-> Events sent with the test app ID are excluded from aggregation.
How Is This Different from Metric Excluded User Management?¶
| Category | Metric Excluded User Management | Metric Filter Management |
|---|---|---|
| Exclusion Basis | User ID (userId, deviceId) | Server ID, App ID |
| Main Target | Internal staff, individual QA account | Entire QA server, test app ID |
| Use Case | Exclude a specific QA staff account | Exclude all QA server events |
Notes & Tips¶
- If you delete a filter, event data from that server ID or app ID will be included in aggregation again, and metric values may change.
- If server ID (serverId) or app ID (appId) attributes are not included when events are sent, the filter will not work. Confirm the attribute transmission rules with the development team first.
Related Menu¶
- Metric Excluded User Management - Exclude aggregation by specific user (playerId)
- Event - Check the event attributes used in filter conditions
