Line Item Eligibility

Before a line item can bid on an impression, it must pass all eligibility checks. These checks are evaluated in order and the first failure stops evaluation.

Eligibility checks

#
Check
Rejection reason

1

Status

Line item must not be paused

2

Start date

Current time must be after delivery.startDate

3

End date

Current time must be before delivery.endDate

4

Media type

Line item media type must match the impression (e.g. banner requires imp.banner)

5

Targeting

Every targeting attribute on the unified Targeting shape must pass (see Targeting)

Line item statuses

Status
Can deliver?
Description

needs_creative

No

No creatives attached yet

ready

Yes

Ready to deliver but not yet started

delivering

Yes

Currently active

paused

No

Manually paused by the user

completed

No

Goal reached or end date passed

Media type matching

The line item's mediatype field must match the impression object:

Line item mediatype
Required impression field

banner

imp.banner must be present

video

imp.video must be present

native

imp.native must be present

audio

imp.audio must be present

Debug information

In non-production environments or when test=1 or nexx360_debug=1 is set, the response includes an ext.eligibility object with the rejection reason for each line item per impression. Example reasons:

The targeting reason format is targeting:<attribute>:<mode> (...), where <attribute> matches the field name on the unified Targeting shape (e.g. geography, domain, userData) and <mode> is included or excluded.

Last updated

Was this helpful?