Technical Implementation

ConnectAd supports integrations via OpenRTB 2.5 protocol.

If you're interested in an OpenRTB integration, please ask your ConnectAd Account Manager for further integration details and your specific endpoint.

{
    "id" : "eb85349d-03c3-44f4-a77b-824f7221d116",
    "imp": [
        {
        "id": "asjkajkskajskas",
        "banner": {
            "h": 250,
            "w": 300,
            "battr": [2,3],
            "btype": [1,3],
            "format": [
                {"w": 728, "h": 90},
                {"w": 300, "h": 250},
                {"w": 160, "h": 60}
                ]
            }
        }
    ],
    "site": {
        "id": "4053",
        "name": "Example Site Name",
        "domain": "http://www.example.com",
        "cat" : [ "IAB15", "IAB15-10" ],
        "page": "http://easy.example.com/easy?cu=13824;cre=mu;target=_blank",
        "ref" : "http://refer+url",
        "publisher": {
            "id": "qqwer1234xgfd",
            "name": "site_name",
            "domain": "my.site.com"
        }
    },
    "device": {
        "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_6_8) AppleWebKit/537.13  (KHTML, like Gecko) Version/5.1.7 Safari/534.57.2",
        "ip": "80.153.147.236",
        "geo": {
            "lat": 37.789,
            "lon": -122.394,
            "country": "USA",
            "city": "San Francisco",
            "region": "CA",
            "zip" : "94105",
            "type": 2
        }
    },
    "user": {
    	"buyeruid" : "89776897686798fwe87rtryt8976fsd7869678",
        "id": "55816b39711f9b5acf3b90e313ed29e51665623f",
        "gender": "M",
        "yob": 1975,
        "data": [{
            "id": "pub-demographics",
            "name": "data_name",
            "segment": [{
                "id" : "345qw245wfrtgwertrt56765wert",
                "name" : "segment_name",
                "value": "segment_value"
            }]
        }]
    }
}

Response sample:

