Manage campaigns for multiple mobile apps

With Blueshift, you can use a single account to run campaigns for user bases of different mobile apps. For example, your firm runs an e-wallet business and a food delivery business, and you have separate mobile apps for each. In cases similar to this, you can add an adapter for each mobile app on our platform and manage campaigns for users of all the mobile apps. 

It's possible that a user has installed all your mobile apps. However, you can configure campaigns in such a way that our platform sends a notification only to the targeted mobile app and its specific user. 

 

Get started

To get started, add an adapter of your mobile app on Blueshift. If you have iOS and Android versions of your mobile app, we recommend that you register both the versions with us under the same adapter. Perform the following steps to add an adapter for your mobile app:

  1. Sign in to the Blueshift app. 
  2. On the top right corner, click on the settings icon > Channels.
    select_channels.png

  3. Select Blueshift Push under Push on the Setup Channels page that appears. The Blueshift Push section opens that lists all the adapters.
     blueshift_push_page.png

  4. Click + ADAPTER for a new app and provide an Alias Name for this adapter. This is used for identifying the adapter. Since we recommend that you add a single adapter for iOS and Android versions of your mobile app, we suggest that you provide your mobile app's name.

    If you are modifying an existing adapter, click on its name.

  5. Click +ADD GCM/FCM APPLICATION to register an Android app and provide the following details:

    Application Name

    Specify the name of the mobile app that you are adding to Blueshift. 

    Package Name

    Specify the package name of your mobile app that you provide to Firebase when you register your mobile app. For more information see Register your app with Firebase.

    Authorization Key

    Provide the authorization key that we use to send notifications to your customers' devices. You can find this as the server key under Project Settings > Cloud Messaging in Firebase Console.  For more information, see Authorize Send Requests

  6. Click Save.

If you have an iOS version of this mobile app and you want to register it with us so that you can send notifications to your iOS mobile app’s users using our platform, click + ADD APNS APPLICATION. Under Apple Push Notification Service, a section appears that shows options to provide the following details about the .pem file and the mobile app:

Screen_Shot_2020-06-04_at_8.44.19_PM.png

  • Application Name: Provide the name of the mobile app that you have integrated with Blueshift.
  • Bundle Id: Provide the iOS app's bundle ID that uniquely identifies it. For more information, see Bundle IDs
  • Environment: Choose Production or Sandbox based on your requirement.
  • PEM File: Upload the .pem file. We describe the steps on how to create a .pem file in this document of our developer portal
  • PEM File Password: Provide the password that protects the .pem file. If you generated a .pem file from a .p12 file that was created with a password, provide that password here.

To add an adapter for another mobile app, go back to the Blueshift Push adapters index page, and repeat the procedure above. To set a default adapter if you add more than one adapters, hover your pointer over the adapter, click on the context menu and select Set Default from the drop-down menu that appears. 

set_default_adapter.png

Integrate Blueshift with your mobile app using our SDKs

Even though you have created an adapter of your mobile apps, we need you to integrate our platform with the apps. When you integrate our platform with your mobile app, we can capture events, send in-app messages, push rich notifications, integrate universal links from our campaigns with your app, and more. To integrate our platform with your mobile app, we provide SDKs that make this integration easy. Here's the documentation that you can use to integrate our SDKs:

 

Create a template

The next step in your journey towards enhancing customer engagement on your mobile app requires you to create a template. You use this template to send rich push notifications to users when you create a campaign. For more information on how to create a template, we suggest that you take a look at these documents:

When you create a template, the template editor provides:

  • A preview of the push notification
  • An option to choose the mobile app for which you want to preview the push notification

Push_Preview.png

 

Create a campaign

Now that everything is ready, you can create a campaign. For the purpose of this guide, we'll use the example of a segment triggered campaign. 

Perform the following steps to create a segment triggered campaign:

  1. Sign in to the Blueshift app, select Campaigns on the left navigation panel
  2. Click + CAMPAIGNS on the right panel > Segment Triggered Campaigns and provide a name for the campaign and click CREATE CAMPAIGN. For the purpose of this example, we'll use a segment of users who abandon a purchase. So this campaigns pushes a notification to users who abandon a purchase. 

    We are using a segment triggered campaigns as an example in this document. However, you can create any type of campaign and follow through with the rest of the procedure. For more information on the different types of the campaigns, see: 

  3. Now let's add a trigger to this campaign and we'll choose the Push channel for push notifications.
    push_channel.png

  4. In the Send a push message trigger click on the gear icon show_advanced_settings_.png to show the trigger's advanced settings. 
  5. Under Using one of the following creatives field, select the template that you want to use. 
  6. In the Push message adapter, choose Blueshift Push. You can see that the field Alias Name is enabled when you choose Blueshift Push.
  7. In the Alias Name field, choose a mobile app. In this example campaign, our platform sends notifications to users who abandon a purchase on the mobile app that you select here.
    Trigger_Preview.png     

    You can also choose Most Recently Used App in this field. If you choose this option, we figure out the app that a user mostly recently used, and push notifications to all the devices on which the user has installed this app. 

  8. Click Create Trigger.

Similarly, you can add an in-app trigger. For example, starting from step 3 of the procedure above, perform the following steps:

  1. Select In-App from the list of triggers:
    in-app-channel.png

  2. In the Send an in-app message trigger click on the gear icon show_advanced_settings_.png to show the trigger's advanced settings. 
  3. Under Using one of the following creatives field, select the template that you want to use. 
  4. In the Alias Name field, choose a mobile app's adapter. In this example campaign, our platform sends a welcome message in the app to users when they launch it for the first time.
    in-app_trigger.png     

    You can also choose Most Recently Used App in this field. If you choose this option, we figure out the app that a user mostly recently used, and send in-app messages to all the devices on which the user has installed this app. 
  5. Click Create Trigger.

Our platform now sends notifications and in-app messages to the users of the mobile app that you select based on the conditions that you specify. Although this is a basic campaign to demonstrate the capability of the mobile integration, we suggest that you take a look at the detailed documentation on campaigns. Use this documentation to create advanced, specialized campaigns to suit your needs. 

 

A note about campaign execution

We qualify users who should receive a push message based on a trigger's filter criteria. For example, we create a segment triggered campaign and add two triggers. The left is a high priority trigger for all users who are using the Blueshiftreads app, and another trigger on the right with a lower priority that targets most recently used app. 

campaign_exec_multi_app.png

Now, based on the trigger filters, this campaign is targeted at users based in San Francisco. However, it's possible that all users who qualify the trigger condition may not have the Blueshiftreads app installed. In that case, our platform pushes a notification to those users based on the app that they recently used. This process maximizes the number of users who receive a push notification.  

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request