---
updatedAt: 2026-10-13T08:13:26.000Z
agentTools:
  projectIndex: https://dev.kevel.com/llms.txt
---

# Setting Up an Auction

## Setting Up an Auction

**Create a Priority First**

You start by creating an Auction [Priority](https://dev.kevel.com/docs/priorities) in the UI or API with the [Create Priority](https://dev.kevel.com/reference/create-priorities) endpoint. The API `SelectionAlgorithm` value for an auction is `1`.

If they are not important to you, you can set **Floor Price** and **Remainder Percentage** to `0`.

**Create a Flight - General Settings**

<Image align="center" width="smart" src="https://files.readme.io/7862c85-Screen_Shot_2018-09-25_at_4.45.13_PM.png" />

1. Create a [Flight](https://dev.kevel.com/docs/flights)
2. In General Settings, make sure that **Priority** is set to an Auction Priority
3. Add in [**Rate** and **Price**](https://dev.kevel.com/docs/flights#rateprice), which is used to calculate eCPM.

**Rate** = how you are pricing your inventory (clicks, conversions, impressions, etc)\
**Price** = the price you're charge for the Rate ($0.50 CPC, $5.00 CPA, etc)\
**Rate** x **Price** = **Revenue**\
**Revenue** / (**Impressions**/1000) = **eCPM**

> 📘
>
> If an advertiser wants to raise their bids to get more impressions, you can edit the Rate/Price at any point. When you make a change, the revenue is updated for future events, but previous revenue data will remain unchanged.

**Create a Flight - eCPM Optimization Section**

4. If you are using CPC, CPA ads in an auction, there are multiple fields you can fill out in the 'eCPM Optimization' section. The API equivalent parameters can be found in the [Create Flight](https://dev.kevel.com/reference/create-flight) endpoint.
5. Save

<Image align="center" width="smart" src="https://files.readme.io/fb38426-2021-04-26-102335_1455x776_scrot.png" />

> 📘
>
> If you don't see the `eCPM Optimization` section on the left in the Flight settings, make sure the **Priority** is tied to an auction priority and you are using the CPA, CPC or Flat rate types. For Flat rate Flights, see [Flat-rate Flights](https://dev.kevel.com/docs/flat-rate-flights#auction-priorities).

Below are the fields in this section:

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Name
      </th>

      <th>
        Description
      </th>

      <th>
        API Parameter (Create Flights)
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **Enable eCPM Calculation**
        (required)
      </td>

      <td>
        Needs to be checked for eCPM calculation to work
      </td>

      <td>
        `IsECPMOptimized = true`\
        (boolean)
      </td>
    </tr>

    <tr>
      <td>
        **Override eCPM**\
        (required if eCPM Calculation is off)
      </td>

      <td>
        Set a static eCPM value for the Flight that won't change. Perfect for making Flat-Rate campaigns eligible for auctions. See [Flat-rate Flights](https://dev.kevel.com/docs/flat-rate-flights#auction-priorities).
      </td>

      <td>
        If `EffectiveCPMOverride` has a value, this will be enabled
      </td>
    </tr>

    <tr>
      <td>
        **eCPM Override**\
        (required if eCPM Calculation is off)
      </td>

      <td>
        The static value of above
      </td>

      <td>
        `EffectiveCPMOverride`\
        (float)
      </td>
    </tr>

    <tr>
      <td>
        **Optimization time frame**\
        (required)
      </td>

      <td>
        How many days back you want Kevel to look at data to calculate eCPM. Must be between 1 and 90
      </td>

      <td>
        `ECPMOptimizePeriod`\
        (integer)
      </td>
    </tr>

    <tr>
      <td>
        **eCPM Multiplier**
      </td>

      <td>
        Artificially inflate eCPM value of the flight. For instance, a value of 2 means if the ad is calculated to have an eCPM of $0.50, then it would jump up to $1.00 in the selection process
      </td>

      <td>
        `ECPMMultiplier`\
        (float)
      </td>
    </tr>

    <tr>
      <td>
        **Floor eCPM**
      </td>

      <td>
        Sets minimum eCPM that'll make the ad eligible to be selected
      </td>

      <td>
        `FloorECPM`\
        (float)
      </td>
    </tr>

    <tr>
      <td>
        **Ceiling eCPM**
      </td>

      <td>
        Caps the eCPM used in the auction: a calculated eCPM above this value is treated as this value
      </td>

      <td>
        `CeilingECPM`\
        (float)
      </td>
    </tr>
  </tbody>
</Table>

Auction flights created via the API do not require eCPM Optimization settings. For those flights, we apply the following default settings during the auction:

* Optimization time frame: 7 days
* eCPM multiplier: 1
* Floor eCPM: 0
* Ceiling eCPM: none (infinity)

> 📘
>
> Kevel recalculates the eCPM of each creative every 30 minutes. The calculation is taken over a period of history defined in **Timeframe to Optimize For**. Accepted values are 1 to 90 days. The smaller the number, the less statistically significant the data will be.

> 🚧
>
> An ad with an eCPM below the floor eCPM will not serve (even as a remainder percentage selection) except during the burn-in period.

**Create a Flight - Burn-in Mode**

In the Flight's eCPM Optimization section, you'll also see the "Burn-in Mode Settings" section. This section is required for the flight to run. The API equivalent parameters can be found in the [Create Flight](https://dev.kevel.com/reference/create-flight) endpoint.

Burn-In mode ensures that all ads get enough data to accurately calculate eCPM for future impressions. For instance, for a CPA campaign, the conversion could happen days later, so optimizing too quickly could lead to false negatives.

With Burn-In you set the eCPM an ad starts at, and how many impressions it takes for the ad to reach its calculated eCPM.

<Image align="center" className="border" width="smart" border={true} src="https://files.readme.io/469516e-2021-04-26-102216_1383x202_scrot.png" />

> 🚧
>
> The "Burn-In Impressions" refers to impressions *per creative* not for the Flight as a whole.

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Name
      </th>

      <th>
        Description
      </th>

      <th>
        API Parameter
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **Default eCPM**
        (required)
      </td>

      <td>
        The eCPM the ads will have at the time the Flight begins serving. As impressions are received, individual ads' eCPM values will adjust throughout the burn-in period until reaching their true eCPM value. Note the actual eCPM can be a changing number as the eCPM changes depending on the ad's performance.
      </td>

      <td>
        `DefaultECPM`\
        (float)
      </td>
    </tr>

    <tr>
      <td>
        **Burn-In Impressions**\
        (required)
      </td>

      <td>
        How many impressions the creative needs before its eCPM is based entirely on its own measured performance
      </td>

      <td>
        `ECPMBurnInImpressions`\
        (integer)
      </td>
    </tr>
  </tbody>
</Table>

Auction flights created via the API do not require eCPM Optimization settings. For those flights, we apply the following default settings during the auction:

* Default eCPM: 0
* Burn-in Impressions: 2400

If the default eCPM is 0, ads in burn-in can only be selected through the [remainder percentage](https://dev.kevel.com/docs/priorities#priority-fields) of the Flight's Priority or if there are not enough ads to compete in the auction such that ads with a $0 bid can win.