> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/rtb/publishers/open-rtb/open-rtb-2.5-pub-code-examples.md).

# Open RTB 2.5 Examples

## Open RTB 2.5 Publisher Request

### Banner

```json
{
   "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
   "at": 1,
   "imp": [
      {
         "id": "974090632",
         "banner": {
            "w": 300,
            "h": 250
         }
      }
   ],
   "site": {
      "id": "12345",
      "domain": "sitedomain.com",
      "cat": [
         "IAB25-3"
      ],
      "page": "https://sitedomain.com/page",
      "keywords": "lifestyle, humour"
   },
   "device": {
      "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36",
      "sua": {
         "architecture": "x86",
         "bitness": "64",
         "model": "Windows",
         "mobile": 0,
         "source": 2,
         "platform": {
            "brand": "Windows",
            "version": [
               "10",
               "0",
               "0"
            ]
         },
         "browsers": [
            {
               "brand": "Chromium",
               "version": [
                  "136",
                  "0",
                  "7103",
                  "93"
               ]
            },
            {
               "brand": "Microsoft Edge",
               "version": [
                  "136",
                  "0",
                  "3240",
                  "64"
               ]
            },
            {
               "brand": "Not.A\/Brand",
               "version": [
                  "99",
                  "0",
                  "0",
                  "0"
               ]
            }
         ]
      },
      "ip": "192.0.2.1",
      "geo": {
         "country": "IRL"
      },
      "language": "en",
      "os": "Linux & UNIX",
      "js": 0,
      "ext": {
         "remote_addr": "192.0.2.1",
         "x_forwarded_for": "",
         "accept_language": "en-GB;q=0.8,pt-PT;q=0.6,en;q=0.4,en-US;q=0.2,de;q=0.2,es;q=0.2,fr;q=0.2"
      }
   },
   "user": {
      "id": "57592f333f8983.043587162282415065",
      "ext": {
         "consent": "CO9A8QHPAbnHWBcADBENBJCoAAAAAAAAAAqIHKJU9VybLh0Dq4A170B0OAEYN_r_v40zigeds-8Myd-X3DsX50M7vFy6pr4AuR4km3CBIQFkHOmcTUmw6IkVrRPsak2Mr7NKJ7PEinsbe2dYEHtfn9VTuZKZr97s___zf_-___3_75f__-3_3_vp9UAAAABA5QAkgkDYAKAQRAAJIwKhQAhAuJDoBAAUUIwtE1hASuCmYVAR-ggYAIDUBGAECDEEGIIIAAAAAkgiAkAPBAAgCIBAACAFSAhAARoAgsAJAwCAAUA0LACKAIQJCDI4KjlICAiRaKCeSMASi72MMIQSigAAAAAAAA"
      }
   },
   "ext": {
      "sub": 1221
   }
}
```

### Direct Links

```json
{
   "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
   "at": 1,
   "imp": [
      {
         "id": "974090632",
         "instl": 0,
         "el": "dGVzdGVAZW1haWwuY29t"
      }
   ],
   "site": {
      "id": "12345",
      "domain": "sitedomain.com",
      "cat": ["IAB25-3"],
      "page": "https://sitedomain.com/page",
      "keywords": "lifestyle, humour",
      "pagecat": ["IAB25-3"],
      "ext": {
         "exchangecat": 508,
         "idzone": 445566
      }
   },
   "device": {
      "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36",
      "sua": {
         "architecture": "x86",
         "bitness": "64",
         "model": "Windows",
         "mobile": 0,
         "source": 2,
         "platform": {
               "brand": "Windows",
               "version": [
                  "10",
                  "0",
                  "0"
               ]
         },
         "browsers": [
               {
                  "brand": "Chromium",
                  "version": [
                     "136",
                     "0",
                     "7103",
                     "93"
                  ]
               },
               {
                  "brand": "Microsoft Edge",
                  "version": [
                     "136",
                     "0",
                     "3240",
                     "64"
                  ]
               },
               {
                  "brand": "Not.A\/Brand",
                  "version": [
                     "99",
                     "0",
                     "0",
                     "0"
                  ]
               }
         ]
      },
      "ip": "192.0.2.1",
      "geo": {
         "country": "PRT"
      },
      "language": "en",
      "os": "Linux & UNIX",
      "js": 0,
      "ext": {
         "remote_addr": "192.0.2.1",
         "x_forwarded_for": "192.0.2.1"
      }
   },
   "user": {
      "id": "57592f333f8983.043587162282415065"
   },
   "ext": {
      "sub": 1221
   }
}
```

### Email Clicks

