4.5.0
HomePromoteAnalyze
Develop
Resources

Changelog

Version 4.5.0 (12th December 2023)

Changes

  • The UserEvent classes have been changed such that you can now submit named custom dimensions instead of dimensions custom1/2/3.

  • All predefined event classes have been renamed, some have been removed or merged. See the migration guide you received for more details.

  • forwardAdImpression now requires you to construct an AdImpression object instead of passing individual parameters.

Bug-Fixes

  • An issue was fixed on certain devices which would result in an invalid Advertiser ID to be reported.

  • An issue was fixed which would have caused some internal events to be duplicated in some cases.

Removed

  • The EventDetails class has been removed, the event name is now just a single string.

Version 4.4.1 (30th August 2023)

Changed

  • Methods returning Future<?> have been changed to return Future<Void> (which always resolves to null).

  • All methods returning Future<T> have been changed to return AsyncFuture<T>, allowing you to await the result from a coroutine using AsyncFuture.await.

  • JustTrackSdk.toPromise has been deprecated in favor of AsyncFuture.registerPromiseCallback.

Bug-Fixes

  • Fixed a bug which would cause some methods of the predefined events to get obfuscated.

  • Fixed a bug which would cause a crash if the AppSetId info is null.

  • The handling of being in restricted mode when targeting Android SDK 33+ has been improved.

Version 4.4.0 (14th July 2023)

Added

  • JustTrackSdk.getUserId was added to retrieve a future for the justtrack user id.

Changed

  • The justtrack SDK now provides the user and test group id without waiting for the justtrack backend.

  • JustTrackSdk.attributeUser was renamed to JustTrackSdk.getAttribution.

  • JustTrackSdk.onDestroy was renamed to JustTrackSdk.shutdown.

  • JustTrackSdk.getAffiliateLink was renamed to JustTrackSdk.createAffiliateLink.

  • JustTrackSdk.publishFirebaseAppInstanceId was renamed to JustTrackSdk.setFirebaseAppInstanceId.

  • Support was added to track in-app purchases made by version 6 of the BillingClient library.

  • The bounds of many dependencies have been relaxed. OkHttp has been removed as a dependency.

Removed

  • JustTrackSdk.getCachedAttribution was removed. Use getUserId or getAttribution instead.

  • The version of JustTrackSdk.integrateWithIronSource without any parameters was removed. Use integrateWithIronSource(IronSourceUserIdSource.JustTrack) instead.

  • SdkBuilder.setEnableIronSourceIntegration(booean) was removed. Use setEnableIronSourceIntegration(boolean, IronSourceUserIdSource.JustTrack) instead.

Bug-Fixes

  • The justtrack SDK no longer performs disk I/O on the main thread.

  • A potential deadlock has been removed when calling JustTrack.notifyAppStart from another thread while initializing the justtrack SDK at the same time.

Version 4.3.8 (29th March 2023)

Added

  • JustTrack.getInstance now returns the current SDK instance if one was already created.

  • setAutomaticInAppPurchaseTracking was added to configure automatic in-app purchase tracking. It is enabled by default.

Removed

  • You can now no longer manually forward in-app purchases. Use the automatic integration instead.

Version 4.3.7 (17th March 2023)

Added

  • runCallbacksOnMainThread was added to the SDK builder to ensure all callbacks from the SDK run on the main thread.

Bug-Fixes

  • Fixed a problem with the Unity Ads integration on minified builds.

Version 4.3.6 (2nd March 2023)

Added

  • forwardAdImpression can now be called with an arbitrary string parameter instead of an AdFormat.

  • integrateWithAdColony was added to automatically track ad impressions from AdColony.

  • integrateWithAppLovin was added to automatically track ad impressions from AppLovin.

  • integrateWithChartboost was added to automatically track ad impressions from Chartboost.

  • integrateWithUnityAds was added to automatically track ad impressions from Unity Ads.

Changed

  • The AdUnit enum was renamed to AdFormat and the RewardedVideo value was renamed to Rewarded. RewardedInterstitial, Native, and AppOpen have been added as new values, too.

  • The SDK now forwards the App Set ID to the backend.

Removed

  • The deprecated versions of forwardAdImpression have been removed.

Version 4.3.5 (16th December 2022)

Changed

  • Removed the length restriction for the in-app purchase token.

