Skip to main content
Version: 1.0.0

Appxiom Data Collection Control

The Appxiom SDK automatically collects comprehensive device and system data points to provide detailed context for issue analysis and debugging. However, you have complete control over what data is collected and transmitted to maintain privacy compliance and meet your application's specific requirements.

Overview of Data Collection

The SDK collects device information to enhance issue reporting with contextual data that helps in:

  • Issue Diagnosis: Understanding device-specific problems and compatibility issues
  • Performance Analysis: Correlating performance with device capabilities and system state
  • User Experience Optimization: Identifying patterns across different device configurations
  • Debugging Context: Providing essential system information for effective troubleshooting

Privacy Control Implementation

Basic Data Filtering

Use the @AX annotation with maskedDeviceData parameter to prevent specific data points from being collected:

@AX(maskedDeviceData = {"model", "brand"})
public class BlogApp extends Application {
@Override
public void onCreate() {
super.onCreate();
Ax.init(this, appKey, platformKey);
}
}

Advanced Privacy Configuration

For comprehensive data filtering, you can mask multiple data points simultaneously:

@AX(maskedDeviceData = {
"model", "brand", "manufacturer",
"telephonyData", "batteryLevel", "timezoneOffset"
})
public class PrivacyFocusedApp extends Application {
@Override
public void onCreate() {
super.onCreate();
Ax.init(this, appKey, platformKey);
}
}

Available Data Points and Masking Keys

The following table details all collectible data points and their corresponding masking keys for the @AX annotation:

Data PointMasking KeyDescription
Device ModelmodelSpecific device model (e.g., "Pixel 6", "Galaxy S21")
Device BrandbrandDevice manufacturer brand (e.g., "Google", "Samsung")
ManufacturermanufacturerCompany that manufactured the device
Custom OScustomOsAndroid Internal OS version and custom ROM information
Telephony DatatelephonyDataCarrier, SIM, and network signal information
Build DisplaybuildDisplaySystem build display information
OS VersionosVersionOperating system version
Battery LevelbatteryLevelCurrent device battery percentage
Last Reboot TimelastRebootTimeElapsed time since device last restarted
Timezone OffsettimezoneOffsetDevice timezone offset from UTC

Frequently Asked Questions (FAQ)

Q: What happens when I mask a data point using the @AX annotation?

A: When you include a data point key in the maskedDeviceData array, the Appxiom SDK completely skips collecting that specific information. The data point will not be transmitted to the dashboard or stored anywhere.

Q: Can I change the masked data points after the app is deployed?

A: No, the @AX annotation is compile-time configuration. To change data collection settings, you need to update the annotation and release a new app version.

Q: Are there any data points that are always collected regardless of masking?

A: The SDK always collects essential app information like package name, version, and basic issue data needed for core functionality. Device-specific data points can be masked using the annotation.

Q: Can I apply different masking rules to different parts of my application?

A: No, the @AX annotation with maskedDeviceData applies globally to your entire application. All data collection uses the same masking configuration.

Q: How do I verify that data masking is working correctly?

A: Check the Appxiom dashboard to confirm that masked data points don't appear in issue reports.

Q: How long is collected data retained in the Appxiom dashboard?

A: Data retention policies are managed in the Appxiom dashboard settings. Reach out to Appxiom support for specific retention periods and compliance options.

Q: Can I delete collected data for compliance requests?

A: Yes, the Appxiom dashboard provides data deletion capabilities to support GDPR data subject requests and other compliance requirements.

Q: Why aren't some data points appearing in my issue reports?

A: Check your @AX annotation to ensure you haven't accidentally masked required data points. Also verify that device permissions are granted for data collection.

Q: What happens if I specify an invalid key in the maskedDeviceData array?

A: Invalid keys are safely ignored by the SDK. Only valid data point keys will affect data collection behavior.