```json

{
   "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
   "at": 1,
   "imp": [
      {
         "id": "974090632",
         "instl": 0,
         "el": "dGVzdGVAZW1haWwuY29t"
      }
   ],
   "site": {
      "id": "12345",
      "domain": "sitedomain.com",
      "name": "site domain",
      "cat": ["IAB25-3"],
      "page": "https://sitedomain.com/page",
      "keywords": "lifestyle, humour",
      "ext": {
         "exchangecat": 508,
         "idzone": 445566
      }
   },
   "device": {
      "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36",
      "sua": {
         "architecture": "x86",
         "bitness": "64",
         "model": "Windows",
         "mobile": 0,
         "source": 2,
         "platform": {
               "brand": "Windows",
               "version": [
                  "10",
                  "0",
                  "0"
               ]
         },
         "browsers": [
               {
                  "brand": "Chromium",
                  "version": [
                     "136",
                     "0",
                     "7103",
                     "93"
                  ]
               },
               {
                  "brand": "Microsoft Edge",
                  "version": [
                     "136",
                     "0",
                     "3240",
                     "64"
                  ]
               },
               {
                  "brand": "Not.A\/Brand",
                  "version": [
                     "99",
                     "0",
                     "0",
                     "0"
                  ]
               }
         ]
      },
      "ip": "192.0.2.1",
      "geo": {
         "country": "PRT"
      },
      "language": "en",
      "os": "Linux & UNIX",
      "js": 0,
      "ext": {
         "remote_addr": "192.0.2.1",
         "x_forwarded_for": "192.0.2.1"
      }
   },
   "user": {
      "id": "57592f333f8983.043587162282415065"
   },
   "ext": {
      "sub": 1221
   }
}

```

### In-Stream Video, Outstream Video, Video Slider

```json

{
    "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
    "at": 1,
    "imp": [
        {
            "id": "974090632",
            "video": {
                "skip": 1,
                "skipafter": 5,
                "skipmin": 25,
                "mimes": ["video/mp4"],
                "protocols": [
                    3,
                    6
                ]
            },
            "ext": {
                "video_cta": 0
            }
        }
    ],
    "site": {
        "id": "12345",
        "domain": "sitedomain.com",
        "name": "site domain",  
        "cat": ["IAB25-3"],
        "page": "https://sitedomain.com/page",
        "keywords": "lifestyle, humour",
        "ext": {
            "exchangecat": 508,
            "idzone": 445566
        }
    },
    "device": {
        "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36",
        "sua": {
         "architecture": "x86",
         "bitness": "64",
         "model": "Windows",
         "mobile": 0,
         "source": 2,
         "platform": {
               "brand": "Windows",
               "version": [
                  "10",
                  "0",
                  "0"
               ]
         },
         "browsers": [
               {
                  "brand": "Chromium",
                  "version": [
                     "136",
                     "0",
                     "7103",
                     "93"
                  ]
               },
               {
                  "brand": "Microsoft Edge",
                  "version": [
                     "136",
                     "0",
                     "3240",
                     "64"
                  ]
               },
               {
                  "brand": "Not.A\/Brand",
                  "version": [
                     "99",
                     "0",
                     "0",
                     "0"
                  ]
               }
         ]
        },
        "ip": "192.0.2.1",
        "geo": {
            "country": "PRT"
        },
        "language": "en",
        "os": "Linux & UNIX",
        "js": 0,
        "ext": {
            "remote_addr": "192.0.2.1",
            "x_forwarded_for": "192.0.2.1"
        }
    },
    "user": {
        "id": "57592f333f8983.043587162282415065"
    },
    "ext": {
        "sub": 1221
    }
}

```

### Native

```json
{
  "id": "7a452540-c8c9-43ca-9d30-ab9d8bfd17a4",
  "at":1,
  "imp": [
    {
      "id": "2d099176-9feb-44e9-85f9-f385b34123a1",
      "native": {
        "request": "{\"native\":{\"ver\":\"1.2\"\n,\"context\":1\n,\"contextsubtype\":10\n,\"plcmttype\":4\n,\"plcmtcnt\":3\n,\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":124}},{\"id\":2,\"data\":{\"type\":1,\"len\":50}},{\"id\":3,\"required\":1,\"img\":{\"type\":3,\"wmin\":150,\"hmin\":150}}]\n}}",
        "ver": "1.2"
      }
    }
  ],
  "site": {
    "id": "2812",
    "domain": "example.com",
    "name": "site domain",  
    "keywords": "lifestyle, humour",
    "page": "https://example.com/",
    "mobile": 1
  },
  "device": {
    "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 11_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15G77 Version/11.4.1 Safari/604.1 AlohaBrowser/2.10.0b17",
    "sua": {
         "architecture": "x86",
         "bitness": "64",
         "model": "Windows",
         "mobile": 0,
         "source": 2,
         "platform": {
               "brand": "Windows",
               "version": [
                  "10",
                  "0",
                  "0"
               ]
         },
         "browsers": [
               {
                  "brand": "Chromium",
                  "version": [
                     "136",
                     "0",
                     "7103",
                     "93"
                  ]
               },
               {
                  "brand": "Microsoft Edge",
                  "version": [
                     "136",
                     "0",
                     "3240",
                     "64"
                  ]
               },
               {
                  "brand": "Not.A\/Brand",
                  "version": [
                     "99",
                     "0",
                     "0",
                     "0"
                  ]
               }
         ]
      },
    "ip": "192.0.2.1",
    "js": 1,
    "language": "en"
  },
  "user": {
    "id": "37d1951a-7184-4b7f-b227-5571a1ea7467"
  }
}

```

### Popunder

