Video

Guide for SSP Video Inventory Integration with CJ MezzoMedia DSP

1. REQUEST

CJ MezzoMedia DSP sends the object defined below in JSON format via HTTP POST to the above URL. The request object definition follows the OpenRTB 2.5 specification.

Request object

Field	Type	Required	Description
id	string	Y	Unique request ID
at	integer	Y	0 : fixed price, 1: first price, 2: second price
tmax	integer	Y	Maximum timeout (ms)
imp	object array	Y	Array of imp objects
app	object	Y	Refer to the app object
device	object	Y	Refer to the device object
user	object	Y	Refer to the user object
bcat	string array	N	Block advertiser categories based on IAB categories
badv	string array	N	Block advertiser domains
bapp	string array	N	Block app bundle or package names
ext	object	Y	Refer to the ext object

Imp

Field	Type	Required	Description
id	string	Y	Unique impression ID
bidfloor	float	Y	Minimum bid price (e.g., 4.12)
bidfloorcur	string	Y	Currency (e.g., KRW)
secure	integer	Y	0 : http, 1 : https
video	object	Y	Refer to the video object
instl	integer	Y	Indicates interstitial (default : 0) 1: the ad is interstitial or full screen 0: not interstitial
displaymanager	string	Y	SSP platform or SDK name
displaymanagerver	string	Y	SSP platform or SDK version

Video

imp / video

Field	Type	Required	Description
mimes	string array	Y	MIME types. (e.g., “video/mp4”)
w	integer	Y	Video width
h	integer	Y	Video height
minduration	integer	Y	Minimum video playback duration (seconds)
maxduration	integer	Y	Maximum video playback duration (seconds)
protocols	integer array	Y	VAST version. Pass “3”
startdelay	integer	Y	Indicates pre-roll, mid-roll, post-roll ad type 0: Pre-roll -1: Standard mid-roll -2: Standard post-roll
linearity	integer	Y	1: Linear / In-Stream 2: Non-Linear / Overlay
delivery	integer array	Y	Pass 2 (Progressive)
placement	integer	Y	Video placement 1: In-player 2: In-banner 3: In-article 4: In-feed 5: Interstitial / Slide / Floating
ext	object	N	Additional information beyond standard fields (e.g., rewarded)

Video / ext

imp / video / ext

Field	Type	Required	Description
rewarded	integer	N	Indicates whether this is a reward ad. 0: no(non-reward) 1: yes(reward))

App

Field	Type	Required	Description
id	string	Y	Publisher ID
name	string	N	Application name
bundle	string	Y	Bundle name, package name
storeurl	string	N	App store URL
cat	string array	N	Categories
publisher	object	Y	Refer to the publisher object

Publisher

app / publisher

Field	Type	Required	Description
id	string	Y	Publisher ID
name	string	N	Publisher name
cat	string array	N	Categories

Device

Field	Type	Required	Description
ua	string	Y	Device User Agent information
dnt	integer	N	Whether Do Not Track is enabled. (0: track allowed, 1: track disallowed)
ip	string	Y	IPv4 address
model	string	N	Model name
os	string	Y	Operating system. (e.g., iOS, Android)
osv	string	Y	Operating system version. (e.g., 8.1, 9.2)
js	integer	N	Defined as 1 in the RTB protocol
ifa	string	Y	Apple IFA or Google ADID

• User Agent (UA) is required for ad exchange transactions.

• IP must be a public IP. Using private IP (e.g., from internal networks or routers) may limit ad delivery.

User

This is a CJ MezzoMedia extension field not defined in the RTB protocol.

Field	Type	Required	Description
id	string	Y	Unique user ID

Example

APP

{
   "id": "cdc-7c6d-4029-dcd|1337",
   "at": 0,
   "tmax": 250,
   "imp": [
      {
         "id": "150226007700",
         "bidfloorcur": "KRW",
         "bidfloor": 0,
         "secure": 0,
         "video": {
            "mimes": [
               "video\\/mp4"
            ],
            "w": 1080,
            "h": 1920,
            "minduration": 5,
            "maxduration": 30,
            "protocols": [
               3
            ],
            "startdelay": 0,
            "linearity": 1,
            "delivery": [
               2
            ],
            "ext": {
               "rewarded": 1
            }
         },
         "instl": 0
      }
   ],
   "app": {
      "id": "test-pub-app-id",
      "name": "test-pub-app-name",
      "bundle": "com.mezzo.co.kr ",
      "storeurl": "https://itunes.apple.com/us/app/id1234567?mt=8",
      "cat": [
         "IAB1"
      ],
      "publisher": {
         "id": "test-pub-app-id",
         "name": "test-pub-app-name",
         "cat": [
            "IAB1"
         ]
      }
   },
   "device": {
      "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 8_4 like Mac OS X) AppleWebKit/600.1.4 (KHTML, like Gecko) Mobile/12H141",
      "dnt": 0,
      "ip": "192.168.1.1",
      "model": "iPhone 7,2",
      "os": "iOS",
      "osv": "8.0",
      "js": 1,
      "ifa": "test-ifa-gaid"
   },
   "user": {
      "id": "923123"
   },
   "ext": {
   }
}

