Step 6 - Create your Hybrid Touchpoint and Configure the SDK

With hybrid apps supporting multiple platforms, you have 2 options for creating the relevant Touchpoints. You can either:

  • create a Touchpoint for each platform, as shown in the table below, or
  • consolidate them under a single Touchpoint, for example, ionic://optimization-example, depending on your use case and how you want to organize your data.

For this exercise, we will be creating an Android Touchpoint. You can then use the same steps to set up the iOS Touchpoint.

FieldDescription
ChannelMobile
Touchpoint Name

Android: Android Mobile App

iOS: iOS Mobile App

We recommend a name that resembles your app name and platform to make it easier to identify throughout MXO .

Base URI

Android: android://optimization-example

iOS: iOS://optimization-example

The Base URI you provide must be unique. It is this URI that is used to send data from the SDK, after installation. We recommend using "android://" as the prefix for your Base URI to make it easier to identify throughout MXO and to distinguish it from other platform apps.

To create your Touchpoint

  1. In MXO , choose Collect.
  2. Select Touchpoints.
  3. Click Create.
  4. Create your new Touchpoint, using the details provided in the table above.
  5. Click Save.

Once created, your Touchpoint will appear in the main MXO UI, as follows:

Mobile - Android Step 5 Touchpoint

To configure the SDK

You need to provide the specific parameters for your MXO environment when integrating your hybrid solution with the SDK. Use these parameters to replace the defaults in the Example App and configure the SDK.

These integration parameters include:

  • Site Key (for your specific Space).
  • Touchpoint URI.
    • The native MXO SDK will automatically prefix the URI scheme (that is, android:// and ios://) when it is omitted. For example, if you use optimization-example.
    • If you want to configure a single Touchpoint, you can explicitly prefix your URI scheme. For example ionic://optimization-example.
  • API Key & Shared Secret (required for OAuth 1.0 authentication).
  • Username/User ID (required for OAuth 1.0 authentication)
  • Host name.
  • Admin mode.
    • Admin mode (adminMode: true) provides you with an interface that lets you add Interaction Points, Activity Capture Points, and Attribute Capture Points to native UI elements within the app. Hybrid apps, however, do not support this feature because they typically use non-native UI elements. For Hybrid apps,only Preview mode is supported, allowing you to view your unpublished (In the Works) configuration before you publish to your live environment.
    • The Admin mode build should only be distributed internally to business users involved in MXO setup. This is your internal dev build.
  • User mode.
    • User mode (adminMode: false) builds should be used for production builds, when you are satisfied that all insights are being tracked in Admin mode and all internal QA requirements have been met.

For more information, see Find the Information required when Integrating MXO with Other Solutions.

You can find the example code for SDK configuration, on GitHub, as follows: