TripleLift supplier ingest
TripleLift runs the TripleLift Exchange and accepts server-to-server supply over OpenRTB. This profile covers the requests supply partners send and TripleLift's responses, not the requests TripleLift sends to DSPs.
Direction and version
Server-to-server supply partners send bid requests to the TripleLift Exchange, and TripleLift returns bid responses.
OpenRTB 2.x JSON with integer flags. Native 1.2 requests are JSON strings in imp.native.request.
The RTBlint profile triplelift-supplier checks requests and responses against the published contract.
Rules beyond the OpenRTB spec
- Each impression needs
imp.tagid, the TripleLift placement name or ID, and at least one media object. imp.banner.formatis required and must list a size. Exactwandhare a documented fallback whenformatis absent.- Video and audio need
mimes, Native needsrequest, and deals needid. - The App table marks
app.bundlerequired, while the prose says an app ID or bundle is not strictly required. siteandappmust not both appear.- Native image assets need
type, and an exact or minimum image size is recommended. - A Native response may use
assetsurlonly when the request setaurlsupportto 1. An absentaurlsupportmeans unsupported. - Returned Native event trackers must use an event and method the request offered. IDs are standard values or exchange-specific values of 500 and above.
- A Native
jstrackermust be HTML with script tags.
Documented extensions
| Path | Meaning |
|---|---|
regs.ext | Accepted location for GDPR, CCPA, and GPP signals alongside the regs fields. |
What the validator checks for this profile
openrtb.profile.triplelift.assetsurl_unsupportedNative assetsurl requires request aurlsupport=1; omission means unsupported.openrtb.profile.triplelift.banner_format_emptyTripleLift's required format array must describe at least one banner size.openrtb.profile.triplelift.banner_format_fallbackTripleLift labels format required but recommends w/h when it is absent. This request uses that documented fallback.openrtb.profile.triplelift.bundle_contract_conflictTripleLift's app table requires bundle while its prose says an app ID or bundle is not strictly required. Confirm the active supplier contract.openrtb.profile.triplelift.event_enumNative event and method IDs must be standard IDs or exchange-specific values of at least 500.openrtb.profile.triplelift.event_unofferedThe returned Native event and tracking method must be among the request's declared options.openrtb.profile.triplelift.image_size_recommendedTripleLift recommends an exact or minimum native image dimension.openrtb.profile.triplelift.jstracker_markupTripleLift Native 1.2 jstracker contains HTML with script tags.
Validate against this contract
Open the tester with the TripleLift supplier ingest profile, or run:
rtblint validate --profile triplelift-supplier request.json