WEB

2. RESPONSE

SSP ➡️ DSP

CJ MezzoMedia SSP returns the response by including the following object in the HTTP body. The object definition follows the OpenRTB 2.5 specification.

Bid Response

Response object in JSON format.

Field	Type	Required	Description
id	string	Y	ID of the Bid Request
bidid	string	Y	ID of the Bid object
cur	string	Y	Currency used for bidding (e.g., KRW)
seatbid	object array	Y	Array of bid objects

Bid

Field	Type	Required	Description
id	string	Y	ID managing the bid
price	float	Y	Bid price
adm	string	Y	Refer to the adm object
nurl	string	Y	Win notice URL
adomain	string array	Y	Advertiser domains for blacklist checking
cid	string	Y	Advertiser campaign name / ID
crid	string	Y	Creative name / ID
cat	string array	Y	Categories
ext	object	Y	Refer to the ext object

Ext

Field	Type	Required	Description
clickurl	string	Y	Click tracking URL
viewable	string	Y	Tracking URL for when the ad area is at least 20% visible for 2 seconds or more
breakaway	string	Y	Tracking URL for an event where ad playback ends before completion

If {m_sec} is included in the breakaway URL, {m_sec} is replaced with the ad playback time before the URL is called. For example, if the breakaway value is set to http://breakaway.tracking.com/tracking.do?time={m_sec} and the user leaves after 20 seconds of playback, http://breakaway.tracking.com/tracking.do?time=20 is called.

Adm

Defined as an object in XML format. The object definition follows the VAST 3.0 specification.

Field	Type	Required	Description
VAST	element	Y	Refer to the VAST element

VAST

adm / VAST

Field	Type	Required	Description
version	integer	Y	VAST protocol version. For VAST 3.0, set as 3
Ad	element array	Y	Array of Ad element

Ad

adm / Ad

Field	Type	Required	Description
id	integer	N	Ad ID
sequence	integer	N	Ad sequence number
Inline	element	Y	Refer to the Inline element

Inline

adm / Ad / Inline

Field	Type	Required	Description
AdSystem	integer	N	Refer to the AdSystem object
AdTitle	integer	N	Ad title
Extensions	element	N	Array of Extensions elements
Error	element	N	Tracking URL called when a player error occurs
Impression	element	Y	Tracking URL called when the video starts
Creatives	element array	Y	Array of Creative elements

AdSystem

adm / Ad / Inline / AdSystem

Field	Type	Required	Description
version	integer	N	The element value is the ad engine name.

The element value is the ad engine name.

Extensions

adm / Ad / Inline / Extensions

Field	Type	Required	Description
requestID	string	N	nique identifier for the ad request

Creative

adm / Ad / Inline / Creatives / Creative

Field	Type	Required	Description
id	integer	N	Ad ID
sequence	integer	N	Ad sequence
Linear	element	Y	Linear element

Linear

adm / Ad / Inline / Creatives / Creative / Linear

Field	Type	Required	Description
Duration	string	N	Video duration (hh:mm:ss format)
TrackingEvents	element array	N	Tracking elements
VideoClicks	element	N	VideoClicks element
MediaFiles	element array	Y	MediaFile elements

Tracking

adm / Ad / Inline / Creatives / Creative / Linear / TrackingEvents / Tracking

The element value is an HTTP(s) URL used to handle click events.

Field	Type	Required	Description
event	string	Y	Event name (e.g., start, firstQuartile, midpoint)
offset	element array	N	Playback time condition (hh:mm:ss format), value is tracking URL

The element value is an HTTP(s) URL used to handle click events.

Event name	Description
start	Called when the video starts
firstQuartile	Called at 25% playback
midpoint	Called at 50% playback
thirdQuartile	Called at 75% playback
complete	Called when playback completes
progress	Called at specified offset (multiple URLs allowed for same event/offset)

Multiple tracking URLs can be assigned to the same event when the event value and offset value are identical.

VideoClicks

adm / Ad / Inline / Creative / Linear / VideoClicks

The element value is an HTTP(s) URL used to handle click events.

Field	Type	Required	Description
ClickThrough	string	Y	Ad landing page URL
ClickTracking	string	N	Click tracking URL
offset	string	N	Click allowed after specified playback time

ClickThrough can redirect to the final landing page after DSP click processing.