Version 4.3.4 (2nd December 2022)

Added

  • The SDK now provides a method to track in-app purchases.

Changed

  • You can now attach a currency to the events you are sending.

  • If you are forwarding ad impressions, you now have to specify the currency for the revenue of the event.

  • The integration with IronSource was changed to allow specifying the user id source.

Version 4.3.3 (26th October 2022)

Added

  • The SDK now provides the install source to the backend.

  • You can now provide a custom user id to the backend.

  • Support for deep links was improved.

Changed

  • The AD_ID permission was added to support Android 13.

  • The SDK now imposes restrictions about the data you can send to the backend.

  • The integration with Google Ads campaigns was improved.

Version 4.3.2 (4th August 2022)

Changed

  • The SDK now provides a method forwardAdImpression to report ad impressions to the justtrack backend.

Bug-Fixes

  • The SDK now validates the advertiser id before handing it out to an app.

Version 4.3.1 (7th July 2022)

Changed

  • Updated androidx.lifecycle:lifecycle-process from 2.4.1 to 2.5.0.

Bug-Fixes

  • The SDK now stores internal logs and metrics more carefully to avoid excessive memory usage.

Version 4.3.0 (6th May 2022)

Changed

  • The SDK now handles timeouts while collecting information for a correct attribution better. This will make it more likely to receive an attribution event after the initial Future resolves should you have registered a listener.

Version 4.2.9 (1st April 2022)

Changed

  • Renamed all occurrences of the Firebase instance id to Firebase app instance id. For example, publishFirebaseInstanceId is now called publishFirebaseAppInstanceId.

Bug-Fixes

  • The SDK now retrieves the Firebase app instance id instead of the Firebase (installation) instance id during automatic integration.

Version 4.2.8 (30th March 2022)

Added

  • The SDK can now automatically detect the Firebase instance id of a user and send it to the justtrack backend.

Changed

  • Updated androidx.lifecycle:lifecycle-process from 2.4.0 to 2.4.1.

  • Updated com.squareup.okhttp3:okhttp from 3.14.9 to 4.9.3.

  • The targeted Android SDK version was changed from 31 to 30.

Bug-Fixes

  • The SDK no longer crashes if it is destroyed while an HTTP request is still running.

  • The SDK no longer deadlocks if someone is publishing hundreds of events per second.

Version 4.2.6 (11th February 2022)

Changed

  • Updated com.google.android.gms:play-services-ads-identifier from 18.0.1 to 18.0.1.

  • The minimum Android SDK version was raised from 16 to 21.

  • Improved attribution precision.

Version 4.2.5 (17th December 2021)

Changed

  • Updated com.google.android.gms:play-services-ads-identifier from 17.1.0 to 18.0.0.

Version 4.2.4 (11th November 2021)

Added

  • The SDK now provides methods to get the advertiser id of the user and the test group id of the user.

Changed

  • The SDK now includes logic to retry fetching the attribution if it failed last time and some time has passed.

Bug-Fixes

  • The SDK no longer blocks upon handling a new intent, instead this is done on a worker thread.

  • The SDK no longer deadlocks when processing an event while handling an event produced from the session manager.

  • The SDK no longer reports the end of the last session a second time upon the next app start.

Version 4.2.3 (25th August 2021)

Changed

  • The SDK now automatically handles a network reconnect when fetching an attribution.

  • Improved the error messages when you try to use an invalid API token.

  • The SDK will now automatically send the revenue value with user events generated from ad impressions to the backend.

Version 4.2.2 (29th July 2021)

Changed

  • Increased version to align with unity version.

Version 4.2.1 (28th July 2021)

Changed

  • Increased likelihood that events reach the backend if the user is only using the app for a short time.

  • Removed session debouncing logic, this is now completely handled on backend side.

Bug-Fixes

  • Fixed a bug which could cause events to be published multiple times.

Version 4.2.0 (25th June 2021)

Changed

  • Events tracking the progress of a user for a level or quest have been extended to automatically track the progress of the user and provide the duration the app was active during that time upon completion.

  • The SDK no longer requests the READ_PHONE_STATE and ACCESS_WIFI_STATE permissions.

  • The session id is now included in all events sent to the backend.

  • setTrackingId now takes the provider of the tracking id as a second parameter.

  • There can be only a single instance of the SDK from now on.

  • Events without a unit are now tracked with a value of 0 (previously there were tracked with a value of 1).

