MMS Campaigns
This article will explain what you can do within the MMS Project Settings, and guide you through the integration process of MMS. Moreover, it elaborates on the SMS fallback and illustrates how the messages are tracked.
MMS campaigns allow you to create even more personalized campaigns through multimedia messages. Adding images or videos to your campaigns can increase user engagement and brand awareness.
Build Your MMS Campaigns
You can access and create MMS campaigns in two ways:
MMS are handled by the third-party providers Sinch and Infobip. Both provide support only in the US and Canada. Note that due to regulatory requirements, service to Canada is fairly limited.
MMS Project Settings
You can access MMS Project settings under Project Settings > Channels > SMS/MMS. Here you can set up the following:
- The default MMS Provider
- The selected MMS integration will send messages to all new and existing campaigns. That means when the default integration is changed (and settings are saved), all SMS nodes that contain MMS from all existing scenarios will automatically change the integration for sending the messages.
- Two-way SMS/MMS messaging
- You can configure how the system handles incoming MMS messages. You can read more about it in this article.
MMS Integration
You have to configure the integration with the provider so the MMS campaigns will work. At the moment, we offer two MMS providers - Sinch & Infobip. This is commonly set up by the CSM.
Sinch
To set up the integration, follow these steps:
- Go to
Data & Assets > Integrations > Sinch MMS. - Select Sinch as your MMS provider. Here, add your Service plan to your project. Remember that each service plan comes with a rate limit and gets its own message queue. The integration includes tracking of enqueued messages.
- Set up a Service Plan ID that is provided by Sinch.
- Set up the API Authentication Token provided with each service plan.
- Choose your endpoint region based on your data protection requirements. Currently, it is available only in the US.
Infobip
To set up the integration, follow these steps:
- Go to
Data & Assets > Integrations > Infobip MMS. - Select Infobip as your MMS provider. Here, add your API key to your project.
- Set up an API key that is provided by Infobip.
SMS Fallback
Sinch and Infobip convert the MMS into a fallback SMS for the scenarios listed below:
- If the MMS submitted is a greater size than the destination mobile network operator.
- If the content type submitted is not supported by the end carrier MMSC.
- If the Sinch/Infobip determines that the end-user device is not MMS compatible for the content to be delivered. For example, Android Devices do not support PDF and ICS file formats.
If any of these scenarios are met, Sinch/Infobip sends the fallback SMS instead of the MMS message. Fallback SMS is charged and priced as an MMS.
Important notes
- SMS fallback is only triggered in the case where any of the above-listed criteria are met.
- For carriers not supported by Sinch/Infobip or where Sinch/Infobip does not have MMS reach, SMS fallback does not happen.
- Sinch/Infobip is able to obtain handset-type information from delivery receipts and store the record in a handset cache for later use.
- Sinch/Infobip has a database of attributes that we manually match to every new handset in the cache so we can adapt the content during MMS delivery.
- SMS fallback is currently supported in the United States on Short Codes.
MMS size
The maximum upload sizes vary based on the content type, network operator and other variables.
Sinch enables the maximum text size up to 5000 characters, image size up to 3000 KB and video up to 50000 KB. Infobip enables up to 1600 characters and up to 300 KB of data (while most US and Canadian carriers can handle up to 1 MB).
Find details on MMS size limitations in the Infobip and Sinch documentation.
Transcoding for short codes is enabled by default.
MMS Tracking
By default, MMS campaigns trackcampaign event with action_type = mms.
Send to Provider Tracking
When Bloomreach Engagement sends a message to the MMS provider, it immediately tracks the response to the attempt. Either the MMS provider accepts the message for delivery or rejects it, Bloomreach Engagement follows the campaign event with these properties and standard campaign event properties:
| event property | value | description |
|---|---|---|
| action_type | mms | Engagement action type. |
| status | enqueuedenqueue_failed | Describes if a message was or was not successfully forwarded to the SMS provider for delivery. |
| action_id | 12 | Unique ID number of the scenario action node. The number rises proportionally with the order in which you created the nodes in the scenarios. The action_id of the first action is 1, for the second action, it is 2, etc. |
| action_name | e.g. mms_1 | Name you gave to the specific action node within the scenario. |
| campaign_id | e.g. 5c584sa5729971a4f992sj9 | The automatically generated ID of the campaign. |
| campaign_name | e.g. Summer Sale | Name you gave to the campaign. |
| campaign_policy | default | Name of the frequency policy used within the campaign. |
| consent_category | General consent | Name of the consent category used within the campaign. |
| status_code | e.g. E111 | Reason HTTP code for failed requests. Sinch's MMS status codes. Infobip's MMS status codes. |
| error | e.g. "Invalid shortcode" | Reason error code for failed requests. Sinch's MMS status codes. Infobip's MMS status codes. |
Events tracked for MMS
The status tracked for MMS is the same status as for SMS (enqueued (sent), delivered, clicked if Link shortener enabled, etc.). Check out this article for a comprehensive overview of the tracked statuses.
Delivery Reports Tracking
The provider calls Bloomreach Engagement callback with delivery reports as statuses delivered or failed when the recipient's operator responds about the delivery. The delivery and content may change based on the provider. At the moment, we only support Sinch and Infobip as MMS providers.
Successful Delivery
Delivered message tracks status=delivered with attribute type=mms/sms that defines whether the message was delivered as MMS or fallback SMS.
| event property | value | description |
|---|---|---|
| action_type | mms | Engagement action type. |
| status | "delivered" | The message was successfully delivered to the recipient's handset. |
| type | "mms/sms" | Type of delivery as MMS or fallback SMS. |
| number_of_message_parts | number | Count of message parts in case of fallback SMS. |
Failed Delivery
Undelivered messages track status failed with the attribute type=mms/sms that defines whether the message failed as MMS or fallback SMS.
| event property | value | description |
|---|---|---|
| action_type | mms | Engagement action type. |
| status | "failed" | Message failed. |
| status_code | e.g. E101 | Reason HTTP code for failed requests. Sinch's MMS status codes. Infobip's MMS status codes. |
| error | e.g. "Error fetching dynamic content" | Reason error code for failed requests. Sinch's MMS status codes. Infobip's MMS status codes. |
| number_of_message_parts | number, e.g. 2 | Count of message parts. |
Predefined Senders
If you use multiple senders in a single Engagement project, you can now store them as Predefined senders. To access its settings, go to Project Settings > Campaigns > Channels > SMS / MMS.
After you set it up, senders are immediately available in the SMS action node of the scenario. The benefit of using predefined senders is that it helps to create more effective and error-prone MMS campaigns.
Two-way Messaging and Keyword Auto Response
MMS campaigns include support for Two-way messaging and keywords auto responses. In case a user replies to your MMS in the form of an MMS, the messages are processed and scanned for keywords. However, it will be more common that a user will reply to an MMS in the form of an SMS.
An MMS mobile-originated message from a user to your short code/number can also contain images or multiple text parts. Any text part of the MMS will be checked for keywords at the beginning of the message. Learn more about Two-way Messaging and Keyword Auto Response in our article.
Contact Cards
Contact Cards provide a quick and convenient way to share your business name, number, logo, and more with your SMS/MMS subscribers so they save you in their contact list. You can create a bigger emotional connection with your subscribers through SMS/MMS and reduce the potential of filtering your messages by third parties. Learn more about Contact Cards here.
Usage Dashboard
You can view the overview of all outgoing MMS messages on the account or project level within the usage dashboard. In the Communications section, you can see the number of sent MMS communications under ‘MMS’ or fallback SMS under ‘Fallback SMS’.
Updated 4 months ago