Send Mobile App Messages over API

MAM offers a wide range of possibilities when it comes to destination targeting options. Below you will find the available fields and examples on how they can be used.
 

To send a single Push notification to one or multiple recipients, use this method. When sending a large number of messages or targeting different user segments with different messages to optimize data traffic and increase performance, use this method. 

Destination address types enabled by default:

The following destination address types are not available by default. They should be defined by User Data in SDK.

 

Single Recipient Destination Address Type

Use this method to target recipient’s device associated with the single Push registration ID.
 

"to": {
    "pushRegistrationId": "69827EDB-A806-4AF6-A7F6-98298EAA4F14"
}

With this type of targeting, you can achieve the following:

• target all iOS or Android devices

• target a particular device

• target all devices of a particular external user id

• target all devices linked to a phone number

• target all devices linked to an email

• target all devices associated with any custom data parameter like tag, subscription or other

In the following example, we are targeting all iOS devices.

"to": {
    "platform": "iOS"
}

With this example, all devices that have been associated with the phone number 41793026727 will be targeted.

"to": {
    "phoneNumber": "41793026727"
}

To send a single Push notification to one or multiple recipients, use this method.

Multiple Recipient Destinations of the Single Address Type (IN)

Combining two or more different parameters of the same destination address type can be done as shown in the example below. In this example, the message will be delivered to both iOS and Android users.

 "to": {
    "platform": ["iOS", "Android"]
 }

By using this method you can target all of the user devices according to email address.

 "to": {
    "email": ["jane.smith@somedomain.com", "john.smith@somedomain.com"]
 }

Multiple Destination Address Types (AND)

You can use this method to target a recipient segment by using two or more different address type filters. The message will be delivered only to those recipients who satisfy all filter conditions. In other words, if the recipient’s device matches address type 1 AND address type 2, the message will be sent.

In the following example, all iOS devices of the recipient with a specific external ID will be targeted.

"to": {
    "platform": "iOS",
    "externalUserId": "customer_21234"
}

Multiple Destination Address Types (OR)

In some cases, you may want to segment your recipients by including different filters over multiple destination address types. By using this method, the recipient will receive the message if he satisfies at least one condition. In other words, if the recipient matches address type 1 OR address type 2, a message will be sent.

In the following example, recipients whose favorite pizza is Capricciosa or favorite pasta is Napolitana will be targeted.

"to": {
    "$or": [
        {"FavoritePizza": "Capricciosa"},
        {"FavoritePasta": "Napolitana"}
    ]
}

Advanced Targeting Example

The combination of different targeting methods is also supported.

In the following example, we are targeting Android devices of the recipients who have a specific user ID or at least one of the listed emails.
 

"to": {
    "$or": [
        {"externalUserId": "my-ext_id-1"},
        {"email": ["myEmail_1@domain.com", "myEmail_2@domain.com"]}
    ],
    "platform": "Android"
}