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	The Apache License, Version 2.0
Categories	Net
GroupId	net.media
ArtifactId	openrtb3-converter-core
Last Version	1.0.5
Release Date	May 8, 2019
Type	jar
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	https://github.com/InteractiveAdvertisingBureau/openrtb3-converter/tree/master/converter-core

Download openrtb3-converter-core

Filename	Size
openrtb3-converter-core-1.0.5.pom
openrtb3-converter-core-1.0.5.jar	8 MB
openrtb3-converter-core-1.0.5-sources.jar	175 KB
openrtb3-converter-core-1.0.5-javadoc.jar	875 KB

How to add to project

Apache Maven

<!-- 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>

Gradle Groovy

// https://jarcasting.com/artifacts/net.media/openrtb3-converter-core/
implementation 'net.media:openrtb3-converter-core:1.0.5'

Gradle Kotlin

// https://jarcasting.com/artifacts/net.media/openrtb3-converter-core/
implementation ("net.media:openrtb3-converter-core:1.0.5")

Apache Buildr

'net.media:openrtb3-converter-core:jar:1.0.5'

Apache Ivy

<dependency org="net.media" name="openrtb3-converter-core" rev="1.0.5">
  <artifact name="openrtb3-converter-core" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='net.media', module='openrtb3-converter-core', version='1.0.5')
)

Scala SBT

libraryDependencies += "net.media" % "openrtb3-converter-core" % "1.0.5"

Leiningen

[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.

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:

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.

IAB Tech Lab

IAB Tech Lab CodeBank

Versions

Version
1.0.5 May 8, 2019
1.0.4 May 3, 2019
1.0.3 Apr 25, 2019
1.0.2 Apr 24, 2019
1.0.1 Apr 23, 2019