Appboy (Braze Android SDK 13.0.0)

java.lang.Object
- com.appboy.Appboy

All Implemented Interfaces:: IAppboy

public class Appboy
extends java.lang.Object
implements IAppboy

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`changeUser(java.lang.String userId)` When you first start using Braze on a device, the user is considered "anonymous".
`static void`	`clearAppboyEndpointProvider()` Clear the currently set `IAppboyEndpointProvider`
`void`	`closeSession(android.app.Activity activity)` Closes the current session.
`static boolean`	`configure(android.content.Context context, AppboyConfig config)` Optional static method to set configuration values for the Appboy singleton, overriding whatever values are present in the appboy.xml.
`Card`	`deserializeContentCard(org.json.JSONObject contentCardJson)` Constructs a Content Card from its `Card.forJsonPut()` output.
`Card`	`deserializeContentCard(java.lang.String contentCardString)` Helper method for `IAppboy.deserializeContentCard(JSONObject)`.
`IInAppMessage`	`deserializeInAppMessageString(java.lang.String inAppMessageJsonString)` This function returns a deserialized in-app message from the message JSON string.
`static void`	`disableSdk(android.content.Context context)` Disables the Braze SDK.
`static boolean`	`enableMockAppboyNetworkRequestsAndDropEventsMode()` Testing utility method that enables mocking for all Braze SDK network requests, essentially turning the SDK "off".
`static void`	`enableSdk(android.content.Context context)` Enables the Braze SDK after an invocation of `disableSdk(Context)`.
`static android.net.Uri`	`getAppboyApiEndpoint(android.net.Uri appboyEndpoint)` If an `IAppboyEndpointProvider` is configured, that provider's delegate is used to generate the Uri for the Braze API endpoint.
`IAppboyImageLoader`	`getAppboyImageLoader()` Returns the `IAppboyImageLoader` for the Braze instance.
`java.lang.String`	`getAppboyPushMessageRegistrationId()` Returns the FCM/ADM/Baidu registration Id used to send the device push messages.
`java.util.List<Card>`	`getCachedContentCards()` Retrieves the offline/cached list of Content Cards from offline storage.
`static java.lang.String`	`getConfiguredApiKey(android.content.Context context)` A helper method to determine if the SDK is configured with an API key.
`int`	`getContentCardCount()` Retrieves information about Content Cards based on the currently cached data.
`long`	`getContentCardsLastUpdatedInSecondsFromEpoch()` Retrieves information about Content Cards based on the currently cached data.
`int`	`getContentCardUnviewedCount()` Retrieves information about Content Cards based on the currently cached data.
`AppboyUser`	`getCurrentUser()` Returns the user currently being tracked by Braze.
`void`	`getCurrentUser(IValueCallback<AppboyUser> completionCallback)` Returns the user currently being tracked by Braze.
`static IAppboyNotificationFactory`	`getCustomAppboyNotificationFactory()` Returns the currently set custom IAppboyNotificationFactory or null.
`java.lang.String`	`getDeviceId()` Get the device ID - a randomly generated, app specific ID that is stored on the device.
`java.lang.String`	`getInstallTrackingId()` Returns a unique device ID for install tracking.
`static Appboy`	`getInstance(android.content.Context context)` Static method that returns the Appboy singleton.
`static boolean`	`getOutboundNetworkRequestsOffline()`
`void`	`logContentCardsDisplayed()` Reports that Content Cards were displayed.
`void`	`logCustomEvent(java.lang.String eventName)` Reports a custom named event.
`void`	`logCustomEvent(java.lang.String eventNameInput, AppboyProperties properties)` Reports a custom named event.
`void`	`logFeedCardClick(java.lang.String cardId)`
`void`	`logFeedCardImpression(java.lang.String cardId)`
`void`	`logFeedDisplayed()` Reports that the feed was displayed.
`void`	`logPurchase(java.lang.String productId, java.lang.String currencyCode, java.math.BigDecimal price)` In order to log a purchase, switch to `IAppboy.logPurchase(String, String, BigDecimal, int)`.
`void`	`logPurchase(java.lang.String productId, java.lang.String currencyCode, java.math.BigDecimal price, AppboyProperties properties)` In order to log a purchase, switch to `IAppboy.logPurchase(String, String, BigDecimal, int, AppboyProperties)`.
`void`	`logPurchase(java.lang.String productId, java.lang.String currencyCode, java.math.BigDecimal price, int quantity)` In order to log a purchase, switch to `IAppboy.logPurchase(String, String, BigDecimal, int, AppboyProperties)`.
`void`	`logPurchase(java.lang.String productIdInput, java.lang.String currencyCodeInput, java.math.BigDecimal price, int quantity, AppboyProperties properties)` Reports that the current user made an in app purchase.
`void`	`logPushNotificationActionClicked(java.lang.String campaignId, java.lang.String actionId, java.lang.String actionType)` Reports that the user clicked on a push notification action button.
`void`	`logPushNotificationOpened(android.content.Intent intent)` Reports that the user clicked on the push notification.
`void`	`logPushNotificationOpened(java.lang.String campaignId)` When possible, `IAppboy.logPushNotificationOpened(Intent)` should be used instead.
`void`	`logPushStoryPageClicked(java.lang.String campaignId, java.lang.String pageId)` Reports that the user clicked on a push story page.
`void`	`openSession(android.app.Activity activity)` Opens a new session or resumes the previous session.
`void`	`registerAppboyPushMessages(java.lang.String registrationId)` Registers the device as eligible to receive push notifications from Braze.
`<T> void`	`removeSingleSubscription(IEventSubscriber<T> subscriber, java.lang.Class<T> eventClass)` Removes a single subscription associated with the given activity and event class.
`void`	`requestContentCardsRefresh(boolean fromCache)` Requests an immediate refresh of Content Cards.
`void`	`requestFeedRefresh()` Requests an immediate refresh of the news feed from the Braze server.
`void`	`requestFeedRefreshFromCache()` Requests a refresh of the news feed from offline storage.
`void`	`requestGeofences(double latitude, double longitude)` Requests a refresh of Braze Geofences for the specified GPS coordinate.
`void`	`requestImmediateDataFlush()` Requests an immediate flush of any analytics data waiting to be sent to Appboy's servers.
`static void`	`setAppboyEndpointProvider(IAppboyEndpointProvider appboyEndpointProvider)` Sets an `IAppboyEndpointProvider` to be used to route Braze API traffic Note that if a custom endpoint is specified using `AppboyConfig.Builder#setCustomEndpoint(String)` or via appboy.xml configuration, any `IAppboyEndpointProvider` previously set using this method will be overridden when the Appboy singleton initializes.
`void`	`setAppboyImageLoader(IAppboyImageLoader appboyImageLoader)` Sets the `IAppboyImageLoader` for the Braze instance.
`static void`	`setCustomAppboyNotificationFactory(IAppboyNotificationFactory customAppboyNotificationFactory)` Set a custom IAppboyNotificationFactory to be used to modify or create Braze push notifications.
`void`	`setGoogleAdvertisingId(java.lang.String googleAdvertisingId, boolean limitAdTrackingEnabled)` Sets the Google Advertising ID and associated ad-tracking enabled field for this device.
`static void`	`setOutboundNetworkRequestsOffline(boolean isOffline)` Pauses or resumes outbound network requests from the Braze SDK at any point during runtime.
`void`	`subscribeToContentCardsUpdates(IEventSubscriber<ContentCardsUpdatedEvent> subscriber)` Subscribes to Content Cards events.
`void`	`subscribeToFeedUpdates(IEventSubscriber<FeedUpdatedEvent> subscriber)` Subscribes to news feed events.
`void`	`subscribeToNetworkFailures(IEventSubscriber<BrazeNetworkFailureEvent> subscriber)` Subscribes to network failures that have occurred within the SDK.
`void`	`subscribeToNewInAppMessages(IEventSubscriber<InAppMessageEvent> subscriber)` Subscribes to in-app message events.
`void`	`subscribeToSessionUpdates(IEventSubscriber<SessionStateChangedEvent> subscriber)` Subscribes to Session start and close events.
`static void`	`wipeData(android.content.Context context)` Hard resets all data created by the Braze SDK from the internal storage directory.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - getInstance
```
public static Appboy getInstance(android.content.Context context)
```
    Static method that returns the Appboy singleton. All requests to Braze are made through this instance.
    
    Parameters:
    
    context - Current context
    
    Returns:
    
    the singleton Appboy instance
  - openSession
