Last modified January 16, 2020 by Shelly Wolfe

Creating a localized, A/B tested push campaign (new!)

Create, customize, and send a localized, A/B tested push notification to all of your mobile platforms in a single campaign with our redesigned campaign workflow and content editor.

Localized and A/B tested push campaign

Swrve’s streamlined campaign workflow gives you several options to create and manage your push notification campaigns and supports creating a localized, A/B tested push in a single campaign. Standard one-time or recurring push notifications are the first type of notifications to use the new workflow. Presently, there are no changes to how you set up Web push, Push via API, Quick push, or Geo triggered push campaigns.

The new campaign workflow for push is currently available as part of our Early Access program. To have this feature enabled for your app, contact your CSM at support@swrve.com.

Setting up your campaign

The first steps for setting up a localized, A/B tested push campaign are the same as other channels, with a few extra actions. Note that all-platform push campaigns are currently only available for mobile platforms (iOS, Android, Amazon).

Create a new push notification campaign from the campaign center

To set up your campaign

  1. To create a new campaign from your Campaigns center, select Create campaign.
  2. On the Choose your marketing channel screen, select the Push campaign channel.
  3. Under Choose Notification type, select Standard push.
  4. Under Choose platform, select All Platforms. If you need to create a platform-specific campaign, select the individual platform.
  5. To continue to the Campaign overview screen, select Continue.
  6. Enter the Campaign name and Description, then select Save to go to the campaign builder.

The blocks on the campaign screen guide you through building your campaign, but you can complete them in any order. For more information about the basic campaign workflow or other campaign channels, see Campaign overview and channels. In the next few sections, we’ll focus on how to add the content for a push campaign.


Personalizing your content

Create a more relevant message by including dynamic, personalized content in your notification—for example, the customer’s name or a flight destination city.

Insert custom user property with fallback text

To personalize your content

  1. Move your cursor to the point in the text where you want to insert personalized content and select Insert property Insert property icon.
  2. In the Insert a user property dialog, enter part or all of the custom property name in the Select item box and then select the property from the list of values.
  3. To include fallback text that displays if a user doesn’t have a value for the custom property, select Property fallback support. Select Add custom text and then enter the fallback value. Or select Don’t show if you don’t want the content to display for that user.

Adding your notification content

To add or edit your push notification content from the campaign build screen, on the Content block, select add + or edit .

Some options in the Content editor apply to all users, such as Message and Custom buttons. Other content is restricted by platform, such as a GIF for iOS media or Android extended notification content. If you select a single platform when setting up the campaign, the Content editor displays only the options that apply to that platform.

As you add your content, it displays in the device preview on the right side of the editor. Select the relevant platform icon and option from the list to view how the content looks in Lock screen, Extended view, or Banner.

Content preview on different platforms in extended view

We’ll start with how to add basic notification content that applies to all platforms. Then we’ll cover how to add custom buttons and platform-specific options. Finally, we’ll review how to add advanced options like custom properties and alert sounds.

To create your basic message

To include emoji in any text field, select Insert emoji and then select the emoji from the library.
  1. On the Content screen, under Message, enter your notification Title.
  2. Optionally, to add a subtitle, select Add subtitle + and then enter the Subtitle.
  3. In the Body box, enter your notification content. Body is the only content that is mandatory.
  4. If you want to include an image, under Image, upload your image file or select URL to enter the image link.
    If you customize the URL with a custom property that references user-specific content (for example, a user’s profile photo or flight destination image), to specify a fallback image that displays if a user does not have a value for the referenced property, select Image URL fallback. Upload the fallback image or select URL to enter the fallback image link.
  5. Under On engage, select the action you want to take if a customer engages with the notification.
    • Open app – opens the app in the foreground.
    • Deeplink / URL – directs the user to a custom location. For example, you might use a deeplink to direct the user straight to your app store or a flight booking screen. For more information about using deeplinks with push notifications, see How do I implement deeplinks in push notifications?
    • Open in-app message / Conversation – opens the app and triggers the selected in-app message or Conversation campaign. To link a push notification to an in-app message or Conversation campaign, you must first create the linked campaign, which then displays in the list of available campaigns. For more information, see Linking push notifications to in-app campaigns.

