Anonymous Tracking
    • 1 Minute to read
    • Dark
      Light

    Anonymous Tracking

    • Dark
      Light

    Article summary

    How Anonymous Tracking Works

    Anonymous tracking ensures that the SDK does not generate or store an everID in the local database, which prevents user recognition in Mapp Intelligence. This feature can be useful in scenarios where stricter data privacy requirements are in place, but it can have several impacts, including:

    • Session detection: It may cause session breaks.

    • User recognition: It suppresses user recognition across multiple sessions.

    • User matching: User matching between Mapp Engage and Mapp Intelligence will not work when anonymous tracking is enabled.

    You can configure anonymous tracking in the Global Configuration to enable it by default without providing an opt-in or opt-out option. Additionally, it is possible to control anonymous tracking during runtime.

    Important: Using this function will significantly reduce data quality. Only enable anonymous tracking if required by your data privacy manager.

    Update Notice

    As of version 5.1.5, the option to generate a new everID or retain the old one when switching from anonymous tracking back to user-centric tracking has been deprecated. If you previously used this feature, make sure to update your configuration accordingly.

    Limitations of Anonymous Tracking

    When anonymous tracking is active, the following functions are not available:

    • Migration from Intelligence v4 to Intelligence v5 without losing historical data.

    • GetEverId() and SetEverId().

    • User matching between Mapp Engage and Mapp Intelligence.

    Anonymous Tracking Configuration

    Data Fields

    Field

    Possible Values

    Description

    Default

    enabled: Boolean

    true, false

    Enables anonymous tracking. When enabled, the requests are sent without the everID.

    disabled

    suppressParams: Set<String>

    Set<String>

    Optionally suppress specific parameters (e.g., customer or order IDs) when anonymous tracking is enabled.

    empty

    setTemporarySessionId(sessionId:String)

    String

    Optionally set a temporary session ID to improve data quality during the session. This ID is stored in RAM and deleted when the app is closed.

    empty

    Methods

    Method

    Description

    abstract fun anonymousTracking(enabled: Boolean, suppressParams: Set<String>)

    Enables and disables anonymous tracking.

    Example Usage

    Enable Anonymous Tracking

    You can enable anonymous tracking and suppress specific parameters in your application:

    Webtrekk.getInstance().anonymousTracking(enabled=true,suppressParams= setOf("cd", "uc703", "uc1"))
    Webtrekk.getInstance().setTemporarySessionId("user-xyz-123456789")
    Set<String> mySet = new HashSet<>(Arrays.asList("cd", "uc703", "uc1"));
    Webtrekk.getInstance().anonymousTracking(true, mySet);
    Webtrekk.getInstance().setTemporarySessionId("user-xyz-123456789");

    Disable Anonymous Tracking 

    You can disable anonymous tracking via a function in your application:

    Webtrekk.getInstance().anonymousTracking(enabled=false)
    Set<String> mySet = new HashSet<>();
    Webtrekk.getInstance().anonymousTracking(false, mySet);


    Was this article helpful?

    What's Next