Demo App Guide
Use the Demo app to learn how to use Infobip mobile messaging products. The app helps you test and demonstrate mobile push notifications, in-app messages, Live chat, and the mobile audience profiling capabilities of People.
You can test the functionality of Infobip's mobile messaging SDK without the need for code development or integrating the SDK into a live mobile app.
The following sections explain how to download, install, and test the demo app.
The examples in this guide are for Android devices. The screens might look different on iOS devices.
Supported operating systems
- Android version 5.0.0 or higher
- iOS version 7.0.0 or higher
Download the app
-
On the Infobip web interface (opens in a new tab), go to Channels and Numbers > Channels > Mobile Applications.
-
Follow one of these options as applicable.
-
If the Demo app was not created in your account: In the Profiles tab >Try demo app section, select Get started.
-
If the Demo app was created in your account: In the Profiles tab, find the Demo app in the list. Select Share demo application.
Alternatively, open the Demo app and select Share demo app.
-
-
Enter the email addresses of recipients to invite them to join the Demo app. Include your email address as well.
-
When you get the invitation, open it on a mobile phone and download the Demo app.
Launch the app
In the Demo app, enter the credentials for your Infobip account. Follow the on-screen instructions.
On the last screen, you will see a request to allow the demo app to send mobile push notifications. For demonstration purposes, select Allow.
View profile in People
After you install and launch the Demo app, the mobile SDK notifies the Infobip platform. A person profile with the app's pushRegistrationId is automatically created in People. The pushRegistrationId is specific to the app instance and the device that has this app instance. This ID remains the same during the lifecycle of the app on the device - from the time you install the app to the time you uninstall it.
To view the pushRegistrationId in your demo app, go to About > Infobip registration ID.
To see the person profile, on the Infobip web interface (opens in a new tab), go to People > Persons. In the list of profiles, you can see a No name profile.
Alternatively, you can filter by Source > Mobile SDK to find the profile.
View system data and device attributes
View in People
In People, select the person profile. In the Activity feed section, you can see the following information.
- Person created event: Information about when the profile was created.
- Mobile app: Install event: Information about the app installation on the end user's device. This event also shows the name of the app - Demo application. Select Show more to see key system information that was fetched by mobile SDK. Example: Platform, application version, device, operating system, and SDK version.
The Infobip platform also tracks whether the app has been uninstalled from the device. If the person profile has the Mobile app: Uninstall event, you can take relevant action. Example: You can communicate with the end user over other channels such as Email or SMS, or send the end user a new invitation to download the app.
Select Show more to view additional information about the events.
To view more information about the app, go to the Contact information tab > Mobile applications section. You can see the name of the app and the pushRegistrationID.
Enable Show additional information to see details such as platform, application version, device, operating system, and SDK version.
View in the app
In the Demo app, go to User > Device data > Standard device attributes. You can see the system information fetched by the mobile SDK.
Custom attributes
You can also set custom device attributes that are specific to your app instance. Example: Create a custom attribute, source_paid, to indicate the source of acquisition.
To create a custom attribute, do the following.
- In the Demo app, go to User > Device data > Custom device attributes.
- Select Add custom attribute.
- Select the attribute Type.
- Enter a Name for the attribute and enter its Value.
- Select Add.
You can now view this custom attribute in People.
- In People, go to the person profile > Contact information tab > Mobile applications section.
- Enable Show additional information.
Personalization
The person profile that is created in People is marked as an anonymous profile of type Lead.
To get personalized messages and to store custom events in the profile, you must link the app to a person profile in People. You can either customize the anonymous profile or link to an existing profile.
To personalize the profile, in the Demo app, go to User > Personalization data.
The message shows that the app is not yet personalized.
Personalize the profile
In the app, set one or more of the following identification attributes and select Add.
- External user ID: This is the ID from an external system such as a CRM.
- Phone number
In the following example, the email address, testdemoapp@test123ib.com, is added.
The profile is now updated in People. Select the person profile and go to the Activity feed section > Change in person profile event. You can view the identification attribute that you added.
Link to existing Person profile
You can link the app installation to an existing Person profile of type Customer in People.
In the app, set one or more of the following identification attributes of an existing Customer profile and select Add.
- External user ID
- Phone number
The pushRegistrationID from the anonymous profile is now assigned to the selected customer profile.
In the app, you can now see the profile data that is fetched from People.
Remove personalization
To remove personalization, in the demo app, select the profile. Select Unlink this profile.
Attributes and tags
The mobile SDK supports fetching standard attributes, custom attributes, and tags from People, and updating them in the app. The changes are shared across all devices.
In the app, go to User > Attributes and tags. For personalized devices, you can see the standard attributes from People.
To test the app, update any of the standard person attributes in the app, and select Save changes.
To verify that these changes are automatically updated in People, go to the Attributes, tags, and events tab in the person profile.
Similarly, you can update the custom attributes and tags.
Example: In the app, change the clothing_size custom person attribute from XXL to S.
To verify that these changes are automatically updated in People, go to the Attributes, tags, and events tab in the person profile.
Track events
Use events to track end user activities inside or outside the mobile app. You can also use events to trigger timely communication with the mobile app user.
Use the demo application to recreate app behavior and trigger standard and custom events.
You can also use the demo application to test different events and event-triggered scenarios before implementing it in your production application.
To track custom events in the demo application, make sure that you have defined the event in People.
In the Demo app, do the following.
- Go to User > Custom events.
- Add the Event ID from the event in People. Example: Accountopeningstarted.
- To add event properties, select Add property.
- Select the attribute Type. You must use the same data type that is specified in the event definition in People. Example: For the Accountopeningstarted event, the data type for the property is Text. So, select Text.
- Enter the attribute Name and Value. You must use the same name that is specified in the event definition in People.
- Select Send event to send a custom event to the Infobip platform.
If the event details are correct, you can now see the event in People. If the event details were not configured correctly, an error message is displayed.
In People, go to the person profile > Activity feed section.
Send Mobile push notifications
After you finish setting up the demo app, you can send Mobile push notifications through Broadcast and Flow to the Demo app.
To make sure that you target the correct audience, create Segments in People. Example: To target end users who are eligible for a gift card, create the giftCard segment.
Send Mobile push over Broadcast
- Select Mobile push as the communication channel.
- Specify the recipients of the push notification. You can select recipients from People, use tags, or use predefined segments.
- Select Demo app as the Sender.
- Create the content of the push notification in the editor.
For more information, refer to the Send Mobile push over Broadcast documentation.
Send Mobile push over Flow
You can use Flow to send mobile push notifications to the Demo app. You can build communication scenarios that are triggered by events such as purchases or application launch. You can also combine mobile push with other channels for failover scenarios.
For more information, refer to the Send Mobile push over Flow documentation.
Analyze
After you send your first push notification, you will receive a message on your mobile device. The mobile SDK automatically creates a delivery report. If you open the message, the mobile SDK also adds the seen status.
To get a detailed report, search for your communication and select it.
The example below shows 1 valid recipient (person profile in People) with 2 registered devices (2 messages delivered and sent). The seen rate is 50%, which indicates that the message was opened on only one of the two devices.