{
    "id": "eb85349d-03c3-44f4-a77b-824f7221d116",
    "seatbid": [
        {
            "bid": [
                {
                    "id": "8148a1af00c34cb3e6bce6d67b48f1a56229d1f9",
                    "impid": "asjkajkskajskas",
                    "price": 11.899999999999999,
                    "adm": "<div id=\"grumi-container\"><script type=\"text/javascript\" nonce=\"!headerNonce!\">!function(d,i){var p={wver:\"1.1.3\",wtype:\"dfp\",key:\"6818a3d1-92d9-465b-84c0-bbfe52c3a026\",meta:{w:\"728\",h:\"90\",adv:\"connectad.io\",cust_imp:\"pwZOQTnQb1Q9SBeklPFcPbGieaVoLRQ6fOxapwkV\",di:\"14\",dn:\"S14\",dcid:\"0\",pid:\"127\",pn:\"example.com\"},sp:\"dfp\",cfg:{},site:\"example.com\"};window.grumi=p}();</script><template style=\"display: none;\" id=\"template0\"><xmp style=\"display: none;\" id=\"xmp0\">This is a creative from ConnectAd.<ins id=\"pwZOQTnQb1Q9SBeklPFcPbGieaVoLRQ6fOxapwkV\"></ins><script type=\"text/javascript\"> (function(){ var i = document.createElement(\"IFRAME\"); i.setAttribute(\"src\", \"https://e.connectad.io/nurls/pwZOQTnQb1Q9SBeklPFcPbGieaVoLRQ6fOxapwkV?a=140&b=127&c=3&d=US&e=728x90&f=eyJpdiI6InFsRGJBQlFjRXdlNHI3TWxENEN4bHc9PSIsInZhbHVlIjoiVDJHcytJbE5HcDJkcHhHa241SHBRQT09IiwibWFjIjoiNGNlMTQ0NjI0M2VkYTFhMTUyYTVlMWZmMGEzOGIxNjlkNDRkYjVhNzQ3NjU2MzMyOGFjYWUzYmVhOGRhN2EyNiJ9&g=75.67286491394&h=2&i=4053&j=easy.example.com&k=easy.example.com&l=8811&m=eyJpdiI6Im41TDZQdzNmYU1Jc2dpWkk4SUZyNmc9PSIsInZhbHVlIjoiTnhwODZ4bXplN3lBY2xac1RjSFhMQT09IiwibWFjIjoiZTljNjA2Zjg2MDk0YzUxYzQxMTJhOGI3OWQ0ZDQ3MTQ0Yzg0NTU4ZjY0YmM3ZTFmMTZlNDM2MDk4MDMxMjIyZSJ9&n=0\"); i.style.width = \"0\"; i.style.height = \"0\"; i.marginWidth = \"0\"; i.marginHeight = \"0\"; i.border = \"0px\"; i.hspace = \"0\"; i.vspace = \"0\"; i.style.border = \"0\"; i.scrolling = \"no\"; i.frameborder = \"0\"; document.getElementById(\"pwZOQTnQb1Q9SBeklPFcPbGieaVoLRQ6fOxapwkV\").appendChild(i); }()); </script></xmp></template><script type=\"text/javascript\" nonce=\"!footerNonce!\">!function(n){var e,o=window.grumi.key,i=window.grumi,r=i&&i.wtype&&\"gpt\"===i.wtype,a=1*new Date,d=navigator.userAgent&&navigator.userAgent.match(/\\b(MSIE |Trident.*?rv:|Edge\\/)(\\d+)/);function t(){var e=function(){for(var e,t=document.getElementsByTagName(\"template\"),n=t.length-1;0<=n;n--)if(\"template0\"===t[n].id){e=t[n];break}return e}();return e.content?e.content.getElementById?e.content.getElementById(\"xmp0\"):e.content.childNodes[0]:e.getElementsByTagName(\"xmp\")[0]}function u(e,t){t=t||!1,top.postMessage&&top.postMessage({evType:e||\"\",key:i.key,adup:i.meta.adup,html:window.grumi?window.grumi.tag:\"\",el:i.meta.adElId,refresh:t},\"*\")}function w(e,t){var n=\"\",o=d&&\"complete\"===document.readyState;window.grumi&&(window.grumi.fsRan=!0,n=window.grumi.tag),o||(window.document.open(),window.document.write(n),window.document.close()),((t=t||!1)||o)&&u(e,o)}function c(e,n){return function(){var t=setTimeout(function(){var e=document.getElementById(a);e&&null===function(e){if(void 0!==e.nextElementSibling)return e.nextElementSibling;for(var t=e.nextSibling;t&&1!==t.nodeType;)t=t.nextSibling;return t}(e)&&n&&n(),clearTimeout(t)},e)}}c(5e3,function(){w()})(),c(2e3,function(){u(\"slwCl\")})(),window.grumi.tag=(e=t())&&e.innerHTML,window.grumi.scriptHost=n,window.parent&&window.parent.postMessage&&window.parent.postMessage({iw:!0,key:i.key,adup:i.meta.adup,el:i.meta.adElId},\"*\"),function(){var e=document.createElement(\"script\");e.type=\"text/javascript\",e.src=n+o+\"/grumi.js\",e.className=\"rm\",e.id=a,r&&!d&&(e.async=!0);var t=\"_\"+1*new Date;window[t]=function(){w(\"netErr\",!0)},window.grumi.start=1*new Date;try{window.document.write(e.outerHTML.replace('class=\"rm\"','onerror=\"'+t+'();\"'))}catch(e){w()}}()}((\"http\"===window.location.protocol.substr(0,4)?window.location.protocol:\"https:\")+\"//rumcdn.geoedge.be/\");</script></div>",
                    "adomain": [
                        "connectad.io"
                    ],
                    "adid": "0"
                }
            ]
        }
    ],
    "cur": "USD"
}