Adding an App to the Fyber Console

Having received the acceptance email from Fyber, it's time to start setting up your apps in the console.

Adding an App

Follow these steps to add an app to the console:

1. Sign in to the console with your user name and password, here.
   The App Management window opens:
   

2. Click ADD APP to open the Add App window
   

Adding an App Options

Select the option for the app you are adding to the console.

Editing App Settings

To edit the settings to your app, follow these steps.

1. From the list of apps available, select the app you want to edit
   

Next to each app you can find its active placement types and selected performance metrics that refer to the app's FairBid traffic of the previous day.

2. Click App Settings
   

3. Enter the iTunes URL for an iOS app or Play Store URL for a Google App, as required.
   

4. Amend the Bundle ID and Categories, if necessary.
5. Click Save to save your changes.

Move to the next tab to add Mediated Networks.

Adding Mediated Networks

Now that you have signed up with Fyber, added an app to the console, created and configured placements, the next step is to add mediated networks.

Before adding a mediated network, you must retrieve parameters from the various networks' dashboards.

Adding a Mediated Network

On the App Management window, click Mediated Networks.

The Mediated Network window opens.

Click the Placements button to add and review placements. For more details, click the Placements tab above.

Mediated Networks

Follow these steps to add a mediated network that you want to work with.

1. Click the required mediated network from the list.
   

• Once selected the network configuration window opens, enter the credentials, as required.
  Each network requires different information.
  

3. Click Save and the mediated network is added to the Active Mediated Networks section.
   

You must make sure that you associate an instance of the Mediated Network to a placement and configure it correctly. For details on how to do this, click the Placements tab above.

Repeat this process for each mediated network.

Click here the next tab to create placements for your app.

Creating Placements

Now that you are signed up to Fyber and have added an app to the console, the next step in the process is to add placements.

What is an Ad Placement?

A Placement refers to a location within your app where ads can be displayed. This location might be, for example, on your Start screen, on the Game Over screen or the bottom or top bar of the app.

For each placement, you can define a specific ad format, configuration and delivery rules to maximize performance.

You must have at least one ad placement to monetize your app. 

Adding your Placement

To start adding your ad placement:

1. Log in to the Fyber console, here.
2. Click Apps on the left menu
   

The App Management window opens

3. Select the app for which you want to create placements
4. Click the Active Placement Types and the Placements window opens.  All current placements are displayed.
   

5. Enter the name of the placement.
6. From the dropdown list select the Placement Type

7. Click Save Placement when you have finished and continue to add placements, as required.

All the placements for that app are saved.

From the placement list you can directly add instances and floor price.  This is particularly helpful for those who frequently adjust floor prices.

8. On the Placements window, next to your placement, click the cog icon and click Placement Setup.
   

You can target a specific audience that is exposed to ads running on this Placement.

1. Toggle Targeting to On
2. Select at least one country
   

3. Select network connection option

Floor prices indicate to buyers participating in auctions held in Fyber Marketplace, the minimal price at which you are willing to sell your inventory. By default, it is set to $0.01 for all countries. A floor price must be at least $0.01 or higher otherwise an auction cannot be held. All floor prices are in US dollars.

1. Enter a floor price
2. Select countries and set a different eCPM floor price for them
   

   

3. Filter and amend the floor price individually or by Country Group.

Capping and Pacing

You can limit the number of ads shown on a placement for a given timeframe and also add pacing rule.

Ad Types

Set out below are the details for each specific placement option.

Quick Reporting Metrics

Next to each placement, you can find data of selected reporting metrics that relate to the actual performance of that placement. Using the given metrics, you can easily gain insights into the health of the placement in terms of how well it performs and its revenue contribution.

An explanation of each metric is provided in its tooltip. You can sort the displayed list of placements by each metric to enable a quick insights discovery or to manage the placements in the context of the different metrics such as revenue contribution, engagement, or fill rate.

Ad Network Instances

Move to the next tab to begin creating instances.

Creating Instances

As part of the set-up process for your Placement, you can define Ad Network Instances and arrange them in order of preference within the Console.

Creating an Instance

Once you have configured mediated networks, you can easily add mediated network instances to your placement configuration.

Before you begin to configure your instance, make sure you have first added placements for the ads in your app. For details of how to do this, click here.

You must also enable mediated networks by adding networks' credentials, in the Mediated Networks section.

To configure an Instance, follow these steps:

1. Login to the Fyber Console and select the app for which you want to add instances
2. Next to the relevant placement from the placement list, click Add Instances
   

3. Enter the details of the Instance:

• Instance Name - The internal name of the instance in the Fyber Console and used in reporting
• Ad Network - The network for which you are setting up the instance

• Instance ID - Taken from the dashboard of the selected network. For a detailed guide on how to retrieve parameters per network click here and navigate to the relevant network guide.
  

4. When finished, click Save Instance.
5. The Instance you have configured is shown in the list under the relevant placement.
   

Changing Auto CPM

To change the default Auto CPM setting to Manual CPM, follow these steps:

1. On the Instance line, click AUTO
   

2. Under CPM Prediction Method, click the dropdown menu
3. Select Manual CPM
4. Click Save

Quick Reporting Metrics

Next to each instance, you can find data of selected reporting metrics that relate to the actual performance of that instance. Using the given metrics, you can easily gain insights into the health of the placement in terms of how well it performs and its revenue contribution.

An explanation of each metric is provided in its tooltip. You can sort the displayed list of instances by each metric to enable a quick insights discovery or to manage the instances in the context of the different metrics such as revenue contribution, engagement, to response rate. 

