# Verve Group

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

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

* Banner
* Interstitial
* Rewarded

To integrate Verve Group as a mediated network with DT :

* [Step 1: Retrieve Verve Group parameters](#h_01j53a0485swfd9yttcps0rkce)
* [Step 2: Add Verve Group as a DT mediated network](#h_01j53a0485txz5br1apygvr5nw)
* [Step 3: Add the Verve Group SDK to your DT integration](#h_01j53a04855whgbfqvh4m7enx7)
* [Step 4: Testing your integration](#h_01jd6a13tq41abkn1htxp3ejtr)

## Step 1: Retrieve Verve Group Parameters <a href="#h_01j53a0485swfd9yttcps0rkce" id="h_01j53a0485swfd9yttcps0rkce"></a>

Before retrieving Verve Group parameters, ensure that you have Verve Group ad unit inventory that you want to mediate with DT. For more information about creating Verve Group inventory, see the following Verve Group articles:

* [Create](https://dashboard.pubnative.net/) a Verve Group account.
* [Add](https://developers.verve.com/reference/hybid-cloud-documentation#step-2a-add-application) your app to Verve Group.
* [Create](https://developers.verve.com/reference/hybid-cloud-documentation#step-2b--add-placement) zones (placements) for your app in Verve Group.
* If you want to mediate bidding placements, [add bidders](https://developers.verve.com/reference/hybid-cloud-documentation#step-3-add-bidders) to your placements.

To add Verve Group as a DT mediated network, locate the following parameters from your Verve Group account:

| VERVE GROUP PARAMETER | REQUIRED FOR                                    | DESCRIPTION                                                                                                                                       |
| --------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Reporting API Key`   | <ul><li>Waterfall</li></ul>                     | Unique access token for your app in the Verve Group system for reporting purposes. In the DT Console, use this value as the `Account Auth Token`. |
| `App ID`              | <ul><li>Waterfall</li></ul>                     | Unique identifier for your app in the Verve Group system.                                                                                         |
| `App Auth Token`      | <ul><li>Waterfall</li><li>SDK Bidding</li></ul> | Unique access token for your app in the Verve Group system. In the DT Console, use this value as the `App Token`.                                 |
| `Zone Number`         | <ul><li>Waterfall</li><li>SDK Bidding</li></ul> | Unique identifier for the placement in the Verve Group system.                                                                                    |

### Obtaining the Reporting API Key <a href="#h_01j53a04850kwp02a5b8t8x525" id="h_01j53a04850kwp02a5b8t8x525"></a>

The Verve Group `Reporting API Key` serves as the Account Auth Token for DT.

To obtain the Verve `Reporting API Key`:

1. Log in to your [Verve Group dashboard](https://dashboard.pubnative.net/), and click the drop-down next to your account name.
2. Click **Reporting API Key**.\
   The Reporting API Key is copied.

<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%2FGeRIeISiNDFiImlSqbm6%2Fimage.png?alt=media&#x26;token=ff36350c-d701-4543-a174-074a5c3a4fb9" alt="" width="334"><figcaption></figcaption></figure></div>

3. Store this value in a text file. This value is required later in [Step 2](#h_01j53a0485txz5br1apygvr5nw) to add Verve Group as a DT mediated network.

### Obtaining the App ID <a href="#h_01j53a0485repqse0419c0avjp" id="h_01j53a0485repqse0419c0avjp"></a>

To obtain the Verve Group `App ID`:

1. Log in to your [Verve Group dashboard](https://dashboard.pubnative.net/).\
   The dashboard URL changes to contain your Verve Group `App ID`.

<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%2FBU4IhXCvJXOVJIrRjSDd%2Fimage.png?alt=media&#x26;token=2f81fd6a-29fc-425e-ab4d-636eaab7514e" alt=""><figcaption></figcaption></figure></div>

2. Store this value in a text file. This value is required later in [Step 2](#h_01j53a0485txz5br1apygvr5nw) to add Verve Group as a DT mediated network.

### Obtaining the App Auth Token <a href="#h_01j53a0485gg2p10jq42sbx6qs" id="h_01j53a0485gg2p10jq42sbx6qs"></a>

1. From your [Verve Group dashboard](https://dashboard.pubnative.net/), click **Apps**, and then click the pencil icon for your app.\
   The **Edit App** page displays the `App auth token`.

<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%2F7PXauZZ95lq4HemxaZR1%2Fimage.png?alt=media&#x26;token=6b881eff-26cc-441d-8473-879966f15f69" alt=""><figcaption></figcaption></figure></div>

2. Copy the `App auth token`, and store this value in a text file. This value is required later in [Step 2](#h_01j53a0485txz5br1apygvr5nw) to add Verve Group as a DT mediated network.

### Obtaining the Zone Number <a href="#h_01j53a0485wjykxzs3xxb5exj9" id="h_01j53a0485wjykxzs3xxb5exj9"></a>

To obtain the Verve `Zone Number`:

1. From your [Verve Group dashboard](https://dashboard.pubnative.net/), click **Apps**, and then click the gear icon for your app.\
   A list of zones associated with your app displays.

<figure><img src="https://2654615282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4IftQ9WUOy9feTA5sZeE%2Fuploads%2FGfI9T6lubf9V4uQqjb4p%2Fimage.png?alt=media&#x26;token=eeb6a890-48e4-439f-b557-bea8636f963c" alt=""><figcaption></figcaption></figure>

2. For each Zone (placement) you want to mediate with DT, copy the `Zone Number`, and store these values in a text file. These values are required later in [Step 2](#h_01j53a0485txz5br1apygvr5nw) to add Verve Group as a DT mediated network.

## Step 2: Add Verve Group as a DT Mediated Network <a href="#h_01j53a0485txz5br1apygvr5nw" id="h_01j53a0485txz5br1apygvr5nw"></a>

Before you add Verve Group as a mediated network in DT FairBid:

* Ensure that you have access to parameters you retrieved from Verve Group in [Step 1](#h_01j53a0485swfd9yttcps0rkce).
* [Add your App](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/adding-a-new-app/adding-an-app) using the DT Console.
* Ensure that you [set up a DT Placement](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-placements) for each Verve Group ad type you want to mediate with DT.

To add Verve Group as a DT mediated network:

1. Log in to the [DT Console](https://console.fyber.com/) and click **App Management**.
2. [Set up](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-mediated-networks) **Verve** or **Verve Bidder** as a mediated network for your app using the parameters you retrieved in [Step 1](#h_01j53a0485swfd9yttcps0rkce).

<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%2FSu53d1kbydoML09SrToT%2Fimage.png?alt=media&#x26;token=4ba90a6b-3ae5-4c24-9a83-a59d7a749e87" alt=""><figcaption></figcaption></figure></div>

<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%2F2OrJ0G5KUsTAJCMG6CTY%2Fimage.png?alt=media&#x26;token=b7c7b7fe-e837-4135-95bc-17ccd14950e6" alt=""><figcaption></figcaption></figure></div>

3. [Set up an ad network instance](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-instances) for each placement you want to mediate with DT. Use the Verve Group `Zone Number` you retrieved in [Step 1](#h_01j53a0485swfd9yttcps0rkce) as the **Instance ID**.

## Step 3: Add the Verve Group SDK to your Integration <a href="#h_01j53a04855whgbfqvh4m7enx7" id="h_01j53a04855whgbfqvh4m7enx7"></a>

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

## Step 4: Test Your Integration <a href="#h_01jd6a13tq41abkn1htxp3ejtr" id="h_01jd6a13tq41abkn1htxp3ejtr"></a>

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>