Method Detail

• setConfig

   static void setConfig(Config config)

  Set the configuration of Batch.You should call this method before any other, only one time.Typically on the onCreate of your MainActivity.

• getSessionID

   static String getSessionID()

  Get the id of the current session, random uuid used internaly by Batch to identify the app session.

• getAPIKey

   static String getAPIKey()

  Return the api keyIf you call this method before calling setConfig, it will return null

• getUserProfile

  @Deprecated() static BatchUserProfile getUserProfile()

  Get the current user profile.You should use this method if you want to modify user language/region or provide a custom ID to identify this user (like an account).Be carefull : Do not use it if you don't know what you are doing,giving a bad custom user ID can result in failure into offer delivery and restoreYou must call this method after onStart otherwise it will return null

• shouldUseAdvertisingID

   static boolean shouldUseAdvertisingID()

  Can Batch use Advertising ID

• shouldUseAdvancedDeviceInformation

   static boolean shouldUseAdvancedDeviceInformation()

  Can Batch use advanced device information

• shouldUseGoogleInstanceID

  @Deprecated() static boolean shouldUseGoogleInstanceID()

  Can Batch use the PlayServices Instance ID API (if available), or fallback to classic GCM.

• shouldAutoRegisterForPush

  @Deprecated() static boolean shouldAutoRegisterForPush()

  Should Batch automatically register to push notificaitonsThis method is not supported anymore: Batch will always register for push.

• getLoggerLevel

   static LoggerLevel getLoggerLevel()

  Get the current logger level

• isRunningInDevMode

  @Deprecated() static boolean isRunningInDevMode()

  Check if Batch is running in dev modeNB : if you call this method before setConfig, you'll always have the default value : false

• copyBatchExtras

   static void copyBatchExtras(@Nullable() Intent from, @Nullable() Intent to)

  Copy Batch's internal data from an intent to another.This is useful if you've got an activity that will not get a chance to start Batch before closing itself,but don't want to break features relying on data put in the intent extras, such as direct open trackingor mobile landings.

  Parameters:

  from - Intent to read Batch's data from

  to - Intent to copy Batch's data to

• copyBatchExtras

   static void copyBatchExtras(@Nullable() Bundle from, @Nullable() Bundle to)

  Copy Batch's internal data from intent extras to another bundle.This is useful if you've got an activity that will not get a chance to start Batch before closing itself,but don't want to break features relying on data put in the intent extras, such as direct open trackingor mobile landings.

  Parameters:

  from - Intent to read Batch's data from

  to - Intent to copy Batch's data to

• getBroadcastPermissionName

  @NonNull() static String getBroadcastPermissionName(@NonNull() Context context)

  Get the broadcast permission name.

  Useful if you want to register your broadcast receiver at runtime

• optOut

   static void optOut(@NonNull() Context context)

  Opt Out from Batch SDK Usage. Requires Batch to be started.

  Note that calling the SDK when opted out is discouraged: Some modules might behave unexpectedlywhen the SDK is opted-out from.

  Opting out will:- Prevent onStart or onServiceCreate from doing anything at all- Disable any network capability from the SDK- Disable all In-App campaigns- Make the Inbox module return an error immediatly when used- Make the SDK reject any BatchUserProfile or save calls- Make the SDK reject calls to trackEvent, trackTransaction, trackLocation and any related methods

  Even if you opt in afterwards, data that has been generated while opted out WILL be lost.

  If you're also looking at deleting user data, please use optOutAndWipeData

  Note that calling this method will stop Batch, effectively simulating calls to onStop, onDestroy and onServiceDestroy.Your app should be prepared to handle these cases.Some features might not be disabled until the next app start.

• optOut

   static void optOut(@NonNull() Context context, @Nullable() BatchOptOutResultListener listener)

  Opt Out from Batch SDK Usage. Requires Batch to be started.

  Same as optOut, with a completion listener.

  Use the listener to be informed about whether the opt-out request has been successfully sent to the server or not.You'll also be able to control what to do in case of failure.

  Note: if the SDK has already been opted-out from, this method will instantly call the listener with a *failure* state.

