Message

The Message class contains the definition of an in-app message and controls its tracking via Experience Edge events.

iOS Interface - Message

Message objects are only created by the AEPMessaging extension, and passed as the message parameter in MessagingDelegate protocol methods.

Public variables

id

Identifier of the Message. This value matches the Message Execution ID assigned by Adobe Journey Optimizer (AJO) Campaign.

public var id: String

autoTrack

If set to true (default), Experience Edge events will automatically be generated when this Message is triggered, displayed, and dismissed.

public var autoTrack: Bool = true

view

Holds a reference to the message's WKWebView (iOS) or WebView (Android) instance, if it exists.

public var view: UIView? {
    fullscreenMessage?.webView
}

Public functions

show

Signals to the UIService (in AEPServices) that the message should be shown.

If autoTrack is true, calling this method will result in an decisioning.propositionTrigger Edge Event being dispatched.

public func show()

dismiss(suppressAutoTrack:)

Signals to the UIService that the message should be removed from the UI.

If autoTrack is true, calling this method will result in an decisioning.propositionDismiss Edge Event being dispatched.

Parameters

• suppressAutoTrack: If set to true, the decisioning.propositionDismiss Edge Event will not be sent regardless of the autoTrack setting.

iOS

public func dismiss(suppressAutoTrack: Bool? = false)

track(_)

Generates and dispatches an Edge Event for the provided interaction and eventType.

Parameters

• interaction: A custom String value to be recorded in the interaction
• eventType: The MessagingEdgeEventType to be used for the ensuing Edge Event

iOS Swift

public func track(_ interaction: String?, withEdgeEventType eventType: MessagingEdgeEventType)

handleJavascriptMessage(_)

Adds a handler for named JavaScript messages sent from the message's WKWebView.

The parameter passed to handler will contain the body of the message passed from the WKWebView's JavaScript.

For a full guide on how to use handleJavascriptMessage, read Call native code from the Javascript of an in-app message.

Parameters

• name: The name of the message that should be handled by handler
• handler: The method or closure to be called with the body of the message created in the Message's JavaScript

iOS Swift

public func handleJavascriptMessage(_ name: String, withHandler handler: @escaping (Any?) -> Void)

Android Interface - Message

The Message class has the business logic related to the in-app message to perform actions like sending tracking events on interactions and suppress tracking. If your app implements PresentationDelegate, it will receive a Presentable object, which is the Mobile Core class containing in-app message view. You will need to get the Message object associated with Presentable object using the MessagingUtils.getMessageForPresentable(Presentable) API. Refer to this tutorial for more details.

Public functions

show

Signals to the UIService that the message should be shown.

If autoTrack is true, calling this method will result in an "decisioning.propositionDisplay" Edge Event being dispatched.

void show()

dismiss

data-variant=warning

data-slots=text1, text2

Signals to the UIService that the message should be removed from the UI.

If autoTrack is true, calling this method will result in an "decisioning.propositionDismiss" Edge Event being dispatched.

Android Java

void dismiss()

track

Generates and dispatches an Edge Event for the provided interaction and eventType.

Parameters

• interaction: A custom String value to be recorded in the interaction
• eventType: The MessagingEdgeEventType to be used for the ensuing Edge Event

Android Java

void track(final String interaction, final MessagingEdgeEventType eventType)

setAutoTrack

Sets the Message's auto tracking preference.

Parameters

• enabled: If true, Experience Edge events will automatically be generated when this Message is triggered, displayed, or dismissed.

Android Java

void setAutoTrack(boolean enabled)

getAutoTrack

Returns the Message's auto tracking preference.

Android Java

boolean getAutoTrack()

evaluateJavascript

data-variant=warning

data-slots=text1, text2

Evaluates the passed in String content containing JavaScript code using the Message's webview. handleJavascriptMessage must be called with a valid callback before calling evaluateJavascript as the body of the message passed from the JavaScript code execution will be returned in the AdobeCallback .

For a full guide on how to use handleJavascriptMessage, read the guide on executing JavaScript methods from native code.

Parameters

• content: A string containing the JavaScript code to be executed

Android Java

void evaluateJavascript(final String content)

handleJavascriptMessage

data-variant=warning

data-slots=text1, text2

Adds a handler for named JavaScript messages sent from the message's WebView.

The AdobeCallback will contain the body of the message passed from the WebView's JavaScript.

For a full guide on how to use handleJavascriptMessage, read the guide on calling native code from the Javascript of an in-app message.

Parameters

• name: The name of the message that should be handled by the callback
• callback: A callback which will be called with the body of the message created in the Message's JavaScript

Android Java

void handleJavascriptMessage(final String name, final AdobeCallback<String> callback)

getId

Returns the message's id.

String getId()

getParent

data-variant=warning

data-slots=text1, text2

Returns the Object which created this Message.

Object getParent()

getWebView

data-variant=warning

data-slots=text1, text2

Returns a reference to the message's WebView instance, if it exists.

WebView getWebView()