How can I test my native mobile app?

So you have created a native mobile app and have enabled it for use with BlueConic.

This article describes how to test your native mobile app in the Journey Simulator, which will allow you to use the advantages of the simulator, like set specific properties, force a certain segment or enable or disable specific dialogues or variants.

Set up a Mobile Channel

First, you will have to define a channel for your app.

  1. Select Settings > Channels & BlueConic Hostnames from the BlueConic navigation bar.
  2. Click the Add channel button.
  3. Select the Domain for the new channel, for example Mobile.
  4. In the Channel Settings page, create a new channel of the type "Mobile App".
  5. Give the new channel a name.
  6. Assign the unique ID of your app in the "App ID" field.
    How to create a mobile app in BlueConic and create channels and positions

To define a new position:

  1. Click the Add position button to define a position in the app:
    • iOS: Use the variable name of the class @IBOutlet as defined in your ViewController. E.g. when the variable name is webViewPlaceHolder, enter #webViewPlaceHolder as Selector.
    • Android: Use the android:id as defined in the XML layout resource. E.g. when your resource file contains <WebView android:id="@+id/webViewPlaceHolder" />, enter #webViewPlaceHolder as Selector.
  2. In the Positions screen, enter the Name and Selector.
    How to create a new channel position for an iOS or Android mobile app in BlueConic
  3. Click Save to store the channel.

Your mobile channel is now ready to be used.

Use the BlueConic Simulator for testing

With the Mobile App channel set up, you can now use the BlueConic Simulator to connect to this mobile channel:

  1. Enter the App ID (as defined in the channel) in the address bar.
  2. Scan the QR code that appears in the Simulator with your mobile device. Alternatively, click the button Connect via email to receive an email message that will allow you to open the mobile app. 

How to use QR codes with BlueConic mobile apps to collect, unify, and activate customer data in the CDP

After scanning the code or opening the link from the email, your mobile app should open with a connection to the Simulator. The Simulator responds to the connection by showing information.

How to use the BlueConic Simulator to test mobile apps in the BlueConic CDP

With the connection between BlueConic and your native mobile app established, changes to profile properties in your app will be visible in the Profile widget. Also, profile properties from BlueConic should be available to the app.

Note that the BlueConic mobile API assumes that a native mobile app will pull the most recent information from BlueConic. In other words, BlueConic will not push information to the mobile app. So if you make changes in the Simulator, you will have to refresh the mobile app to retrieve the latest information.