Instance Advanced Settings

The Instance Setup page allows you to manage advanced settings of the Instance. To get to this page Click the three vertical dots at the end of the row and select Instance Setup. 

The Instance Setup page allows you to manage the following settings:

Capping - Limit the number of impressions to be displayed by this Instance in a certain timeframe. Toggle the switch to display the settings and insert your choice of values. 

Pacing - Set a limit of one ad display at most by this Instance in a certain timeframe. Toggle the switch to display the settings and insert your choice of values.

Targeting by country - Choose a list of countries in which the instance will be active, or a list of countries in which it won’t. If a user generates an ad request from a country where the instance isn’t active, the instance is never called and therefore does not provide a fill. 

Pay attention to use the Include/Exclude options carefully according to your targeting choice. Toggle the switch to display the settings and insert your choice of values. 

Targeting by User Tracking Status - This option allows you to restrict the Instance depending on the decision made by the user with regard to allowing tracking. For iOS, It is based on Apple’s App Tracking Transparency (ATT) framework and the availability of IDFA. For Android, It is based on the user's choice of whether to opt-out of Ads Personalization.

Use this advanced setting to create different waterfall setups for the same Placement.  Each is targeted for different types of users - those who allow tracking them and those who do not. 

When finished, click Save.

Activating or Deactivating an Instance

Follow these steps to activate or deactivate an instance.

1. From the list of instances, select the instance you want to deactivate or delete
   

2. Toggle the switch to either activate or deactivate the instance. 

Deleting an Instance

Follow these steps to delete an instance.

1. Click the three vertical dots and at the end of the row.
2. Select Delete
   

You are prompted to confirm if you want to delete the instance.

3. Click Delete to remove the instance.

You can also sort your waterfall by switching to "Manual CPM" and setting the actual CPM value. Alternatively, you can use Manual Prioritization and prioritize network instances above the waterfall, regardless of their CPM.

For details on how to set up your placement waterfall using auto CPM or manual prioritization, click here. 

Prioritizing Ad Networks

Once you have configured your placement, using the instructions here, follow the steps below to prioritize the order of the Ad Networks.

1. In the Configure Placement window, click + Ad Network Instance
   
   

2. Select the Ad Network you want to add
   

Ad Networks that have already been configured are displayed at the top of the dropdown menu.

Networks that have not yet been configured appear under New Demand.

3. Enter the required parameters for that Ad Network and click Add.
   

If the credentials you enter are incorrect, you are presented with the following message, detailing the reason for the configuration failure:

4. Enter the Ad Network Instance

For details on creating Ad Network Instances, click the Mediated Networks tab above.

5. From the dropdown menu select the Bidding Type.
   

• Automatic CPM works using Fyber's price prediction algorithm
• Manual CPM uses the values entered manually
  

6. Once you've finished configuring the instance, click Add.

Each configured Ad Network Instance appears, by default, under the Auto Optimized

7. Click and drag the Ad Network you want to manually prioritize into the Manual Prioritization section

8. Rearrange the Instances in the Manual Prioritization section by dragging and dropping them in the order you want them to be prioritized.

9. Add additional instances, if required by clicking on Ad Network Instance.

The order set in the manual prioritization, is the order in which the instances are called, before moving to instances under the Auto Optimized section.

10. Click the menu icon (three vertical dots) of each Ad Network to either Edit, Deactivate or Remove it.
    

Ad Networks (Instances) that are deactivated automatically move to the auto-optimization section. Clicking Remove, disconnects the Ad Network Instance from the Placement.

Waterfall Visualization

The Waterfall Visualization tool displays the actual order in which the waterfall Instances are called, together with the values predicted by Fyber’s Auto CPM algorithm if you have set Auto CPM as an Instance.

The Waterfall Vizualization takes into account:

• Settings of the Instance targeting
• The country from which the ad request is received
• The user’s tracking status (if the IDFA is available for iOS users, or if an Android user opted out of personalized ads).

To use the Waterfall Visualization feature:

1. Click the three vertical dots at the end of the Placement row
2. Click Waterfall Visualization to open the window
   

   

3. Select a country
4. Select the User Tracking Status

A simulation of the waterfall for the next ad request is displayed.

You have now successfully added and prioritized the ad networks (instances).

Auction Audit

Using the Auction Audit tool you can both sample and view real logs of auctions that have taken place within the last seven days for any of your FairBid Placements. The sampled auctions of the Placement are chosen at random according to the country and time you have selected.

The FairBid auction begins with running the waterfall and continues to the bidders’ auction that includes the Fyber Marketplace DSPs and the bidding mediated networks. The FairBid auction winner is the demand source that offered or was predicted to offer the highest CPM for the ad request.

To use the Audit Auction feature:

1. Click the three vertical dots at the end of the Placement row
2. Click Auction Audit to open the window
3. Select the country you want from the Country field
4. Select the Date of the auction
5. Select the Hour of the auction
6. Click Sample an Auction

The auction details are displayed.

By default, the first presented sample is of an auction that took place 24 hours ago for an ad request from the United States of America.

Change the filter values to sample auctions that have taken place on ad requests from different countries, days, and times. For each combination of country, date and time, you can sample up to 5 different auctions that have taken place.

To sample an additional auction using the same country and time combination, click Sample an Auction again.

A counter with the number of the currently displayed auctions out of the possible available auctions is displayed above the sample.

You can copy the sample content for further analysis of the auction together with your Fyber Account Manager.