To add custom buttons

Add up to three custom buttons to give your users options for interacting with the notification in extended view. You can configure the button actions with deeplinks to direct the customer to a specific screen in your app, or even use the buttons to create a short survey.

Add custom buttons

  1. Select to expand the Custom buttons section.
  2. To add your first button, select Add custom buttons +.
  3. Under Button 1, enter your Button text and select an engagement option from the On engage list.
  4. If you select Deeplink / URL, enter the deeplink addresses for both platforms, or select Copy link to all if the link is the same for all your platforms.
  5. To add more buttons, select Custom button + and repeat steps 3 and 4 as needed.
  6. When you’re finished adding your buttons, select Confirm.

Platform-specific content

Your basic message content and buttons (2) apply to notifications sent to all platforms. iOS and Android also support different content options, such as GIF and audio for iOS (1) or specifying the large icon (3) or different content for Android notifications displayed in extended view (4,5,6).

Platform-specific content for iOS and Android

iOS

To include iOS-specific media, under the Image uploader, select Add iOS-specific media.

Add iOS-specific media content to your notification

Upload your media file or select URL to enter the media link.

If you customize the URL with a custom property that references user-specific content, to specify fallback media that displays if a user does not have a value for the referenced property, select Media URL fallback. Upload the fallback media or select URL to enter the fallback media link.

Android

Android notifications include the option to set a large icon (3) or specify different title and body content that displays when a user views the notification in extended view (4,5,6).

If you include an image in your basic notification content, you’ll be limited in how much text you can include in the extended body. To include a longer message for Android users, leave the main image empty and use the iOS-specific media option to include an image for iOS users only.

Select to expand the Android options section. Then upload or enter the desired content:

  • Large icon – Upload the icon image or select URL to enter the icon image link.
  • Extended title – Enter the title that displays in extended view.
  • Extended body – Enter the notification content that displays in extended view.
  • Extended icon – Upload the icon image or select URL to enter the icon image link.

Advanced options

Use the Advanced options section to include instructional parameters with your notification or to select an alert sound. Select to expand the Advanced options section.

Advanced options for adding key-value pairs or a custom alert sound

Custom properties

To send instructional parameters to your app when you send the push notification, define custom key/value groups or pairs. For example, you might want to direct the user straight to the store (instead of the default start screen) when they open your app from the push notification. Alternatively, you might want tracking parameters to be passed from the push notification for use by your internal or external tracking systems.

To add custom key/value pairs:

  1. Under Custom properties, select Add Group or enter individual Key/Value pairs, as required.
  2. Enter a key/value pair in the Key and Value fields. For example, go_to/storetrial/30days or discount/10percent.
  3. To add the group or individual payloads, select Confirm.

To view a sample of the payload that will be sent with the notification, select View sample payload.

Alert sounds

Some brands use a distinctive alert sound to notify users of an app update, for example, BBC News. To make a sound available with your notifications, you must first configure it at the app level. For more information, see Push campaign prerequisites.

To select a sound for your push notification, turn on the Alert sound toggle and then select the sound from the list.


Localizing and A/B testing your content

One of the most exciting features of our new campaign flow is the ability to localize and A/B test your campaign content within a single, unified campaign. Use the Languages and Variant tabs to create localized versions of your content or create variations of your message to test for best conversion.

Add multiple languages or variants to your content

For more information on how to localize and A/B test your campaign content, see Localizing and A/B testing campaign content.


Testing your message

To preview your message on a physical device, first ensure your device is set up on the QA Devices screen. If your campaign includes multiple languages and variants, select the content you want to test, and then in the header bar, select Send test message Send test message button.

Select your device from the list and then select Send. If the Send button is disabled, check to make sure your message includes all required content.


Next steps