Changelog
Version 4.5.0 (12th December 2023)
Changed
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.
The JustTrackSDK can now only be initialized from the main thread. If you need to initialize it from another thread, use
DispatchQueue.main.sync
to move the call to the main thread.JustTrackSdk.forwardAdImpression
now requires you to construct anAdImpression
object instead of passing individual parameters.
Version 4.4.1 (30th August 2023)
Bug-Fixes
Initializing the SDK multiple times no longer causes multiple instances running concurrently.
Version 4.4.0 (14th July 2023)
Added
JustTrackSdk.userId
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 toJustTrackSdk.attribution
and is now a property.JustTrackSdk.getRetargetingParameters
was renamed toJustTrackSdk.retargetingParameters
and is now a property.JustTrackSdk.getPreliminaryRetargetingParameters
was renamed toJustTrackSdk.preliminaryRetargetingParameters
and is now a property.JustTrackSdk.getAppVersionAtInstall
was renamed toJustTrackSdk.attribution
and is now a property.JustTrackSdk.getSdkVersion
was renamed toJustTrackSdk.sdkVersion
and is now a property.JustTrackSdk.getAdvertiserIdInfo
was renamed toJustTrackSdk.advertiserIdInfo
and is now a property.JustTrackSdk.getTestGroupId
was renamed toJustTrackSdk.testGroupId
and is now a property.JustTrackSdk.publishEvent
was renamed toJustTrackSdk.publish(event:)
.JustTrackSdk.registerAttributionListener
was renamed toJustTrackSdk.register(attributionListener:)
.JustTrackSdk.registerRetargetingParametersListener
was renamed toJustTrackSdk.register(retargetingParametersListener:)
.JustTrackSdk.registerPreliminaryRetargetingParametersListener
was renamed toJustTrackSdk.register(preliminaryRetargetingParametersListener:)
.JustTrackSdk.onDestroy
was renamed toJustTrackSdk.shutdown
.JustTrackSdk.getAffiliateLink
was renamed toJustTrackSdk.createAffiliateLink(channel:)
and can now throw an error instead of returning a future which can fail. A version without a parameter that doesn't throw any errors was also added.JustTrackSdk.publishFirebaseAppInstanceId
was renamed toJustTrackSdk.set(firebaseAppInstanceId:)
.The
AdvertiserIdInfo
andAttributionResponse
protocols now provide properties instead of getter methods.XCode 14.0 or newer is now required.
Removed
JustTrackSdk.getCachedAttribution
was removed.
Version 4.3.8 (29th March 2023)
Added
JustTrack.getInstance
now returns the current SDK instance if one was already created.set(automaticInAppPurchaseTracking: Bool)
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)
Bug-Fixes
Added support to integrate with AppLovin 10.x.
Added support to integrate with Unity Ads 4.6.0.
Version 4.3.6 (2nd March 2023)
Added
forwardAdImpression
can now be called with an arbitrary string parameter instead of anAdFormat
.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 toAdFormat
and the.rewarded_video
value was renamed torewarded
..rewarded_interstitial
,.native
, and.app_open
have been added as new values, too.The
JustTrackSDKFirebase
andJustTrackSDKIronsource
pods were merged into theJustTrackSDK
pod.
Bug-Fixes
The correct device model is now reported to the justtrack backend, improving attribution precision.
Version 4.3.5 (16th December 2022)
Changed
Forwarding in-app purchases no longer requires you to manually supply the receipt as 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.
Bug-Fixes
The reported app version was fixed and now provides the name you specify instead of the version code only.
The SDK no longer reports requesting the tracking permission multiple times if the method is called more than once.
Version 4.3.3 (8th November 2022)
Added
The SDK now provides the token for Apple Search Ads to the backend.
You can now provide a custom user id to the backend.
The SDK is now available as a CocoaPod.
Changed
The SDK now imposes restrictions about the data you can send to the backend.
The integration with Google Ads campaigns was improved.
The native integration with IronSource was changed to allow specifying the user id source.
Version 4.3.2 (4th August 2022)
Changed
The SDK now provides a method
forwardAdImpression
to report ad impressions to the justtrack backend.
Version 4.3.1 (7th July 2022)
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.The test group id is now computed based on the IDFV instead of the IDFA.
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 calledpublishFirebaseAppInstanceId
.
Bug-Fixes
The SDK now retrieves the Firebase app instance id instead of the Firebase (installation) instance id during integration.
Version 4.2.8 (30th March 2022)
Added
Changed
Improved attribution precision.
Version 4.2.5 (17th December 2021)
Added
Added
JustTrack.requestTrackingAuthorization
to allow the user to opt in for tracking.
Changed
Improved the precision of the retrieved device model name.
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 now sends session_app_open events correctly.
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.
Increased likelihood that events reach the backend if the user is only using the app for a short time.
Added call to
SKAdNetwork.registerAppForAdNetworkAttribution
.
Version 4.2.0 (23rd 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 session id is now included in all events sent to the backend.
You now have to name the provider of the tracking id when initializing the SDK.
Removed
Removed
with(realTime:)
from all interfaces again as well as realTime event functionality.It is no longer possible to set the duration for progression events by hand.
Version 4.1.0 (21st May 2021)
Added
Added
with(realTime:)
to user events to send events without any delay.Added
registerAttributionListener
,registerRetargetingParametersListener
, andregisterPreliminaryRetargetingParametersListener
to the SDK as well as needed companion types.Added
getRetargetingParameters
andgetPreliminaryRetargetingParameters
to the SDK.
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 aEventDetails
instance instead of aString
as thename
parameter. You can create aEventDetails
instance from a string, leaving category, element, and action empty.Events are now persisted until they reached the justtrack servers at least once.
There is now a short delay before sending user events to batch them.
The justtrack SDK is now licensed under the MIT license.
The attribution format was changed slightly and more information is now provided with each attribution.
Added the current version name (if available) to the app version send to the backend.
The SDK now fetches the attribution again after 5 seconds (default, can be changed) after a re-attribution opportunity was detected.
Removed
Removed units for level, currency, and average count.
Version 2.4.2 (11th January 2021)
Changed
Use build number as version if available.
Bug-Fixes
Use correct locale when formatting dates.
Version 2.3.3 (10th December 2020)
Added
Created the SDK and released it onto an unsuspecting world.
Last updated