topic Re: Mobile User Tagging in Real User Monitoring

Mobile User Tagging

alejandro_herna — Fri, 30 Sep 2022 12:06:23 GMT

I've inplemented the Mobile monitoring of an Android App with command line Auto instrumentation and the client wants to identify the user with the user tagging, however I've never done that before and I need some advice. So far I know that I have to use the OneAgent SDK for mobile and I read in the documentation that I can add it by adding it to the dependencies with the next instruction:

dependencies {
implementation 'com.dynatrace.agent:agent-android:<version>'

}

and that I can do the tag with the instruction:

Dynatrace.identifyUser(<usertag>);

However is it not clear for me how to do the tag could you help me please?

Also I have inplemented the mobile monitoring with manual Instrumentation (developer) for IOS can you also tell me how to do the user tagging for IOS please.

Re: Mobile User Tagging

Thomas_Wirth1 — Fri, 27 Apr 2018 06:42:51 GMT

You have to add the OneAgent library as dependency to your project (in the file build.gradle) with

dependencies {
	implementation 'com.dynatrace.agent:agent-android:<version>'
}

, where version must be the equal to the version of the auto-instrumentor. The OneAgent library is now hosted on JCenter and MavenCentral, which allows you to easily upgrade the version. But in this case we recommend to use the Dynatrace Gradle plugin, because it automatically ensures that the version of the agent and auto-instrumentor are equal.

Re: Mobile User Tagging

alejandro_herna — Fri, 27 Apr 2018 14:17:39 GMT

Yeah I already know that, what is not clear for me is how to apply the tag.

Re: Mobile User Tagging

alejandro_herna — Fri, 27 Apr 2018 17:34:49 GMT

@Patrick H. Can you help me with this?

Re: Mobile User Tagging

Patrick_H — Wed, 02 May 2018 06:16:49 GMT

The tag is applied by using the API Dynatrace.identifyUser(<usertag>); where <usertag> is e.g. the users email address or a user id which you want to tag the session of a user.

Re: Mobile User Tagging

thiago_bien — Thu, 21 Jun 2018 16:33:19 GMT

@Patrick, where should the API be called/configured in the app in order to tag the session with the username?
Should the dev add that API call right after the login code, for example?
Only calling the API in one point of the APP will already tag the entire session successfully?

Re: Mobile User Tagging

pahofmann — Thu, 21 Jun 2018 17:56:28 GMT

Different Patrick, but I can still help 😉

Calling identifyUser will tag the entire session. The earlier the tagging is done, the earlier the tag will be available for live session. Doing it after the login would be fine. But it also is no problem if you do it later on, as long as the point where you call the API is always executed for every user.

Re: Mobile User Tagging

thiago_bien — Thu, 21 Jun 2018 18:39:21 GMT

Great! Thank you, Patrick!

Re: Mobile User Tagging

suresh230591 — Wed, 17 Apr 2019 07:18:52 GMT

Hi,

From where we should call this API Dynatrace.identifyUser("john.doe@example.com"); Is it possible to do this from GUI.

Re: Mobile User Tagging

Patrick_H — Wed, 17 Apr 2019 08:21:06 GMT

You call it when you know which user a session should be tagged with (e.g. after login finished or after app was started and you already know which user is logged in). It has te be set on every app restart as the user tag is not persisted.
I don't understand the GUI part of this question... but you can call it from everywhere

Re: Mobile User Tagging

ve00685603 — Thu, 05 Jun 2025 17:41:50 GMT

We are having ios native mobile application implemented to one of our customers. We would like to apply mobile usertag for iOS as well. Could you pls give some tips around this? Pls advise. Thanks

Re: Mobile User Tagging

Patrick_H — Fri, 06 Jun 2025 05:31:19 GMT

The documentation is here: https://docs.dynatrace.com/docs/shortlink/ios-oneagent-sdk#tag-specific-users
Other than that to ensure every session is tagged, set the tag either every time a user logs in or when the app is restarted either in applicationDidFinishLaunching callback or when the authenticated user session of the app is restored.