# HyprMX

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

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

* Banner
* Interstitial
* Rewarded

To integrate HyprMX as DT mediated network:

1. [Step 1: Retrieve HyprMX parameters](#step-1-retrieve-hyprmx-parameters).
2. [Step 2: Add HyprMX as a mediated network](#step-2-add-hyprmx-as-a-mediated-network).
3. [Step 3: Add the HyprMX SDK to your integration](#step-3-adding-the-hyprmx-sdk-to-your-integration).
4. [Step 4: Test your integration](#step-4-test-your-integration).

{% hint style="info" %}
DT FairBid SDK 3.21.1 or later supports HyprMX Banners.
{% endhint %}

## Step 1: Retrieve HyprMX Parameters

HyprMX is a managed service that provides placements for your application. To create an account with them, contact HyprMX at <integration@hyprmx.com> . Once HyprMX has created your account, you can retrieve the required parameters to integrate HyprMx in your DT account.

From your HyprMX account, locate the following parameters. Store these values in a text file. These values are required later in [Step 2](#step-2-add-hyprmx-as-a-mediated-network) to add HyprMX as a DT mediated network.

| HYPRMX PARAMETER    | DESCRIPTION                                                      |
| ------------------- | ---------------------------------------------------------------- |
| `Distributor ID`    | The unique identifier of the distributor in the HyprMX system.   |
| `Reporting API Key` | The unique identifier of the Reporting API in the HyprMX system. |
| `Placement Name`    | The name of the placement in the HyprMX system.                  |

## Step 2: Add HyprMX as a Mediated Network

Before adding HyprMX as a DT mediated network:

* Ensure that you have access to parameters you retrieved from HyprMX in [Step 1](#step-1-retrieve-hyprmx-parameters).
* [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 HyprMX ad type you want to mediate with DT.

To add HyprMX 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) HyprMX as a mediated network using the parameter you retrieved in [Step 1](#step-1-retrieve-hyprmx-parameters).
3. [Set up an ad network instance](https://app.gitbook.com/s/LbREhkP3WlLtP6TNVZ2Q/app-management/setting-up-an-existing-app/setting-up-instances) using the HyprMx Placement Name for the Instance ID.

## Step 3: Adding the HyprMX SDK to your Integration

To integrate the HyprMX 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>