```
public void openSession(android.app.Activity activity)
```
    Description copied from interface: IAppboy
    
    Opens a new session or resumes the previous session. A call to IAppboy.openSession(Activity) within the session timeout of a call to IAppboy.closeSession(Activity) will cause the previous session to be resumed. This is done so that transitions from one Activity to another do not create a new session each time.
    
    Specified by:
    
    openSession in interface IAppboy
    
    Parameters:
    
    activity - The current Activity.
  - closeSession
```
public void closeSession(android.app.Activity activity)
```
    Description copied from interface: IAppboy
    
    Closes the current session. The session may be reopened if a call is made to IAppboy.openSession(Activity) within the session timeout.
    
    Specified by:
    
    closeSession in interface IAppboy
    
    Parameters:
    
    activity - The current Activity.
  - logCustomEvent
```
public void logCustomEvent(java.lang.String eventName)
```
    Description copied from interface: IAppboy
    
    Reports a custom named event.
    
    Specified by:
    
    logCustomEvent in interface IAppboy
    
    Parameters:
    
    eventName - The String identifier for the event to track. Best practice is to track generic events useful for segmenting, instead of specific user actions (i.e. track watched_sports_video instead of watched_video_adrian_peterson_td_mnf).
  - logCustomEvent
```
public void logCustomEvent(java.lang.String eventNameInput,
                           AppboyProperties properties)
```
    Description copied from interface: IAppboy
    
    Reports a custom named event.
    
    Specified by:
    
    logCustomEvent in interface IAppboy
    
    Parameters:
    
    eventNameInput - The String identifier for the event to track. Best practice is to track generic events useful for segmenting, instead of specific user actions (i.e. track watched_sports_video instead of watched_video_adrian_peterson_td_mnf).
    
    properties - An object containing key-value properties describing this event. Property names are non-empty strings <= 255 characters, with no leading dollar signs.
  - logPurchase
```
public void logPurchase(java.lang.String productId,
                        java.lang.String currencyCode,
                        java.math.BigDecimal price)
```
    Description copied from interface: IAppboy
    
    In order to log a purchase, switch to IAppboy.logPurchase(String, String, BigDecimal, int). Using this method will by default log a purchase with a quantity of one.
    
    Specified by:
    
    logPurchase in interface IAppboy
    
    See Also:
    
    IAppboy.logPurchase(String, String, java.math.BigDecimal, int)
  - logPurchase