```json

{
    "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
    "at": 1,
    "imp": [
        {
            "id": "974090632",
            "instl": 1
        }
    ],
    "site": {
        "id": "12345",
        "domain": "sitedomain.com",
        "name": "site domain",  
        "cat": ["IAB25-3"],
        "page": "https://sitedomain.com/page",
        "keywords": "lifestyle, humour"
    },
    "device": {
        "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36",
        "sua": {
         "architecture": "x86",
         "bitness": "64",
         "model": "Windows",
         "mobile": 0,
         "source": 2,
         "platform": {
               "brand": "Windows",
               "version": [
                  "10",
                  "0",
                  "0"
               ]
         },
         "browsers": [
               {
                  "brand": "Chromium",
                  "version": [
                     "136",
                     "0",
                     "7103",
                     "93"
                  ]
               },
               {
                  "brand": "Microsoft Edge",
                  "version": [
                     "136",
                     "0",
                     "3240",
                     "64"
                  ]
               },
               {
                  "brand": "Not.A\/Brand",
                  "version": [
                     "99",
                     "0",
                     "0",
                     "0"
                  ]
               }
         ]
      },
        "ip": "192.0.2.1",
        "geo": {
            "country": "IRL"
        },
        "language": "en",
        "os": "Linux & UNIX",
        "js": 0,
        "ext": {
            "remote_addr": "192.0.2.1",
            "x_forwarded_for": "192.0.2.1"
        }
    },
    "user": {
        "id": "57592f333f8983.043587162282415065"
    },
    "ext": {
        "sub": 1221
    }
}

```

### Push Notifications - 720 x 480

```json
{
    "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
    "at": 1,
    "imp": [
        {
            "id": "90180978",
            "native": {
                "request":"{\"native\":{\"ver\":\"1.2\",\"plcmttype\":500,\"plcmtcnt\":1,\"assets\":[{\"id\":1,\"required\":1,\"img\":{\"type\":1,\"w\":720,\"h\":480,\"wmin\":720,\"hmin\":480}},{\"id\":2,\"required\":1,\"title\":{\"len\":60}},{\"id\":3,\"required\":1,\"data\":{\"type\":2,\"len\":110}}]}}",
                "ver": "1.2"
            },
            "secure": 1
        }
    ],
    "site": {
        "id": "12345",
        "domain": "sitedomain.com",
        "name": "site domain",  
        "cat": ["IAB25-3"],
        "page": "https://sitedomain.com/page",
        "keywords": "lifestyle, humour"
    },
    "device": {
        "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36",
        "sua": {
         "architecture": "x86",
         "bitness": "64",
         "model": "Windows",
         "mobile": 0,
         "source": 2,
         "platform": {
               "brand": "Windows",
               "version": [
                  "10",
                  "0",
                  "0"
               ]
         },
         "browsers": [
               {
                  "brand": "Chromium",
                  "version": [
                     "136",
                     "0",
                     "7103",
                     "93"
                  ]
               },
               {
                  "brand": "Microsoft Edge",
                  "version": [
                     "136",
                     "0",
                     "3240",
                     "64"
                  ]
               },
               {
                  "brand": "Not.A\/Brand",
                  "version": [
                     "99",
                     "0",
                     "0",
                     "0"
                  ]
               }
         ]
      },
        "ip": "192.0.2.1",
        "geo": {
            "country": "IRL"
        },
        "language": "en",
        "os": "Linux & UNIX",
        "js": 0,
        "ext": {
            "remote_addr": "192.0.2.1",
            "x_forwarded_for": "",
            "accept_language": "en-GB;q=0.8,pt-PT;q=0.6,en;q=0.4,en-US;q=0.2,de;q=0.2,es;q=0.2,fr;q=0.2"
        }
    },
    "user": {
        "id": "57592f333f8983.043587162282415065"
    },
    "ext": {
        "sub": 1221
    }
}
```

### Push Notifications - 192 x 192

```json
{
    "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
    "at":1,
    "imp": [
        {
            "id": "90180978",
            "native": {
                "request":"{\"native\":{\"ver\":\"1.2\",\"plcmttype\":500,\"plcmtcnt\":1,\"assets\":[{\"id\":1,\"required\":1,\"img\":{\"type\":1,\"w\":192,\"h\":192,\"wmin\":192,\"hmin\":192}},{\"id\":2,\"required\":1,\"title\":{\"len\":60}},{\"id\":3,\"required\":1,\"data\":{\"type\":2,\"len\":110}}]}}",
                "ver": "1.2"
            }
        }
    ],
    "site": {
        "id": "12345",
        "domain": "sitedomain.com",
        "name": "site domain",  
        "cat": ["IAB25-3"],
        "page": "https://sitedomain.com/page",
        "keywords": "lifestyle, humour"
    },
    "device": {
        "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36",
        "sua": {
         "architecture": "x86",
         "bitness": "64",
         "model": "Windows",
         "mobile": 0,
         "source": 2,
         "platform": {
               "brand": "Windows",
               "version": [
                  "10",
                  "0",
                  "0"
               ]
         },
         "browsers": [
               {
                  "brand": "Chromium",
                  "version": [
                     "136",
                     "0",
                     "7103",
                     "93"
                  ]
               },
               {
                  "brand": "Microsoft Edge",
                  "version": [
                     "136",
                     "0",
                     "3240",
                     "64"
                  ]
               },
               {
                  "brand": "Not.A\/Brand",
                  "version": [
                     "99",
                     "0",
                     "0",
                     "0"
                  ]
               }
         ]
      },
        "ip": "192.0.2.1",
        "geo": {
            "country": "IRL"
        },
        "language": "en",
        "os": "Linux & UNIX",
        "js": 0,
        "ext": {
            "remote_addr": "192.0.2.1",
            "x_forwarded_for": "",
            "accept_language": "en-GB;q=0.8,pt-PT;q=0.6,en;q=0.4,en-US;q=0.2,de;q=0.2,es;q=0.2,fr;q=0.2"
        }
    },
    "user": {
        "id": "57592f333f8983.043587162282415065"
    },
    "ext": {
        "sub": 1221
    }
}
```

