FirebaseInAppMessaging

public class FirebaseInAppMessaging extends Object

The entry point of the Firebase In App Messaging headless SDK.

Firebase In-App Messaging will automatically initialize, and start listening for events.

This feature uses a Firebase Instance ID token to:

identify the app instance
fetch messages from the Firebase backend
send usage metrics to the Firebase backend.

To delete the Instance ID and the data associated with it, see deleteInstanceId().

Public Method Summary

void	addClickListener(FirebaseInAppMessagingClickListener clickListener) Registers a click listener with FIAM, which will be notified on every FIAM click
void	addClickListener(FirebaseInAppMessagingClickListener clickListener, Executor executor) Registers a click listener with FIAM, which will be notified on every FIAM click, and triggered on the provided executor
void	addDisplayErrorListener(FirebaseInAppMessagingDisplayErrorListener displayErrorListener) Registers a display error listener with FIAM, which will be notified on every FIAM display error
void	addDisplayErrorListener(FirebaseInAppMessagingDisplayErrorListener displayErrorListener, Executor executor) Registers a display error listener with FIAM, which will be notified on every FIAM display error, and triggered on the provided executor
void	addImpressionListener(FirebaseInAppMessagingImpressionListener impressionListener) Registers an impression listener with FIAM, which will be notified on every FIAM impression
void	addImpressionListener(FirebaseInAppMessagingImpressionListener impressionListener, Executor executor) Registers an impression listener with FIAM, which will be notified on every FIAM impression, and triggered on the provided executor
boolean	areMessagesSuppressed() Determine whether messages are suppressed or not.
static FirebaseInAppMessaging	getInstance() Get FirebaseInAppMessaging instance using the firebase app returned by `getInstance()`
boolean	isAutomaticDataCollectionEnabled() Determine whether automatic data collection is enabled or not
void	removeClickListener(FirebaseInAppMessagingClickListener clickListener) Unregisters a click listener
void	removeDisplayErrorListener(FirebaseInAppMessagingDisplayErrorListener displayErrorListener) Unregisters a display error listener
void	removeImpressionListener(FirebaseInAppMessagingImpressionListener impressionListener) Unregisters an impression listener
void	setAutomaticDataCollectionEnabled(boolean isAutomaticCollectionEnabled) Enable or disable automatic data collection for Firebase In-App Messaging.
void	setMessageDisplayComponent(FirebaseInAppMessagingDisplay messageDisplay)
void	setMessagesSuppressed(Boolean areMessagesSuppressed) Enable or disable suppression of Firebase In App Messaging messages When enabled, no in app messages will be rendered until either you either disable suppression, or the app restarts, as this state is not preserved over app restarts.

Inherited Method Summary

From class java.lang.Object

Object	clone()
boolean	equals(Object arg0)
void	finalize()
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Public Methods

public void addClickListener (FirebaseInAppMessagingClickListener clickListener)

Registers a click listener with FIAM, which will be notified on every FIAM click

public void addClickListener (FirebaseInAppMessagingClickListener clickListener, Executor executor)

Registers a click listener with FIAM, which will be notified on every FIAM click, and triggered on the provided executor

public void addDisplayErrorListener (FirebaseInAppMessagingDisplayErrorListener displayErrorListener)

Registers a display error listener with FIAM, which will be notified on every FIAM display error

public void addDisplayErrorListener (FirebaseInAppMessagingDisplayErrorListener displayErrorListener, Executor executor)

Registers a display error listener with FIAM, which will be notified on every FIAM display error, and triggered on the provided executor

public void addImpressionListener (FirebaseInAppMessagingImpressionListener impressionListener)

Registers an impression listener with FIAM, which will be notified on every FIAM impression

public void addImpressionListener (FirebaseInAppMessagingImpressionListener impressionListener, Executor executor)

Registers an impression listener with FIAM, which will be notified on every FIAM impression, and triggered on the provided executor

public boolean areMessagesSuppressed ()

Determine whether messages are suppressed or not. This is honored by the UI sdk, which handles rendering the in app message.

Returns

true if messages should be suppressed

public static FirebaseInAppMessaging getInstance ()

Get FirebaseInAppMessaging instance using the firebase app returned by getInstance()

public boolean isAutomaticDataCollectionEnabled ()

Determine whether automatic data collection is enabled or not

Returns

true if auto initialization is required

public void removeClickListener (FirebaseInAppMessagingClickListener clickListener)

Unregisters a click listener

public void removeDisplayErrorListener (FirebaseInAppMessagingDisplayErrorListener displayErrorListener)

Unregisters a display error listener

public void removeImpressionListener (FirebaseInAppMessagingImpressionListener impressionListener)

Unregisters an impression listener

public void setAutomaticDataCollectionEnabled (boolean isAutomaticCollectionEnabled)

Enable or disable automatic data collection for Firebase In-App Messaging.

When enabled, generates a registration token on app startup if there is no valid one and generates a new token when it is deleted (which prevents deleteInstanceId() from stopping the periodic sending of data). This setting is persisted across app restarts and overrides the setting specified in your manifest.

By default, auto-initialization is enabled. If you need to change the default, (for example, because you want to prompt the user before generates/refreshes a registration token on app startup), add to your application’s manifest:

            <meta-data android:name="firebase_inapp_messaging_auto_init_enabled" android:value="false" />

Note, this will require you to manually initialize Firebase In-App Messaging, via:

            FirebaseInAppMessaging.getInstance().setAutomaticDataCollectionEnabled(true)

Parameters

isAutomaticCollectionEnabled	Whether isEnabled

public void setMessageDisplayComponent (FirebaseInAppMessagingDisplay messageDisplay)

public void setMessagesSuppressed (Boolean areMessagesSuppressed)

Enable or disable suppression of Firebase In App Messaging messages

When enabled, no in app messages will be rendered until either you either disable suppression, or the app restarts, as this state is not preserved over app restarts.

By default, messages are not suppressed.

Parameters

areMessagesSuppressed	Whether messages should be suppressed