```
public void logPurchase(java.lang.String productId,
                        java.lang.String currencyCode,
                        java.math.BigDecimal price,
                        AppboyProperties properties)
```
    Description copied from interface: IAppboy
    
    In order to log a purchase, switch to IAppboy.logPurchase(String, String, BigDecimal, int, AppboyProperties). Using this method will by default log a purchase with a quantity of one.
    
    Specified by:
    
    logPurchase in interface IAppboy
    
    See Also:
    
    IAppboy.logPurchase(String, String, java.math.BigDecimal, int, AppboyProperties)
  - logPurchase
```
public void logPurchase(java.lang.String productId,
                        java.lang.String currencyCode,
                        java.math.BigDecimal price,
                        int quantity)
```
    Description copied from interface: IAppboy
    
    In order to log a purchase, switch to IAppboy.logPurchase(String, String, BigDecimal, int, AppboyProperties).
    
    Specified by:
    
    logPurchase in interface IAppboy
    
    See Also:
    
    IAppboy.logPurchase(String, String, java.math.BigDecimal, int, AppboyProperties)
  - logPurchase
```
public void logPurchase(java.lang.String productIdInput,
                        java.lang.String currencyCodeInput,
                        java.math.BigDecimal price,
                        int quantity,
                        AppboyProperties properties)
```
    Description copied from interface: IAppboy
    
    Reports that the current user made an in app purchase. Useful for tracking and segmenting users more likely to make purchases.
    
    Specified by:
    
    logPurchase in interface IAppboy
    
    Parameters:
    
    productIdInput - The String identifier for the product purchased. Usually the Google Play SKU.
    
    currencyCodeInput - Currencies should be represented as an ISO 4217 currency code. Supported currency symbols include: AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTC, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLF, CLP, CNY, COP, CRC, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EEK, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GGP, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, IMP, INR, IQD, IRR, ISK, JEP, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MTL, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, STD, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEF, VND, VUV, WST, XAF, XAG, XAU, XCD, XDR, XOF, XPD, XPF, XPT, YER, ZAR, ZMK, ZMW and ZWL. Any other provided currency symbol will result in a logged warning and no other action taken by the SDK.
    
    price - The price paid. Base units depend on the currency. As an example, USD should be reported as Dollars.Cents, whereas JPY should be reported as a whole number of Yen. All provided BigDecimal values will have RoundingMode.HALF_UP rounding applied such that a maximum of two digits exist after the decimal point. May be negative.
    
    quantity - The quantity of items purchased expressed as a whole number. Must be greater than zero.
    
    properties - A map of key-value properties describing this purchase. Property names are non-empty strings <= 255 characters, with no leading dollar signs. Property values can be integers, floats, booleans, datetimes (of the formats "%FT%T%z", "%Y-%m-%d %H:%M:%S", "%Y-%m-%d", "%m/%d/%Y"), or strings <= 255 characters. Note: The productId and currencyCode are trimmed of any whitespace characters before being sent to Braze.
    
    Note: Querying the Google Play store for SKU details may return the price of a in-app purchases in micros. Therefore, a purchase of price 0.99USD will be returned as 9900000. To pass this value to Braze, be sure to convert it to a BigDecimal before attempting to convert it from micros to a decimal value in order to avoid integer division rounding errors.
    
    BigDecimal priceInMicro = new BigDecimal(9900000L); BigDecimal priceInDecimal = priceInMicro.divide(new BigDecimal(10e6));
  - logPushNotificationOpened
```
public void logPushNotificationOpened(java.lang.String campaignId)
```
    Description copied from interface: IAppboy
    
    When possible, IAppboy.logPushNotificationOpened(Intent) should be used instead. Note that integrations shouldn't be calling this method directly. Reports that the user clicked on the push notification.
    
    Specified by:
    
    logPushNotificationOpened in interface IAppboy
    
    Parameters:
    
    campaignId - The ID of the campaign that triggered the push notification. This can be found as an extra in the push notification intent.
  - logPushNotificationOpened
```
public void logPushNotificationOpened(android.content.Intent intent)
```
    Description copied from interface: IAppboy
    
    Reports that the user clicked on the push notification. Note that integrations shouldn't be calling this method directly.
    
    Specified by:
    
    logPushNotificationOpened in interface IAppboy
    
    Parameters:
    
    intent - The push notification intent.
  - logPushNotificationActionClicked
```
public void logPushNotificationActionClicked(java.lang.String campaignId,
                                             java.lang.String actionId,
                                             java.lang.String actionType)
```
    Description copied from interface: IAppboy
    
    Reports that the user clicked on a push notification action button.
    
    Specified by:
    
    logPushNotificationActionClicked in interface IAppboy
    
    Parameters:
    
    campaignId - The ID of the campaign that triggered the push notification. This can be found as an extra in the push notification intent.
    
    actionId - The ID of the action button that was clicked.
    
    actionType - The action type from the intent's string extra under Constants.APPBOY_ACTION_TYPE_KEY.
  - logPushStoryPageClicked
```
public void logPushStoryPageClicked(java.lang.String campaignId,
                                    java.lang.String pageId)
```
    Description copied from interface: IAppboy
    
    Reports that the user clicked on a push story page.
    
    Specified by:
    
    logPushStoryPageClicked in interface IAppboy
    
    Parameters:
    
    campaignId - The ID of the campaign that triggered the push notification. This can be found as an extra in the push notification intent.
    
    pageId - The ID of the push story page that was clicked.
  - logContentCardsDisplayed
