Configuring the Integration

Introduction

To work with the Offer Wall Edge using the Fyber SDK you must ensure that you have:

Note

Before you can configure the Offer Wall Edge, you must ensure that you have your virtual currency configured. If you have not already done so, you can modify your App Settings.

Step 1: Enabling the Offer Wall Edge

  1. Go to the Dashboard and click through to your selected App.
  2. Go to Placements and select the app from the list. Make sure Status is set to On.
3ff9ca1-Screen_Shot_2020-03-04_at_14.08.47.png
  1. Select the currency you wish to use for video rewards from the Virtual currency dropdown menu.
a4b6f48-Screen_Shot_2020-03-04_at_14.10.02.png
  1. In the Exchange rate field enter the number of your virtual currency that equates to one Euro or Dollar (depending on the currency you have set in your account settings).
  2. Select the Round up low rewards to 1 unit of virtual currency (recommended) if you want to show offers that reward less than 1 of your virtual currency.
    In such cases, its reward rounded up to 1.
4d4b545-Screen_Shot_2020-03-04_at_14.11.57.png
  1. Click Save to save your Offer Wall configurations.
2d473ac-Screen_Shot_2020-03-04_at_13.57.05.png

Setting up the Offer Wall

Step 2: Displaying the Offer Wall Edge

Follow these steps to set up the display.

The SDK header is included in your View Controller:

Objective-C
#import "FyberSDK.h"

The following code snippet must be added to display Offer Wall Edge:

Objective-CSwift
// Creating an instance of the FYBOfferWallViewController
FYBOfferWallViewController *offerWallViewController = [FyberSDK offerWallViewController];

// If YES the offer wall will be dismissed after clicking on an offer
offerWallViewController.shouldDismissOnRedirect = YES;

// Showing the Offer Wall
[offerWallViewController presentFromViewController:self animated:YES completion:^{
        // The Offer Wall is successfully presented
} dismiss:^(NSError *error) {
        // The Offer Wall is dismissed
        // If an error occurred, the error parameter describes the error otherwise is nil
}];

The optional boolean property shouldDismissOnRedirect is used to control the behavior of of the FYBOfferWallViewController custom class.

This is set to No by default, and Offer Wall Edge remains open after the user is redirected to an offer. If this is set to Yes, Offer Wall Edge is automatically dismissed.

Optional Configuration

By default, Offer Wall Edge is dismissed if it is not fully loaded after 20 seconds.

If you want to change this, add the following key in your application's Info.plist.

Key Type Example Description
FYBOFWRequestTimeout Number 20 Define the time interval after which the Offer Wall is dismissed if it is not fully loaded.
 

Step 3: Choose Your Rewarding Strategy

First, set up the developer Dashboard for the option you choose and then add the code necessary on the SDK side.

There are two options when it comes to rewarding the users with virtual currency: 

Option 1: Using the Virtual Currency Server (VCS)

If you do not run your own servers, Fyber can provide you with virtual currency hosting. This is the default setting for mobile applications in the developer dashboard.

Click here for details of VCS Hosting.

Option 2: Using your Own Server (Server Side)

If you are interested in using your own server to handle virtual rewarding to your users, Fyber can interact with it after you've set up your own server.

Click here for details of Server-Side Hosting.

Note

You must choose one of the two options. You cannot have both.

For more details on Reward Handling, click here.

Note

Make sure to read the Rewarding your Users section to discover the advantages of each method.

Activating Fyber Logging

Fyber provides custom logging to help you troubleshoot your integration. Activate logging before starting up the Fyber SDK to ensure you have logs of the startup itself.

Activate Logging
[FyberSDK setLoggingLevel:FYBLogLevelDebug];

FYBSDKOptions *options = [FYBSDKOptions optionsWithAppId:@"0000" securityToken:@"0000000000000000000"];
[FyberSDK startWithOptions:options];

Best Practice Check

We recommend you disable logging before going live.