Removed

  • Removed setRealTime from all interfaces again as well as realTime event functionality.

  • It is no longer possible to set the duration for progression events by hand.

Bug-Fixes

  • Fixed a bug where in some locales string would be converted to upper/lower case with the wrong locale.

Version 4.1.1 (18th Mai 2021)

Added

  • Added setRealTime to HasCustomDimensions to send predefined events without any delay.

Version 4.1.0 (17th Mai 2021)

Added

  • Added setRealTime to the UserEventBuilder to send events without any delay.

Removed

  • Removed setCurrentActivity from SdkBuilder interface as it is no longer required.

Changed

  • Replaced com.google.android.gms:play-services-ads:20.0.0 dependency with com.google.android.gms:play-services-ads-identifier:17.0.0.

  • Added new dependency androidx.lifecycle:lifecycle-process:2.3.1.

  • Events are now persisted until they reached the justtrack servers at least once.

  • Updated predefined user events:

    • Added UserCardShowEvent

    • Added UserNotificationClickEvent

    • Added UserCardClickEvent

    • Added AdOfferwallShowEvent

    • Added AdInterstitialShowEvent

    • Added AdRewardedShowEvent

    • Added AdBannerShowEvent

    • Changed unit on AdOfferwallCloseEvent from seconds or milliseconds to count.

    • Changed unit on AdInterstitialCloseEvent from seconds or milliseconds to count.

    • Changed unit on AdRewardedCloseEvent from seconds or milliseconds to count.

    • Changed unit on AdBannerCloseEvent from seconds or milliseconds to count.

Bug-Fixes

  • Fixed the timestamp on events which are constructed at app start and sent later.

Version 4.0.1 (30th April 2021)

Bug-Fixes

  • Fixed predefined events to publish their custom parameters with the correct dimensions.

Version 4.0.0 (22nd April 2021)

Changed

  • The implementation for standard events changed significantly. Each standard event now has an associated class and should be created via an instance of this class.

  • Standard events now carry built-in dimensions next to the three custom dimensions.

  • A UserEvent now takes a EventDetails instance instead of a String as the name parameter. You can create a EventDetails instance from a string, leaving category, element, and action empty.

  • There is now a short delay before sending user events to batch them.

  • The justtrack SDK is now licensed under the MIT license.

  • Added the current version name (if available) to the app version send to the backend.

  • The JustTrackSdkBuilder has been simplified and now only depends on an Activity or Application.

Added

  • Added the EventDetails class to group event name, category, element, and action. Only the event name is mandatory.

  • Added a static class justtrack to record application start and load times before initializing the SDK.

Removed

  • Removed units for level, currency, and average count.

  • Removed setEnableActivityTracking from the SdkBuilder interface.

Version 3.2.0 (6th April 2021)

Changed

  • AttributionResponse#getCampaign(), AttributionResponse#getChannel() and AttributionResponse#getNetwork() now return Campaign, Channel and Network interfaces instead of the old IdString interface.

  • RetargetingParameters#getUrl() was replaced by RetargetingParameters#getUri() to allow URIs with an unknown protocol (e.g., your app name) to be returned.

Added

  • Added Campaign, Channel and Network interfaces.

  • Added Campaign#getType() to retrieve the type of a campaign.

  • Added Channel#isIncent() to retrieve the incent flag of the channel.

  • Added support for a preliminary retargeting result. This allows you to already display some welcome screen while the SDK is still waiting for the retargeting attribution to be confirmed by the justtrack backend (as this can take a few seconds). Therefore there is a new interface PreliminaryRetargetingParameters, a new method JustTrackSdk#getPreliminaryRetargetingParameters(), a new listener interface PreliminaryRetargetingParametersListener and a new method JustTrackSdk#registerPreliminaryRetargetingParametersListener(PreliminaryRetargetingParametersListener) to register said listener. After obtaining an instance of PreliminaryRetargetingParameters, you can validate() them to check whether the user did really click on a retargeting campaign or whether they e.g. crafted the Intent by hand.

Version 3.1.0 (16th March 2021)

Changed

  • The SDK now fetches the attribution again after 5 seconds (default, can be changed) after a re-attribution opportunity was detected.