```
public void logContentCardsDisplayed()
```
    Description copied from interface: IAppboy
    
    Reports that Content Cards were displayed.
    
    Specified by:
    
    logContentCardsDisplayed in interface IAppboy
  - logFeedDisplayed
```
public void logFeedDisplayed()
```
    Description copied from interface: IAppboy
    
    Reports that the feed was displayed.
    
    Specified by:
    
    logFeedDisplayed in interface IAppboy
  - requestFeedRefreshFromCache
```
public void requestFeedRefreshFromCache()
```
    Description copied from interface: IAppboy
    
    Requests a refresh of the news feed from offline storage. The result of this call will be reported asynchronously via a FeedUpdatedEvent, similar to a call to IAppboy.requestFeedRefresh().
    
    Specified by:
    
    requestFeedRefreshFromCache in interface IAppboy
  - requestFeedRefresh
```
public void requestFeedRefresh()
```
    Description copied from interface: IAppboy
    
    Requests an immediate refresh of the news feed from the Braze server.
    
    All refresh requests also flush the session/events queue when the network request executes.
    
    Results of refresh calls are reported asynchronously via events. Events can be subscribed to with other methods in this class. If the network call returns before any subscribers are active, the result will be lost.
    
    Specified by:
    
    requestFeedRefresh in interface IAppboy
  - requestContentCardsRefresh
```
public void requestContentCardsRefresh(boolean fromCache)
```
    Description copied from interface: IAppboy
    
    Requests an immediate refresh of Content Cards. If fromCache is true, data will be pulled from offline storage. If fromCache is false, the SDK will request an immediate refresh of Content Cards from the Appboy server.
    
    Results of both cached and non-cached refresh calls are reported asynchronously via events. Events can be subscribed to using IAppboy.subscribeToContentCardsUpdates(IEventSubscriber)
    
    If the network call returns before any subscribers are active, the result will be lost.
    
    Specified by:
    
    requestContentCardsRefresh in interface IAppboy
    
    Parameters:
    
    fromCache - whether to request data from offline storage.
  - requestImmediateDataFlush
```
public void requestImmediateDataFlush()
```
    Description copied from interface: IAppboy
    
    Requests an immediate flush of any analytics data waiting to be sent to Appboy's servers.
    
    Specified by:
    
    requestImmediateDataFlush in interface IAppboy
  - subscribeToNewInAppMessages
```
public void subscribeToNewInAppMessages(IEventSubscriber<InAppMessageEvent> subscriber)
```
    Description copied from interface: IAppboy
    
    Subscribes to in-app message events. The subscriber callback will be called when a new in-app message is sent. The subscriber will be called with a InAppMessageEvent.
    
    Subscriptions should be cleaned up manually by calling IAppboy.removeSingleSubscription(com.appboy.events.IEventSubscriber, Class).
    
    All events are triggered from background threads and isolate any encountered exceptions. If you need to do work on the UI thread in response to an event, you will need to coordinate that in the IEventSubscriber's trigger method.
    
    Specified by:
    
    subscribeToNewInAppMessages in interface IAppboy
    
    Parameters:
    
    subscriber - A callback that should be executed when the news feed is updated.
  - subscribeToContentCardsUpdates
```
public void subscribeToContentCardsUpdates(IEventSubscriber<ContentCardsUpdatedEvent> subscriber)
```
    Description copied from interface: IAppboy
    
    Subscribes to Content Cards events. The subscriber callback will be called when Content Cards is updated. The subscriber will be called with a ContentCardsUpdatedEvent.
    
    Subscriptions should be cleaned up manually by calling IAppboy.removeSingleSubscription(com.appboy.events.IEventSubscriber, Class).
    
    All events are triggered from background threads and isolate any encountered exceptions. If you need to do work on the UI thread in response to an event, you will need to coordinate that in the IEventSubscriber's trigger method.
    
    Specified by:
    
    subscribeToContentCardsUpdates in interface IAppboy
    
    Parameters:
    
    subscriber - A callback that will be executed when Content Cards are updated.
  - subscribeToFeedUpdates
```
public void subscribeToFeedUpdates(IEventSubscriber<FeedUpdatedEvent> subscriber)
```
    Description copied from interface: IAppboy
    
    Subscribes to news feed events. The subscriber callback will be called when the news feed is updated. The subscriber will be called with a FeedUpdatedEvent.
    
    Subscriptions should be cleaned up manually by calling IAppboy.removeSingleSubscription(com.appboy.events.IEventSubscriber, Class).
    
    All events are triggered from background threads and isolate any encountered exceptions. If you need to do work on the UI thread in response to an event, you will need to coordinate that in the IEventSubscriber's trigger method.
    
    Specified by:
    
    subscribeToFeedUpdates in interface IAppboy
    
    Parameters:
    
    subscriber - A callback that should be executed when the news feed is updated.
  - subscribeToSessionUpdates
```
public void subscribeToSessionUpdates(IEventSubscriber<SessionStateChangedEvent> subscriber)
```
    Description copied from interface: IAppboy
    
    Subscribes to Session start and close events. The subscriber callback will be called when a session is created or sealed. The subscriber will be called with a SessionStateChangedEvent.
    
    For reference, a session is created or sealed only once.
    
    Subscriptions should be cleaned up manually by calling IAppboy.removeSingleSubscription(com.appboy.events.IEventSubscriber, Class).
    
    All events are triggered from background threads and isolate any encountered exceptions. If you need to do work on the UI thread in response to an event, you will need to coordinate that in the IEventSubscriber's trigger method.
    
    Specified by:
    
    subscribeToSessionUpdates in interface IAppboy
    
    Parameters:
    
    subscriber - A callback that will be executed when a session is created or sealed.
  - subscribeToNetworkFailures
