Configure AdColony for Unity Mediation

Publishers can use Unity Mediation to load and display ads from AdColony through waterfall and bidding mediation.

Prerequisites

Before you begin, create an AdColony account: https://clients.adcolony.com/signup.

If your game is made with Unity, install the AdColony Adapter to your project:

  1. Open your project in the Unity Editor.

  2. Select Edit > Project Settings > Services > Mediation or Services > Mediation > Configure.

  3. In the Adapter Configuration section, find the AdColony Adapter and select Install.

    Note: Installing the AdColony Adapter through the Unity Editor also pulls in the AdColony SDK.

Add an app to your AdColony account

To add an app to your AdColony account, complete the following steps.

  1. Sign in to your AdColony account: https://clients.adcolony.com/login.

  2. On the welcome page, select Setup New App.

  1. Complete the form that appears with information about your app, including app name, platform, COPPA compliance, ad audio settings, and ad types, and then select Create.

    Result: The app page appears with a banner letting you know it has been created.

Retrieve your AdColony credentials

To connect the Unity Mediation platform with the AdColony ad network, you need to retrieve the Read-Only API Key from your AdColony account. The Read-Only API Key imports performance data from your AdColony account for reporting and optimization purposes in the Unity Dashboard.

To find the Read-Only API Key:

  1. At the top of the AdColony page, select the gear symbol.

  2. Select Account Settings.

    Result: The Read-Only API Key is listed midway on the Account Settings page.

Set up an Ad Zone

Note: An Ad Zone in AdColony is the equivalent of a Placement in Unity.
  1. On your app page, select Setup New Ad Zone.

  2. Complete the Ad Zone settings, including ad zone name, ad settings, ad zone size, ad formats, and options, and then select Create.

  3. Review your information, and then select Save.

    Result: The app page appears with a banner stating the Zone has been updated.

Configure the AdColony Ad Source in the Unity Dashboard

To configure AdColony as a third-party Ad Source in Unity Mediation, complete the following steps.

  1. On the Unity Monetization Dashboard, in the left navigation menu, select Mediation > Ad Sources.

  2. Find AdColony in the list of Ad Sources and select Activate.

  3. Complete the fields with the credentials from your AdColony account:

    1. In the API Key field, enter the AdColony Read-Only API Key.

    2. Enable the Reporting Access Authorization checkbox.

  1. Select Complete.

Create an Ad Colony line item

Prerequisites: Create a waterfall, Configure an Ad Unit, Configure the AdColony Ad Source, and Install the AdColony Adapter and SDK

To create an Ad Colony line item, complete the following steps:

  1. On the Unity Monetization Dashboard, select the Waterfalls page, and then select the waterfall that you want to add a line item to.

  2. In the Sort by eCPM Target or Auto - eCPM (Backfill) section, select Add Line Item.

  3. Select AdColony, and then select Next.

  4. Map line items to the Ad Source.

    1. Enter a line item name.

      Note: For more information on naming convention best practices, see Ensure standardized line syntax.
    2. Set an eCPM target that reflects the estimated price expected from the Ad Source.

      Note: The eCPM target is only for defining the order in which ad networks are called, and has no role in the acceptance or rejection of an ad due to a price point.
  5. Select Save.

Add AdColony as a bidding source

Prerequisites: Create a waterfall, Configure an Ad Unit, Configure the AdColony Ad Source, and Install the AdColony Adapter and SDK

To add AdColony as a bidding source for the Unity Mediation platform, complete the following steps.

  1. On the Unity Monetization Dashboard, select the Waterfalls page, and then select the waterfall that you want to add a line item to.

  2. In the Bidding section, select Add Bidding Source.

  3. Select AdColony, and then select Save.

  4. Map line items to the Ad Source.

    1. Enter the App ID.

    2. Enter the Zone ID.

  5. Select Save.