openrtb3-converter-core

Core library offering transformation support between requests and responses of various OpenRTB versions: 2.3, 2.4, 2.5 and 3.0

License

License

Categories

Categories

Net
GroupId

GroupId

net.media
ArtifactId

ArtifactId

openrtb3-converter-core
Last Version

Last Version

1.0.5
Release Date

Release Date

Type

Type

jar
Description

Description

openrtb3-converter-core
Core library offering transformation support between requests and responses of various OpenRTB versions: 2.3, 2.4, 2.5 and 3.0
Project URL

Project URL

https://github.com/InteractiveAdvertisingBureau/openrtb3-converter/tree/master/converter-core

Download openrtb3-converter-core

How to add to project

<!-- https://jarcasting.com/artifacts/net.media/openrtb3-converter-core/ -->
<dependency>
    <groupId>net.media</groupId>
    <artifactId>openrtb3-converter-core</artifactId>
    <version>1.0.5</version>
</dependency>
// https://jarcasting.com/artifacts/net.media/openrtb3-converter-core/
implementation 'net.media:openrtb3-converter-core:1.0.5'
// https://jarcasting.com/artifacts/net.media/openrtb3-converter-core/
implementation ("net.media:openrtb3-converter-core:1.0.5")
'net.media:openrtb3-converter-core:jar:1.0.5'
<dependency org="net.media" name="openrtb3-converter-core" rev="1.0.5">
  <artifact name="openrtb3-converter-core" type="jar" />
</dependency>
@Grapes(
@Grab(group='net.media', module='openrtb3-converter-core', version='1.0.5')
)
libraryDependencies += "net.media" % "openrtb3-converter-core" % "1.0.5"
[net.media/openrtb3-converter-core "1.0.5"]

Dependencies

compile (1)

Group / Artifact Type Version
org.hibernate : hibernate-validator jar 6.0.5.Final

test (2)

Group / Artifact Type Version
junit : junit jar 4.12
org.skyscreamer : jsonassert jar 1.2.3

Project Modules

There are no modules declared in this project.

build_status

The new structure of OpenRTB 3.0

Programmatic advertising has seen consistent growth over the last few years. However, due to varied requirements of different partners and the increasing complexity in the supply chain, it was felt that the underlying structure of oRTB was not scalable enough and needed to be changed.

OpenRTB 3.0 thus introduced a layered approach where the commerce transaction (e.g., auction parameters, deals, bids, etc.) was differentiated from the object specifications (e.g ads, placements, users, devices, sites, publishers, etc). The commerce transaction is supposed to be the focus of oRTB while the objects being transacted was added to AdCOM (Advertising Common Object Model).

This has two benefits: 1.) The AdCOM layer can be reused in other specifications such as OpenDirect, AdManagementAPI and custom specifications 2.) The object layer can be revised independent of the oRTB spec.

Problem:

However, structural changes also mean that oRTB 3.0 is not backward compatible. This becomes problematic when different partners in the supply chain are on different versions of oRTB.

Solution: the Library

This is the problem which media.net wants to solve with the open source library which can be used to convert requests and responses from OpenRTB 3.0 to OpenRTB 2.x and vice-versa.

How the convertor fits in the supply chain when an exchange and a DSP/Exchange are on different versions of OpenRTB:

Supply chain

How is the conversion done?

The conversion is done by analyzing the objects and fields for requests and responses across oRTB 3.0 and oRTB2.x. The objects and their fields from one specification are mapped to the corresponding or closest objects and fields of the other specification. In case where a direct or close mapping does not exist, extension sub-objects of the respective objects are used.

Specification versions supported

The library allows conversion from OpenRTB v 2.3, 2.4, 2.5 to OpenRTB v3.0 and vice-versa for both requests and responses.

AdCOM 1.0 is supported as the Layer 4 object.

OpenRTB Dynamic Native Ads API Specification Version 1.1 is used for transacting native ad objects for OpenRTB 2.x.

Documentation

Details about how to use the library are available here.

The mappings which serve as the standard for conversion between OpenRTB 3.0 and OpenRTB 2.5 are available here and here PDF.

net.media

IAB Tech Lab

IAB Tech Lab CodeBank

Versions

Version
1.0.5
1.0.4
1.0.3
1.0.2
1.0.1