```
public void subscribeToNetworkFailures(IEventSubscriber<BrazeNetworkFailureEvent> subscriber)
```
    Description copied from interface: IAppboy
    
    Subscribes to network failures that have occurred within the SDK.
    
    Specified by:
    
    subscribeToNetworkFailures in interface IAppboy
    
    Parameters:
    
    subscriber - A callback that will be executed when a network failure event has occurred.
  - removeSingleSubscription
```
public <T> void removeSingleSubscription(IEventSubscriber<T> subscriber,
                                         java.lang.Class<T> eventClass)
```
    Description copied from interface: IAppboy
    
    Removes a single subscription associated with the given activity and event class. This should be called if you want to selectively unsubscribe from an event, but do not want to remove every subscription for the activity.
    
    Specified by:
    
    removeSingleSubscription in interface IAppboy
    
    Parameters:
    
    subscriber - The callback which is currently subscribed.
    
    eventClass - The Event class which this IEventSubscriber is subscribed to.
  - changeUser
```
public void changeUser(java.lang.String userId)
```
    Description copied from interface: IAppboy
    
    When you first start using Braze on a device, the user is considered "anonymous". You can use this method to optionally identify a user with a unique ID, which enables the following:
    * If the same user is identified on another device, their user profile, usage history and event history will be shared across devices.
    * If your app is used by multiple people, you can assign each of them a unique identifier to track them separately. Only the most recent user on a particular device will receive push notifications and in-app messages.
    
    When you request a user switch (which is any call to changeUser where the new user ID is not the same as the existing user ID), the current session for the previous user (anonymous or not) is automatically sealed and a new session is started. Similarly, following a call to changeUser, any events which fire are guaranteed to be for the new user -- if an in flight server request completes for the old user after the user switch no events will fire, so you do not need to worry about filtering out events from Braze for old users.
    
    Additionally, if you identify a user which has never been identified on another device, the entire history of that user as an "anonymous" user on this device will be preserved and associated with the newly identified user. However, if you identify a user which *has* been identified in another app, any history which was already flushed to the server for the anonymous user on this device will become orphaned and will not be associated with any future users. These orphaned users are not considered in your user counts and will not be messaged.
    
    As part of the user change process, if you switch from an identified user to another identified user, Braze attempts to flush the previous user's data with a background task. If that background task fails, Braze will not attempt to re-flush the previous user's data until the next time you switch back to that user ID, instead preferring to minimize network traffic and free up any resources being used by the previous user's operations.
    
    When this method returns, all subsequent calls to your Braze instance will operate on the new user.
    Note: Once you identify a user, you cannot revert to the "anonymous" user. The transition from anonymous to identified tracking is only allowed once because the initial anonymous user receives special treatment to allow for preservation of their history. As a result, we recommend against changing the user ID just because your app has entered a "logged out" state because it makes you unable to target the previously logged out user with re-engagement campaigns. If you anticipate multiple users on the same device, but only want to target one of them when your app is in a logged out state, we recommend separately keeping track of the user ID you want to target while logged out and switching back to that user ID as part of your app's logout process.
    
    Note that an AppboyUser can be retrieved at any time using IAppboy.getCurrentUser().
    
    Specified by:
    
    changeUser in interface IAppboy
    
    Parameters:
    
    userId - An external user identifier. May not be longer than Constants.USER_ID_MAX_LENGTH_BYTES.
    
    See Also:
    
    IAppboy.getCurrentUser()
  - getCurrentUser
```
public AppboyUser getCurrentUser()
```
    Description copied from interface: IAppboy
    
    Returns the user currently being tracked by Braze. Note that modifying values on instances of AppboyUser for a previous user will result in those values being stored locally, but they will not be synced with the Braze server until that user becomes active again.
    
    Note that this method will block the caller thread until the current AppboyUser is available. Please use IAppboy.getCurrentUser(IValueCallback) for the asynchronous version of this method.
    
    Specified by:
    
    getCurrentUser in interface IAppboy
  - getCurrentUser
```
public void getCurrentUser(IValueCallback<AppboyUser> completionCallback)
```
    Description copied from interface: IAppboy
    
    Returns the user currently being tracked by Braze. Note that modifying values on instances of AppboyUser for a previous user will result in those values being stored locally, but they will not be synced with the Braze server until that user becomes active again.
    
    Note that this method is asynchronous and will not block the caller thread. Please use IAppboy.getCurrentUser() for the synchronous version of this method.
    
    Specified by:
    
    getCurrentUser in interface IAppboy
    
    Parameters:
    
    completionCallback - that has IValueCallback.onSuccess(T) called with a non-null AppboyUser or IValueCallback.onError() called otherwise.
  - registerAppboyPushMessages
