API Reference

extensionVersion

The extensionVersion API returns the library version.
Android
iOS (AEP 3.x)
Java
Syntax
public static String extensionVersion();
Example
Messaging.extensionVersion();
Swift
Syntax
public static let extensionVersion
Example
Messaging.extensionVersion
Objective-C
Syntax
public static let extensionVersion
Example
[AEPMobileMessaging extensionVersion];

handleNotificationResponse

The handleNotificationResponse function transmits the push notification interaction feedback.
Android
iOS (AEP 3.x)
Java
Syntax
public static void handleNotificationResponse(final Intent intent, final boolean applicationOpened, final String customActionId);
Variable
Type
Description
intent
Intent
The intent contains information related to the messageId and the data.
applicationOpened
Boolean
Shows whether the application has been opened or not.
actionId
String
The ID of the custom action.
Example
// Intent can be retrieved from the Activity/BroadcastReceiver using the getIntent() method.
Intent intent = getIntent();
Messaging.handleNotificationResponse(intent, true, "customActionId");
Swift
Syntax
static func handleNotificationResponse(_ response: UNNotificationResponse, applicationOpened: Bool, customActionId: String?)
Variable
Type
Description
response
UNNotificationResponse
An object containing information about the push notification details.
applicationOpened
Boolean
Shows whether the application has been opened or not.
customActionId
String
The ID of the custom action.
Example
func userNotificationCenter(_: UNUserNotificationCenter,
didReceive response: UNNotificationResponse,
withCompletionHandler completionHandler: @escaping () -> Void) {
Messaging.handleNotificationResponse(response, applicationOpened: true, customActionId: "customActionId")
completionHandler()
}
Objective-C
Syntax
@objc(handleNotificationResponse:applicationOpened:withCustomActionId:)
static func handleNotificationResponse(_ response: UNNotificationResponse, applicationOpened: Bool, customActionId: String?)
Example
- (void)userNotificationCenter:(UNUserNotificationCenter *)center
didReceiveNotificationResponse:(UNNotificationResponse *)response
withCompletionHandler:(void (^)())completionHandler {
[AEPMobileMessaging handleNotificationResponse:response applicationOpened:YES withCustomActionId:@"customActionId"];
completionHandler();
}

registerExtension

The registerExtension API lets you register your extension with the Mobile Core.
Android
iOS (AEP 3.x)
Java
Syntax
public static void registerExtension();
Example
Messaging.registerExtension();
Swift
Use the MobileCore API registerExtensions to register the Messaging extension.
Syntax
public static func registerExtensions(_ extensions: [NSObject.Type], _ completion: (() -> Void)? = nil)
Example
MobileCore.registerExtensions([Messaging.self, ...], {
// processing after registration
})
Objective-C
Use the AEPMobileCore API registerExtensions to register the Messaging extension.
Syntax
public static func registerExtensions(_ extensions: [NSObject.Type], _ completion: (() -> Void)? = nil)
Example
[AEPMobileCore registerExtensions:@[AEPMobileMessaging.class, ...] completion:^{
// processing after registration
}];

setPushIdentifier

Although this API is provided in Mobile Core, its use is required when implementing AJO for the purposes of syncing push tokens to Adobe Experience Platform services.
The setPushIdentifier API sets the push token, allowing you to sync it with Profile in Adobe Experience Platform.
Android
iOS (AEP 3.x)
To retrieve the push token from Firebase Messaging Service, please follow the tutorial within the Firebase documentation.
Java
Syntax
public static void setPushIdentifier(final String pushIdentifier);
Variable
Type
Description
pushIdentifier
String
The push token that is synced with Adobe Experience Platform.
Example
FirebaseMessaging.getInstance().getToken().addOnCompleteListener(new OnCompleteListener<String>() {
@Override
public void onComplete(@NonNull Task<String> task) {
if (task.isSuccessful()) {
String token = task.getResult();
MobileCore.setPushIdentifier(token);
}
}
});
To retrieve the push token in iOS, please read the tutorial within Apple's documentation.
Swift
Syntax
public static func setPushIdentifier(_ deviceToken: Data?)
Variable
Type
Description
deviceToken
Data
The push token that is synced with Adobe Experience Platform.
Example
func application(_: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
MobileCore.setPushIdentifier(deviceToken)
}
Objective-C
Syntax
public static func setPushIdentifier(_ deviceToken: Data?)
Variable
Type
Description
deviceToken
Data
The push token that is synced with Adobe Experience Platform.
Example
- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
[AEPMobileCore setPushIdentifier:deviceToken];
}

addPushTrackingDetails (Android only)

The addPushTrackingDetails API is used to update a pending intent with important information, such as messageId and Customer Journey information.
Note: Calling this API is mandatory, so the pending intent can be used while tracking push notification interactions.
Android
Java
Syntax
public static boolean addPushTrackingDetails(final Intent intent, final String messageId, final Map<String, String> data)
Variable
Type
Description
intent
Intent
The pending intent that needs to be updated so it can be used when the user interacts with the notification.
messageId
String
The message ID for the push notification.
data
Map<String, String>
The data of the remoteMessage.
This API returns a boolean, indicating whether the intent was updated with necessary information (messageId and Customer Journey data).
Example
boolean success = addPushTrackingDetails(intent, messageId, data)

Public classes

MessagingPushPayload (Android only)

