Beachfront-iO Unity Sdk
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Beachfront Android Unity SDK usage guide


This document details the process of integrating the Beachfront AD SDK with your Unity Android application.



  1. Access the Console and register your application to get your App ID & Ad unit Id;
  2. Download the Beachfront Unity SDK & import the Beachfront Unity SDK to your Unity project as a custom package.
  3. Add the Google play service library project to Assets > Plugins > Android.
  4. After you've added the Google Play services library as a dependency for your app project, open your app's manifest file and add the following tag as a child of the element:
	<meta-data android:name=""
		android:value="@integer/google_play_services_version" />
  1. Add the BF activity in the application node of AndroidManifesh.xml:
	android:configChanges="keyboardHidden|orientation|screenSize" />
  • Make sure to have android:targetSdkVersion should be equal or greater then 13 in the manifest
 <uses-sdk android:targetSdkVersion="13" />

Add following required permession in your AndroidManifest.xml

  <uses-permission android:name="android.permission.READ_PHONE_STATE" />
  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />  

Once you’ve completed the above steps, you can start displaying ads in your application by following the simple instructions for Interstitial Ad below: In your Game Object C# script (the one from which you want to show the ad), implement the AdListener interface. This will register the Ad events with your game object.

In your Activity class (the one from which you want to show the ad), declare a BFIOInterstitial instance variable, register your activity as the interstitial's BFIOInterstitial.InterstitialListener and instantiate it in the onCreate(Bundle savedInstanceState) method.

public class Demo : MonoBehaviour, AdListener

Declare an instance variable of UnityBFIO type.

UnityBFIO unityBFIO;

Instantiate the Unity BFIO variable in the start method with the APP ID & Add Unity ID

unityBFIO = UnityBFIO.getInstance (appID,adUnitID, this);

Request Ad:


Show Ad:

	unityBFIO.showAD( );

Below is the sample Unity Game Object class integrated with Beachfront .iO:

using UnityEngine;
using System;
using System.Collections;

public class Demo : MonoBehaviour, AdListener { private GUIStyle labelStyle = new GUIStyle();
private float centerX = Screen.width / 2;
UnityBFIO unityBFIO;
String appID = “57d0480b-3784-4741-e240-fb9d67e4b131”; String adUnitID = “43577eec-b857-4050-c716-7759958d1642”;

// Use this for initialization
void Start () {
labelStyle.fontSize = 24;
labelStyle.normal.textColor =; labelStyle.alignment = TextAnchor.MiddleCenter; unityBFIO = UnityBFIO.getInstance (appID,adUnitID, this);

void OnGUI ()
  GUI.Label(new Rect(centerX - 200, 20, 400, 35), "BFIOSDK Demo", labelStyle);
if (GUI.Button(new Rect(centerX - 75, 80, 180, 75), "Request Ad"))

public void onInterstitialFailed(string args){ }
public void onInterstitialStarted(string args){ }
public void onInterstitialClicked(string args){ }
public void onInterstitialDismissed(string args){ }
public void onInterstitialCompleted(string args){ }
public void onReceiveInterstitial(string args){ unityBFIO.showAD( );

Have a bug? Please create an issue on GitHub!