• optOutAndWipeData

   static void optOutAndWipeData(@NonNull() Context context)

  Opt Out from Batch SDK Usage. Requires Batch to be started.

  Same as optOut but also wipes data.

  Note that calling this method will stop Batch, effectively simulating calls to onStop, onDestroy and onServiceDestroy.Your app should be prepared to handle these cases.

• optOutAndWipeData

   static void optOutAndWipeData(@NonNull() Context context, @Nullable() BatchOptOutResultListener listener)

  Opt Out from Batch SDK Usage. Requires Batch to be started.

  Same as optOut but also wipes data.

  Note that calling this method will stop Batch, effectively simulating calls to onStop, onDestroy and onServiceDestroy.Your app should be prepared to handle these cases.

  Use the listener to be informed about whether the opt-out request has been successfully sent to the server or not.You'll also be able to control what to do in case of failure.

  Note: if the SDK has already been opted-out from, this method will instantly call the listener with a *failure* state.

• optIn

   static void optIn(@NonNull() Context context)

  Opt In to Batch SDK Usage.

  This method will be taken into account on next full application start (full process restart)

  Only useful if you called optOut or optOutAndWipeData or opted out by default in the manifest

  Some features might not be disabled until the next app start if you call this late into the application's life. It is stronglyadvised to restart the application (or at least the current activity) after opting in.

• isOptedOut

   static boolean isOptedOut(@NonNull() Context context)

  Returns whether Batch has been opted out from or not

  Warning: This method might perform some quick I/O in the caller thread.

• setFindMyInstallationEnabled

   static void setFindMyInstallationEnabled(boolean enabled)

  Control whether Batch should enables the Find My Installation feature (default = true)

  If enabled Batch will copy the current installation id in the clipboard when the applicationis foregrounded 5 times within 12 seconds.

  Parameters:

  enabled - Whether to enable the find my installation feature.

• onCreate

   static void onCreate(Activity activity)

  Method to call on your main activity onCreate.

  Parameters:

  activity - Created activity

• onStart

   static void onStart(Activity activity)

  Method to call on your main activity onStart to start Batch and support URL scheme events.You must call this method before any other on Batch.Will fail and log an Error if

  • Given {@code activity} is null
  • You call it before calling setConfig
  • Your app doesn't have {@code android.permission.INTERNET} permission

  Parameters:

  activity - The activity that's starting

• onServiceCreate

   static void onServiceCreate(Context context, boolean userActivity)

  Method to call on your service onCreate to start Batch.You must call this method before any other on Batch.Note that all Batch functionality is not available in this mode. See the documentation for more info.Using this method, you'll also be able to control whether this start should count as user activity or not.This might impact Analytics.Will fail and log an Error if

  • Given {@code context} is null
  • You call it before calling setConfig
  • Your app doesn't have {@code android.permission.INTERNET} permission

  Parameters:

  context - The service or application context

  userActivity - If the start comes from user activity or for background use only

• onServiceDestroy

   static void onServiceDestroy(Context context)

  Method to call on your service onDestroy to stop Batch.Calling this method if Batch is already stopped or not started will do nothing

  Parameters:

  context - The service or application context

• onNewIntent

   static void onNewIntent(Activity activity, Intent intent)

  Method to call on your main activity onNewIntentCalling this method if Batch is already stopped or not started will do nothing

• onStop

   static void onStop(Activity activity)

  Method to call on your main activity onStopCalling this method if Batch is already stopped or not started will do nothing

  Parameters:

  activity - the activity that generate the onStop event

• onDestroy

   static void onDestroy(Activity activity)

  Method to call on your main activity onDestroyCalling this method if Batch is already stopped or not started will do nothing

  Parameters:

  activity - the activity that generate the onDestroy event