Migrating from Version 3 to Version 4

You can always find our latest Android SDK version here. We recommend migrating to this version if you are still using version 3.

Proceed as follows to migrate from version 3 to version 4:

1. First, replace the version 3 "*.jar" SDK-file with the new version 4 "*.aar".

2. Configure your app by creating a new container in Mapp Tag Integration. For "trackDomain" and "trackID" use the values from your existing implementation.

   

   We recommend using the option for an external configuration.

3. Copy the configuration file “webtrekk_config.xml” to the resources folder of your Android module under “module/res/raw/”.
   
   

4. Replace your Mapp Intelligence initialization with “webtrekk.initWebtrekk()”.
   
   

5. Remove the “Webtrekk.activityStop()” and “Webtrekk.activityStart()” function calls from your code because these functions are now called automatically.

   

   Direct calls of these functions may produce unexpected results.

6. Choose automatic or manual tracking. These options can be set for the complete application or individual activity.

   

   Please keep in mind that individual activity tracking overwrites the global settings.

   • Automatic tracking of activities
     Use Tag Integration to set up this option.
     
     
   • Manual tracking of activities
     Create "trackingParameter"-objects and add required parameters. Then use “Webtrekk.track(TrackingParameter tp)” to add additional parameters for page tracking.
     
     

7. For a Cross Device Bridge integration, use special Cross Device Bridge requests instead of page or action requests “track(WebtrekkUserParameters userParameters)” (see section Implementing Cross Device Bridge below).