---
title: "Placement Body Parameters"
method: POST
path: "/part-of-decision/api"
---

# Placement Body Parameters

`POST /part-of-decision/api`

## Request

- Base URL: `https://e-YOUR-NETWORKID.adzerk.net`
- URL: `https://e-YOUR-NETWORKID.adzerk.net/part-of-decision/api`
- Auth: none required

Every request must contain one or more Placements. Each placement represents a "slot" in which an ad may be served.

## Request body

- object
  - `divName` string: A unique name for the placement defined by you
  - `networkid` integer: The numeric network id
  - `siteid` integer, required: The numeric site id
  - `adTypes` integer[], required: One or more integer ad types. More info [here](doc:ad-sizes)
  - `zoneIds` integer[]: Zone IDs to use
  - `advertiserId` integer: An advertiser ID; if specified, only serve that advertiser if possible
  - `campaignId` integer: A numeric campaign id; if specified, only consider ads in that campaign
  - `flightId` integer: A flight ID; if specified, only serve that flight if possible
  - `adId` integer: A numeric ad (flight-creative map) ID; if specified, only serve that ad if possible
  - `clickUrl` string: The ad's click-through URL
  - `properties` object: A map of key/value pairs used for [Custom Targeting](doc:custom-targeting)
    - `age` integer
    - `segment_membership` string
  - `eventIds` integer[]: An array of numeric event types. Requests tracking URLs for custom events. See here for [Event Tracking IDs](doc:custom-event-tracking)
  - `overrides` object: An object that overrides values for an advertiser, campaign, flight or ad. Used especially for header bidding
  - `contentKeys` object: A map of key/value pairs used with [ContentDB](doc:contentdb-1). The format is `"contentKeys": {"schema": "contentKey"}`.
    - `audience` string: *example key/value pair*
    - `businesses` string: *example key/value pair*
  - `count` integer: The number of ads to return per placement. Integer between 1 and 20
  - `proportionality` boolean: If true, fills ads in a multi-winner placement in proportion to the flight's goals
  - `ecpmPartitions` string[]: (BETA) The name of the eCPM Partition that should be used to source eCPM data for auctions
  - `skipSelection` boolean: (BETA) If true, returns all candidate ads for the placement instead of making a selection, bypassing weighting. Will not skip floor pricing settings in an auction, but you can override those via `floorPrice` and `floorCpc`.
  - `skipFilters` object: Specifies which filters to bypass during the selection process. For example, given `"skipFilters":{"keyword":true}`, keyword targeting is ignored. Options: `geodistance`, `geolocation`, `keyword`, `placementLimit`, `facet`, `siteZone`, `category`
    - `keyword` boolean
  - `eventMultiplier` integer: Multiples the count of all events returned in the selection. For example, an impression with an eventMultiplier of 10 will count as 10 impressions in reporting.
  - `floorPrice` number, float: Sets a floor price to use if the selection results in an auction. Overrides any floor price set on the priority. Should be expressed as an eCPM value.
  - `floorCpc` number, float: Sets a [floor CPC](doc:second-price-auctions#cpc-floor-prices) to use if the selection results in an auction. Overrides any floor CPC set on the priority.
  - `logEvents` string, json: Similar to eventIds, but instead of returning event pixels in the response, pushes event pixles into [data shipping logs](doc:data-shipping)
  - `relevancy` object: See the [relevancy score](https://dev.kevel.com/docs/relevancy-score) documentation for data type examples
    - `idAttribute` unknown[]: See the [using relevancy score](https://dev.kevel.com/docs/relevancy-score#using-relevancy-scores) documentation for data type examples
      - unknown
  - `adQuery` object: See [AdQuery](doc:adquery#setting-up-adquery-decision-api-requests) for details and example usage.
    - `key` string

## Response `200`

200

- object
  - `user` object
    - `key` string
  - `decisions` object
    - `div0` object
      - `adId` integer
      - `creativeId` integer
      - `flightId` integer
      - `campaignId` integer
      - `priorityId` integer
      - `clickUrl` string
      - `contents` object[]
        - `type` string
        - `body` string
        - `template` string
        - `data` object
          - `imageUrl` string
          - `title` string
          - `width` integer
          - `height` integer
          - `customData` object
            - `headline` string
            - `cta` string
      - `impressionUrl` string
      - `events` object[]
        - `id` integer
        - `url` string
      - `pricing` object
        - `price` integer
        - `clearPrice` number
        - `revenue` number
        - `rateType` integer
        - `eCPM` integer
  - `candidateRetrieval` object
    - `div0` object
      - `candidatesFoundCount` integer

## Changes

- **2026-11-03** `665ab18f7977`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kevel/apis/engine-apis/changes/part-of-decision/api/post.md)

---

[API](https://skmtc.dev/kevel/apis/engine-apis.md) - [All operations](https://skmtc.dev/kevel/apis/engine-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/kevel/apis/engine-apis/revisions/665ab18f7977?raw)