```
public void registerAppboyPushMessages(java.lang.String registrationId)
```
    Description copied from interface: IAppboy
    
    Registers the device as eligible to receive push notifications from Braze. For FCM/ADM applications, this takes the FCM/ADM registration ID to send the device FCM/ADM messages. For apps integrating Baidu Cloud Push, this method is used to register the Baidu user with Braze. The registration ID is flushed immediately.
    
    This should only be used if you already use FCM/ADM/FCM messaging in your app from another provider or are integrating Baidu Cloud Push.
    
    Specified by:
    
    registerAppboyPushMessages in interface IAppboy
    
    Parameters:
    
    registrationId - The registration ID, or for apps integrating Baidu Cloud Push, the Baidu user id
  - getAppboyPushMessageRegistrationId
```
public java.lang.String getAppboyPushMessageRegistrationId()
```
    Description copied from interface: IAppboy
    
    Returns the FCM/ADM/Baidu registration Id used to send the device push messages.
    
    Specified by:
    
    getAppboyPushMessageRegistrationId in interface IAppboy
  - getInstallTrackingId
```
public java.lang.String getInstallTrackingId()
```
    Description copied from interface: IAppboy
    
    Returns a unique device ID for install tracking.
    
    Specified by:
    
    getInstallTrackingId in interface IAppboy
  - getAppboyImageLoader
```
public IAppboyImageLoader getAppboyImageLoader()
```
    Description copied from interface: IAppboy
    
    Returns the IAppboyImageLoader for the Braze instance.
    
    Specified by:
    
    getAppboyImageLoader in interface IAppboy
  - setAppboyImageLoader
```
public void setAppboyImageLoader(IAppboyImageLoader appboyImageLoader)
```
    Description copied from interface: IAppboy
    
    Sets the IAppboyImageLoader for the Braze instance. This IAppboyImageLoader is used for all image related
    
    Specified by:
    
    setAppboyImageLoader in interface IAppboy
    
    Parameters:
    
    appboyImageLoader - The image loader to be set for the Braze instance. If null, then the existing image loader is unchanged.
  - getContentCardCount
```
public int getContentCardCount()
```
    Description copied from interface: IAppboy
    
    Retrieves information about Content Cards based on the currently cached data.
    
    Note that this method is synchronous and will block the current running thread.
    
    Specified by:
    
    getContentCardCount in interface IAppboy
    
    Returns:
    
    The total number of cached Content Cards. If Content Cards information cannot be retrieved, returns -1.
    
    See Also:
    
    IAppboy.requestContentCardsRefresh(boolean)
  - getContentCardUnviewedCount
```
public int getContentCardUnviewedCount()
```
    Description copied from interface: IAppboy
    
    Retrieves information about Content Cards based on the currently cached data.
    
    Note that this method is synchronous and will block the current running thread.
    
    Specified by:
    
    getContentCardUnviewedCount in interface IAppboy
    
    Returns:
    
    The number of cached unviewed Content Cards. If Content Cards information cannot be retrieved, returns -1.
    
    See Also:
    
    IAppboy.requestContentCardsRefresh(boolean)
  - getContentCardsLastUpdatedInSecondsFromEpoch
```
public long getContentCardsLastUpdatedInSecondsFromEpoch()
```
    Description copied from interface: IAppboy
    
    Retrieves information about Content Cards based on the currently cached data.
    
    Note that this method is synchronous and will block the current running thread.
    
    Specified by:
    
    getContentCardsLastUpdatedInSecondsFromEpoch in interface IAppboy
    
    Returns:
    
    The Unix timestamp (in seconds) of when this snapshot of Content Cards was last received from Braze's servers. If Content Cards information cannot be retrieved, returns -1.
    
    See Also:
    
    IAppboy.requestContentCardsRefresh(boolean)
  - getCachedContentCards
```
public java.util.List<Card> getCachedContentCards()
```
    Description copied from interface: IAppboy
    
    Retrieves the offline/cached list of Content Cards from offline storage. Useful method to synchronously check the state of Content Cards already synced to the device.
    
    Specified by:
    
    getCachedContentCards in interface IAppboy
    
    Returns:
    
    The list of cached Content Cards. Note that this does not request a fresh list of Content Cards from Braze. If the SDK is disabled or the cached list of cards cannot be retrieved, returns null.
  - deserializeContentCard
```
public Card deserializeContentCard(java.lang.String contentCardString)
```
    Description copied from interface: IAppboy
    
    Helper method for IAppboy.deserializeContentCard(JSONObject).
    
    Specified by:
    
    deserializeContentCard in interface IAppboy
    
    Parameters:
    
    contentCardString - The string content of a Content Card's JSONObject obtained via JSONObject.toString().
  - deserializeContentCard
```
public Card deserializeContentCard(org.json.JSONObject contentCardJson)
```
    Description copied from interface: IAppboy
    
    Constructs a Content Card from its Card.forJsonPut() output. Useful for caching Content Card data and recreating them for your own purposes.
    
    Note that the analytics methods on this deserialized cards will work in the same way as a standard Braze provided Card. I.e. clicks and impressions can be logged on the returned object.
    
    Specified by:
    
    deserializeContentCard in interface IAppboy
    
    Parameters:
    
    contentCardJson - The JSONObject representation of a Content Card as obtained via Card.forJsonPut().
  - logFeedCardImpression
```
public void logFeedCardImpression(java.lang.String cardId)
```
    Specified by:
    
    logFeedCardImpression in interface IAppboy
    
    Parameters:
    
    cardId - The ID of the feed card.
    
    See Also:
    
    Card.logImpression()
  - logFeedCardClick
```
public void logFeedCardClick(java.lang.String cardId)
```
    Specified by:
    
    logFeedCardClick in interface IAppboy
    
    Parameters:
    
    cardId - The ID of the feed card.
    
    See Also:
    
    Card.logClick()
  - deserializeInAppMessageString
