# Liftoff Monetize

This article is for publishers who want to use the DT FairBid SDK to load and display ads from Liftoff Monetize via DT FairBid mediation.

Liftoff Monetize currently supports the following [ad types](https://app.gitbook.com/s/8KSLu5HNiyDWpvGRZh7B/publishers/additional-resources/ad-types-and-specification):

* Banner
* Interstitial
* Rewarded

To integrate Liftoff Monetize as an DT mediated network:

* [Step 1: Locate Liftoff Monetize parameters](#step-1-locate-liftoff-monetize-parameters).
* [Step 2: Add Liftoff Monetize as a DT mediated network](#step-2-add-liftoff-monetize-as-a-dt-mediated-network):
  * [Add Liftoff Monetize for Waterfall mediation](#adding-liftoff-monetize-as-waterfall-network).\
    This allows for traditional waterfall mediation with Liftoff Monetize. Ensure that your app and bidding placements have been added to the Liftoff Monetize network.
  * Add Liftoff Monetize for Bidding mediation:
    * [Add Liftoff Monetize as a manually managed DT mediated network](#adding-liftoff-monetize-as-a-manually-managed-bidding-network).\
      This allows DT to include Liftoff Monetize in bidding mediation. Ensure that your app and bidding placements have been added to the Liftoff Monetize network.
    * [Add Liftoff Monetize as an automatically managed DT mediate network](#adding-liftoff-monetize-as-an-automatically-managed-bidding-network).\
      This allows DT to include Liftoff Monetize in bidding mediation. DT adds your app and bidding placements to the Liftoff Monetize network on your behalf.
* [Step 3: Add the LiftoffMonetize/Vungle SDK to your DT integration](#step-3-add-the-liftoff-monetize-sdk-to-your-integration).
* [Step 4: Test your integration](#step-4-test-your-integration).

## Step 1: Locate Liftoff Monetize Parameters

Depending on the type of mediation you intend to use, adding Liftoff Monetize as a mediated network requires specific parameters from the Liftoff Monetize Dashboard. Before you can locate these parameters, use the following table to ensure that you have completed any app setup tasks in the Liftoff Monetize Dashboard.

<table><thead><tr><th width="187">Liftoff Monetize Tasks</th><th align="center">Waterfall</th><th align="center">Bidding - Manual</th><th align="center">Bidding - Automatic</th></tr></thead><tbody><tr><td><a href="https://support.vungle.com/hc/en-us/articles/203610124-Start-Monetizing-With-Liftoff">Create</a> a Liftoff Monetize Account.</td><td align="center"><i class="fa-check">:check:</i></td><td align="center"><i class="fa-check">:check:</i></td><td align="center"><i class="fa-check">:check:</i></td></tr><tr><td><a href="https://support.vungle.com/hc/en-us/articles/115000493152-Add-and-Edit-Your-App-in-the-Dashboard">Add</a> your app to Liftoff Monetize.</td><td align="center"><i class="fa-check">:check:</i></td><td align="center"><i class="fa-check">:check:</i></td><td align="center"></td></tr><tr><td><a href="https://support.vungle.com/hc/en-us/articles/360041566292-Create-or-Edit-a-Placement">Create</a> Placements in Liftoff Monetize for traditional waterfall mediation.</td><td align="center"><i class="fa-check">:check:</i></td><td align="center"></td><td align="center"></td></tr><tr><td><a href="https://support.vungle.com/hc/en-us/articles/360041566292-Create-or-Edit-a-Placement">Create</a> Liftoff Monetize placements for bidding mediation.</td><td align="center"></td><td align="center"><i class="fa-check">:check:</i></td><td align="center"></td></tr></tbody></table>

To enable Liftoff Monetize as a DT mediated ad network, locate the following Liftoff Monetize parameters:

<table><thead><tr><th width="191.12109375">Parameter</th><th width="277.1171875">Description</th><th width="95.04296875" align="center">Waterfall</th><th width="107.21875" align="center">Bidding - Manual</th><th align="center">Bidding - Automatic</th></tr></thead><tbody><tr><td><code>App ID</code></td><td>Unique identifier of your application in the Liftoff Monetize system.</td><td align="center"><i class="fa-check">:check:</i></td><td align="center"><i class="fa-check">:check:</i></td><td align="center"></td></tr><tr><td><code>Placement Reference ID</code></td><td>Unique identifier of the ad unit in the Liftoff Monetize system.</td><td align="center"><i class="fa-check">:check:</i></td><td align="center"><i class="fa-check">:check:</i></td><td align="center"></td></tr><tr><td><code>Reporting API Key</code></td><td>Your unique key for the Liftoff Monetize API.</td><td align="center"><i class="fa-check">:check:</i></td><td align="center"></td><td align="center"></td></tr><tr><td><code>Secret Token</code></td><td>Your unique key for your Liftoff Monetize publisher self-serve API.</td><td align="center"></td><td align="center"></td><td align="center"><i class="fa-check">:check:</i></td></tr></tbody></table>

### Locating the App ID

From the [Liftoff Monetize Dashboard](https://publisher.vungle.com/login2), click the **Applications** drop-down and select your app.\
The **App Settings** appear and include the App ID.

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2F8ZTko2nXXHcM4trDVfWc%2Fimage.png?alt=media&#x26;token=863787d6-6900-4261-9e93-80ee40839f2c" alt=""></div>

### Locating the Placement Reference ID

From the [Liftoff Monetize Dashboard](https://publisher.vungle.com/login2), click the **Applications** drop-down, select your app, and then click **Placements**.\
The **Placements** page appears and includes the Placement Reference ID for all app placements.

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2FDlIJk4MZYeaEYTebwN60%2Fimage.png?alt=media&#x26;token=f97ffeee-0dd4-4980-b07f-d1c0e184aa82" alt=""></div>

### Locating the API Key & Secret Token

From the [Liftoff Monetize Dashboard](https://publisher.vungle.com/login2), click **My Account** in the upper-right corner of the screen.\
The **Overview** page appears and includes API Key and Secret Token.

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2FCMqtOwJaFcJxbfeOIcYj%2Fimage.png?alt=media&#x26;token=8ce40992-b7fb-449b-bd74-696a2450aa04" alt=""></div>

## Step 2: Add Liftoff Monetize as a DT Mediated Network

Before you add Liftoff Monetize as a mediated network in DT FairBid, complete the following tasks in the [DT Console](https://console.fyber.com/):

* Add your App to the DT ecosystem. For more information, see [Adding an App](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/adding-a-new-app/adding-an-app).
* Ensure that you have a DT Placement for each Mintegral ad type you want to mediate with DT. For more information, see [Setting Up Placements](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-placements).

### Adding Liftoff Monetize as Waterfall Network

To add Liftoff Monetize as a DT mediated network:

1. From the [DT Console](https://console.fyber.com/), go to **Monetization → App Management**, locate the **Network** tab for your app, and click **Add network**.\
   The list of available networks appears.

<figure><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2FApqcWQ7MFP81PBSDyTyy%2Fimage.png?alt=media&#x26;token=e10e9527-ef6a-437f-95c5-1de8254bb3d2" alt=""><figcaption></figcaption></figure>

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2FApqcWQ7MFP81PBSDyTyy%2Fimage.png?alt=media&#x26;token=e10e9527-ef6a-437f-95c5-1de8254bb3d2" alt=""></div>

2. Click the **Liftoff Monetize** tile and enter the Liftoff Monetize parameters for Waterfall integration from [Step 1](#step-1-locate-liftoff-monetize-parameters).\
   For more information, see [Adding a Waterfall Network](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-mediated-networks#adding-a-waterfall-network).

{% hint style="info" %}
Some networks offer both traditional waterfall and programmatic bidding. Networks that offer programmatic bidding appear as separate tiles labeled specifically for bidding. For waterfall mediation, do not select the *bidder* version of the network.
{% endhint %}

<div align="left" data-with-frame="true"><figure><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2FmQ0FXoae4LaqLSYOo27g%2Fimage.png?alt=media&#x26;token=1da0e3ff-0a3d-4a79-8279-cec501822aac" alt=""><figcaption></figcaption></figure></div>

3. Create a Waterfall network instance for each Liftoff Monetize placement you want DT to mediate. Use the Liftoff Monetize Placement Reference ID you located in [Step 1](#step-1-locate-liftoff-monetize-parameters) as the **Instance ID**.\
   For more information, see [Adding a Waterfall Instance](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-instances#adding-a-waterfall-instance).

### Adding Liftoff Monetize as a Manually Managed Bidding Network

To add Liftoff Monetize as a DT mediated network:

1. From the [DT Console](https://console.fyber.com/), go to **Monetization → App Management**, locate the **Network** tab for your app, and click **Add network**.\
   The list of available networks appears.

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2FYAYGOGam2sA2Q0IIrqop%2Fimage.png?alt=media&#x26;token=19db4dd0-a2dc-4b3a-94b1-ee3312b86edd" alt=""></div>

2. Click the **Liftoff Monetize bidder** tile.\
   The **Add network** form for **Liftoff Monetize bidder** appears.\
   For more information, see [Adding a Manually Managed Bidding Network](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-mediated-networks#adding-a-manually-managed-bidding-network).

{% hint style="info" %}
Networks that support programmatic bidding appear as separate tiles labeled specifically for bidding. To offer your placements for bidding, make sure you select the *bidder* version of the network—in this case, **Liftoff Monetize bidder**.
{% endhint %}

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2F2CLa1wZHYGKGP0nkHJqg%2Fimage.png?alt=media&#x26;token=445554c7-3922-457e-b5b8-8e875790df61" alt=""></div>

3. Click **Manually managed** and enter the Liftoff Monetize parameters for manual management from [Step 1](#step-1-locate-liftoff-monetize-parameters).
4. Create a Bidding network instance for each Liftoff Monetize placement you want DT to mediate. Use the Liftoff Monetize Placement Reference ID you located in [Step 1](#step-1-locate-liftoff-monetize-parameters) as the **Instance ID**.\
   For more information, see [Manually Adding a Bidding Instance](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-instances#manually-adding-a-bidding-instance).

### Adding Liftoff Monetize as an Automatically Managed Bidding Network

To add Liftoff Monetize for automatically managed bidding mediation:

1. From the [DT Console](https://console.fyber.com/), go to **Monetization → App Management**, locate the **Network** tab for your app, and click **Add network**.\
   The list of available networks appears.

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2F2YWdi0fDJen6x5HyZUdG%2Fimage.png?alt=media&#x26;token=eef4bf30-9e74-4f2e-b2d2-00bcde4eff57" alt=""></div>

2. Click the **Liftoff Monetize bidder** tile.\
   The **Add network** form for **Liftoff Monetize bidder** appears.\
   For more information, see [Adding an Automatically Managed Bidding Network](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-mediated-networks#adding-an-automatically-managed-bidding-network).

{% hint style="info" %}
Networks that support programmatic bidding appear as separate tiles labeled specifically for bidding. To offer your placements for bidding, make sure you select the *bidder* version of the network—in this case, **Liftoff Monetize Bidder**
{% endhint %}

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2FnXEtpMyF6aTYKaILIKvt%2Fimage.png?alt=media&#x26;token=5c5e5e86-f3e0-4043-835b-6ab87e3c92b2" alt=""></div>

3. Click **Automatically managed** and enter the Liftoff Monetize parameters for automatic management from [Step 1](#step-1-locate-liftoff-monetize-parameters).
4. Auto-generate a Bidding network instance for each FairBid placement you want to mediate with Liftoff Monetize. For more information, see [Automatically Adding a Bidding Instance](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-instances#automatically-adding-a-bidding-instance).

## Step 3: Add the Liftoff Monetize SDK to your Integration

To integrate the Liftoff Monetize/Vungle SDK, follow the instructions on the [Supported Networks](https://docs.digitalturbine.com/dt-fairbid/fairbid-sdk/supported-networks) page.

## Step 4: Test Your Integration

Use the DT Test Suite to verify that you have set up your app properly for FairBid mediation. The DT Test Suite is available for Android, iOS, and Unity apps. For more information about using the DT Test Suite, see [Test Suite](https://docs.digitalturbine.com/dt-fairbid/fairbid-sdk/tools/test-suite).

<div align="left" data-with-frame="true"><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2FoqWJTBXcQ0oynphWzkiP%2FIMG_4982_copy%20(2).jpg?alt=media&#x26;token=24ad859d-8e24-4307-ba67-a2c908893584" alt="" width="188"></div>