### Desktop Fullpage Interstitial

```json

{
    "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
    "at":1,
    "imp": [
        {
            "id": "974090632",
            "instl": 1,
             "banner": {
                "w": 1600,
                "h": 900,
                "mimes": [
                  "image/jpg",
                  "image/png",
                  "video/mp4",
                  "image/webp"
                ],
                "ext": {
                  "image_output": "xml",
                  "video_output": "xml"
                }
            }
        }
    ],
    "site": {
        "id": "12345",
        "domain": "sitedomain.com",
        "name": "site domain",  
        "cat": ["IAB25-3"],
        "page": "https://sitedomain.com/page",
        "keywords": "lifestyle, humour"
    },
    "device": {
        "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36",
        "sua": {
         "architecture": "x86",
         "bitness": "64",
         "model": "Windows",
         "mobile": 0,
         "source": 2,
         "platform": {
               "brand": "Windows",
               "version": [
                  "10",
                  "0",
                  "0"
               ]
         },
         "browsers": [
               {
                  "brand": "Chromium",
                  "version": [
                     "136",
                     "0",
                     "7103",
                     "93"
                  ]
               },
               {
                  "brand": "Microsoft Edge",
                  "version": [
                     "136",
                     "0",
                     "3240",
                     "64"
                  ]
               },
               {
                  "brand": "Not.A\/Brand",
                  "version": [
                     "99",
                     "0",
                     "0",
                     "0"
                  ]
               }
         ]
      },
        "ip": "192.0.2.1",
        "geo": {
            "country": "XXX"
        },
        "language": "en",
        "os": "Linux & UNIX",
        "js": 0,
        "ext": {
            "remote_addr": "192.0.2.1",
            "x_forwarded_for": "192.0.2.1"
        }
    },
    "user": {
        "id": "57592f333f8983.043587162282415065"
    },
    "ext": {
        "sub": 1221
    }
}
```

### Mobile Fullpage Interstitial

```json
{
    "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
    "at":1,
    "imp": [
        {
            "id": "974090632",
            "instl": 1,
             "banner": {
                "w": 900,
                "h": 1600,
                "mimes": [
                  "image/jpg",
                  "image/png",
                  "video/mp4",
                  "image/webp"
                ]
            }
        }
    ],
    "site": {
        "id": "12345",
        "domain": "sitedomain.com",
        "name": "site domain",  
        "cat": ["IAB25-3"],
        "page": "https://sitedomain.com/page",
        "keywords": "lifestyle, humour"
    },
    "device": {
        "ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.63 Safari/537.36",
        "ip": "192.0.2.1",
              "sua": {
         "architecture": "x86",
         "bitness": "64",
         "model": "Windows",
         "mobile": 0,
         "source": 2,
         "platform": {
               "brand": "Windows",
               "version": [
                  "10",
                  "0",
                  "0"
               ]
         },
         "browsers": [
               {
                  "brand": "Chromium",
                  "version": [
                     "136",
                     "0",
                     "7103",
                     "93"
                  ]
               },
               {
                  "brand": "Microsoft Edge",
                  "version": [
                     "136",
                     "0",
                     "3240",
                     "64"
                  ]
               },
               {
                  "brand": "Not.A\/Brand",
                  "version": [
                     "99",
                     "0",
                     "0",
                     "0"
                  ]
               }
         ]
      },
        "geo": {
            "country": "XXX"
        },
        "language": "en",
        "os": "Linux & UNIX",
        "js": 0,
        "ext": {
            "remote_addr": "192.0.2.1",
            "x_forwarded_for": "192.0.2.1"
        }
    },
    "user": {
        "id": "57592f333f8983.043587162282415065"
    },
    "ext": {
        "sub": 1221
    }
}

```

## Open RTB 2.5 Publisher Response

### Banner / Push Notifications JSON

```json
{
   "id":"d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
   "seatbid":[
      {
         "bid":[
            {
               "id":"1737294d31e606ef366cbf9fd30ca409c8819978",
               "impid":"974090632",
               "price":0.55,
               "adm":"<ExoClick_XML_AD_MARKUP>",
               "ext":{
                  "btype":1
               },
               "nurl": "https://mysite.com/my_notification_url",
               "burl": "https://mysite.com/my_billing_notification_url",
               "cid":"123456",
               "crid":"22334455",
               "adid":"22334455",
               "adomain":[
                  "wwww.advertiser.com"
               ],
               "w":300,
               "h":250
            }
         ]
      }
   ]
}
```

### Direct Links JSON

