Package com.batch.android

Class Batch

java.lang.Object
com.batch.android.Batch
public final class Batch extends Object
Entry point of the Batch library

  • Field Details

  • Method Details

    • getAPIKey

      public static String getAPIKey()
      Return the api key
      If you call this method before calling setConfig, it will return null
      Returns:
      API key if available, null otherwise

    • getUserProfile

      @Deprecated public static BatchUserProfile getUserProfile()
      Deprecated.
      Please use Batch.User methods instead
      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 restore

      You must call this method after onStart(android.app.Activity) otherwise it will return null
      Returns:
      instance of BatchUser to set properties, null if you call it before onStart.

    • setConfig

      public 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.
      Parameters:
      config -

    • shouldUseAdvertisingID

      @Deprecated public static boolean shouldUseAdvertisingID()
      Deprecated.
      This method does nothing, please stop using it and see return false.
      Can Batch use Advertising ID

      Batch doesn't collects Android Advertising Identifier anymore.

    • shouldUseAdvancedDeviceInformation

      public static boolean shouldUseAdvancedDeviceInformation()
      Can Batch use advanced device information
      Returns:

    • shouldUseGoogleInstanceID

      @Deprecated public static boolean shouldUseGoogleInstanceID()
      Deprecated.
      Please migrate to FCM
      Can Batch use the PlayServices Instance ID API (if available), or fallback to classic GCM.
      Returns:

    • shouldAutoRegisterForPush

      @Deprecated public static boolean shouldAutoRegisterForPush()
      Deprecated.
      Please remove this call, as it doesn't do anything anymore
      Should Batch automatically register to push notificaitons This method is not supported anymore: Batch will always register for push.
      Returns:
      Always true

    • getLoggerLevel

      public static LoggerLevel getLoggerLevel()
      Get the current logger level
      Returns:

    • getSessionID

      public static String getSessionID()
      Get the id of the current session, random uuid used internaly by Batch to identify the app session.
      Returns:
      session id if any, null otherwise

    • isRunningInDevMode

      @Deprecated public static boolean isRunningInDevMode()
      Deprecated.
      This method is not needed, since all DEV API Keys start with "DEV".
      Check if Batch is running in dev mode
      NB : if you call this method before Batch#setConfig(Config), you'll always have the default value : false
      Returns:
      true if Batch is running in dev mode, false if not

    • copyBatchExtras

      public static void copyBatchExtras(Intent from, 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 tracking or mobile landings.
      Parameters:
      from - Intent to read Batch's data from
      to - Intent to copy Batch's data to

    • copyBatchExtras

      public static void copyBatchExtras(Bundle from, 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 tracking or mobile landings.
      Parameters:
      from - Intent to read Batch's data from
      to - Intent to copy Batch's data to

    • getBroadcastPermissionName

      public static String getBroadcastPermissionName(Context context)
      Get the broadcast permission name.

      Useful if you want to register your broadcast receiver at runtime

    • optOut

      public static void optOut(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 unexpectedly when the SDK is opted-out from.

      Opting out will: - Prevent Batch#onStart(Activity) or Batch#onServiceCreate(Context, boolean) 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 BatchUserDataEditor#save() calls - Make the SDK reject calls to Batch.User#trackEvent(String), Batch.User#trackTransaction(double), Batch.User#trackLocation(Location) 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 Batch#optOutAndWipeData(Context)

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

    • optOut

      public static void optOut(Context context, BatchOptOutResultListener listener)
      Opt Out from Batch SDK Usage. Requires Batch to be started.

      Same as Batch#optOut(Context), 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.

      See Also:

    • optOutAndWipeData

      public static void optOutAndWipeData(Context context)
      Opt Out from Batch SDK Usage. Requires Batch to be started.

      Same as Batch#optOut(Context) but also wipes data.

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

      See Also:

    • optOutAndWipeData

      public static void optOutAndWipeData(Context context, BatchOptOutResultListener listener)
      Opt Out from Batch SDK Usage. Requires Batch to be started.

      Same as Batch#optOut(Context) but also wipes data.

      Note that calling this method will stop Batch, effectively simulating calls to Batch#onStop(Activity), Batch#onDestroy(Activity) and Batch#onServiceDestroy(Context). 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.

      See Also:

    • optIn

      public static void optIn(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 Batch#optOut(Context) or Batch#optOutAndWipeData(Context) 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 strongly advised to restart the application (or at least the current activity) after opting in.

    • isOptedOut

      public static boolean isOptedOut(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

      public 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 application is foregrounded 5 times within 12 seconds.

      Parameters:
      enabled - Whether to enable the find my installation feature.

    • onCreate

      public static void onCreate(Activity activity)
      Method to call on your main activity Activity#onCreate(Bundle).
      Parameters:
      activity - Created activity

    • onStart

      public static void onStart(Activity activity)
      Method to call on your main activity 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 activity is null
      • You call it before calling Batch#setConfig(Config)
      • Your app doesn't have android.permission.INTERNET permission
      Parameters:
      activity - The activity that's starting

    • onServiceCreate

      public static void onServiceCreate(Context context, boolean userActivity)
      Method to call on your service 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 context is null
      • You call it before calling Batch#setConfig(Config)
      • Your app doesn't have 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

      public static void onServiceDestroy(Context context)
      Method to call on your service 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

      public static void onNewIntent(Activity activity, Intent intent)
      Method to call on your main activity Activity#onNewIntent(Intent)
      Calling this method if Batch is already stopped or not started will do nothing
      Parameters:
      intent -

    • onStop

      public static void onStop(Activity activity)
      Method to call on your main activity Activity#onStop()
      Calling this method if Batch is already stopped or not started will do nothing
      Parameters:
      activity - the activity that generate the onStop event

    • onDestroy

      public static void onDestroy(Activity activity)
      Method to call on your main activity Activity#onDestroy()
      Calling this method if Batch is already stopped or not started will do nothing
      Parameters:
      activity - the activity that generate the onDestroy event