Overview

Skill Level: Any

Prerequisites

You use the 3.x IBM Mobile App Messaging SDKs with Watson Campaign Automation to configure your apps and the actions that are associated with them.

Marketers use customer data and individual behaviors that are collected from various sources to inform and drive real-time personalized customer interactions with Watson Campaign Automation. With mobile app message capabilities in Watson Campaign Automation, your marketers can incorporate mobile app messages to iOS, and Android mobile apps as part of their single or multi-channel marketing campaigns and communicate with targeted groups of customers based on a combination of profile, behavioral, and channel consent data.

Your developer integrates the SDK into your mobile app and then registers and configures each app in the Watson Campaign Automation Development area. For more information, see Add an App in Watson Campaign Automation.

When customers install your mobile app, your marketer can begin tracking user behaviors and use Watson Campaign Automation queries to segment customers based on profile data, behavioral data, and past mobile interactions.

The following table contains the steps and owner of each task that is used in the Mobile App Message process. IBM Silverpop enables Mobile App Messages for your organization.

 

Note:

  • Watson Campaign Automation documentation contains information for marketers, app developers, and organization administrators and requires a user name and password. If you need a user name and password, contact your Client Services representative. IBM Knowledge Center is the home for all SDK-related information. developerWorks¬ģ is an IBM website where you can download the SDKs and learn, develop, and connect with other developers.
  • Only Xamarin.Forms is supported for Xamarin.

Step-by-step

  1. Enable Mobile App Messages for the organization.

    IBM Watson Campaign Automation provisioning performs this task.

     

    Note: As a part of the onboarding process, Provisioning enables the organization for Mobile App Messages. For any questions, contact your Relationship Manager or Client Services. 

  2. Build your mobile app.

    The mobile app developer performs this task.

  3. Register your mobile app.

    The mobile app developer performs this task. Watson Campaign Automation login is not required to view documentation.

    Setting up your iOS app

    Creating a Google API project with GCM

    Creating a Google API project with FCM

  4. Download the SDKs.

    The mobile app developer performs this task. Watson Campaign Automation login is not required to view documentation. 

    Download the IBM Mobile App Messaging SDK for Apple iOS, IBM Mobile App Messaging SDK for Android, the IBM Mobile App Messaging plug-in for Cordova, or the IBM Mobile App Messaging SDK for Xamarin apps at SDKs, Samples and Tools on Github.

  5. Set up your mobile app.

    The Watson Campaign Automation Organization Administrator (Org Admin) sets up the app in Watson Campaign Automation. Watson Campaign Automation login is required to view documentation.

     

    Set up your mobile app in Watson Campaign Automation:

    Enable developer and notification creator user permissions
    Set up Mobile App Messages database

  6. Implement the SDK within your app.

    The Watson Campaign Automation Organization Administrator (Org Admin) performs this task. Watson Campaign Automation login is not required to view documentation.

     

    Implement the iOS SDK within your app
    Implement the Android SDK within your app
    Set up the Xamarin SDK
    Verify or add the Cordova Plug-ins

  7. Test the implementation.

    The  Watson Campaign Automation Organization Administrator (Org Admin) performs this task. Watson Campaign Automation login is not required to view documentation.

    Preparing your iOS app for App Store distribution
    Testing your Android app
    Testing mobile app messages for iOS and Android apps developed with Xamarin
    Test your Apache Cordova iOS and Android apps

  8. Customize your app and include Universal Behavior (UB) events in your app:

    The Watson Campaign Automation Organization Administrator (Org Admin) performs this task. Watson Campaign Automation login is not required to view documentation.

    Configuring advanced push service options for iOS apps
    Configuring advanced push service options for Android apps
    Configuring advanced push services for Xamarin apps
    Find Mobile App Message Data using Universal Behaviors
    Configuring events in Cordova

  9. Add mobile apps to Watson Campaign Automation and set up Mobile Push App Groups.

    The Watson Campaign Automation Organization Administrator (Org Admin) performs this task. Watson Campaign Automation login is required to view documentation.

    In the Development menu, add each mobile app to Apps in Watson Campaign Automation and set up Mobile Push App Groups using the GCM Google API Key or FCM Google API Key, and APNS Certificate file. Developers also have to configure default and custom actions and the message templates.

    For more information about Mobile Push APIs, see APIs for integration.

    For more information about Objective-C APIs, see the iOS Native API reference for iOS apps. This documentation is also available in the  IBM Mobile App Messaging SDK for iOS.

    For more information about Java APIs, see the Android Native API reference for Android apps. This documentation is also available in the IBM Mobile App Messaging SDK for Android.

    For more information about JavaScript APIs, see the Cordova API reference for Cordova apps. This documentation is also available in the IBM Mobile App Messaging Plug-in for Cordova.

  10. Create, schedule, and send a mobile app message.

    Watson Campaign Automation Notification Creator performs this task. Watson Campaign Automation login is required to view documentation. 

     

    Developers must implement actions and messages in the SDK before marketers can create content. For more information, see Mobile app messages for iOS, Mobile app messages for Android, Mobile app messages for Xamarin, and Enabling in-app messages and inbox messages for Cordova.

    Create, schedule, and send a mobile app message in  Watson Campaign Automationby clicking Content > Create Mobile App Message.

    Marketers can also choose to include HTML content in some of the mobile app messages.

Expected outcome

For information about the following common use cases, refer to the corresponding documentation: 

To create reports and view data, go to Push Notification Report.

To create a simple mobile app messages that shows in the mobile user’s device, go to Create, schedule, and send a mobile app message.

Go Back to the Mobile App Messaging home page. 

 

Join The Discussion

Your email address will not be published. Required fields are marked *