```json
{
    "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
    "seatbid": [
        {
            "bid": [
                {
                    "id": "9093b7bc2715a39446fe380ecb63a45a96485cd8",
                    "impid": "974090632",
                    "price": 0.07,
                    "adm": "<URL_AD_MARKUP>",
                    "ext": {
                        "btype": 2
                    },
                    "nurl": "https://mysite.com/my_notification_url",
                    "burl": "https://mysite.com/my_billing_notification_url",
                    "cid": "123456",
                    "crid": "22334455",
                    "adid": "126544225",
                    "cat": [],
                    "adomain": [
                        "www.advertiser-domain.com"
                    ],
                    "w": 0,
                    "h": 0,
                    "attr": []
                }
            ]
        }
    ]
}
```

### Email Clicks JSON

```json

{
    "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
    "seatbid": [
        {
            "bid": [
                {
                    "id": "9093b7bc2715a39446fe380ecb63a45a96485cd8",
                    "impid": "974090632",
                    "price": 0.07,
                    "adm": "<URL_AD_MARKUP>",
                    "ext": {
                        "btype": 2
                    },
                    "nurl": "https://mysite.com/my_notification_url",
                    "burl": "https://mysite.com/my_billing_notification_url",
                    "cid": "123456",
                    "crid": "22334455",
                    "adid": "126544225",
                    "cat": [],
                    "adomain": [
                        "www.advertiser-domain.com"
                    ],
                    "w": 0,
                    "h": 0,
                    "attr": []
                }
            ]
        }
    ]
}

```

### In-Stream Video, Outstream Video, Video Slider JSON

```json

{
    "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
    "seatbid": [{
        "bid": [{
            "id": "12ab3d",
            "impid": "974090632",
            "price": 0.55,
            "adm": "<EXOCLICK_XML_AD_MARKUP>",
            "nurl": "https://mysite.com/my_notification_url",
            "burl": "https://mysite.com/my_billing_notification_url",
            "cid" : "123456",
            "crid" : "22334455",
            "ext": {
                "btype": 1
            },
            "adid": "126544225",
            "cat": [],
            "adomain": [
                "www.advertiser-domain.com"
            ],
            "w": 0,
            "h": 0,
            "attr": []
        }]
    }]
}


```

### Native JSON

* Single placement ("plcmtcnt":1) response

```json
{
  "id": "7a452540-c8c9-43ca-9d30-ab9d8bfd17a4", 
  "seatbid": 
  [
    {
      "bid": 
      [
        {
            "id": "4fab7972833e2aaf53a828b1408fc104293734e3", 
            "impid": "2d099176-9feb-44e9-85f9-f385b34123a1", 
            "price": 0.0025,                                 
            "adm": "<AD_MARKUP>", 
            "ext": { "btype": 1 }, 
            "nurl": "https://mysite.com/my_notification_url",
            "burl": "https://mysite.com/my_billing_notification_url",
            "cid": "123456",
            "crid": "22334455",
            "adid": "126544225",
            "cat": [],
            "adomain": [
                "www.advertiser-domain.com"
            ],
            "w": 300,
            "h": 300,
            "attr": []
        }
      ]
    }
  ]
}
```

### Popunder JSON

```json
{
    "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
    "seatbid": [
        {
            "bid": [
                {
                    "id": "12ab3d",
                    "impid": "974090632",
                    "price": 0.55,
                    "adm": "<URL_AD_MARKUP>",
                    "nurl": "https://mysite.com/my_notification_url",
                    "burl": "https://mysite.com/my_billing_notification_url",
                    "cid": "123456",
                    "crid": "22334455",
                    "ext": {
                        "btype": 1
                    },
                    "adid": "126544225",
                    "cat": [],
                    "adomain": [
                        "www.advertiser-domain.com"
                    ],
                    "w": 0,
                    "h": 0,
                    "attr": []
                }
            ]
        }
    ]
}
```

### Fullpage Interstitial JSON

```json
{
  "id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
  "seatbid": [
    {
      "bid": [
        {
          "id": "6cf48ee722a1a7b27f954fc87c6bd5dc7fcef269",
          "impid": "974090632",
          "price": 0.05,
          "adm": "<EXOCLICK_XML_OR_JSON_AD_MARKUP>",
          "ext": {
            "btype": 1
          },
          "nurl": "https://mysite.com/my_notification_url",
          "burl": "https://mysite.com/my_billing_notification_url",
          "cid": "7562017",
          "crid": "195600_115116297",
          "adid": "115116297",
          "cat": [],
          "adomain": [
            "www.exoclick.com"
          ],
          "w": 1600,
          "h": 900,
          "attr": []
        }
      ]
    }
  ],
  "bidid": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
  "cur": "EUR"
}

```

{% hint style="info" %}
**Note**: Direct Links, Email Clicks and Popunder response objects already have the ADM included.
{% endhint %}

## ADM

### Banner: HTML (a tag)