MediaFile

adm / Ad / Inline / Creatives / Creative / Linear / MediaFiles / MediaFile

Field	Type	Required	Description
delivery	string	N	Video delivery method (progressive supported)
type	string	N	Video format (e.g., video/mp4)
width	integer	N	Video width
height	integer	N	Video height
bitrate	integer	N	Video bitrate

Element value is the video content URL (HTTP, HTTPS).

Example

reponse

{
   "id": "cdc-7c6d-4029-dcd|1337",
   "at": 0,
   "tmax": 250,
   "imp": [
      {
         "id": "150226007700",
         "bidfloorcur": "KRW",
         "bidfloor": 0,
         "secure": 0,
         "video": {
            "mimes": [
               "video\\/mp4"
            ],
            "w": 1080,
            "h": 1920,
            "minduration": 5,
            "maxduration": 30,
            "protocols": [
               3
            ],
            "startdelay": 0,
            "linearity": 1,
            "delivery": [
               2
            ],
            "ext": {
               "rewarded": 1
            }
         },
         "instl": 0
      }
   ],
   "site": {
      "id": "test-pub-app-id",
      "domain": "test-pub-web-domain",
      "ref": " test-pub-web-ref",
      "cat": [
         "IAB1"
      ],
      "publisher": {
         "id": "test-pub-app-id",
         "name": "test-pub-app-name",
         "cat": [
            "IAB1"
         ]
      }
  },
  "device": {
      "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 8_4 like Mac OS X) AppleWebKit/600.1.4 (KHTML, like Gecko) Mobile/12H141",
      "ip": "192.168.1.1"
  },
  "user": {
      "id": "923123"
  },
  "ext": {
      "price_type": 1,
      "tracking_type": 0
  }
}

adm

3. SKAdNetwork Support (iOS 14+)

This section describes support for campaigns where SKAdNetwork is enabled on iOS 14 or later.

1	The DSP must be registered as an Ad Network in Apple’s SKAdNetwork API. (https://developer.apple.com/documentation/storekit/skadnetwork/registering_an_ad_network)
2	A public key must be issued by Apple and a postback URL must be configured.
3	The SKAdNetwork ID issued by Apple must be shared with CJ MezzoMedia, which will request registration in the publisher’s info.plist.
4	When returning a response for SKAdNetwork-enabled campaigns, the DSP must include the SKAdNetwork ID and all related fields.
5	The advertiser app must register via registerAppForAdNetworkAttribution().
6	The DSP can receive install data via SKAdNetwork.

Additional Fields in Ad Request (SKAdNetwork)

BidRequest / imp / banner / ext / skadn

Prerequisites:

1	The DSP’s SKAdNetwork ID must be registered in the publisher’s info.plist.
2	The user device must run iOS 14 or higher.
3	A version of the SDK that supports SKAdNetwork must be installed.
4	The DSP must comply with CJ MezzoMedia Bid Request specifications.

Field	Type	Required	Description	Example
version	string	Y	SKAdNetwork version (2.0 or higher)	“version”:”2.0”
sourceapp	string	Y	Publisher app ID registered in Apple App Store. Matches BidRequest.app.bundle	“sourceapp”:”000000000”
skadnetids	string	Y	SKAdNetwork IDs registered in publisher’s info.plist	“skadnetids”:[“feyaarzu9v.skadnetwork”]

Additional Fields in Ad Response (SKAdNetwork)

BidResponse / imp / banner / ext / skadn

Field	Type	Required	Description	Example
version	string	Y	SKAdNetwork version (2.0 or higher)	“version”:”2.0”
network	string	Y	Ad network identifier. Must match at least one skadnetid in the request	“network”:[“feyaarzu9v.skadnetwork”]
campaign	string	Y	Campaign ID (integer between 1 and 100 per Apple spec)	“campaign”:”45”
itunesitem	string	Y	Advertiser app ID in App Store. Matches BidResponse.bid.bundle	“itunesitem”:”123456789”
nonce	string	Y	Unique ID for each ad response	“nonce”:”123b1a78-b5ef-98ad-1234-ab-c4effa00b8”
sourceapp	string	Y	Publisher app ID. Matches BidRequest.imp.ext.skad.sourceapp	“sourceapp”:”000000000”
timestamp	string	Y	Unix time as a string	“timestamp”:”1234567890”
signature	string	Y	SKAdNetwork signature provided by Apple	“signature”:”ABCDEFGHijkl-lmb…”

Example

Request

{
	"imp":[{
        "ext": {
          "skadn": {
            "version": "2.0",
			"sourceapp": "000000000",
			"skadnetids": ["feyaarzu9v.skadnetwork", "8sRFag4vVC.skadnetwork"]
			}
			}
		}]
}

Response