# Ogury

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

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

* Banner
* Interstitial
* Rewarded

To integrate Ogury as a mediated network in DT FairBid:

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

### Step 1: Retrieve Ogury Parameters

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

* [Create](https://support.ogury.com/help-center-for-publishers/set-up-ogury-global-demand/setup-your-accounts) an Ogury account.
* [Add](https://support.ogury.com/help-center-for-publishers/set-up-ogury-global-demand/how-to-create-an-asset) your app (asset) to Ogury.
* [Create](https://support.ogury.com/help-center-for-publishers/set-up-ogury-global-demand/how-to-create-an-ad-unit) ad units in Ogury. Ensure that you specify the appropriate **Ad Unit Integration type**:
  * **Standard** for traditional waterfall mediation, or
  * **Header Bidding** for SDK Bidding.

Locate the following Ogury parameters, and store the values in a text file. These values are required later in [Step 2](#step-2-add-ogury-as-a-mediated-network) to set up Ogury as a DT mediated network.

#### Required Ogury Parameters

| Ogury Parameter | Required For                                    | Description                                                                                                                                                                                                                                                                                         |
| --------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `API Token`     | <ul><li>Waterfall</li></ul>                     | Unique ID assigned to your account. This parameter works with Ogury API v2 only. For more information about how to locate your Ogury API token, see Ogury's documentation on [Reporting API Authentication](https://support.ogury.com/reporting-api#authentication).                                |
| `Asset KEY`     | <ul><li>Waterfall</li><li>SDK Bidding</li></ul> | Unique ID assigned to your asset. For more information about locating your Ogury Asset KEY, see Ogury's documentation on [Creating Assets](https://support.ogury.com/help-center-for-publishers/set-up-ogury-global-demand/how-to-create-an-asset#save-your-asset-key).                             |
| `Ad Unit ID`    | <ul><li>Waterfall</li><li>SDK Bidding</li></ul> | Unique ID assigned to your Ogury ad unit. For more information about how to locate your Ogury Ad Unit IDs, see Ogury's documentation on [locating your Ad Unit ID](https://support.ogury.com/help-center-for-publishers/set-up-ogury-global-demand/how-to-create-an-ad-unit#find-your-a-d-unit-id). |

### Step 2: Add Ogury as a Mediated Network

Before you add Ogury as a mediated network in DT FairBid:

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

To add Ogury 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) **Ogury** or **Ogury Bidder** as a mediated network for your app using the parameters you retrieved in [Step 1](#step-1-retrieve-ogury-parameters).

<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%2FWyZEZ8foTYyjwwlAIjFG%2Fimage.png?alt=media&#x26;token=58e74068-3ff6-46da-90c7-a9819c5913cc" alt=""></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 Ogury `Ad Unit ID` you retrieved in [Step 1](#step-1-retrieve-ogury-parameters) as the **Instance ID**.

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

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

{% hint style="info" %}
The `app-ads.txt` standard helps prevent the unauthorized selling of in-app inventory and app domain spoofing. To maximize your fill rate from Ogury, follow the [Ogury instructions](https://support.ogury.com/help-center-for-publishers/set-up-ogury-global-demand/update-your-app-ads.txt) for adding Ogury as an authorized seller of your inventory.
{% endhint %}

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