```html
<a 
  href="https://sitedomain.com/click.php?data=H4sIAAAAAAAAA0WOO27DQAxEr6LG7YLf_ZRp0qTIGVarFSzEtgJZhh2Ahw.jJjNkRc7gCXLJkkwB7Lzv3_cTv53o3ef5fIblNvVXOG9m6DKMmCgmgmLjWL.WrYe2Xg0hCAUIaKIMWVhNIGaNxWuzmaCRFxiYsDHAixTM28w0aaGZmedcMgfwaE4YiTIJKkT1TFTNTaZ55KKpliKaJTZujR1pbs3.iu_L3qf1WpfbQQSHh8sy9_v.c.nD.XFdH9tgx_O_zRedkFzmGGw5HQfntc8P40I6TalC6dgrjyipdaxjS5hkAvoFeR9FKz4BAAA-"
  target="_blank"
  ontouchstart=""
  onclick="var href='https://sitedomain.com/click.php?data=H4sIAAAAAAAAA0WOO27DQAxEr6LG7YLf_ZRp0qTIGVarFSzEtgJZhh2Ahw.jJjNkRc7gCXLJkkwB7Lzv3_cTv53o3ef5fIblNvVXOG9m6DKMmCgmgmLjWL.WrYe2Xg0hCAUIaKIMWVhNIGaNxWuzmaCRFxiYsDHAixTM28w0aaGZmedcMgfwaE4YiTIJKkT1TFTNTaZ55KKpliKaJTZujR1pbs3.iu_L3qf1WpfbQQSHh8sy9_v.c.nD.XFdH9tgx_O_zRedkFzmGGw5HQfntc8P40I6TalC6dgrjyipdaxjS5hkAvoFeR9FKz4BAAA-';
           this.href = href + '&clickX=' + event.clientX + '&clickY=' + event.clientY;">
  <img 
    width="300" 
    height="250" 
    src="https://sitedomain.com/library/432437/c506e8224d74d30b946f3398fe7bf9f90a9bf5ec.jpg" 
    border="0" 
    style="">
</a>

<img 
  src="https://sitedomain.com/cimp.php?data=TVRZeE56STJOekl3T1h3ek9UVTROMkUyWmpObE16bGxObUZsTTJVek5UZ3lNakF6T0RBMVpUTXpaZy0tfC9saWJyYXJ5LzQzMjQzNy9jNTA2ZTgyMjRkNzRkMzBiOTQ2ZjMzOThmZTdiZjlmOTBhOWJmNWVjLmpwZ3xodHRwc3wxMC40Mi4wLjF8WFhYfDQxfGJiYWtpcmUuY29tfDQzMjQzN3w0NDYwNzV8Nzc2MTg2fDQwNjg1Njl8NTA4fDQxMzk4NDd8NDUzMDg0MzV8MTF8Mnw0M3wwfDB8MTExMXw1MDB8OTB8VVNEfFVTRHwxfDF8MjF8MzAweDI1MHwxfHx8MTh8MnwxfHw1NzU5MmYzMzNmODk4My4wNDM1ODcxNjIyODI0MTUwNjV8NjU1OGM0ZGZiMzk1N2E5OTQ1ODQ2YzNjYzMxMTFmY2N8MXwwfHNpdGVkb21haW4uY29tfDB8MHwwfDEuMDJ8MXwwfGV4Y2hhbmdlX2Jhbm5lcnwwfDB8MHwtMXwwfDB8fHwwfDB8fDB8MjIyMnwzMzMzfDg3fDB8MHwxfE9LfDc0MDYzMzg1ZTIxYmMwNDU2NTNhNDU0ZTQ2ZjAxYjEx" 
  width="1" 
  height="1" 
  border="0" 
/>

```

### In-Stream Video, Outstream Video, Video Slider ADM

The VAST structure shown here is detailed below.

Remote VAST:

```xml
<?xml version="1.0" encoding="UTF-8"?>
<VAST version="3.0">
    <Ad id="1111111">
        <Wrapper>
            <AdSystem>EXOCLICK</AdSystem>
            <VASTAdTagURI><![CDATA[https://external.adserver.com/xml?cid=1111111]]></VASTAdTagURI>
            <Impression id="exotr">
                <![CDATA[https://syndication.mysite.com/vregister.php?a=vimp&tracking_event=impression&idzone=22222&data=abcd]]></Impression>
            <Error>
                <![CDATA[https://syndication.mysite.com/vregister.php?a=vview&errorcode=[ERRORCODE]&idzone=22222]]></Error>
            <Creatives>
                <Creative sequence="1" id="12345">
                    <Linear>
                        <TrackingEvents>
                            <Tracking id="prog_1" event="progress" offset="00:00:10.000">
                                <![CDATA[https://syndication.mysite.com/vregister.php?a=vview&tracking_event=progress&progress=00:00:10.000&idzone=22222&data=abcd]]></Tracking>
                        </TrackingEvents>
                        <VideoClicks>
                            <ClickThrough>
                                <![CDATA[https://syndication.mysite.com/click.php?data=abcd]]></ClickThrough>
                        </VideoClicks>
                    </Linear>
                </Creative>
            </Creatives>
        </Wrapper>
    </Ad>
</VAST>
```

Local VAST:

```xml

<?xml version="1.0" encoding="UTF-8"?>
<VAST version="3.0">
	<Ad id="123456">
		<InLine>
			<AdSystem>mysite.com</AdSystem>
			<AdTitle/>
			<Impression id="exotr">
				<![CDATA[http://syndication.mysite.com/vregister.php?a=vimp&tracking_event=impression&idzone=123456&2027add921916df3805db53a7c6af183=tsVuZ8uHLjt4ddvLjq4d_XDz65dddlTlK8E.etqayWunDNRRTXA3GxK9Yw85nw11QVuLvzVVysSOZyzSsSObmppNcDbDdrlNcFTlOfDXA3PYzHBU.5Tnw1wN1QVuZ8NcDeM0rmfDXA20xW49NThnw1wNtMSTsQPS58NcDdrFMDFcE0ufDXA3NVnw1wNs0zXVOU58NcDbblsDTmfDXA20xTTA5Tnw1wNwVT58NdVjOfDXaxHY5nw1z2MxwVPuUr0sVuZ8Nc9jMcFT7lK7VlNLkrWGaJ4GtpiSdiB6VdqymlyVrDNE8DW5e0.xK84vXMvPYzHBU.5Tnx1uXtPsSvOL1zLyuV3TUxZ8dbDa9eE7mfDW7NTIxXnrgblcrumpiz462prJa6cF5qYHoJWI81FFNb9dc6967s1NzFLbja7s1OeuBuemZuxqtdpitx6anDPhrnpgagleXkmbcjz4a36656s.GupqlxyVelyqaOyuCaXPXZU5SvA3nw12UxrvsVP564JJ6XKqoJpV6q2K7Ks.GuCSelyqqCaVeCW1iOBtelxiqaXPhrpcdcpcpXqgrcXfmqrlYkcz1sNsxzNRZ8NcDczrrlOfDXA3GxK3BK8vOw85nw1uXuNWVwTSr1wSOZ64G22K2GnJa3Kc.GuBtpimmByleqaylpzPhrlmqapgnrz4a4JWpnpYK5l5Jm3M.GutyqteSZtzPhrpcegmlXecmlYkcXgbz4a56Zr8F6q2K7Ks9vHXA3OxTXK5Tnw1tQV4LvOTSsSOLwN58NcrlbDVkFeC89M1.C9eE7meuVythqyCvBeema_BdtypqmCeuCaXPWw2zHM1Eva5TnrgknpcqqgmlXYjjXgltYjgbXpcYqmlqz4a6rGeWfDXVYzzz4a6mqYJ6168J3M9dTVME9a8rEjmeupqmCete1ynPWzTNdU5Sva5Tnw12058NcEtblMrEefDXZU5Su0xPPBK9nw12VOUrtMTzwSvLu0uUWOStYZ8NdtlkDefHty49fPXn269uXnl08c.vTtwY7.ejnXl5Y5cNdcEjlVbEk.fHty49fPXn2662ppooHGppanJa8.M]]>
			</Impression>
			<Error>
				<![CDATA[http://syndication.mysite.com/vregister.php?a=vview&errorcode=[ERRORCODE]&idzone=4286963&dg=123456-53781245-2-0-0-InLine]]>
			</Error>
			<Creatives>
				<Creative sequence="1" id="53781245">
					<Linear>
						<Duration>00:00:14.40</Duration>
						<TrackingEvents>
							<Tracking id="prog_1" event="progress" offset="00:00:10.000">
								<![CDATA[http://syndication.mysite.com/vregister.php?a=vview&tracking_event=progress&progress=00:00:10.000&idzone=123456&2027add921916df3805db53a7c6af183=tsVuZ8uHLjt4ddvLjq4d_XDz65dddlTlK8E.etqayWunDNRRTXA3GxK9Yw85nw11QVuLvzVVysSOZyzSsSObmppNcDbDdrlNcFTlOfDXA3PYzHBU.5Tnw1wN1QVuZ8NcDeM0rmfDXA20xW49NThnw1wNtMSTsQPS58NcDdrFMDFcE0ufDXA3NVnw1wNs0zXVOU58NcDbblsDTmfDXA20xTTA5Tnw1wNwVT58NdVjOfDXaxHY5nw1z2MxwVPuUr0sVuZ8Nc9jMcFT7lK7VlNLkrWGaJ4GtpiSdiB6VdqymlyVrDNE8DW5e0.xK84vXMvPYzHBU.5Tnx1uXtPsSvOL1zLyuV3TUxZ8dbDa9eE7mfDW7NTIxXnrgblcrumpiz462prJa6cF5qYHoJWI81FFNb9dc6967s1NzFLbja7s1OeuBuemZuxqtdpitx6anDPhrnpgagleXkmbcjz4a36656s.GupqlxyVelyqaOyuCaXPXZU5SvA3nw12UxrvsVP564JJ6XKqoJpV6q2K7Ks.GuCSelyqqCaVeCW1iOBtelxiqaXPhrpcdcpcpXqgrcXfmqrlYkcz1sNsxzNRZ8NcDczrrlOfDXA3GxK3BK8vOw85nw12wNuTLuWuS1563KaZqWpm3M9cDbbFbDTktblOfDXA20xTTA5SvVNZS05nw1yzVNUwT158NcErUz0sFcy8kzbmfDXW5VWvJM25nw10uPQTSrvOTSsSOLwN58Nc9M1.C9VbFdlWe3jrgbnYprlcpz4a2oK8F3nJpWJHF4G8.GuVythqyCvBeema_BevCdzPXK5Ww1ZBXgvPTNfgu25U1TBPXBNLnrYbZjmaiXtcpz1wST0uVVQTSrsRxrwS2sRwNr0uMVTS1Z8NdVjPLPhrqsZ558NdTVME9a9eE7meupqmCeteViRzPXU1TBPWva5TnrZpmuqcpXtcpz4a7ac.GuCWtymViPPhrtssgbz49uXHr568.3Xt568effp579uDHfz0c68vHft111wSOVVsST58e3Lj189efbrrammigcamlqclrz4w]]>
							</Tracking>
						</TrackingEvents>
						<VideoClicks>
							<ClickThrough>
								<![CDATA[https://syndication.mysite.com/click.php?data=H4sIAAAAAAAAA0VPOWrEQBD8ipJNhz7nCJ04ceA3jEcaVljHosNg04_3rByY6oKGKqq6RQRQ0NDux_HYb_xyo9c2X3lz_bAf45KPcV3cuU2urLMZEjW3J9Sk7NV.hm195O3zUhGckAOHphwikqgJRZ88myKatSIyVIMGe5aaBk1UmbnGFNmBsMbQ4imSoIJ_er1qLNLXD04ackqiUXzhUhgRayktB2wfj6Ff5zwu1yVwoZvG2p74nobufs7ruXV2mf9hjQx27fonSeP7m8WUGfoiFWqh7OsQasA4RCYMgDH9Aqi26WQ6AQAA]]>
							</ClickThrough>
						</VideoClicks>
						<MediaFiles>
							<MediaFile delivery="progressive" type="video/mp4">
								<![CDATA[https://staticcdn.mysite.com/library/195600/5b7d9ad16e4b86ba8695f867e9a8464fc4444943.mp4]]>
							</MediaFile>
						</MediaFiles>
						<Icons>
							<Icon>
								<IconClicks>
									<IconClickThrough>var.destination.url.com</IconClickThrough>
								</IconClicks>
							</Icon>
						</Icons>
					</Linear>
				</Creative>
			</Creatives>
      <Extensions>
    <Extension>
        <TitleCTA>
            <MobileText>View More</MobileText>
            <PCText>View More</PCText>
            <Link><![CDATA[]]></Link>
            <Tracking><![CDATA[https://click.tracking.com/click.php?data=H4sIAAAAAAAAA0...-]]></Tracking>
        </TitleCTA>
    </Extension>
</Extensions>
		</InLine>
	</Ad>
</VAST>

```