```
public IInAppMessage deserializeInAppMessageString(java.lang.String inAppMessageJsonString)
```
    Description copied from interface: IAppboy
    
    This function returns a deserialized in-app message from the message JSON string.
    
    Specified by:
    
    deserializeInAppMessageString in interface IAppboy
    
    Parameters:
    
    inAppMessageJsonString - The in-app message JSON string
  - requestGeofences
```
public void requestGeofences(double latitude,
                             double longitude)
```
    Description copied from interface: IAppboy
    
    Requests a refresh of Braze Geofences for the specified GPS coordinate.
    
    Note that Braze Geofences can be requested (either manually here or automatically by default) a max of 1 times per session. To be sure that this method has an effect, you should disable Braze Geofences from being automatically requested on session start in your configuration.
    
    This method should be called after location permissions have be provided to the SDK and after a session has been started.
    
    Specified by:
    
    requestGeofences in interface IAppboy
    
    Parameters:
    
    latitude - A valid GPS latitude in range (-90, 90)
    
    longitude - A valid GPS longitude in range (-180, 180)
    
    See Also:
    
    AppboyConfig.Builder#setAutomaticGeofenceRequestsEnabled(boolean), ValidationUtils.isValidLocation(double, double)
  - setGoogleAdvertisingId
```
public void setGoogleAdvertisingId(java.lang.String googleAdvertisingId,
                                   boolean limitAdTrackingEnabled)
```
    Description copied from interface: IAppboy
    
    Sets the Google Advertising ID and associated ad-tracking enabled field for this device. Note that the SDK does not automatically collect this data.
    
    Specified by:
    
    setGoogleAdvertisingId in interface IAppboy
    
    Parameters:
    
    googleAdvertisingId - The Google Advertising ID.
    
    limitAdTrackingEnabled - Whether ad-tracking is enabled for the Google Advertising ID.
  - getDeviceId
```
public java.lang.String getDeviceId()
```
    Get the device ID - a randomly generated, app specific ID that is stored on the device. A new ID will be generated if the user clears the data for the app or removes/re-installs the app. The ID will persist across changeUser(String) calls.
    
    Returns:
    
    The device ID.
  - getConfiguredApiKey
```
public static java.lang.String getConfiguredApiKey(android.content.Context context)
```
    A helper method to determine if the SDK is configured with an API key. Note that the SDK should not be called without a configured API key under any circumstances.
    
    Returns:
    
    Returns the configured Braze API key, or null if not set.
  - setOutboundNetworkRequestsOffline
```
public static void setOutboundNetworkRequestsOffline(boolean isOffline)
```
    Pauses or resumes outbound network requests from the Braze SDK at any point during runtime. Events are not lost during the offline state. Manual requests made from the Appboy singleton will also be offline. Single shot requests in offline mode, (such as templating, image, and file requests) are lost and will not be repeated later. Basically, everything that is not an event logged to a session will be lost.
    Offline mode defaults to false, meaning outbound network requests are enabled by default.
    The following is a breakdown of network behavior for various facets of the Braze SDK.
    For push, inbound push messages will still be received, but any network requests required to display the notification will not download. For example, if a push message contains a remote image url and text, only the text will display on the notification since the remote image won't be downloaded in offline mode.
    For in-app messages, any outbound network request for a non-cached image will not download and the in-app message will not display. Images that are locally cached will display normally in the in-app message. The Braze SDK does not display any in-app message where the required assets are not available. In offline mode, this means that any in-app message with images not cached locally will not display.
    For HTML in-app messages, zip asset files can't be downloaded in offline mode and thus the HTML in-app message won't be displayed. However, if the assets have already been downloaded, then the message will be displayed. Additionally, the WebView displaying the HTML in-app message will not respect the offline mode value. I.e., any outbound network requests originating from inside the HTML in-app message itself will proceed with no respect to the offline state. This is because these network requests are not handled by Appboy.
    For the News Feed, non-cached images will not be downloaded in offline mode. Images that are locally cached will display normally. Any WebView opened from a News Feed card will not respect the offline mode value. Thus network requests from inside a WebView opened from the News Feed will proceed without respect to the offline state.
    
    Parameters:
    
    isOffline - If true, sets the SDK to offline and pauses all outbound network requests. If false, all outbound network requests from the SDK are enabled.
  - getOutboundNetworkRequestsOffline
```
public static boolean getOutboundNetworkRequestsOffline()
```
    Returns:
    
    Whether outbound network requests from the Braze SDK are offline.
    
    See Also:
    
    setOutboundNetworkRequestsOffline(boolean)
  - setAppboyEndpointProvider
```
public static void setAppboyEndpointProvider(IAppboyEndpointProvider appboyEndpointProvider)
```
    Sets an IAppboyEndpointProvider to be used to route Braze API traffic
    Note that if a custom endpoint is specified using AppboyConfig.Builder#setCustomEndpoint(String) or via appboy.xml configuration, any IAppboyEndpointProvider previously set using this method will be overridden when the Appboy singleton initializes.
    
    Parameters:
    
    appboyEndpointProvider - The IAppboyEndpointProvider that will return the URI for routing Braze traffic
  - clearAppboyEndpointProvider
```
public static void clearAppboyEndpointProvider()
```
    Clear the currently set IAppboyEndpointProvider
  - getAppboyApiEndpoint
