Initial SDK Setup
Installing the Braze SDK will provide you with basic analytics functionality as well as working in-app messages with which you can engage your users.
Get the Xamarin binding
Step 1: Get the Xamarin binding
A Xamarin binding is a way to use native libraries in Xamarin apps. The implementation of a binding consists of building a C# interface to the library, and then using that interface in your application. See the Xamarin documentation.
There are two ways to include the Braze SDK binding.
The first integration method is to include the binding source found here. Under
appboy-component\src\android you will find our binding source code; adding a project reference to the
AppboyPlatform.XamarinAndroidBinding.csproj in your Xamarin application will cause the binding to be built with your project and provide you access to the Braze Android SDK.
The second integration method involves getting the Braze SDK Bindings component from the Xamarin Component store. In your application, if you right click the Components folder and click
Get More Components you will be taken to the component store. Search for ‘Braze’ and install the component into your project.
Note: We require the Xamarin.Android.Support.v4 nuget package/component. If you install as a component this should automatically be added. If you link to our source it will be pulled in as part of that project. If you need to update that package you can do so by manually updating your
packages.config (or the one in our source code).
Step 2: Configure the Braze SDK in appboy.xml
Now that the libraries have been integrated, you have to create an
appboy.xml file in your project’s
Resources/values folder. The contents of that file should resemble the following code snippet:
Note: Be sure to substitute
REPLACE_WITH_YOUR_API_KEY with the API key located the App Settings page of the Braze dashboard.
<?xml version="1.0" encoding="utf-8"?> <resources> <string name="com_appboy_api_key">REPLACE_WITH_YOUR_API_KEY</string> </resources>
Step 3: Add Required Permissions to Android Manifest
Now that you’ve added your API key, you need to add the following permissions to your
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
Note: In Xamarin Studio you can click Options->Android Application and select the Internet and AccessNetworkState permissions through a GUI instead of modifying your
AndroidManifest.xml source directly.
appboy.xml in the Android sample app for an example implementation.
Step 4: Tracking User Sessions and Registering for In-App Messages
To enable user session tracking and register your app for in-app messages, add the following call to the
OnCreate() lifecycle method of the
Application class in your app:
SDK Integration Complete
You should now be able to launch your application and see sessions being logged to the Braze dashboard (along with device information and other analytics). Note: Consult the Android integration instructions for more in depth discussion of best practices for the basic SDK integration.