### Fulloage Interstitial

```xml
<?xml version="1.0"?><ad><iframeAd><url><![CDATA[https://mysite.com/fpi-render.php?data=TVRjME9UY3lPVE15Tm53]]></url></iframeAd></ad>

```

### Native Ads

```
{\"native\":{\"link\":{\"url\":\"http:\/\/mysite.com\/landingpages\/mypage\"},\"assets\":[{\"id\":1,\"required\":1,\"img\":{\"url\":\"http:\/\/mysite.com\/images\/myad.jpg\",\"w\":300,\"h\":300,\"ext\":{\"crop_anchor_point\":1}}},{\"id\":2,\"title\":{\"text\":\"Ad Title\"}},{\"id\":3,\"data\":{\"type\":2,\"value\":\"Ad description\"}},{\"id\":4,\"data\":{\"type\":1,\"value\":\"Ad brand\"}},{\"id\":5,\"ext\":{\"crop_anchor_point\":1}}],\"imptrackers\":[\"https://mytracker1.com\"],\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://myEventTracker1.com\"}]}}
```

Which is based on the following JSON object:

```json
{
    "native": {
          "link": {
              "url": "http://mysite.com/landingpages/mypage"
          },
          "assets": [
              {
                  "id": 1,
                  "required": 1,
                  "img": {
                      "url": "http://mysite.com/images/myad.jpg",
                      "w": 300,
                      "h": 300,
                      "ext": {
                          "crop_anchor_point": 1
                      }
                  }
              },
              {
                  "id": 2,
                  "title": {
                      "text": "Ad Title"
                  }
              },
              {
                  "id": 3,
                  "data": {
                      "type": 2,
                      "value": "Ad description"
                  }
              },
              {
                  "id": 4,
                  "data": {
                      "type": 1,
                      "value": "Ad brand"
                  }
              }
          ],
          "eventtrackers": [
              {
                  "event": 1,
                  "method": 1,
                  "url": "https://myEventTracker1.com"
              }
          ]
    }
}
```

### Push Notifications

```
{\"native\":{\"link\":{\"url\":\"http:\/\/mysite.com\/landingpages\/mypage\"},\"assets\":[{\"id\":1,\"required\":1,\"img\":{\"url\":\"http:\/\/mysite.com\/images\/myad.jpg\",\"w\":720,\"h\":480}},{\"id\":2,\"title\":{\"text\":\"Ad Title\"}},{\"id\":3,\"data\":{\"type\":2,\"value\":\"Ad description\"}}],\"imptrackers\":[\"https://mytracker1.com\"]}}
```

Which is based on the following JSON object:

```json
{
    "native": {
          "link": {
              "url": "http://mysite.com/landingpages/mypage"
          },
          "assets": [
              {
                  "id": 1,
                  "required": 1,
                  "img": {
                      "url": "http://mysite.com/images/myad.jpg",
                      "w": 720,
                      "h": 480
                  }
              },
              {
                  "id": 2,
                  "title": {
                      "text": "Ad Title"
                  }
              },
              {
                  "id": 3,
                  "data": {
                      "type": 2,
                      "value": "Ad description"
                  }
              }
          ],
          "imptrackers": [
              "https://mytracker1.com"
          ]
    }
}
```

{% hint style="info" %}

* Only one imptracker URL is allowed in the case of Push Notification ads
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.exoclick.com/rtb/publishers/open-rtb/open-rtb-2.5-pub-code-examples.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