```
public static android.net.Uri getAppboyApiEndpoint(android.net.Uri appboyEndpoint)
```
    If an IAppboyEndpointProvider is configured, that provider's delegate is used to generate the Uri for the Braze API endpoint. Otherwise, return the Uri given.
    
    Parameters:
    
    appboyEndpoint - A Uri for a Braze API endpoint
    
    Returns:
    
    A Braze Api Endpoint Uri
  - setCustomAppboyNotificationFactory
```
public static void setCustomAppboyNotificationFactory(IAppboyNotificationFactory customAppboyNotificationFactory)
```
    Set a custom IAppboyNotificationFactory to be used to modify or create Braze push notifications.
    To ensure that your custom notification factory is always set before a notification is received, call this method in the Application.onCreate() method of your Application class.
    
    Parameters:
    
    customAppboyNotificationFactory - The IAppboyNotificationFactory that will return the notification to be displayed.
  - getCustomAppboyNotificationFactory
```
public static IAppboyNotificationFactory getCustomAppboyNotificationFactory()
```
    Returns the currently set custom IAppboyNotificationFactory or null.
  - configure
```
public static boolean configure(android.content.Context context,
                                AppboyConfig config)
```
    Optional static method to set configuration values for the Appboy singleton, overriding whatever values are present in the appboy.xml. Calling this method at the beginning of each app run is encouraged.
    
    Note that if the singleton is active, this this method will have no effect. Calling `wipeData()`, `disableSdk()`, or failing to properly provide an API key will reset the ability to call `configure()`.
    
    Override values will persist through app runs. To clear the override cache, pass a null config object. Multiple calls to configure will merge together. For example, setting parameter A in one config calls and parameter B in another config call will result in both parameter A & B being present in the override cache.
    
    Parameters:
    
    context - Application context
    
    config - An AppboyConfig to override any values in the `appboy.xml` configuration or from a previously set AppboyConfig
  - enableMockAppboyNetworkRequestsAndDropEventsMode
```
public static boolean enableMockAppboyNetworkRequestsAndDropEventsMode()
```
    Testing utility method that enables mocking for all Braze SDK network requests, essentially turning the SDK "off". Calls to the Braze server will be mocked and return success responses with no content (i.e. no in-app messages or News Feed cards will be received). All events dispatched while this mode is enabled will be dropped, meaning sessions or events logged while in this mode will almost certainly be lost. To have effect, this method MUST be called before any call to getInstance() in a given app run (in the onCreate() method of your application is a good place).
    This method is intended to be used for CI and other automated solutions, to prevent test data from polluting your Braze dashboard. This method should not be used in a production environment.
    
    Returns:
    
    true if this was called before the first call (and will have effect) to getInstance() or else false.
  - disableSdk
```
public static void disableSdk(android.content.Context context)
```
    Disables the Braze SDK. This call persists across Braze SDK instances until enableSdk(Context) is called.
    Any in-flight actions such as event logging, data syncing, etc. will be dropped and not retried as a result of this call.
    Any stored instances of Appboy should not be used. A new instance of getInstance(Context) should be obtained after this call.
    All network requests for subsequent invocations of the Braze SDK (including new instances) will be offline. To re-enable network requests and Braze SDK functionality, call enableSdk(Context).
  - enableSdk
```
public static void enableSdk(android.content.Context context)
```
    Enables the Braze SDK after an invocation of disableSdk(Context). Note that the Braze SDK is enabled by default.
    All network requests will be online as a result of this call.
  - wipeData
```
public static void wipeData(android.content.Context context)
```
    Hard resets all data created by the Braze SDK from the internal storage directory. Note that any in-flight actions such as event logging, data syncing, etc. will be cancelled as a result of this call.
    Note that any references to this Appboy instance will be unusable after this call. Subsequent calls to getInstance(Context) will be usable.

Class Appboy

Method Summary

Methods inherited from class java.lang.Object

Method Detail

getInstance

openSession

closeSession

logCustomEvent

logCustomEvent

logPurchase

logPurchase

logPurchase

logPurchase

logPushNotificationOpened

logPushNotificationOpened

logPushNotificationActionClicked

logPushStoryPageClicked

logContentCardsDisplayed

logFeedDisplayed

requestFeedRefreshFromCache

requestFeedRefresh

requestContentCardsRefresh

requestImmediateDataFlush

subscribeToNewInAppMessages

subscribeToContentCardsUpdates

subscribeToFeedUpdates

subscribeToSessionUpdates

subscribeToNetworkFailures

removeSingleSubscription

changeUser

getCurrentUser

getCurrentUser

registerAppboyPushMessages

getAppboyPushMessageRegistrationId

getInstallTrackingId

getAppboyImageLoader

setAppboyImageLoader

getContentCardCount

getContentCardUnviewedCount

getContentCardsLastUpdatedInSecondsFromEpoch

getCachedContentCards

deserializeContentCard

deserializeContentCard

logFeedCardImpression

logFeedCardClick

deserializeInAppMessageString

requestGeofences

setGoogleAdvertisingId

getDeviceId

getConfiguredApiKey

setOutboundNetworkRequestsOffline

getOutboundNetworkRequestsOffline

setAppboyEndpointProvider

clearAppboyEndpointProvider

getAppboyApiEndpoint

setCustomAppboyNotificationFactory

getCustomAppboyNotificationFactory

configure

enableMockAppboyNetworkRequestsAndDropEventsMode

disableSdk

enableSdk

wipeData