> For the complete documentation index, see [llms.txt](https://docs.digitalturbine.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digitalturbine.com/dt-fairbid/fairbid-sdk/sdk-reference/mediation-started-callback.md).

# 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 %}             |                  |                                 |                                 |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.digitalturbine.com/dt-fairbid/fairbid-sdk/sdk-reference/mediation-started-callback.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.