Xamarin In-App Integration for Android Mapp Cloud

The following document describes how to integrate the Xamarin Android plugin to support In-App Messaging.

In order to integrate your app with the In-App Messaging cache service, you will need to configure the Android Configuration File to include the 'Jamie URL' based on your Mapp Engage system ID number (tenant ID) and your Google Project ID. The Jamie URL varies by the location of your Mapp Engage system. Your Mapp account manager or project manager will provide this URL, AppID and SDK Keys to you during onboarding. 

  • CEP_URL: This is the Jamie URL for caching and delivering In-App Messages. A Mapp Cloud account manager or project manager will provide this to you.

  • SDK Key: This is the SDK Key generated from the Mapp Engage Channel Management. There will be a different SDK Key for each app you have configured in your Mapp Engage environment. For example, customers with an Android development, Android Production, iOS development, and iOS production apps, will have four different SDK Keys. One for each app. A Mapp Cloud account manager or project manager will provide this to you. You can also view this in the Mapp Engage system under Administration > Channels. 

  • APP_ID: This is the ID number of your app from the Mapp Engage Channel Management. There will be a different App ID for each app you have configured in your Mapp Engage environment. For example, customers with an Android development, Android Production, iOS development, and iOS production apps, will have four different App ID Keys. One for each app. A Mapp Cloud account manager or project manager will provide this to you. You can also view this in the Mapp Engage system under Administration > Channels. 

  • TENANT_ID: This is the ID number of your Mapp Engage system. A Mapp Cloud account manager or project manager will provide this to you. 

  • Google Project ID: This is the ID number of your Google Project.

If you have all of these parameters correct, you can trigger in-app messages into the application. To create an in-app trigger event in Android, include the following call in your app: 

appoxeeInstance.TriggerDMCCallInApp(this, "event_name");

Example:

private void openInApp(object sender, EventArgs e) { appoxeeInstance.TriggerDMCCallInApp(this, "app_open"); }