MessagePushPayload is a helper class for extracting the data payload attributes from RemoteMessage, which are used while creating the push notification.
Android
Java
Syntax
public MessagingPushPayload(RemoteMessage message)
Variable
Type
Description
message
RemoteMessage
A message that contains the necessary attributes for creating a push notification.
public MessagingPushPayload(Map<String, String> data)
Variable
Type
Description
data
Map<String, String>
A data payload that contains the necessary attributes for creating a push notification.
Examples
// Using the remote message
@Override
public void onMessageReceived(@NonNull RemoteMessage remoteMessage) {
MessagingPushPayload payload = new MessagingPushPayload(remoteMessage);
}
// Using the data map
@Override
public void onMessageReceived(@NonNull RemoteMessage remoteMessage) {
MessagingPushPayload payload = new MessagingPushPayload(remoteMessage.getData());
}

Public APIs

Public APIs are used to get attributes from the push payload, which are used while creating the push notification.
Android
Java
Syntax
// Returns the title from the remote message
public String getTitle()
// Returns the body from the remote message
public String getBody()
// Returns the sound from the remote message
// The sound string represents the filename of a sound resource bundled in the app.
public String getSound()
// Returns the notification badge count from the remote message
public int getBadgeCount()
// Returns the notification priority from the remote message.
// For more information, please read the Firebase documentation (https://firebase.google.com/docs/reference/fcm/rest/v1/projects.messages#notificationpriority)
public int getNotificationPriority()
// Returns the channel ID from the remote message.
public String getChannelId()
// Returns the icon string from the remote message.
// The icon string represents the drawable resource name in the app.
public String getIcon()
// Returns the image URL from the remote message.
public String getImageUrl()
// Returns the data map from the remote message.
public Map<String, String> getData()
// Returns an ActionType object which represents the type of action which needs to be performed on push notification interaction.
// More information about the ActionType enum definition can be found in the ActionType section below.
public ActionType getActionType()
// Returns the action URI as a string. The action URI is used to direct the push notification interaction.
public String getActionUri()
// Returns a list of ActionButtons. More information about the ActionButtons class definition can be found in the ActionButtons section below.
public List<ActionButton> getActionButtons()
Internal classes and enums
ActionType
public enum ActionType {
DEEPLINK, WEBURL, DISMISS, NONE
}
ActionButtons
// Constructor
public ActionButton(final String label, final String link, final String type)
// Public APIs
// Returns the label for the action button
public String getLabel()
// Returns the link for the action button
public String getLink()
// Returns the ActionType for the action button
public ActionType getType()

Payload keys

Android
iOS (AEP 3.x)
You should use the MessagingPushPayload class to extract the payload values.
FCM Payload Example
{
"message" : {
"android" : {
"collapse_key" : "new_message",
"priority" : "HIGH",
"data" : {
"adb_title" : "Game Request",
"adb_body" : "Bob wants to play chess",
"adb_sound" : "somesound_res",
"adb_n_count" : "3",
"adb_n_priority" : "PRIORITY_LOW",
"adb_channel_id" : "cid",
"adb_icon" : "notification_icon",
"adb_image" : "www.imageUrl.com",
"adb_a_type" : "DEEPLINK/WEBURL/DISMISS",
"adb_uri" : "uri/weburl",
"adb_act" : [
{
"label" : "deeplink",
"uri" : "notificationapp://",
"type" : "DEEPLINK"
},
{
"label" : "weburl",
"uri" : "https://www.yahoo.com",
"type" : "WEBURL"
},
{
"label" : "dismiss",
"uri" : "",
"type" : "DISMISS"
}
],
"some_custom_data_key" : "some data"
}
}
}
}
Key
Type
Description
adb_title
String
The push notification's title
adb_body
String
The push notification's body
adb_sound
String
The push notification's sound
adb_n_count
String
The push notification badge count
adb_n_priority
String
The push notification's priority. For more information, please read the Firebase documentation
adb_channel_id
String
The push notification's channel ID
adb_icon
String
The push notification's icon resource name
adb_image
String
The URL of the image to be displayed on the notification
adb_a_type
enum
An enum that determines what type of action will be performed when the notification is clicked. It can be one of the following values: DEEPLINK, WEBURL, or DISMISS.
adb_uri
String
The URI used for deeplinking. The deeplink is used to open the appropriate webpage or app screen when the notification is clicked.
adb_act
Array
An array that contains the action object(s).
adb_act.label
String
The label for the action object
adb_act.uri
String
The URI for the action object
adb_act.type
enum
The action type for the action object. It can be one of the following values: DEEPLINK, WEBURL, DISMISS
APNS Payload Example
{
"aps":{
"alert":{
"title":"Hello from CJM",
"body":"Have a good day!"
},
"sound":"dingDong",
"badge":2,
"mutable-content":1,
"category":"iosCategory",
"thread-id":"myGroup",
"content-available":1
},
"a":"x",
"b":"y",
"adb_media":"www.imageUrl.com",
"adb_a_type":"DEEPLINK/WEBURL/DISMISS",
"adb_uri":"deeplink://url / weburl",
"adb_act":[
{
"aid":"customId1",
"label":"dismiss",
"type":"DISMISS"
}
]
}
Key
Type
Description
adb_media
String
The URL of the media. In this situation, media refers to either an image or a video. This URL can be used to download the rich media before showing the push notification.
adb_uri
String
The URI used for deeplinking. The deeplink is used to open appropriate webpage or app screen when the notification is clicked.
adb_a_type
enum
An enum that determines what type of action will be performed when the notification is selected. It can be one of the following string values: DEEPLINK, WEBURL, DISMISS.
adb_act
Array
An array that contains the action object(s).
adb_act.aid
String
The ID for the action object.
adb_act.label
String
The name for the action object
adb_act.type
String
The type for the action object. It can be one of the following string values: DEEPLINK, WEBURL, DISMISS
Export as PDF
Copy link
Edit on GitHub
On this page
extensionVersion
handleNotificationResponse
registerExtension
setPushIdentifier
addPushTrackingDetails (Android only)
Public classes
MessagingPushPayload (Android only)
Public APIs
Payload keys