Added

  • Added setReFetchReAttributionDelaySeconds to the SDK builder to control when attributions are fetched a second time after a re-attribution opportunity was detected.

Version 3.0.0 (22nd February 2021)

Changed

  • Renamed various parts of the attribution response:

    • uuid -> userId

    • subId -> sourceId

    • subAppId -> sourceBundleId

    • adSetId -> adsetId (small S)

    • recruiter.clientId -> recruiter.packageId

  • Added recruiter.userId, recruiter.platform, installId, userType, sourcePlacement to the attribution response

  • Updated okhttp dependency to 3.14.9 and play-services-ads dependency to 19.7.0

  • JustTrackSdkBuilder and ExistingJustTrackSdkBuilder now take an Intent as the second parameter.

  • Starting with this version, you have to implement Activity#onNewIntent(Intent) to allow the SDK to detect receiving intents while the app is already running.

Added

  • Added setInactivityTimeFrame(long) and setReAttributionTimeFrame(long) to the SdkBuilder interface. Use it to specify how often we need to fetch for a new (re-)attribution. By default we will fetch a new attribution every 14 days or after the SDK was not initialized for more than 48 hours.

  • Added getRetargetingParameters to the JustTrackSdk interface. It provides the retargeting parameters the app was started with (if any, otherwise null).

  • Added registerAttributionListener and registerRetargetingParametersListener to the SDK as well as needed companion types.

  • Added onNewIntent to the SDK to notify it about new intents (if you don't call setIntent in your activity).

Version 2.4.2 (11th January 2021)

Changed

  • The SDK now waits for some time before retrying requests.

  • Allow the advertiser id to be missing if we have a tracking id.

Version 2.4.1 (11th December 2020)

Bug-Fixes

  • Fixed wrong ad unit names in IronSource integration.

Version 2.4.0 (8th December 2020)

Added

  • Added setTrackingId(String) to SdkBuilder interface to provide a tracking id (e.g., the Appsflyer id of the user) as an additional means of identifying the user.

  • Added integrateWithIronSource() to JustTrackSdk interface.

  • Added setEnableIronSourceIntegration(boolean) to SdkBuilder interface.

  • When you have the IronSource SDK integrated into your app, you can now automatically sent the userId to IronSource as well as subscribing to impression events as user events by calling integrateWithIronSource() or setEnableIronSourceIntegration(true).

Version 2.3.3 (22th October 2020)

Changed

  • The Logger interface was changed and supports additional fields now.

  • The SDK now automatically sends logs to the justtrack backend.

  • The SDK now sends additional information about the install referrer to the backend.

Bug-Fixes

  • The SDK now correctly reports the Version of the app upon install.

Version 2.3.2 (8th October 2020)

Added

  • Added setFirebaseInstanceId and publishFirebaseInstanceId methods to forward a firebase id to the justtrack backend.

Version 2.3.1 (17th September 2020)

Changed

  • The SDK now automatically publishes SESSION_APP_OPEN events each time the SDK detects an app launch.

Version 2.3.0 (7th September 2020)

Added

  • Added getCachedAttribution method.

Changed

  • The SDK will now automatically fetch a new attribution should the first attribution be younger than 15 minutes to make sure any changes on the backend side are propagated to the app eventually.

  • An attribution now includes the campaign ID and name instead of just the ID.

Bug-Fixes

  • Fixed a race condition resulting in invalid date strings.

Removed

  • Removed the old event tracking ("notify"-calls) as the server side no longer accepts these messages.

  • Removed getAppInstallCount method.

Version 2.2.3 (29th July 2020)

Added

  • You can now get an existing SDK instance if one exists

  • You can specify an activity which is currently active should you instantiate the SDK while the activity is already running (see SdkBuilder#setCurrentActivity).

Changed

  • We are now sending the Android version instead of the Linux kernel version to the backend.

Version 2.2.2 (17th July 2020)

Added

  • Added level and currency units.

Version 2.2.1 (13th July 2020)

Added

  • Added setEnableBroadcastReceiver(boolean) and setEnableActivityTracking(boolean) methods to SdkBuilder.

Changed

  • Changed package name to io.justtrack and updated domains to *.justtrack.io.

  • It is no longer legal to call get() of a future returned by the SDK on the main thread.

Last updated