Fyber Rewarded Installs Advertising

To get started with Rewarded Installs advertising, please go to our self-service platform http://acp.fyber.com to create an account.

Once you are logged in, you can create a new campaign by clicking “New Campaign” in the campaigns tab.

  1. Campaign Name: Enter any name for easy reference to the campaign in the future such as “Tiny Tower - Christmas Burst”.
  2. Choose whether your app is already live on the Google Play store. If it is, please enter your package name (How to find my package name) and hit the search button. We will then automatically load all app information from the Google Play store.
  3. Choose “Download and OPEN” for the required action. In case you want users to perform a different action, choose one of the other options and make sure you read “Fyber Rewarded Actions Advertising” for integration instructions.
  4. Enter your bid per install. The bid is one of the factors that determines the ranking of your campaign on our network and thereby the volume you’ll be able to drive.
  5. Enter your campaign caps. You can limit the amount of installs your app will receive per day or for the whole campaign.

Once you are set up, hit save. You will be assigned an AppID that you will need when integrating the Fyber SDK.

Before you can start your campaign, you will need to:

  1. Complete your account information with billing details
  2. Add funds to your account. You can do so via Paypal or by contacting your account manager.
  3. Integrate the Fyber SDK. All you need to do is follow the section “Getting started with Fyber SDK”.
  4. Report the app install when the application starts. If you are using the SDK only as an advertiser you won’t need to start the SDK. Just insert the snippet below on your app onCreate() method:

     InstallReporter.create(myAppId).report(context);
    
  5. Implementing the Fyber Broadcast receiver:
  • After the application’s installation, the Google Play app broadcasts an Intent containing data regarding the campaign, from which the installation was triggered. We use that data to track conversions and optimize campaigns to drive even more installs.
  • If you want to receive and store the data, you have to add the install broadcast receiver in your Android manifest file:
	<receiver
		android:exported="true"
		android:name="com.fyber.receivers.InstallReferrerReceiver" >
		<intent-filter >
			<action android:name="com.android.vending.INSTALL_REFERRER" />
		</intent-filter>
	</receiver>

OPTIONAL: Using Fyber SDK with Existing Broadcast receivers

Only one com.android.vending.INSTALL_REFERRER broadcast receiver can be specified. Therefore, if you already have one INSTALL_REFERRER receiver in the manifest, leave it as is. And instead of copy/pasting the snippet above, simply call the Fyber’s InstallReferrerReceiver from your own receiver, like this:

public class YourReceiver extends BroadcastReceiver {
	@Override
	public void onReceive(Context context, Intent intent) {
		// Your existing receiver code…
		// […]
		com.fyber.receivers.InstallReferrerReceiver installReferrerReceiver =
			new com.fyber.receivers.InstallReferrerReceiver();
		installReferrerReceiver.onReceive(context, intent);
	}
}

If you don’t have access to the source code of the other broadcast receiver for the INSTALL_REFERRER signal in your application, or if you have many receivers interested in this broadcast, you might find more convenient to declare and implement your own BroadcastReceiver and call all other receivers from it:

Implement your own receiver:

public class YourReceiver extends BroadcastReceiver {
@Override
	public void onReceive(Context context, Intent intent) {
		com.fyber.receivers.InstallReferrerReceiver installReferrerReceiver =
			new com.fyber.receivers.InstallReferrerReceiver();
		installReferrerReceiver.onReceive(context, intent);

		anotherInterestedReceiver.onReceive(context, intent);
		yetAnotherReceiver.onReceive(context, intent);

		// […]
	}
}

Declare it in your manifest:

<receiver
	android:exported="true"
	android:name="*** here the qualified class name of your own receiver ***" >
	<intent-filter >
		<action android:name="com.android.vending.INSTALL_REFERRER" />
	</intent-filter>
</receiver>

As soon as all data is provided, the account is funded, and our platform has received the first successful connections from the SDK within your application, your campaign is ready to go live.

Enable your campaign by setting it to “enabled”. Should your campaign already be enabled but hasn’t been live due to lack of balance on your account or missing data, just click “update” on top of the campaign checklist to set it back live.

Offer Suppression

In case you are running your campaign on multiple networks, it might be possible that the user has already installed your app through one of them. To avoid duplicate install of the app and you paying twice for the same user we have developed a suppression feature, which makes the offers not available to users that have already installed the app in the past. This avoids additional charges and shows the user only offers that he can complete.

How do we do it?

To make sure we know about all the users that have already installed app, we need you to integrate our SDK or set up the Server-2-Server tracking so that it notifies us on every new app start (i.e. from both new and existing users). This way our platform can learn and have up-to-date information about all the users already using the app and therefore prevent the offer from being shown to them.

What do you have to do?

That is the best part! Almost nothing! For new integrations you only have to make sure that the SDK or Server-2-Server integration notifies our platform on every start. If you have our SDK already integrated, just adjust the integration to do the same. The rest of the work is done by us automatically — we filter out the duplicates and make sure you acquire and pay for only unique users.