This is a major release, please see our migration guide for more info on how to update your current Batch implementation.
Plugin
- Updated Batch to 2.0. For more information see the ios and android changelog .
- Batch requires iOS 13.0 or higher.
- Batch requires a
minSdk
level of 21 or higher.
iOS
- Removed deprecated
canUseIDFA
property fromBatchPluginConfiguration
. - Removed
canUseAdvancedDeviceInformation
property fromBatchPluginConfiguration
. You should now use thesetAutomaticDataCollection
API. - Added
profileCustomIdMigrationEnabled
property to disable the profile custom id migration. This can also be done from theInfo.plist
file. See our documentation for info. - Added
profileCustomDataMigrationEnabled
property to disable the profile custom data migration. This can also be done from theInfo.plist
file. See our documentation for info.
Android
- Removed deprecated
canUseAdvertisingID
method fromBatchPluginConfiguration
. - Removed
setCanUseAdvancedDeviceInformation
andcanUseAdvancedDeviceInformation
method fromBatchPluginConfiguration
. You should now use the newsetAutomaticDataCollection
API. - Added
setProfileCustomIdMigrationEnabled
method to disable the profile custom id migration. This can also be done from theAndroidManifest
meta-data. See our documentation for info. - Added
setProfileCustomDataMigrationEnabled
method to disable the profile custom data migration. This can also be done from theAndroidManifest
meta-data. See our documentation for info.
Core
- Added method
isOptedOut
to checks whether Batch has been opted out from or not. - Added method
setAutomaticDataCollection
to fine-tune the data you authorize to be tracked by Batch.
User
- Removed method
trackTransaction
with no equivalent. - Removed method
BatchUser.newEditor
and the related classBatchUserDataEditor
, you should now useBatchProfile.instance.newEditor()
which return an instance ofBatchProfileAttributeEditor
. - Added method
clearInstallationData
which allows you to remove the installation data without modifying the current profile.
Event
This version introduced two new types of attribute that can be attached to an event : Array and Object.
- Removed
trackEvent
APIs from the user module. You should now useBatchProfile.instance.trackEvent
. BatchEventData
has been renamed intoBatchEventAttributes
.- Added support of type Array and Object with the following:
- Added
putObject
method toBatchEventAttributes
. - Added
putObjectList
methodBatchEventAttributes
. - Added
putStringList
methodBatchEventAttributes
.
- Added
- Removed
addTag
API fromBatchEventData
You should now use the$tags
key inBatchEventAttributes
with theputStringList
method. - Removed parameter
label
fromtrackEvent
API. You should now use the$label
key inBatchEventAttributes
with theputString
method.
Profile
Introduced BatchProfile
, a new module that enables interacting with profiles. Its functionality replaces most of BatchUser used to do.
- Added
identify
API as replacement ofBatchUser.instance.newEditor().setIdentifier
. - Added
newEditor
method to get a new instance of aBatchProfileAttributeEditor
as replacement ofBatchUserDataEditor
. - Added
trackEvent
API as replacement of theBatchUser.instance.trackEvent
methods. - Added
trackLocation
API as replacement of theBatchUser.instance.trackLocation
method.