# Mediation Started Callback

DT FairBid provides access to initialization information about FairBid itself and each of the integrated third-party networks (mediated networks).

Run the following API to set up a single listener that monitors mediation events, confirms network readiness, and efficiently handles initialization in your app.

For more detailed initialization information for each mediated network, see [Tracking Network Initialization](#tracking-network-initialization).

{% tabs %}
{% tab title="Android" %}
{% code title="Kotlin" %}

```kotlin
fairBid.withFairBidListener(object : FairBidListener {
            override fun mediationFailedToStart(errorMessage: String, errorCode: Int) {
                // The SDK was unable to start any of the mediated networks.
                // That includes DT-X
                // Nothing to do. Contact support if this error persists (errorCode will be used to troubleshoot the problem)
            }

            override fun mediationStarted() {
                // FairBid is ready to mediate.
                // TPNs that need to be started as early as possible have been started
            }

            override fun onNetworkFailedToStart(network: MediatedNetwork, errorMessage: String) {
                // A specific network failed to start.
            }

            override fun onNetworkStarted(network: MediatedNetwork) {
                // A specific network started successfully.
            }

        })

```

{% endcode %}

{% code title="Java" %}

```java
FairBid.configureForAppId("AppId").withFairBidListener(new FairBidListener() {
    @Override
    public void mediationFailedToStart(String errorMessage, int errorCode) {
        // The SDK was unable to start any of the mediated networks.
        // That includes DT-X
        // Nothing to do. Contact support if this error persists (errorCode will be used to troubleshoot the problem)
    }

    @Override
    public void mediationStarted() {
        // FairBid is ready to mediate.
        // TPNs that need to be started as early as possible have been started
    }

    @Override
    public void onNetworkFailedToStart(MediatedNetwork network, String errorMessage) {
        // A specific network failed to start.
    }

    @Override
    public void onNetworkStarted(MediatedNetwork network) {
        // A specific network started successfully.
    }
});}    
```

{% endcode %}
{% endtab %}

{% tab title="iOS" %}
{% code title="Swift" %}

```swift
class MyDelegate: FairBidDelegate {
    func networkStarted(_ network: FYBMediatedNetwork) {
        // A specific network started successfully.
    }
    func network(_ network: FYBMediatedNetwork, failedToStartWithError error: Error) {
        // A specific network failed to start.
    }
    
    func mediationStarted() {
        // FairBid is ready to mediate.
        // TPNs that need to be started as early as possible have been started
    }
    
    func mediationFailedToStartWithError(_ error: Error) {
        // The SDK was unable to start any of the mediated networks.
        // That includes DT-X
        // Nothing to do.
        // Contact support if this error persists (errorCode will be used to troubleshoot the problem)
    }
}
}
```

{% endcode %}

{% code title="Objective-C" %}

```objective-c
@interface MyDelegate: NSObject

@end

@implementation MyDelegate
- (void)networkStarted:(FYBMediatedNetwork)network {
    // A specific network started successfully.
}
- (void)network:(FYBMediatedNetwork)network failedToStartWithError:(NSError *)error {
    // A specific network failed to start.
}
- (void)mediationStarted {
    // FairBid is ready to mediate.
    // TPNs that need to be started as early as possible have been started
}
- (void)mediationFailedToStartWithError:(NSError *)error {
    // The SDK was unable to start any of the mediated networks.
    // That includes DT-X
    // Nothing to do. 
    // Contact support if this error persists (errorCode will be used to troubleshoot the problem)
}
@end
```

{% endcode %}
{% endtab %}

{% tab title="Unity" %}
{% code title="C#" %}

```csharp
public class MyListener : FairBidListener
{
    public void OnNetworkStarted(MediatedNetwork network)
    {
        // A specific network started successfully.
    }

    public void OnNetworkFailedToStart(MediatedNetwork network, string error)
    {
         // A specific network failed to start.
    }

    public void OnMediationStarted()
    {
        // FairBid is ready to mediate.
        // TPNs that need to be started as early as possible have been started
    }

    public void OnMediationFailedToStart(string error, string code)
    {
        // The SDK was unable to start any of the mediated networks.
        // That includes DT-X
        // Nothing to do. 
        // Contact support if this error persists (errorCode will be used to troubleshoot the problem)        

    }
}

FairBid.SetFairBidListener(new MyListener());
```

{% endcode %}
{% endtab %}
{% endtabs %}

## Tracking Network Initialization 

Mediated networks can be initialized either when FairBid starts or later when the first ad request is made (Lazy Start). With either initialization method, some networks provide an explicit callback to report whether network initialization was successful.

The following tables summarize whether Lazy Start is available for each network and the dedicated Start Success callback availability.

{% tabs %}
{% tab title="Andoid" %}

| MEDIATED NETWORK          | NAME IN CALLBACK |            LAZY START           |      START SUCCESS CALLBACK     |
| ------------------------- | ---------------- | :-----------------------------: | :-----------------------------: |
| AdMob/Google Bidding      | `ADMOB`          |                                 | <i class="fa-check">:check:</i> |
| Amazon Publisher Services | `AMAZON`         | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| Applovin                  | `APPLOVIN`       | <i class="fa-check">:check:</i> |                                 |
| BIGO Ads                  | `BIGOADS`        | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| Chartboost                | `CHARTBOOST`     | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| Google Ad Manager         | `GAM`            | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| HyprMX                    | `HYPRMX`         | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| InMobi                    | `INMOBI`         |                                 | <i class="fa-check">:check:</i> |
| IronSource                | `IRON_SOURCE`    | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| Liftoff Monetize          | `VUNGLE`         |                                 | <i class="fa-check">:check:</i> |
| Meta Audience Network     | `FACEBOOK`       | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| Mintegral                 | `MINTEGRAL`      |                                 | <i class="fa-check">:check:</i> |
| Ogury                     | `OGURY`          |                                 |                                 |
| Pangle                    | `PANGLE`         |                                 | <i class="fa-check">:check:</i> |
| Unity Ads                 | `UNITYADS`       | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| Verve Group               | `VERVE`          |                                 | <i class="fa-check">:check:</i> |
| {% endtab %}              |                  |                                 |                                 |

{% tab title="iOS" %}

| MEDIATED NETWORK          | NAME IN CALLBACK |            LAZY START           |      START SUCCESS CALLBACK     |
| ------------------------- | ---------------- | :-----------------------------: | :-----------------------------: |
| AdMob/Google Bidding      | `ADMOB`          |                                 | <i class="fa-check">:check:</i> |
| Amazon Publisher Services | `AMAZON`         | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| Applovin                  | `APPLOVIN`       | <i class="fa-check">:check:</i> |                                 |
| BIGO Ads                  | `BIGOADS`        | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| Chartboost                | `CHARTBOOST`     | <i class="fa-check">:check:</i> |                                 |
| Google Ad Manager         | `GAM`            | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| HyprMX                    | `HYPRMX`         | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| InMobi                    | `INMOBI`         |                                 | <i class="fa-check">:check:</i> |
| IronSource                | `IRON_SOURCE`    | <i class="fa-check">:check:</i> |                                 |
| Liftoff Monetize          | `VUNGLE`         |                                 | <i class="fa-check">:check:</i> |
| Meta Audience Network     | `FACEBOOK`       |                                 |                                 |
| Mintegral                 | `MINTEGRAL`      |                                 |                                 |
| Ogury                     | `OGURY`          |                                 |                                 |
| Pangle                    | `PANGLE`         |                                 | <i class="fa-check">:check:</i> |
| Unity Ads                 | `UNITYADS`       | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| Verve Group               | `VERVE`          |                                 | <i class="fa-check">:check:</i> |

{% hint style="info" %}
Apps built on iOS should support Lazy Start on all networks. However, if you have at least one Bidding instance, FairBid initializes the network immediately.
{% endhint %}
{% endtab %}

{% tab title="Unity - Android" %}

| MEDIATED NETWORK          | NAME IN CALLBACK |            LAZY START           |      START SUCCESS CALLBACK     |
| ------------------------- | ---------------- | :-----------------------------: | :-----------------------------: |
| AdMob/Google Bidding      | `ADMOB`          |                                 | <i class="fa-check">:check:</i> |
| Amazon Publisher Services | `AMAZON`         | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| Applovin                  | `APPLOVIN`       | <i class="fa-check">:check:</i> |                                 |
| BIGO Ads                  | `BIGOADS`        | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| Chartboost                | `CHARTBOOST`     | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| Google Ad Manager         | `GAM`            | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| HyprMX                    | `HYPRMX`         | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| InMobi                    | `INMOBI`         |                                 | <i class="fa-check">:check:</i> |
| IronSource                | `IRON_SOURCE`    | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| Liftoff Monetize          | `VUNGLE`         |                                 | <i class="fa-check">:check:</i> |
| Meta Audience Network     | `FACEBOOK`       | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| Mintegral                 | `MINTEGRAL`      |                                 | <i class="fa-check">:check:</i> |
| Ogury                     | `OGURY`          |                                 |                                 |
| Pangle                    | `PANGLE`         |                                 | <i class="fa-check">:check:</i> |
| Unity Ads                 | `UNITYADS`       | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| Verve Group               | `VERVE`          |                                 | <i class="fa-check">:check:</i> |
| {% endtab %}              |                  |                                 |                                 |

{% tab title="Unity - iOS" %}

| MEDIATED NETWORK          | NAME IN CALLBACK |            LAZY START           |      START SUCCESS CALLBACK     |
| ------------------------- | ---------------- | :-----------------------------: | :-----------------------------: |
| AdMob/Google Bidding      | `ADMOB`          |                                 | <i class="fa-check">:check:</i> |
| Amazon Publisher Services | `AMAZON`         | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| Applovin                  | `APPLOVIN`       | <i class="fa-check">:check:</i> |                                 |
| BIGO Ads                  | `BIGOADS`        | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| Chartboost                | `CHARTBOOST`     | <i class="fa-check">:check:</i> |                                 |
| Google Ad Manager         | `GAM`            | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| HyprMX                    | `HYPRMX`         | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| InMobi                    | `INMOBI`         |                                 | <i class="fa-check">:check:</i> |
| IronSource                | `IRON_SOURCE`    | <i class="fa-check">:check:</i> |                                 |
| Liftoff Monetize          | `VUNGLE`         |                                 | <i class="fa-check">:check:</i> |
| Meta Audience Network     | `FACEBOOK`       |                                 |                                 |
| Mintegral                 | `MINTEGRAL`      |                                 |                                 |
| Ogury                     | `OGURY`          |                                 |                                 |
| Pangle                    | `PANGLE`         |                                 | <i class="fa-check">:check:</i> |
| Unity Ads                 | `UNITYADS`       | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> |
| Verve Group               | `VERVE`          |                                 | <i class="fa-check">:check:</i> |
| {% endtab %}              |                  |                                 |                                 |
| {% endtabs %}             |                  |                                 |                                 |