Overview
A push message is a great way to communicate with your users and nudge their behaviors throughout a Workflow.
Workflows allow you to send messages to users across your apps—including mobile and web apps. Before we dive into how you can add a message to your Workflow, it's worth explaining the logic of our cross-messaging platform.
A Note About Messaging Across Apps
If your App Group (audience) includes users from both web apps and mobile apps, we'll make sure to message your end users wherever we most recently saw them. Specifically, end users will receive the message associated with the most recent opted-in device and with the most recent app used (session) irrespective of events defined in the workflow.
For example, if a user qualified for the workflow by performing the events as defined in the event criteria AND most recently had a session on the iOS app on mobile, we would try and send an app push notification to the mobile device. However, if there was not a push token associated with the device, we would try and send to the next device with a push token, then the next app.
A Note About Browser Variances
An end user can perform an event in any browser but can only receive the push notification on the browser that was used to opt-in to web push notifications.
For example, a user who’s opted into web push on Chrome could perform the add to cart event on Firefox and still receive a push notification. Likewise, a user who’s opted into iOS app notifications and web app notifications will receive the message on the most recent app used.
Now that you understand the basics, let's dive into adding a message to our Workflow.
Push Message Builder
A Push Message allows you to build a push using the typical message functions like title, deep link, key/value pairs, and creatives.
To add a push message to your Workflow, click the + button.
Select Send push message from the pop-up modal.
This will open another modal where you'll be able to craft your message.
Make sure to give your push message a name by clicking the Untitled Message copy at the top of the modal. We'll use this name to identify the message's "push sent" event in the Events section of your Localytics Dashboard.
You can also customize messages by Application (iOS, Android, Web) by using the icons on the left navigation or by selecting from the dropdown in the right editing column.
Message Title
Add a title to your push as the header of the message. The title will appear as a bold text above the message. The title is an optional piece of copy for your push message—so feel free to skip it if you’d prefer.
Message Body
Finally, it’s time for the most important part of your message—the message body! The message body is the only copy that is mandatory.
We do our best to show you an example of what the message will look like on the left. It’s important to note that there is no official character limit for the message body since each phone and OS will handle the content differently.
Liquid Personalization
You're also able to personalize the title, body, and rich media embed by using Liquid templating (sometimes called dynamic content). Simply place your cursor in the appropriate field and select +Personalize above the Body field.
Read our full guide about Liquid here.
Enable Localization
Localization allows you to create unique messages to customers based on their default language (set within the device). This can be done all within the same message editor.
To enable localization, click the Enable Localization button in the message builder.
Choose the default language. This will be the message sent to users when their preferred language message isn't available. For example, if you have users whose devices are set to French, but no French text, they'll receive the default copy.
For help on selecting a default language, Localytics pulls up quick metrics to tell you just how many users you have associated with each.
After you've set the default language, you can continue adding languages using the dropdown menu.
Toggle between languages/copy using the arrows or select the language from the dropdown menu. To remove a language, click the Options button.
Message Preview
On the left side of your Push Message builder, you’ll see a preview of what your message looks like as you build it. It’s important to note that this is just a preview. Depending on the phone type and style your message will translate differently (ie, an iPhone plus might look different from a regular iPhone).
You'll be able to simulate a customer by toggling the Simulate Customer button available on hover within the Message Preview. Use the Randomize option to populate customer IDs or Profile Lookup to add a specific customer ID.
Live Preview
If your App Group includes a web app, you'll also see an option for Live Preview.
This button allows you to send a quick Web Push notification to your browser to test the push before you set it live. Check out the GIF below for a quick demo.
For more on enabling Live Preview, check out our Test Mode doc.
Message Overview
On the bottom left of the Message Editor, you'll be able to access an Overview of your messages. This is to provide an easy view of all of your messages, especially if you are creating and managing multiple messages within the Message Builder.
Click the Overview button to see all of your messages previewed in one view.
After you've crafted your push message (and checked it between all of your grouped apps), click the Add button to add the push to your Workflow.
