> For the complete documentation index, see [llms.txt](https://docs.targetpick.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.targetpick.io/targetpick_eng/for-ssp/native.md). # Native ## 1. **REQUEST** {% hint style="info" %} SSP :arrow\_right: DSP {% endhint %} 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](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf) specification and [OpenRTB Dynamic Native Ads API Specification Version 1.2](https://www.iab.com/wp-content/uploads/2018/03/OpenRTB-Native-Ads-Specification-Final-1.2.pdf) specifications. ### **Request object** | Field | Type | Required | Description | | ------ | ------------ | -------- | --------------------------------------------------------------------------------------------------- | | id | string | Y | Unique request ID | | cur | string array | N | Currency for auction (ISO-4217-alpha), e.g., “KRW” | | test | integer | N | Auctions are either in test mode (1) or live mode (0), and bidding is not allowed in test auctions. | | site | object | Y | Refer to the [`site`](#site) object | | app | object | Y | Refer to the [`app`](#app) object | | device | object | Y | Refer to the [`device`](#device) object | | user | object | Y | Refer to the [`user`](#user) object | | imp | object array | Y | Array of [`imp`](#imp) objects | | at | integer | Y | | | tmax | integer | Y | Maximum timeout (ms) | | 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 | N | Refer to the `ext` object | ### **Site** | Field | Type | Required | Description | | --------- | ------------ | -------- | --------------------------------------------- | | id | string | Y | Publisher ID | | name | string | N | Site name | | domain | string | N | Site domain | | page | string | N | Page URL | | ref | string | N | Referrer URL | | cat | string array | N | Categories | | publisher | object | Y | Refer to the [`publisher`](#publisher) object | ### **App** | Field | Type | Required | Description | | --------- | ------------ | -------- | --------------------------------------------- | | id | string | Y | Publisher ID | | name | string | N | Application name | | bundle | string | Y | Bundle or package name | | storeurl | string | N | App store URL | | cat | string array | N | Categories | | publisher | object | Y | Refer to the [`publisher`](#publisher) object | ### **Publisher** > site / publisher\ > app / publisher | Field | Type | Required | Description | | ------ | ------ | -------- | -------------- | | id | string | Y | Publisher ID | | name | string | N | Publisher name | | domain | string | N | Site domain | ### **Device** | Field | Type | Required | Description | | ----- | ------- | -------- | ------------------------------------------------------------------------------------------------------------ | | adid | string | Y | Device ADID information | | make | string | Y | Device make (e.g., “samsung”) | | ua | string | Y | Device User Agent information | | dnt | integer | N |

Whether Do Not Track is enabled.

| | 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 | {% hint style="danger" %} * 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. {% endhint %} ### **User** {% hint style="info" %} This is a CJ MezzoMedia extension field not defined in the RTB protocol. {% endhint %} | Field | Type | Required | Description | | ----- | ------ | -------- | -------------------------------------- | | id | string | Y | Cookie matching ID received from Mezzo | ### **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 | | | type | string | Y | Native | | native | object | Y | Refer to the [`native`](#native) object | | instl | integer | Y |

Indicates interstitial (default : 0)

| | displaymanager | string | Y | SSP platform or SDK name | | displaymanagerver | string | Y | SSP platform or SDK version | ### **Native** > imp / native | Field | Type | Required | Description | | ------- | ------------- | -------- | -------------------------------------------- | | request | string | Y | Valid request for native ads | | ver | string | Y | Version of the Dynamic Native Ads API in use | | battr | integer array | - | Blocked creative attributes | ### **Native\_request** > imp / native / | Field | Type | Required | Description | | ------------- | ------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------- | | ver | string | Y | Version of the Native markup in use | | assets | object array | Y | Refer to the [`native_asset`](#native_asset) object | | eventtrackers | object array | Y |

Supported event tracking types
Refer to the native\_eventtracker object

| | privacy | integer | - | | ### **Native\_asset** > imp / native / native\_request | Field | Type | Required | Description | | -------- | ------- | -------- | ---------------------------------------------------------------- | | id | integer | Y | Unique Asset ID | | required | integer | Y | Set to 1 if the asset is required | | title | object | - | Refer to the [`native_asset: Title`](#native_asset-title) object | | img | object | - | Refer to the [`native_asset: Image`](#native_asset-image) object | | video | object | - | Refer to the [`native_asset: Video`](#native_asset-video) object | | data | object | - | Refer to the [`native_asset: Data`](#native_asset-data) object | ### **Native\_asset: Title** > imp / native / native\_request / native\_asset | Field | Type | Required | Description | | ----- | ------- | -------- | ------------------------------------------------- | | len | integer | Y | Maximum character length within the Title element | ### **Native\_asset: Image** > imp / native / native\_request / native\_asset | Field | Type | Required | Description | | ----- | ------- | -------- | ------------------------------------------------------- | | type | integer | Y | Type ID of the Image element supported by the publisher | | w | integer | - | Image width in pixels | | h | integer | - | Image height in pixels | | wmin | integer | - | Minimum requested Image width in pixels | | hmin | integer | - | Minimum requested Image height in pixels | ### **Native\_asset: Video** > imp / native / native\_request / native\_asset | Field | Type | Required | Description | | ----------- | ------------- | -------- | ----------------------------------------------- | | mimes | string array | Y | Supported content MIME types | | minduration | integer | Y | Minimum video ad duration (seconds) | | maxduration | integer | Y | Maximum video ad duration (seconds) | | protocols | integer array | Y | Video protocol types supported by the publisher | ### **Native\_asset: Data** > imp / native / native\_request / native\_asset | Field | Type | Required | Description | | ----- | ------- | -------- | ---------------------------------------------- | | type | integer | Y | Data element ID supported by the publisher | | len | integer | - | Maximum character length for the Data response | ### **Native\_eventtracker** > imp / native / native\_request / | Field | Type | Required | Description | | ------- | ------------- | -------- | ------------------------------------------------ | | event | integer | Y | Event type that can be tracked | | methods | integer array | Y | Tracking methods delivered when the event occurs | ### **Example** {% tabs %} {% tab title="APP" %} {% code lineNumbers="true" %} ```json { "id": "cdc-7c6d-4029-dcd|1337", "test": 0, "cur": "KRW", "imp": [ { "bidfloor":1.0, "bidfloorcur":"USD", "displaymanager":"SOMA", "displaymanagerver":"sdkandroid_9-1-6", "ext":{ }, "id":"1", "instl":0, "native":{ "battr":[ 1, 3, 5, 8, 9 ], "request":"{ "ver":"1.2",\"plcmttype\":1,\"plcmtcnt\":1,\"seq\":0,\"aurlsupport\":0,\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":90}},{\"id\":2,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":3,\"required\":1,\"img\":{\"type\":1,\"wmin\":50,\"hmin\":50}},{\"id\":5,\"required\":1,\"data\":{\"type\":2,\"len\":140}},{\"id\":6,\"required\":1,\"data\":{\"type\":12,\"len\":15}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1,2]}]}", "ver":"1.2" }, "secure":0, "tagid":"130700475" } ], "app": { "id": "test-pub-app-id", "name": "test-pub-app-name", "bundle": "com.mezzo.co.kr ", "storeurl": "https://play.google.com/store/apps/details?id=com.mezzo.co.kr", "cat": "IAB1", "publisher": { "id": "test-pub-app-id", "domain": "test-pub-domain", "product_attr": 1 } }, "device": { "adid": "test-ifa-gaid", "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", "make":"samsung", "model": "iPhone 7,2", "os": "iOS", "osv": "8.0", "js": 1, "ifa": "test-ifa-gaid" }, "user": { "id": "923123" }, "ext": { } } ``` {% endcode %} {% endtab %} {% endtabs %} ## ## **2. RESPONSE** {% hint style="info" %} DSP :arrow\_right: SSP {% endhint %} The DSP responds by including the object defined below in the HTTP body.\ The object definition follows the OpenRTB 2.5 and OpenRTB Dynamic Native Ads API Specification Version 1.2 specifications. ### **Bid Response** {% hint style="info" %} JSON 형식의 응답 객체입니다. {% endhint %} | Field | Type | Required | Description | | ------- | ------------ | -------- | -------------------------------------------------------------------------------- | | id | string | Y | Bid Request ID | | bidid | string | Y | Bid object ID | | cur | string | Y | Currency used for bidding (e.g., KRW) | | seatbid | object array | Y | Array of [`seatbid`](#seatbid) objects. At least one is required for a valid bid | ### **Seatbid** | Field | Type | Required | Description | | ----- | ------------ | -------- | ------------------------------------------------------------------------ | | seat | string | Y | ID managing the bidding entity | | bid | object array | Y | Array of [`bid`](#bid) objects. At least one is required for a valid bid | ### **Bid** | Field | Type | Required | Description | | ------- | ------------ | -------- | -------------------------------------------------------------------------------------------- | | id | string | Y | ID managing the bid | | impid | string | Y | Impression ID related to the bid request. Must match the impression object ID in the request | | price | float | Y | Bid price | | cat | string array | Y | Categories | | nurl | string | Y | Win notice URL. | | adm | string | Y | Refer to the [`native_response`](#native_response) object | | iurl | string | Y | Impression image URL | | adomain | string array | Y | Advertiser domains for blacklist checking | | cid | string | Y | Advertiser campaign name / ID | | crid | string | Y | Creative name / ID | | w | string | Y | Ad width | | h | string | Y | Ad height | | ext | string | Y | Extension field | ### **Native\_response** > bid / adm / | Field | Type | Required | Description | | ------------- | ------------ | -------- | ------------------------------------------------------------------------------------------------------------------------- | | ver | string | Y | Native markup version | | assets | object array | Y |

Native ad assets.
Refer to the native\_response\_asset object

| | link | object | Y | Refer to the [`native_response_asset_link`](#native_response_asset-link) object | | eventtrackers | object array | Y | Refer to the [`native_response_asset_eventtracker`](#native_response_eventtracker) object | | privacy | string | Y | Response value for privacy requests | ### **Native\_response\_asset** > bid / adm / native\_response | Field | Type | Required | Description | | -------- | ------- | -------- | --------------------------------------------------------------------------------- | | id | integer | Y | Unique asset ID | | required | integer | Y | Set to 1 if the asset is required | | title | object | - | Refer to the [`native_response_asset_title`](#native_response_asset-title) object | | img | object | - | Refer to the [`native_response_asset_image`](#native_response_asset-image) object | | video | object | - | Refer to the [`native_response_asset_video`](#native_response_asset-video) object | | data | object | - | Refer to the [`native_response_asset_data`](#native_response_asset-data) object | ### **Native\_response\_asset: Title** > bid / adm / native\_response / native\_response\_asset | Field | Type | Required | Description | | ----- | ------ | -------- | ------------------------------------- | | text | string | Y | Text associated with the Text element | ### **Native\_response\_asset: Image** > bid / adm / native\_response / native\_response\_asset | Field | Type | Required | Description | | ----- | ------- | -------- | ---------------------- | | url | string | Y | Image asset url | | w | integer | Y | Image width in pixels | | h | integer | Y | Image height in pixels | ### **Native\_response\_asset: Video** > bid / adm / native\_response / native\_response\_asset | Field | Type | Required | Description | | ------- | ------ | -------- | ----------- | | vasttag | string | Y | vast xml | ### **Native\_response\_asset: Data** > bid / adm / native\_response / native\_response\_asset | Field | Type | Required | Description | | ----- | ------ | -------- | --------------------------------------------------- | | value | string | Y | Formatted string to be displayed for the Data asset | ### **Native\_response\_asset: Link** > bid / adm / native\_response / native\_response\_asset | Field | Type | Required | Description | | ----- | ------ | -------- | --------------------- | | url | string | Y | Clickable landing URL | ### **Native\_response\_eventtracker** > bid / adm / native\_response / | Field | Type | Required | Description | | ------- | ------- | -------- | ------------------------- | | event | integer | Y | Type of event to track | | methods | integer | Y | Requested tracking method | ### **Example** {% tabs %} {% tab title="success" %} {% code lineNumbers="true" %} ```json { "id": "ece5c105-dd24-468f-8392-d624b8d49953", "seatbid": [ { "bid": [ { "id":"5d7801c2be564c8100f00011-1062015", "price":2.0, "impid":"1", "nurl":"http://node-p2e-gie4ah.sitescout.com/smaato/win/aid:5d7801c2be564c8100f00011;c:${AUCTION_PRICE};s:;cid:1062015;ts:1568145858061;d:MzMzMTUwMi1uYXRpdmU", "adm":"{\"native\":{\"link\":{\"url\":\"http://clickserv.sitescout.com/clk/8cc00d7733a331ba/88e42568017fb609/0-0/0///~_aid_~5d7801c2be564c8100f00011//cidentLy8vLy8\",\"clicktrackers\":[\"https://adrta.com/c?clid=ss&paid=ss&cb=1568145858061&avid=112053&caid=1062015&publisherId=1100043642&kv5=&plid=3331502&segment=&kv4=100.10.38.5&kv14=&kv1=native&siteId=120207704&kv7=17&kv15=UNKNOWN&kv16=&kv17=&kv18=com.particlenews.newsbreak&kv24=MOBILE_APP&kv20=&kv21=eb6fe99843ff5310bd0cd40d267826fff05d8aa3&kv22=9863a35c-c598-4c80-b091-d7adf379bb26&kv11=5d7801c2be564c8100f00011&kv3=&kv2=\"]},\"ver\":\"1.2\",\"assets\":[{\"id\":5,\"required\":1,\"data\":{\"type\":2,\"value\":\"Lose 3 to 5 pounds per week. Keep it off with free support for life!\"}},{\"id\":2,\"required\":1,\"img\":{\"type\":3,\"url\":\"http://cdn01.basis.net/112100/112053/uhSvl5gEElOXwX0T.jpg\",\"w\":1200,\"h\":627}},{\"id\":1,\"required\":1,\"title\":{\"text\":\"Lose Weight For Life!\"}},{\"id\":6,\"required\":1,\"data\":{\"type\":12,\"value\":\"Learn more\"}},{\"id\":3,\"required\":1,\"img\":{\"type\":1,\"url\":\"http://cdn01.basis.net/112100/112053/5MkC88n4Mc8MdPa4.jpg\",\"w\":240,\"h\":240}}],\"imptrackers\":[\"https://node-p2e-gie4ah.sitescout.com/smaato/px/aid:5d7801c2be564c8100f00011;c:${AUCTION_PRICE};s:;cid:1062015;ts:1568145858061\",\"https://pixel-sync.sitescout.com/dmp/pixelSync?nid=17&wb=1&hdid=0&id=9863a35c-c598-4c80-b091-d7adf379bb26&idType=4\",\"https://ad.doubleclick.net/ddm/trackimp/N428001.3027484BASISDSP/B22322261.248240382;dc_trk_aid=447774364;dc_trk_cid=119057854;u=210363%7C5d7801c2be564c8100f00011%7C%7Ccom.particlenews.newsbreak%7CAWAKEN002CP+%5BCPA%5D+GT+%28Zips%2B15+mi%29_Display%7CMOBILE_APP%7C1062015;ord=[timestamp];dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;tfua=?\"],\"jstracker\":\"\"}}", "adomain":[ "awaken180weightloss.com" ], "iurl":"http://preview.sitescout.ad/preview?adOnly=1&ad=8cc00d7733a331ba", "crid":"3331502", "cid":"1062015", "attr":[ ], "cat":[ "IAB7-44", "IAB7" ] } ], "seat":"18878" } ], "bidid": "dsp", "cur": "KRW" } ``` {% endcode %} {% endtab %} {% tab title="noad" %} {% code lineNumbers="true" %} ```json { "id": "", "seatbid": [], "bidid": "mezzo", "cur": "KRW" } ``` {% endcode %} {% endtab %} {% endtabs %} ## ## 3. SKAdNetwork Support (iOS 14+) {% hint style="info" %} This section describes support for campaigns where SKAdNetwork is enabled on iOS 14 or later. {% endhint %}
1The DSP must be registered as an Ad Network in Apple’s SKAdNetwork API. (https://developer.apple.com/documentation/storekit/skadnetwork/registering_an_ad_network)
2A public key must be issued by Apple and a postback URL must be configured.
3The SKAdNetwork ID issued by Apple must be shared with CJ MezzoMedia, which will request registration in the publisher’s info.plist.
4When returning a response for SKAdNetwork-enabled campaigns, the DSP must include the SKAdNetwork ID and all related fields.
5The advertiser app must register via registerAppForAdNetworkAttribution().
6The DSP can receive install data via SKAdNetwork.
### Additional Fields in Ad Request (SKAdNetwork) > BidRequest / imp / banner / ext / skadn Prerequisites:
1DSP에서 제공하는 SKAdNetwork ID가 퍼블리셔의 info.plist에 등록되어 있어야 한다.
1The DSP’s SKAdNetwork ID must be registered in the publisher’s info.plist.
2The user device must run iOS 14 or higher.
3A version of the SDK that supports SKAdNetwork must be installed.
4The 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** {% tabs %} {% tab title="Request" %} {% code lineNumbers="true" %} ```json { "imp":[{ "ext": { "skadn": { "version": "2.0", "sourceapp": "000000000", "skadnetids": ["feyaarzu9v.skadnetwork", "8sRFag4vVC.skadnetwork"] } } }] } ``` {% endcode %} {% endtab %} {% tab title="Response" %} {% code lineNumbers="true" %} ```json { "seatbid": [{ "bid": [{ "ext": { "skadn": { "version": "2.0", "network": "feyaarzu9v.skadnetwork ", "campaign": "45", "itunesitem": "123456789", "nonce": "123b1a78-b5ef-98ad-1234-ab-c4effa00b8", "sourceapp": "000000000", "timestamp": "1234567890", "signature": "ABCDEFGHijkl-lmbKBSE8QnhLTIHZZZWCFgZpRqRxHss65KoFAiAJgJKjdrWdkLUOCCjuEx2RmFS7daRzSVZRVZ8RyMyUXg" } } }] }] } ``` {% endcode %} {% endtab %} {% endtabs %}